SQLGetConnectAttr

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformní systém (PDW)

Nativní klientský ODBC ovladač SQL Server definuje specifické atributy připojení pro ovladač. Některé atributy jsou dostupné pro SQLGetConnectAttr a funkce slouží k hlášení jejich aktuálních nastavení. Hodnoty hlášené pro tyto atributy nejsou zaručeny, dokud není navázáno spojení nebo atribut nastaven pomocí SQLSetConnectAttr.

Toto téma uvádí atributy pouze pro čtení. Pro informace o ostatních atributech připojení pro nativní klienty ODBC pro SQL Server viz SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Atribut SQL_COPT_SS_CONNECTION_DEAD hlásí stav spojení se serverem. Ovladač se ptá sítě na aktuální stav připojení.

Note

Standardní atribut ODBC SQL_ATTR_CONNECTION_DEAD vrací nejnovější stav spojení. To nemusí být aktuální stav připojení.

Value Description
SQL_CD_TRUE Spojení se serverem bylo ztraceno.
SQL_CD_FALSE Připojení je otevřené a dostupné pro zpracování příkazů.

SQL_COPT_SS_CLIENT_CONNECTION_ID

Atribut SQL_COPT_SS_CLIENT_CONNECTION_ID získá ID připojení klienta, které lze následně použít k nalezení:

  • Diagnostické informace v logu XEvents, když je povoleno.

  • Informace o chybách spojení v bufferu spojovacího kruhu.

  • Diagnostické informace v záznamech sledování přístupu k datům, když je povoleno.

Pro více informací viz Přístup k diagnostickým informacím v rozšířeném záznamu událostí.

Value Description
SQL_ERROR Spojení selhalo.
SQL_SUCCESS Spojení se podařilo. ID připojení klienta se nachází ve výstupním bufferu.

SQL_COPT_SS_PERF_DATA

Atribut SQL_COPT_SS_PERF_DATA vrací ukazatel na strukturu SQLPERF obsahující aktuální statistiky výkonu ovladače. SQLGetConnectAttr vrátí NULL, pokud není zapnuté logování výkonu. Statistiky ve struktuře SQLPERF nejsou dynamicky aktualizovány ovladačem. Zavolejte SQLGetConnectAttr pokaždé, když je potřeba obnovit statistiky výkonu.

Value Description
NULA Záznam výkonu není zapnutý.
Jakákoli jiná hodnota Ukazatel na strukturu SQLPERF.

SQL_COPT_SS_PERF_QUERY

Atribut SQL_COPT_SS_PERF_QUERY vrací TRUE, pokud je zapnuto logování dlouho běžících dotazů. Požadavek vrací FALSI, pokud logování dotazů není aktivní.

SQL_COPT_SS_USER_DATA

Atribut SQL_COPT_SS_USER_DATA získává ukazatel uživatelských dat. Uživatelská data jsou uložena v paměti vlastněná klientem a zaznamenávána pro každé připojení. Pokud ukazatel uživatelských dat nebyl nastaven, vrátí se SQL_UD_NOTSET, NULL ukazatel.

Value Description
SQL_UD_NOTSET Ukazatel uživatelských dat není nastaven.
Jakákoli jiná hodnota Ukazatel na uživatelská data.

SQLGetConnectAttr Podpora pro názvy principálních služeb (SPN)

SQLGetConnectAttr lze použít k dotazování hodnoty nových atributů spojení SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED a SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption lze také použít k dotazování těchto hodnot.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD je dostupný pouze pro otevřená připojení, která používají Windows autentizaci.

Pokud SQL_COPT_SS_SERVER_SPN nebo SQL_COPT_SS_FAILOVER_PARTNER nebyly nastaveny, vrátí se výchozí hodnota (prázdný řetězec).

Pro více informací o SPN viz Názvy principálů služeb (SPN) v Client Connections (ODBC).

Viz také

FUNKCE SQLGetConnectAttr
Podrobnosti implementace rozhraní ODBC API
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)