Herstellen einer Verbindung zum DataSnap-Server (FireDAC)

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Datenbankkonnektivität (FireDAC)

In diesem Thema wird beschrieben, wie eine Verbindung zu mehrschichtigen DataSnap-Servern hergestellt wird.

Unterstützte Versionen

Der mehrschichtige FireDAC-DataSnap-Treiber unterstützt:

  • Mit RAD Studio 2007 und höher erzeugte DataSnap-Server.
  • Mit RAD Studio XE2 Enterprise und höher erzeugte DataSnap-Clients.

Client-Software

FireDAC linkt den Embarcadero DataSnap-dbExpress-Treiber statisch, daher sind keine weiteren Dateien oder DLLs erforderlich. Unterstützt wird RAD Studio XE2 Enterprise und höher.

Treibereinbindung

So binden Sie den DataSnap-Treiber ein:

Verbindungsdefinitionsparameter

Für eine Verbindung mit dem DataSnap-Server ist für die meisten Anwendungen die Angabe von DriverID, Protocol, Server, Port, User_Name und Password erforderlich (Einzelheiten finden Sie unter Definieren von Verbindungen (FireDAC)).

DriverID=DS

Parameter Beschreibung Beispielwert
Protocol

Das für die Verbindung mit dem DataSnap-Server verwendete Protokoll. Folgende Werte sind möglich:

  • TCP/IP: Verbindung über das TCP/IP-Protokoll. Dies ist das Standardprotokoll.
  • HTTP: Verbindung über das HTTP-Protokoll.
TCP/IP
Server Adresse des Servers, mit dem verbunden werden soll. 127.0.0.1
Port Der TCP/IP- oder HTTP-Port, über den der DataSnap-Server empfängt. Der Vorgabewert für TCP/IP ist 211, für HTTP - 8080. 211
User_Name Benutzername für die Authentifizierung beim DataSnap-Server.
Password Passwort für die Authentifizierung beim DataSnap-Server.
BufferKBSize Zu verwendende Puffergröße in Kilobyte für Lese- und Schreibvorgänge. Der Vorgabewert ist 32 KB. 64
Filters Client-Filter zum Speichern der Filterkonfiguration. Der Vorgabewert ist leer. Weitere Informationen unter: TDBXPropertyNames.Filters { "ZLibCompression": {} }
URLPath Nur HTTP. URL-Pfad für den HTTP-DataSnap-Dienst, wenn das HTTP-Protokoll verwendet wird. Der Vorgabewert ist leer.
DatasnapContext Nur HTTP. Pfad zum DS-HTTP-Dienst für die Zusammenstellung des URL. Die aktuelle Konvention lautet: "http://x.com/datasnap/provider/classname/method/params". Der Benutzer kann dabei das Wort "datasnap" ändern oder löschen. Der Vorgabewert ist "datasnap/".
DSProxyHost Nur HTTP. Der Host, über den Anforderungen gesendet werden können, oder ein leerer String, wenn Sie keinen Proxy verwenden. Der Vorgabewert ist leer.
DSProxyPort Nur HTTP. Der Port auf dem Proxy-Host, über den Anforderungen gesendet werden können. Wenn DSProxyHost festgelegt ist, wird dieser Wert ignoriert. Der Vorgabewert ist leer.
DSProxyUsername Nur HTTP. Benutzername für die Authentifizierung beim Proxy. Der Vorgabewert ist leer.
DSProxyPassword Nur HTTP. Passwort für die Authentifizierung beim Proxy. Der Vorgabewert ist leer.
DSAuthenticationScheme Nur HTTP. DataSnap-Authentifizierungsschema. Wird in Verbindung mit dem DataSnap-Benutzernamen und -Passwort für die Authentifizierung mit dem HTTP-Protokoll verwendet. Setzen Sie diesen Parameter auf "basic", um "User_Name"-/"Password"-Werte mit einer HTTP-Basisauthentifizierung zusätzlich zum Senden dieser Werte in dem DBX-Verbindungsstring zu senden. Mit der HTTP-Basisauthentifizierung können Anmeldeinformationen an einen Zwischenprozess-DataSnap-HTTP-Tunnelserver übergeben werden. Der Vorgabewert ist leer.
LoginTimeout Nur HTTP. Zeitüberschreitungswert bei der Verbindung. Der Wert enthält die Anzahl von Millisekunden, die der Client darauf wartet, dass die Verbindung möglich wird. Der Wert stellt die Zeitüberschreitung für die erste Serverantwortbestätigung und nicht für die gesamte Verbindungs-/Authentifizierungsphase bereit. Dieser Parameter sollte verwendet werden, um das Einfrieren der Anwendung zu verhindern, wenn die Möglichkeit besteht, dass Verbindungen zu älteren DataSnap-Server-Versionen oder zu anderen Anwendungen versucht werden, die das aktuelle Kommunikationsprotokoll nicht bestätigen. Der Vorgabewert ist 10000ms.
CommunicationTimeout Nur HTTP. Zeitüberschreitungswert in Millisekunden für eine Antwort nach Herstellen der Verbindung. Der Vorgabewert ist leer.

Anwendungsfälle

Herstellen einer Verbindung zum lokalen DataSnap-Server mit Standardeinstellungen:


DriverID=DS

Herstellen einer Verbindung zum DataSnap-Server mit dem auf einem lokalen Host ausgeführten TCP/IP-Protokoll:


DriverID=DS
Protocol=tcp/ip
Server=127.0.0.1
Port=211
User_Name=dsusr
Password=123

Siehe auch