Datenbankverbindung

• conn := Open(source, user, password) baut eine Verbindung zur Datenquelle source mit der Benutzerkennung user und dem Paßword password auf. Wenn man diese Angaben nicht von vorneherein kennt, ruft man conn := OpenUI(connStr, connStrOut) auf und setzt den Eingabeparameter connStr vor dem Aufruf auf die leere Zeichenkette (""). Der ODBC-Treibermanager erfragt dann über Dialogboxen interaktiv die zu verwendende Datenbank, den Benutzernamen und das Paßwort. Der Ausgabeparameter connStrOut liefert alle Benutzereingaben als Zeichenkette zurück, die man bei einem erneuten Verbindungsaufbau wieder angeben kann. Der Rückgabewert der Funktionen Open und OpenUI ist ein Zeiger auf eine Verbindungsstruktur.

• ErrC(str, conn) ruft ShowError mit entsprechenden Parameterwerten auf.

• Commit(conn) und Rollback(conn) sind die Aufrufe für die Transaktionskontrolle, sofern die entsprechende Datenbank diese unterstützt. Commit macht die Operationen seit dem Verbindungsaufbau oder seit dem letzten Commit persistent, während Rollback diese ungeschehen macht.

• mapped := Map(conn, type, mapType) versucht, den gewünschten Typ type auf einen Datentyp abzubilden, der von der über conn verbundenen Datenbank unterstützt wird. Wenn mapped TRUE ist, ist das gelungen und mapType ist der entsprechende Datentyp.

• GetTypeName(conn, sqlType, typeName, createParams) liefert den Namen des Datentyps sqlType in typeName. Wenn createParams ungleich der leeren Zeichenkette ist, muß man bei der Definition des Spaltentyps einer Tabelle entsprechende Parameter angeben (z.B. NUMERIC(10, 2), CHAR(32)). createParams enthält eine durch Kommata getrennte Liste von Parametern.

• GetConnOption(conn, option, info) liefert den aktuellen Wert der die Verbindung conn betreffenden Option option. Beispiele für solche Optionen sind der Zugriffsmodus (nur lesend oder lesend und schreibend), der Timeout beim Verbindungsaufbau und die Art und Weise der Isolation mehrerer Transaktionen. Gültige Werte für option sind im Anhang zu finden. Abhängig von der Art der Option muß man ein StringField (wenn die Information als Zeichenkette zurückgeliefert wird) oder ein IntField (wenn die Information als Ganzzahl oder Bitmaske zurückgeliefert wird) zum Auslesen der Werte übergeben.

• SetConnOption(conn, option, info) setzt die Option info auf den Wert von info.

• GetInfo(conn, infoNr, info) liefert Informationen allgemeiner Art über den Treiber und die Datenbank, die mit der Verbindung conn assoziiert sind. Man kann zum Beispiel Information über den ODBC Treiber (wie die maximale Anzahl gültiger Verbindungen, den Datenquellennamen etc.), über die Datenbank selber (Name der Datenbank, des Datenbankprogrammes, Version), über die Datenquelle (Transaktionskontrolle), über Umfang der unterstützten SQL-Grammatik, die Limits von SQL, über unterstützte skalare Funktionen und über die Datentypkonversion erfragen. Gültige Werte für infoNr sind im Anhang zu finden. Abhängig von der Art der Information muß man ein StringField (wenn sie als Zeichenkette zurückgeliefert wird) oder ein IntField (wenn sie als Ganzzahl oder Bitmaske zurückgeliefert wird) zum Auslesen der Werte übergeben.

• conn := NewConnection() liefert eine initialisierte Verbindungsstruktur, die aber noch mit keiner Datenbank verbunden ist. Diese Funktion braucht man nur für spezielle Erweiterungen, bei denen man den Verbindungsaufbau selber implementieren möchte.