SQLGetConnectAttr
Gilt für:
SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)
Der ODBC-Treiber des nativen SQL Server-Clients 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 sind erst garantiert, nachdem eine Verbindung hergestellt wurde oder das Attribut mit SQLSetConnectAttr festgelegt wurde.
In diesem Thema sind die schreibgeschützten Attribute aufgeführt. Informationen zu den anderen SQL Server Native Client ODBC-treiberspezifischen 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 zum Abfragen dieser Werte verwendet werden.)
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 Service Principal Names (SPNs) in Client Connections (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Connections (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Connections (ODBC).
Weitere Informationen
SQLGetConnectAttr-Funktion
ODBC-API-Implementierungsdetails
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)