DO - Der FoxPro-Kompatible Skriptinterpreter

sqlconnect

[1] sqlconnect(OdbcConnectionName AS String, [CanShare AS Logical?]) AS Integer
[2] sqlconnect(SqlHandle AS Integer) AS Integer

Stellt eine Verbindung zu einer ODBC-Datenquelle her.

Parameter OdbcConnectionName

Im ODBC-Treibermanager von Windows und Linux lassen sich ODBC-Datenquellen einrichten die über einen eindeutigen Namen angesprochen werden können. Der Parameter OdbcConnectionName kann nun verwendet werden diese Konfiguration anhand ihres eindeutigen Namens zu finden und eine Verbindung mit der Datenquelle herzustellen.

Parameter CanShare

Legt fest ob das neue erzeugte SqlHandle vervielfältigt werden darf.

Parameter SqlHandle

Anstatt eine Zeichenkette mit einem Datenquellennamen anzugeben, kann auch ein bereits vorhandenes SqlHandle angegeben werden, um es zu vervielfältigen. Das Vervielfältigen von Handles ist dann notwendig, wenn die gleiche Datenbankverbindung verwendet werden soll um mehrere Datenbankabfragen gleichzeitig auszuführen oder vorzubereiten.

Rückgabewert

Der Rückgabewert ist entweder ein neues SqlHandle, oder -1, falls ein Fehler aufgetreten ist. In diesem Fall kann der genaue Fehler mit aerror() abgerufen werden.

  1
  2
  3
  4

*!* Erzeugt ein neus SqlHandle zu einer ODBC-Datenquelle
LOCAL conn
conn = sqlconnect("some_odbc_datasource_name")
sqldisconnect(conn)

Beispiel mit Shared-Handles

  1
  2
  3
  4
  5
  6
  7
  8
  9
10
11
12
13
14
15
16

*!* Erzeugt ein Shared-Handle das später gesplittet werden kann,
*!* so dass sich mehrere Handles eine Verbindung zur
*!* Datenquelle teilen können.
LOCAL conn, second_handle
conn = sqlconnect("some_odbc_datasource_name", .T.)

*!* Handle splitten
second_handle = sqlconnect(conn)

*!* Nun können auf beiden Handles gleichzeitig
*!* Abfragen vorbereitet werden.
sqlprepare(conn,"select 1")
sqlprepare(second_handle,"select 2")

*!* ...

Besonderheiten bezüglich 32/64-Bit ODBC-Treibern

Bitte beachten Sie, dass die 32-Bit Version der DO-Runtime nur 32-Bit Versionen des ODBC-Treibers und die 64-Bit Version der DO-Runtime nur 64-Bit Versionen des ODBC-Treibers nutzen kann.