SQLGetConnectAttr

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Az SQL Server Native Client ODBC illezőprogramja illesztő-specifikus kapcsolati attribútumokat határoz meg. Néhány attribútum elérhető az SQLGetConnectAttr számára, és a függvény a jelenlegi beállítások jelentésére szolgál. Ezeknek az attribútumoknak az értékei csak akkor garantáltak, ha kapcsolat létrejött, vagy az attribútumot SQLSetConnectAttr segítségével beállították.

Ez a téma felsorolja az csak olvasható attribútumokat. Az SQL Server Native Client ODBC illesztő-specifikus kapcsolati attribútumokról információért lásd: SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

A SQL_COPT_SS_CONNECTION_DEAD attribútum jelzi a szerverhez való csatlakozás állapotát. Az illesztőprogram a hálózat aktuális állapotát kérdezi a kapcsolat aktuális állapotára.

Note

A szabványos ODBC kapcsolat attribútum SQL_ATTR_CONNECTION_DEAD a kapcsolat legfrissebb állapotát adja vissza. Lehet, hogy ez nem a jelenlegi kapcsolati állapot.

Value Description
SQL_CD_TRUE A szerverrel való kapcsolat megszakadt.
SQL_CD_FALSE A kapcsolat nyitott és elérhető a kivonatfeldolgozásra.

SQL_COPT_SS_CLIENT_CONNECTION_ID

A SQL_COPT_SS_CLIENT_CONNECTION_ID attribútum visszakapja a klienskapcsolati azonosítót, amely ezután a következő helyeket tárhat:

  • Diagnosztikai információk az XEvents naplójában, ha engedélyezve.

  • Kapcsolati hiba információ a csatlakozási gyűrűpufferben.

  • Diagnosztikai információk az adathozzáférési nyomkövető naplókban találhatók, ha engedélyezve.

További információért lásd: Diagnosztikai információk elérése a Kiterjesztett Eseménynaplóban.

Value Description
SQL_ERROR A kapcsolat megszakadt.
SQL_SUCCESS A kapcsolat sikerült. A klienskapcsolati azonosító a kimeneti pufferben található.

SQL_COPT_SS_PERF_DATA

A SQL_COPT_SS_PERF_DATA attribútum egy mutatót ad vissza egy SQLPERF struktúrához, amely tartalmazza az aktuális illesztőprogram teljesítmény statisztikáit. Az SQLGetConnectAttr NULL-t ad vissza, ha a teljesítménynaplózás nincs engedélyezve. Az SQLPERF struktúrában szereplő statisztikákat nem frissíti dinamikusan az illezőprogram. Minden alkalommal, amikor a teljesítménystatisztikákat frissíteni kell, hívd az SQLGetConnectAttr-t .

Value Description
NULLA A teljesítménynaplózás nincs engedélyezve.
Bármilyen más érték Egy mutató egy SQLPERF struktúrára.

SQL_COPT_SS_PERF_QUERY

A SQL_COPT_SS_PERF_QUERY attribútum TRUE-t ad, ha engedélyezve van a hosszú futó lekérdezések naplózását. A kérés HAMIS-t ad vissza, ha a lekérdezés naplózása nem aktív.

SQL_COPT_SS_USER_DATA

A SQL_COPT_SS_USER_DATA attribútum lekéri a felhasználó-adat mutatót. A felhasználói adatokat kliens-tulajdonban lévő memóriában tárolják, és minden kapcsolatot rögzítenek. Ha a felhasználó-adat mutatót nem állították be, akkor a SQL_UD_NOTSET, egy NULL mutató visszatér.

Value Description
SQL_UD_NOTSET Nincs beállítva felhasználó-adat mutató.
Bármilyen más érték Egy mutató a felhasználói adatokra.

SQLGetConnectAttr Support for Service Principal Names (SPNs)

Az SQLGetConnectAttr segítségével lekérdezhető az új kapcsolat attribútumok értékének lekérdezésére SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED és SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (Az SQLGetConnectOption is használható ezeknek az értékeknek a lekérdezésére.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD csak olyan nyílt kapcsolatok esetén érhető el, amelyek Windows hitelesítést használnak.

Ha SQL_COPT_SS_SERVER_SPN vagy SQL_COPT_SS_FAILOVER_PARTNER nem volt beállítva, akkor az alapértelmezett érték (egy üres string) jelenik meg.

További információért az SPN-ekről lásd: Szolgáltatásfő nevek (SPN-ek) a Klienskapcsolatok (ODBC) részben.