Verbindungsattribute

Verbindungsattribute sind Merkmale der Verbindung. Da Transaktionen beispielsweise auf Verbindungsebene auftreten, handelt es sich bei der Transaktionsisolationsstufe um ein Verbindungsattribute. Ebenso ist das Anmeldetimeout, also die Anzahl der Sekunden, die beim Versuch, eine Verbindung herzustellen, gewartet wird, bevor ein Timeout eintritt, ein Verbindungsattribut.

Verbindungsattribute werden mit SQLSetConnectAttr und ihren aktuellen Einstellungen festgelegt, die mit SQLGetConnectAttr abgerufen wurden. Wenn SQLSetConnectAttr aufgerufen wird, bevor der Treiber geladen wird, speichert der Treiber-Manager die Attribute in der Verbindungsstruktur und legt sie im Treiber als Teil des Verbindungsvorgangs fest. Es besteht keine Anforderung, dass eine Anwendung Verbindungsattribute festgelegt hat; alle Verbindungsattribute verfügen über Standardeinstellungen, von denen einige treiberspezifisch sind.

Je nach Attribut und Treiber kann ein Verbindungsattribut vor oder nach der Verbindung festgelegt werden. Das Anmeldetimeout (SQL_ATTR_LOGIN_TIMEOUT) gilt für den Verbindungsprozess und ist nur wirksam, wenn es vor dem Herstellen der Verbindung festgelegt ist. Die Attribute, die angeben, ob die ODBC-Cursorbibliothek (SQL_ATTR_ODBC_CURSORS) verwendet werden soll, und die Netzwerkpaketgröße (SQL_ATTR_PACKET_SIZE) muss vor dem Verbinden festgelegt werden, da sich die ODBC-Cursorbibliothek zwischen dem Treiber-Manager und dem Treiber befindet und daher vor dem Treiber geladen werden muss.

Die Attribute, die angegeben werden sollen, ob eine Datenquelle schreibgeschützt oder beschreibbar ist (SQL_ATTR_ACCESS_MODE), und der aktuelle Katalog (SQL_ATTR_CURRENT_CATALOG) können je nach Treiber vor oder nach dem Verbinden festgelegt werden. Interoperable Anwendungen legen sie jedoch vor dem Herstellen der Verbindung fest, da einige Treiber diese änderungen nach dem Herstellen der Verbindung nicht unterstützen.

Einige Verbindungsattribute verfügen über einen Standardwert, bevor die Verbindung hergestellt wird, während andere nicht. Dies sind SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE und SQL_ATTR_TRACEFILE.

Die Übersetzungsverbindungsattribute (SQL_ATTR_TRANSLATE_DLL und SQL_ATTR_TRANSLATE_OPTION) müssen nach dem Verbinden festgelegt werden.

Alle anderen Verbindungsattribute können jederzeit festgelegt werden. Weitere Informationen finden Sie in der Beschreibung der SQLSetConnectAttr-Funktion . (Verbindungsattribute können nicht auf Umgebungsebene durch einen Aufruf von SQLSetEnvAttr festgelegt werden.)