Skip navigation links
25.1.5.2 MyODBC: Datentypen »
Section Navigation      [Toggle]

25.1.5.1. MyODBC: API-Referenz

Dieser Abschnitt fasst ODBC-Routinen nach Funktionalität zusammen.

Die vollständige Referenz zur ODBC-API finden Sie in der ODBC Programmer's Reference unter http://msdn.microsoft.com/library/en-us/odbc/htm/odbcabout_this_manual.asp.

Eine Anwendung kann die Funktion SQLGetInfo aufrufen, um Konformitätsinformationen über MyODBC einzuholen. Ob der Treiber eine bestimmte Funktion unterstützt, kann eine Anwendung mit SQLGetFunctions in Erfahrung bringen.

Hinweis: Zur Abwärtskompatibilität unterstützt der MyODBC 3.51-Treiber auch die veralteten Funktionen.

Die folgenden Tabellen zeigen die MyODBC-API-Funktionsaufrufe nach Aufgabenbereich:

Verbindung mit einer Datenquelle:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLAllocHandle Nein Ja ISO 92 Beschafft einen Handle für Umgebung, Verbindung, Anweisung oder Deskriptor.
SQLConnect Ja Ja ISO 92 Verbindet sich mit einem konkreten Treiber über Data Source Name, Benutzername und Passwort.
SQLDriverConnect Ja Ja ODBC Verbindet sich mit einem konkreten Treiber über einen Verbindungs-String oder verlangt, dass der Treiber-Manager und Treiber Verbindungsdialogfelder für den Benutzer anzeigen.
SQLAllocEnv Ja Ja Veraltet Beschafft einen vom Treiber zugewiesenen Umgebungs-Handle.
SQLAllocConnect Ja Ja Veraltet Beschafft einen Verbindungs-Handle

Informationen über einen Treiber und Datenquellen beschaffen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLDataSources Nein Nein ISO 92 Liefert eine Liste der verfügbaren Datenquellen, mit denen der Treiber-Manager umgehen kann.
SQLDrivers Nein Nein ODBC Liefert eine Liste der installierten Treiber und ihrer Attribute, mit denen der Treiber-Manager umgehen kann.
SQLGetInfo Ja Ja ISO 92 Liefert Informationen über einen spezifischen Treiber und eine Datenquelle.
SQLGetFunctions Ja Ja ISO 92 Zeigt die unterstützten Treiberfunktionen an.
SQLGetTypeInfo Ja Ja ISO 92 Gibt Informationen über die unterstützten Datentypen.

Treiberattribute einstellen und abfragen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLSetConnectAttr Nein Ja ISO 92 Setzt ein Verbindungsattribut.
SQLGetConnectAttr Nein Ja ISO 92 Gibt den Wert eines Verbindungsattributs zurück.
SQLSetConnectOption Ja Ja Veraltet Setzt eine Verbindungsoption.
SQLGetConnectOption Ja Ja Veraltet Gibt den Wert einer Verbindungsoption zurück.
SQLSetEnvAttr Nein Ja ISO 92 Setzt ein Umgebungsattribut.
SQLGetEnvAttr Nein Ja ISO 92 Gibt den Wert eines Umgebungsattributs zurück.
SQLSetStmtAttr Nein Ja ISO 92 Setzt ein Anweisungsattribut.
SQLGetStmtAttr Nein Ja ISO 92 Gibt den Wert eines Anweisungsattributs zurück.
SQLSetStmtOption Ja Ja Veraltet Setzt eine Anweisungsoption.
SQLGetStmtOption Ja Ja Veraltet Gibt den Wert einer Anweisungsoption zurück.

Vorbereitung von SQL-Requests:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLAllocStmt Ja Ja Veraltet Weist einen Anweisungs-Handle zu.
SQLPrepare Ja Ja ISO 92 Bereitet eine SQL-Anweisung zur späteren Ausführung vor.
SQLBindParameter Ja Ja ODBC Weist Speicher für einen Parameter in einer SQL-Anweisung zu.
SQLGetCursorName Ja Ja ISO 92 Gibt den mit einem Anweisungs-Handle verbundenen Cursor-Namen zurück.
SQLSetCursorName Ja Ja ISO 92 Gibt einen Cursor-Namen an.
SQLSetScrollOptions Ja Ja ODBC Setzt Optionen zur Steuerung des Cursor-Verhaltens.

Übermittlung von Requests:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLExecute Ja Ja ISO 92 Führt eine vorbereitete Anweisung aus.
SQLExecDirect Ja Ja ISO 92 Führt eine Anweisung aus.
SQLNativeSql Ja Ja ODBC Gibt den Text einer vom Treiber übersetzten SQL-Anweisung zurück.
SQLDescribeParam Ja Ja ODBC Gibt die Beschreibung eines bestimmten Parameters in einer Anweisung zurück.
SQLNumParams Ja Ja ISO 92 Gibt die Anzahl der Parameter in einer Anweisung zurück.
SQLParamData Ja Ja ISO 92 Wird in Verbindung mit SQLPutData verwendet, um Parameterdaten zur Ausführungszeit zu liefern. (Nützlich für lange Datenwerte.)
SQLPutData Ja Ja ISO 92 Sendet einen Datenwert eines Parameters ganz oder teilweise. (Nützlich für lange Datenwerte.)

Ergebnisse und Ergebnisinformationen abrufen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLRowCount Ja Ja ISO 92 Meldet, wie viele Zeilen von einem Insert, Update oder Delete betroffen wurden.
SQLNumResultCols Ja Ja ISO 92 Meldet die Anzahl der Zeilen in der Ergebnismenge.
SQLDescribeCol Ja Ja ISO 92 Beschreibt eine Spalte der Ergebnismenge.
SQLColAttribute Nein Ja ISO 92 Beschreibt Attribute einer Spalte der Ergebniszeile.
SQLColAttributes Ja Ja Veraltet Beschreibt Attribute einer Spalte der Ergebniszeile.
SQLFetch Ja Ja ISO 92 Gibt mehrere Ergebniszeilen zurück.
SQLFetchScroll Nein Ja ISO 92 Gibt scrollbare Ergebniszeilen zurück.
SQLExtendedFetch Ja Ja Veraltet Gibt scrollbare Ergebniszeilen zurück.
SQLSetPos Ja Ja ODBC Setzt einen Cursor in einen abgeholten Datenblock, sodass eine Anwendung Daten in der Zeilenmenge erneuern oder Daten in der Ergebnismenge aktualisieren oder löschen kann.
SQLBulkOperations Nein Ja ODBC Führt Einfügungen oder Bookmarking als Massenoperationen aus, darunter Updates, Deletes und Datenabruf anhand von Bookmarks.

Fehler- oder Diagnosedaten abrufen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLError Ja Ja Veraltet Gibt zusätzliche Fehler- oder Statusinformationen zurück.
SQLGetDiagField Ja Ja ISO 92 Gibt zusätzliche diagnostische Informationen zurück (ein einzelnes Feld der diagnostischen Datenstruktur).
SQLGetDiagRec Ja Ja ISO 92 Gibt zusätzliche diagnostische Informationen zurück (mehrere Felder der diagnostischen Datenstruktur).

Informationen über die Systemtabellen (Katalogfunktionen) der Datenquelle abrufen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLColumnPrivileges Ja Ja ODBC Liefert eine Liste von Spalten und zugehörigen Berechtigungen für eine oder mehr Tabellen.
SQLColumns Ja Ja X/Open Liefert eine Liste der Spaltennamen in den angegebenen Tabellen.
SQLForeignKeys Ja Ja ODBC Liefert für eine angegebene Tabelle eine Liste der Spalten, die den Fremdschlüssel bilden (sofern vorhanden).
SQLPrimaryKeys Ja Ja ODBC Liefert die Liste der Spalten, die den Primärschlüssel einer Tabelle bilden.
SQLSpecialColumns Ja Ja X/Open Liefert Informationen über die optimale Spaltenmenge zur eindeutigen Identifikation einer Zeile in einer angegebenen Tabelle oder die Spalten, die automatisch aktualisiert werden, wenn eine Transaktion einen Wert in der Zeile ändert.
SQLStatistics Ja Ja ISO 92 Liefert Statistikdaten über eine einzelne Tabelle und die Liste der mit ihr verbundenen Indizes.
SQLTablePrivileges Ja Ja ODBC Liefert eine Liste der Tabellen und zugehörigen Berechtigungen.
SQLTables Ja Ja X/Open Liefert eine Liste der Tabellennamen, die in einer bestimmten Datenstruktur gespeichert sind.

Transaktionen ausführen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLTransact Ja Ja Veraltet Schreibt eine Transaktion fest (Commit) oder rollt sie zurück (Rollback).
SQLEndTran Nein Ja ISO 92 Schreibt eine Transaktion fest (Commit) oder rollt sie zurück (Rollback).

Anweisungen abschließen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLFreeStmt Ja Ja ISO 92 Beendet die Anweisungsverarbeitung, verwirft noch anhängige Ergebnisse und gibt optional die Ressourcen frei, die mit dem Anweisungs-Handle verbunden waren.
SQLCloseCursor Ja Ja ISO 92 Schließt einen auf einem Anweisungs-Handle geöffneten Cursor.
SQLCancel Ja Ja ISO 92 Bricht eine SQL-Anweisung ab.

Verbindungen schließen:

  MyODBC    
Funktionsname 2.50 3.51 Standard Zweck
SQLDisconnect Ja Ja ISO 92 Schließt die Verbindung.
SQLFreeHandle Nein Ja ISO 92 Gibt einen Umgebungs-, Verbindungs-, Anweisungs- oder Deskriptor-Handle frei.
SQLFreeConnect Ja Ja Veraltet Gibt einen Verbindungs-Handle frei.
SQLFreeEnv Ja Ja Veraltet Gibt einen Umgebungs-Handle frei

Dies ist eine Übersetzung des MySQL-Referenzhandbuchs, das sich auf dev.mysql.com befindet. Das ursprüngliche Referenzhandbuch ist auf Englisch, und diese Übersetzung ist nicht notwendigerweise so aktuell wie die englische Ausgabe. Das vorliegende deutschsprachige Handbuch behandelt MySQL bis zur Version 5.1.