Datenbanktools-Schnittstelle (DBTools)

SQL Anywhere enthält Sybase Central und eine Gruppe von Dienstprogrammen für die Datenbankverwaltung. Diese Dienstprogramme für das Datenbankmanagement übernehmen bestimmte Aufgaben, z.B. das Sichern und Erstellen von Datenbanken, die Konvertieren von Transaktionslogs in SQL usw.

Unterstützte Plattformen

Alle Dienstprogramme für das Datenbankmanagement verwenden als Shared Library die DBTools-Bibliothek. Sie wird für Windows-Betriebssysteme und für Linux, Unix und Mac OS X bereitgestellt. Bei Windows lautet der Name dieser Bibliothek dbtool16.dll. Bei Linux und Unix lautet der Name dieser Bibliothek libdbtool16_r.so. Bei Mac OS X lautet der Name dieser Bibliothek libdbtool16_r.dylib.

Sie können Ihre eigenen Dienstprogramme für das Datenbankmanagement entwickeln oder von Datenbankmanagementfunktionen in Ihre Anwendungen integrieren, indem Sie die DBTools-Bibliothek aufrufen. In diesem Abschnitt wird die Schnittstelle zur DBTools-Bibliothek beschrieben. Vorausgesetzt wird, dass Sie wissen, wie Sie Bibliotheksroutinen aus der von Ihnen verwendeten Entwicklungsumgebung aufrufen.

Die DBTools-Bibliothek hat Funktionen oder Eintrittspunkte für jedes einzelne Dienstprogramm für das Datenbankmanagement. Außerdem müssen Funktionen vor dem Aufruf anderer DBTools-Funktionen sowie im Anschluss an die Verwendung anderer DBTools-Funktionen aufgerufen werden.

Windows Mobile

Die dbtools.h-Header-Datei

Die DBTools-Header-Datei enthält eine Liste der Eintrittspunkte zur DBTools-Bibliothek und liefert die Strukturen, mit denen Daten an die Bibliothek übergeben oder von ihr bezogen werden. Die Datei dbtools.h wird im Unterverzeichnis SDK\Include des SQL Anywhere-Installationsverzeichnisses gespeichert. In der Datei dbtools.h finden Sie die neuesten Informationen über die Eintrittspunkte und die Strukturbestandteile.

Die Header-Datei dbtools.h bezieht u.a. folgende andere Dateien ein:

sqlca.h Diese Datei ist für die Auflösung diverser Makros, nicht für SQLCA selbst, vorgesehen.
dllapi.h Diese Datei definiert Präprozessor-Makros für betriebssystem- und sprachenabhängige Makros.
dbtlvers.h Diese Datei definiert den Präprozessor-Makro DB_TOOLS_VERSION_NUMBER und andere versionsspezifische Makros.

Die sqldef.h-Header-Datei

Die dbrmt.h-Header-Datei

Die in SQL Anywhere enthaltene Header-Datei dbrmt.h beschreibt den DBRemoteSQL-Eintrittspunkt in der DBTools-Bibliothek und außerdem die Struktur, die für die Übergabe der Informationen vom und an den DBRemoteSQL-Eintrittspunkt verwendet wird. Die Datei dbrmt.h wird im Unterverzeichnis SDK\Include des SQL Anywhere-Installationsverzeichnisses gespeichert. In der Datei dbrmt.h finden Sie die neuesten Informationen über den DBRemoteSQL-Eintrittspunkt und die Strukturelemente.

DBTools-Importbibliotheken
Initialisierung und Finalisierung der DBTools-Bibliothek
DBTools-Funktionsaufrufe
Callback-Funktionen
Versionsnummern und Kompatibilität
Bitfelder
Ein Beispiel für DBTools
SQL Anywhere-Datenbanktools - C-API-Referenz
Exit-Codes der Softwarekomponenten

Kommentieren Sie diese Seite in DocCommentXchange.