Datenbanktools-Schnittstelle (DBTools)

SQL Anywhere enthält Sybase Central und eine Gruppe von Dienstprogrammen für die Datenbankverwaltung. Diese Dienstprogramme für die Datenbankverwaltung übernehmen bestimmte Aufgaben, wie etwa das Sichern und Erstellen von Datenbanken, die Übersetzung von Transaktionslogs in SQL usw.

Unterstützte Plattformen

Alle Dienstprogramme für die Datenbankverwaltung verwenden als gemeinsame Bibliothek 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 dbtool12.dll. Bei Linux und Unix lautet der Name dieser Bibliothek libdbtool12_r.so. Bei Mac OS X lautet der Name dieser Bibliothek libdbtool12_r.dylib.

Sie können Ihre eigenen Dienstprogramme für die Datenbankverwaltung entwickeln oder Funktionen der Datenbankverwaltung in Ihre Anwendungen einbauen, 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 zur Datenbankverwaltung. 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
Initialisieren und Beenden der DBTools-Bibliothek
DBTools-Funktionen aufrufen
Callback-Funktionen
Versionsnummern und Kompatibilität
Bitfelder
Ein Beispiel für DBTools
SQL Anywhere-Datenbanktools - C-API-Referenz
Beendigungscodes der Softwarekomponenten

Kommentieren Sie diese Seite in DocCommentXchange.