Rails-Unterstützung in SQL Anywhere

Rails ist ein Webentwicklungs-Framework, das in der Ruby-Sprache geschrieben ist. Seine Stärke liegt in der Entwicklung von Webanwendungen. Eine Vertrautheit mit der Ruby-Programmiersprache wird ausdrücklich empfohlen, bevor Sie mit Rails-Entwicklungen beginnen. Wenn Sie dabei sind, sich mit Ruby vertraut zu machen, lesen Sie SQL Anywhere-Ruby-API-Referenz.

Voraussetzungen für die Rails-Entwicklung

RubyGems Sie sollten RubyGems installieren. Es vereinfacht die Installation der Ruby-Pakete. Über die Download-Seite Ruby on Rails wird Ihnen die korrekte Version für die Installation gezeigt. Weitere Hinweise finden Sie unter http://www.rubyonrails.org/.
Ruby Sie müssen den Ruby-Interpreter auf Ihrem System installieren. Auf der Ruby on Rails-Website finden Sie Empfehlungen, welche Version Sie installieren sollten. Weitere Hinweise finden Sie unter http://www.rubyonrails.org/.
Rails Mit RubyGems können Sie Rails und seine Abhängigkeiten unter Verwendung einer einzigen Befehlszeile installieren:
gem install rails
Ruby Development Kit Installieren Sie das Ruby Development Kit (DevKit). Laden Sie das DevKit von http://rubyinstaller.org/downloads/ herunter und befolgenden Sie Anweisungen unter http://github.com/oneclick/rubyinstaller/wiki/Development-Kit.

activerecord-sqlanywhere-adapter Wenn Sie es noch nicht getan haben, müssen Sie die SQL Anywhere ActiveRecord-Unterstützung installieren, um Rails-Entwicklungen mit SQL Anywhere durchzuführen. Mit RubyGems können Sie die gesamte SQL Anywhere ActiveRecord-Unterstützung und ihre Abhängigkeiten unter Verwendung einer einzigen Befehlszeile installieren:

gem install activerecord-sqlanywhere-adapter

Bevor Sie beginnen

Nachdem Sie die erforderlichen Komponenten installiert haben, gibt es einige abschließende Schritte, die Sie durchführen müssen, bevor Sie mit der Rails-Entwicklung unter Verwendung von SQL Anywhere beginnen können. Diese Schritte sind erforderlich, um SQL Anywhere der Gruppe von Datenbank-Verwaltungssystemen hinzuzufügen, die von Rails unterstützt werden. Zum Zeitpunkt der Dokumentationserstellung war die Version Rails 3.1.3 aktuell.

Hinzufügen von SQL Anywhere-Unterstützung zu Rails

Zum Konfigurieren einer Datenbank müssen Sie eine sqlanywhere.yml-Datei im Rails-Verzeichnis configs\databases erstellen. Wenn Sie Ruby im Pfad \Ruby installiert haben und die Version 3.1.3 von Rails eingerichtet wurde, ist der Pfad zu dieser Datei \Ruby\lib\ruby\gems\1.9.1\gems\railties-3.1.3\lib\rails\generators\rails\app\templates\config\databases. Diese Datei sollte Folgendes enthalten:

#
# SQL Anywhere database configuration
#
# This configuration file defines the patten used for
# database filenames. If your application is called "blog",
# then the database names will be blog_development,
# blog_test, blog_production. The specified username and
# password should permit DBA access to the database.
#

development:
  adapter: sqlanywhere
  server: <%= app_name %>
  database: <%= app_name %>_development
  username: DBA
  password: sql

# Warning: The database defined as "test" will be erased and
# re-generated from your development database when you run "rake".
# Do not set this db to the same as development or production.
test:
  adapter: sqlanywhere
  server: <%= app_name %>
  database: <%= app_name %>_test
  username: DBA
  password: sql

production:
  adapter: sqlanywhere
  server: <%= app_name %>
  database: <%= app_name %>_production
  username: DBA
  password: sql

Sie müssen die Rails-Datei app_base.rb aktualisieren. Unter den gleichen Annahmen wie in Schritt 1 oben befindet sich diese Datei im Pfad \Ruby\lib\ruby\gems\1.9.1\gems\railties-3.1.3\lib\rails\generators\app_base.rb. Bearbeiten Sie die Datei app_base.rb und navigieren Sie zur folgenden Zeile:

DATABASES = %w( mysql oracle postgresql sqlite3 frontbase ibm_db sqlserver )

Fügen Sie sqlanywhere folgendermaßen der Liste hinzu:

DATABASES = %w( sqlanywhere mysql oracle postgresql sqlite3 frontbase ibm_db sqlserver )

Nun speichern und schließen Sie die Datei.

Die Datei sqlanywhere.yml bietet eine Vorlage für die Erstellung von database.yml-Dateien in Rails-Projekten. Die Vorlage oben zeigt einige der Datenbankoptionen, die angegeben werden können. Hier ist die vollständige Liste.

adapter (erforderlich, kein Standardwert). Diese Option muss auf sqlanywhere eingestellt werden, damit der SQL Anywhere ActiveRecord-Adapter verwendet werden kann.
database (erforderlich, kein Standardwert). Diese Option entspricht "DatabaseName =" in einer Verbindungszeichenfolge.
server (optional, standardmäßig Option database). Diese Option entspricht "ServerName =" in einer Verbindungszeichenfolge.
username (optional, standardmäßig 'DBA'). Diese Option entspricht "UserID =" in einer Verbindungszeichenfolge.
password (optional, standardmäßig 'sql'). Diese Option entspricht "Password =" in einer Verbindungszeichenfolge.
Kodierung (optional, standardmäßig der Betriebssystem-Zeichensatz der Datenbank). Diese Option entspricht "CharSet =" in einer Verbindungszeichenfolge.
commlinks (optional). Diese Option entspricht "CommLinks =" in einer Verbindungszeichenfolge.
connection_name (optional). Diese Option entspricht "ConnectionName =" in einer Verbindungszeichenfolge.

Praktische Einführung in Rails

Es wird empfohlen, dass Sie mit der praktischen Einführung auf der Ruby on Rails-Website beginnen. Verwenden Sie die nachstehenden Hinweise parallel zur praktischen Einführung. Diese Hinweise beschreiben Unterschiede bei der Verwendung von SQL Anywhere. Eine praktische Einführung zu Rails finden Sie unter [external link] http://guides.rails.info/getting_started.html.

In der praktischen Einführung erfahren Sie, welchen Befehl Sie verwenden, um das blog-Projekt zu initialisieren. Hier ist der Befehl, um das blog-Projekt für die Verwendung mit SQL Anywhere zu initialisieren:

rails new blog -d sqlanywhere

Nach dem Erstellen der blog-Anwendung navigieren Sie zu diesem Ordner, um direkt in dieser Anwendung weiterzuarbeiten:

cd blog

Bearbeiten Sie die Datei gemfile, um eine gem-Direktive für den SQL Anywhere ActiveRecord-Adapter einzuschließen. Fügen Sie die neue Direktive nach der nachstehenden Zeile ein:

gem 'sqlanywhere'
gem 'activerecord-sqlanywhere-adapter'

Wenn Sie sich den Inhalt der Datei config\database.yml ansehen, erkennen Sie, dass sie auf Entwicklungs-, Test- und Produktionsdatenbanken verweist. Anstelle der Verwendung eines rake-Befehls zum Erstellen der Datenbanken, wie dies in der praktischen Einführung gezeigt wird, wechseln Sie in das Verzeichnis db des Projekts und erstellen Sie drei Datenbanken wie nachstehend beschrieben.

cd db
dbinit blog_development
dbinit blog_test
dbinit blog_production
cd ..

Bevor Sie fortfahren, müssen Sie den Datenbankserver und die drei Datenbanken wie nachstehend beschrieben starten.

dbsrv12 -n blog blog_development.db blog_production.db blog_test.db

Der Servername in der Befehlszeile (blog) muss zum Namen passen, der durch die Tags server: in der Datei database.yml festgelegt ist. Die Vorlagendatei sqlanywhere.yml wird konfiguriert, um sicherzustellen, dass der Servername mit dem Projektnamen in allen generierten database.yml-Dateien übereinstimmt.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.