SQLGetConnectAttr

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Der SQL Server Native Client ODBC-Treiber definiert treiberspezifische Verbindungsattribute. Einige der Attribute sind für SQLGetConnectAttr verfügbar, und die Funktion wird verwendet, um ihre aktuellen Einstellungen zu melden. Die für diese Attribute gemeldeten Werte werden erst garantiert, nachdem eine Verbindung hergestellt oder das Attribut mithilfe von SQLSetConnectAttr festgelegt wurde.

In diesem Thema sind die schreibgeschützten Attribute aufgeführt. Informationen zu den anderen SQL Server Native Client ODBC-Treiber-spezifischen Verbindungsattributen finden Sie unter SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Das SQL_COPT_SS_CONNECTION_DEAD-Attribut meldet den Status einer Verbindung zu einem Server. Der Treiber sendet eine Abfrage an das Netzwerk bezüglich des aktuellen Status der Verbindung.

Hinweis

Das Standard-ODBC-Verbindungsattribut SQL_ATTR_CONNECTION_DEAD gibt den letzten Status der Verbindung zurück. Dabei handelt es sich nicht zwingend um den aktuellen Verbindungsstatus.

Wert BESCHREIBUNG
SQL_CD_TRUE Die Verbindung zum Server wurde unterbrochen.
SQL_CD_FALSE Die Verbindung besteht und ist für die Anweisungsverarbeitung verfügbar.

SQL_COPT_SS_CLIENT_CONNECTION_ID

Das SQL_COPT_SS_CLIENT_CONNECTION_ID-Attribut ruft die Clientverbindungs-ID ab, die dann für die Suche verwendet werden kann:

  • Diagnoseinformationen im XEvents-Protokoll, wenn aktiviert.

  • Verbindungsfehlerinformationen im Verbindungsringpuffer.

  • Diagnoseinformationen in den Datenzugriff-Ablaufverfolgungsprotokollen, wenn aktiviert.

Weitere Informationen finden Sie unter Zugreifen auf Diagnoseinformationen im Protokoll für erweiterte Ereignisse.

Wert BESCHREIBUNG
SQL_ERROR Die Verbindung konnte nicht hergestellt werden
SQL_SUCCESS Die Verbindung wurde erfolgreich hergestellt. Die Clientverbindungs-ID befindet sich im Ausgabepuffer.

SQL_COPT_SS_PERF_DATA

Das SQL_COPT_SS_PERF_DATA-Attribut gibt einen Zeiger auf eine SQLPERF-Struktur zurück, die die aktuellen statistischen Daten zur Treiberleistung enthält. SQLGetConnectAttr gibt NULL zurück, wenn die Leistungsprotokollierung nicht aktiviert ist. Die Statistik in der SQLPERF-Struktur wird nicht dynamisch vom Treiber aktualisiert. Rufen Sie SQLGetConnectAttr jedes Mal auf, wenn die Leistungsstatistiken aktualisiert werden müssen.

Wert BESCHREIBUNG
NULL Die Leistungsprotokollierung wird nicht aktiviert.
Ein beliebiger anderer Wert. Ein Zeiger auf eine SQLPERF-Struktur.

SQL_COPT_SS_PERF_QUERY

Das SQL_COPT_SS_PERF_QUERY-Attribut gibt TRUE zurück, wenn die Protokollierung von Abfragen mit langer Ausführungszeit aktiviert ist. Die Anforderung gibt FALSE zurück, wenn die Abfrageprotokollierung nicht aktiv ist.

SQL_COPT_SS_USER_DATA

Das SQL_COPT_SS_USER_DATA-Attribut ruft den Benutzerdatenzeiger ab. Benutzerdaten werden im clienteigenen Speicher gespeichert und pro Verbindung aufgezeichnet. Wenn der Benutzerdatenzeiger nicht festgelegt wurde, wird SQL_UD_NOTSET, ein NULL-Zeiger, zurückgegeben.

Wert BESCHREIBUNG
SQL_UD_NOTSET Es ist kein Benutzerdatenzeiger festgelegt.
Ein beliebiger anderer Wert. Ein Zeiger auf die Benutzerdaten.

SQLGetConnectAttr-Unterstützung für Dienstprinzipalnamen (SPNs)

SQLGetConnectAttr kann verwendet werden, um den Wert der neuen Verbindungsattribute SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED und SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD abzufragen. (SQLGetConnectOption kann auch verwendet werden, um diese Werte abzufragen.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ist nur für offene Verbindungen verfügbar, die die Windows-Authentifizierung verwenden.

Wenn SQL_COPT_SS_SERVER_SPN oder SQL_COPT_SS_FAILOVER_PARTNER nicht festgelegt wurde, wird der Standardwert (eine leere Zeichenfolge) zurückgegeben.

Weitere Informationen zu SPNs finden Sie unter Dienstprinzipalnamen (Service Principal Names, SPNs) in Clientverbindungen (ODBC).

Weitere Informationen

SQLGetConnectAttr-Funktion
ODBC API Implementation Details
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)