Einrichten von Verbindungen (FireDAC)

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Einführung (FireDAC)


In diesem Artikel wird beschrieben, wie Sie eine FireDAC-Datenbankverbindungsdefinition definieren. FireDAC ist eine Multi-DBMS-Engine für den Datenzugriff, die Treiber für alle unterstützten DBMS enthält. In diesem Artikel wird eine Verbindungsdefinition für die Demodatenbank Microsoft SQL Server Northwind erstellt.

Einführung

In diesem Artikel werden folgende Themen behandelt:

  • Was ist eine FireDAC-Verbindungsdefinition?: Mit einer FireDAC-Verbindungsdefinition legen Sie die DBMS-Verbindungsparameter fest.
  • Verwenden des Hilfsprogramms FDExplorer: Mit dem FireDAC-Explorer erstellen Sie die Verbindungsparametergruppen, die für die systemweite Verwendung in einer zentralen Speicherdatei gespeichert werden.
  • Verwenden des TFDConnection-Entwurfszeiteditors: Mit dem TFDConnection-Entwurfszeiteditor legen Sie die Verbindungsparameter beim Entwurf fest.

Was ist eine FireDAC-Verbindungsdefinition?

Die FireDAC-Komponenten übergeben anhand von Verbindungsdefinitionen erforderliche Verbindungsparameter, wie Server, Database, User_Name, an die FireDAC-Treiberschicht (zur Laufzeit und beim Entwurf). Lesen Sie die Verbindungsdefinitionsreferenz, um alle Details über die genaue technische Definition, wie Erstellen einer Verbindungsdefinition zur Laufzeit mit Delphi-Code, kennenzulernen.

FireDAC bietet zwei grundlegende Methoden zum Festlegen der Verbindungsdefinition beim Entwurf:

  • Erstellen einer gemeinsamen und zentralen persistenten Verbindungsdefinition mit dem FDExplorer.
    • Diese Definition kann dann später der Eigenschaft TFDConnection.ConnectionDefName zugewiesen werden.
    • Für Kunden mit BDE-Kenntnissen: Der FDExplorer entspricht weitgehend dem Tool BDE-Administrator.
  • Erstellen einer temporären Verbindungsdefinition mit dem TFDConnection-Entwurfszeiteditor durch Ausfüllen der Eigenschaft TFDConnection.Params im Delphi-Entwurfszeiteditor.
    • Für Kunden mit ADO-Kenntnissen: Dieser Editor entspricht weitgehend einem Verbindungs-String-Generator.

Verwenden des Hilfsprogramms FDExplorer

Das Hilfsprogramm FDExplorer ist das Haupttool zum Verwalten der zentralisierten persistenten Verbindungsdefinitionen. Lesen Sie die FDExplorer-Referenz, um Einzelheiten über die genaue Verwendung dieses Tools zu erfahren.

Klicken Sie in der IDE auf Tools > FireDAC > Explorer, um den FDExplorer auszuführen. Drücken Sie anschließend STRG-N, um eine neue leere Verbindungsdefinition zu erstellen.

Der Parameterwert DriverID gibt den Treiber an, den Sie verwenden möchten. Nach Setzen von DriverID auf MSSQL zeigt FireDAC die treiberspezifische Parametergruppe an. Die treiberspezifischen Parameter von Microsoft SQL Server umfassen:

Parameter Beschreibung
Server Der Bezeichner für den Server von SQL Server. Wenn der Host nur einen Standardserver hat, dann enthält dieser Wert die Host-Adresse.
Database Der Name der Standarddatenbank.
OSAuthent Wenn dieser Parameter auf Yes gesetzt ist, dann verwendet FireDAC die Windows-Authentifizierung . Bei No (Vorgabe) wird die Authentifizierung von MS SQL Server verwendet.
User_Name Der Anmelde-Benutzername, wenn OSAuthent=No.
Password Das Anmeldepasswort, wenn OSAuthent=No.
MetaDefSchema Standardschemaname. Der Entwurfszeitcode schließt einen Schemanamen von einem Objektnamen aus, wenn er gleich MetaDefSchema ist.

Der nächste Screenshot zeigt die Konfiguration der Verbindungsdefinition:

MSSQLConnDefSetup.png

Drücken Sie STRG+A, um die Verbindungsdefinition in der Verbindungsdefinitionsdatei zu speichern. Zum Testen der neuen Verbindungsdefinition klicken Sie auf das "+"-Zeichen neben dem Hierarchieelement. Der Explorer zeigt daraufhin das Anmeldedialogfeld an. Nach erfolgreicher Anmeldung wird der Hierarchieknoten erweitert, und Sie können die Details der DB-Objekte anzeigen.

Hinweis: Wenn Sie mit dem FDExplorer oder FDAdministrator eine neue persistente Verbindungsdefinition hinzufügen, während die Delphi-IDE ausgeführt wird, ist die Verbindung für den FireDAC-Entwurfszeitcode nicht sichtbar. Um die Liste mit den persistenten Verbindungsdefinitionen zu aktualisieren, müssen Sie die Delphi-IDE neu starten.

Die Verbindungsdefinition kann nun in Delphi verwendet werden. Setzen Sie einfach den Wert der Eigenschaft TFDConnection.ConnectionDefName auf den Namen der neu erstellten Verbindungsdefinition.

Verwenden des TFDConnection-Entwurfszeiteditors

Der Entwurfszeiteditor der Komponente TFDConnection ist die Umgebung zum Verwalten von temporären Verbindungsparametern. Doppelklicken Sie beim Entwurf auf eine beliebige TFDConnection-Komponente. Daraufhin wird vom FireDAC-Package das Dialogfeld Connection Editor angezeigt:

ConnEditorFD.png

Der Connection Editor stellt eine ähnliche Funktionalität wie der FDExplorer bereit. Auch hier beginnen Sie mit dem Festlegen folgender Werte:

  • Driver ID – zum Neuerstellen einer Verbindungsdefinition (wie in diesem Beispiel).
  • Connection Definition Name – zum Erstellen einer temporären Verbindung, die die Parameter einer vorhandenen persistenten Verbindung überschreibt.

Sie müssen auch hier die Parameter ausfüllen, wie im vorherigen Kapitel beschrieben. Dieses Dialogfeld enthält die folgenden Funktionen:

  • Die Schaltfläche Test – zum Testen der Verbindungsdefinition.
  • Die Schaltfläche Wizard – zum Aufrufen eines DBMS-spezifischen Verbindungsdefinitions-Experten, falls verfügbar.
  • Die Schaltfläche Revert to default – zum Zurücksetzen der Parameter auf ihre Standardwerte.
  • Die Schaltfläche Help – zum Aufrufen einer Hilfeseite mit einer Beschreibung der aktuellen Treiberparameter.
  • Die Seite Info – zum Testen der Verbindung zu einem DBMS und Abrufen von Informationen über die Verbindung.
  • Die Seite SQL Script – zum Ausführen der SQL-Skriptbefehle in dieser Verbindung.

Nach Drücken der Schaltfläche OK im Editor lädt FireDAC die Verbindungsparameter in die Eigenschaft TFDConnection.Params und setzt die Eigenschaft TFDConnection.DriverName auf den ausgewählten Wert.

Aktivieren einer Verbindung

Nachdem Sie der Eigenschaft TFDConnection.ConnectionDefName einen persistenten Verbindungsdefinitionsnamen zugewiesen oder die temporären Verbindungsdefinitionsparameter in der Eigenschaft TFDConnection.Params ausgefüllt haben, setzen Sie die Eigenschaft TFDConnection.Connected auf True. Wenn die Parameter korrekt angegeben wurden, wird die Verbindung hergestellt.


Siehe auch

Beispiele