SQLConnect (Funktion)

Sie können die Funktion SQLConnect() in einen InTouch-QuickScript verwenden, um eine Verbindung zu der vom ConnectString-Argument angegebenen Datenbank herzustellen.

Die Funktion SQLConnect() gibt einen Wert an das Argument ConnectionID zurück, die als Parameter für alle nachfolgenden SQL-Funktionen verwendet wird. Bevor Sie die Funktion SQLConnect in einem Skript verwenden können, müssen Sie eine Bindeliste definiert haben.

Kategorie

SQL

Syntax

[Ergebnis=]SQLConnect(VerbindungsID, "Verbindungszeichenfolge");

Argumente

VerbindungsID

Eine Variable vom Typ „Speicher Integer“, die die Nummer (ID) enthält, die jeder neuen Datenbankverbindung von der Funktion SQLConnect() zugewiesen wird.

Verbindungszeichenfolge

Zeichenfolge, die die Datenbank und andere zum Anmelden erforderliche Informationen in SQLConnect() angibt.

Anmerkungen

Im Projektordner muss eine Bindeliste (in der Datei SQL.DEF) gespeichert sein. Anderenfalls versagt diese Funktion den Dienst.

Wenn „SQLTrace=1“ im Abschnitt [InTouch] in der Datei win.ini definiert ist, werden bei jeder erfolgreichen Ausführung von SQLConnect Versionsinformationen für ADO, den Provider und das Datenbanksystem im Log Viewer protokolliert.

Beispiele

Mit der folgenden Anweisung stellen Sie eine Verbindung zum IBM OS/2 Datenbankmanager und zur Datenbank MUSTER her:

[ErgebnisCode=]SQLConnect(VerbindungsID,"DSN=OS2DM;
DB=MUSTER");

Die Funktion gibt einen Wert an die Variable ConnectionID zurück, die als Parameter für alle nachfolgenden SQL-Funktionen verwendet wird.

"DSN=Datenquellenname[;Attribut=Wert
[;Attribut=Wert]...]"