SQLGetConnectAttr

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

De SQL Server Native Client ODBC-driver definieert driver-specifieke verbindingsattributen. Sommige attributen zijn beschikbaar voor SQLGetConnectAttr, en de functie wordt gebruikt om hun huidige instellingen te rapporteren. De waarden die voor deze attributen worden gerapporteerd, zijn pas gegarandeerd nadat een verbinding is gemaakt of het attribuut is ingesteld met SQLSetConnectAttr.

Dit onderwerp vermeldt de alleen-lezen attributen. Voor informatie over de andere SQL Server Native Client ODBC-driver-specifieke verbindingsattributen, zie SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Het attribuut SQL_COPT_SS_CONNECTION_DEAD rapporteert de status van een verbinding met een server. De driver vraagt het netwerk op naar de huidige status van de verbinding.

Note

Het standaard ODBC-verbindingsattribuut SQL_ATTR_CONNECTION_DEAD geeft de meest recente status van de verbinding terug. Dit hoeft niet de huidige verbindingstoestand te zijn.

Value Description
SQL_CD_TRUE De verbinding met de server is verloren.
SQL_CD_FALSE De verbinding is open en beschikbaar voor verwerking van statements.

SQL_COPT_SS_CLIENT_CONNECTION_ID

Het attribuut SQL_COPT_SS_CLIENT_CONNECTION_ID haalt de clientverbindings-ID op, die vervolgens gebruikt kan worden om het volgende te lokaliseren:

  • Diagnostische informatie in het XEvents-logboek, wanneer ingeschakeld.

  • Verbindingsfoutinformatie in de verbindingsringbuffer.

  • Diagnostische informatie in de data access tracing-logs, wanneer ingeschakeld.

Voor meer informatie, zie Toegang tot diagnostische informatie in het Uitgebreide Gebeurtenislogboek.

Value Description
SQL_ERROR De verbinding mislukte.
SQL_SUCCESS De verbinding slaagde. De client connection ID wordt gevonden in de output buffer.

SQL_COPT_SS_PERF_DATA

Het attribuut SQL_COPT_SS_PERF_DATA geeft een pointer terug naar een SQLPERF-structuur met de huidige driverprestatiestatistieken. SQLGetConnectAttr geeft NULL terug als performance logging niet is ingeschakeld. De statistieken in de SQLPERF-structuur worden niet dynamisch bijgewerkt door de driver. Roep SQLGetConnectAttr aan telkens wanneer de prestatiestatistieken ververst moeten worden.

Value Description
NUL Prestatielogging is niet ingeschakeld.
Elke andere waarde Een verwijzing naar een SQLPERF-structuur.

SQL_COPT_SS_PERF_QUERY

Het attribuut SQL_COPT_SS_PERF_QUERY geeft TRUE terug als logging van langlopende queries is ingeschakeld. Het verzoek geeft FALSE terug als querylogging niet actief is.

SQL_COPT_SS_USER_DATA

Het attribuut SQL_COPT_SS_USER_DATA haalt de gebruikersdatapointer op. Gebruikersgegevens worden opgeslagen in het door de cliënt beheerde geheugen en per verbinding geregistreerd. Als de gebruikersdatapointer niet is ingesteld, wordt SQL_UD_NOTSET, een NULL-pointer, teruggegeven.

Value Description
SQL_UD_NOTSET Er is geen gebruikersdatapointer ingesteld.
Elke andere waarde Een verwijzing naar de gebruikersgegevens.

SQLGetConnectAttr Ondersteuning voor Service Principal Names (SPN's)

SQLGetConnectAttr kan worden gebruikt om de waarde van de nieuwe verbindingsattributen SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED en SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD op te vragen. (SQLGetConnectOption kan ook worden gebruikt om deze waarden op te vragen.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD is alleen beschikbaar voor open verbindingen die gebruikmaken van Windows Authenticatie.

Als SQL_COPT_SS_SERVER_SPN of SQL_COPT_SS_FAILOVER_PARTNER niet is ingesteld, wordt de standaardwaarde (een lege string) teruggegeven.

Voor meer informatie over SPN's, zie Service Principal Names (SPN's) in Client Connections (ODBC).

Zie ook

SQLGetConnectAttr, functie
Details van ODBC-API-implementatie
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)

  • Last updated on