SQLGetConnectAttr

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Le pilote ODBC SQL Server Native Client définit des attributs de connexion spécifiques au pilote. Certains des attributs sont accessibles à SQLGetConnectAttret la fonction est utilisée pour indiquer leurs paramètres actuels. Les valeurs indiquées pour ces attributs ne sont pas garanties tant qu'une connexion n'a pas été établie ou que l'attribut n'a pas été défini à l'aide de SQLSetConnectAttr.

Cette rubrique dresse la liste des attributs accessibles en lecture seule. Pour plus d’informations sur les autres attributs de connexion spécifiques au pilote ODBC SQL Server Native Client, consultez SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

L'attribut SQL_COPT_SS_CONNECTION_DEAD signale l'état d'une connexion à un serveur. Le pilote interroge le réseau afin de connaître l'état actuel de la connexion.

Notes

L'attribut de connexion ODBC standard SQL_ATTR_CONNECTION_DEAD retourne l'état le plus récent de la connexion. Cela peut ne pas être l'état actuel de la connexion.

Valeur Description
SQL_CD_TRUE La connexion au serveur a été perdue.
SQL_CD_FALSE La connexion est ouverte et disponible pour le traitement d'instruction.

SQL_COPT_SS_CLIENT_CONNECTION_ID

L'attribut SQL_COPT_SS_CLIENT_CONNECTION_ID récupère l'ID de connexion client, qui peut ensuite être utilisé pour localiser :

  • Les informations de diagnostic dans le journal XEvents, si cette option est activée.

  • Les informations d'erreur de connexion dans la mémoire tampon en anneau de connexion.

  • Les informations de diagnostic dans les journaux de suivi d'accès aux données, si cette option est activée.

Pour plus d’informations, consultez Accès aux informations de diagnostic dans le journal des événements étendus.

Valeur Description
SQL_ERROR La connexion a échoué.
SQL_SUCCESS La connexion a abouti. L'ID de connexion client se trouve dans le tampon de sortie.

SQL_COPT_SS_PERF_DATA

L'attribut SQL_COPT_SS_PERF_DATA retourne un pointeur vers une structure SQLPERF contenant les statistiques actuelles de performances de pilote. SQLGetConnectAttr retourne NULL si l'enregistrement de performance n'est pas activé. Les statistiques dans la structure SQLPERF ne sont pas mises à jour de manière dynamique par le pilote. Appelez SQLGetConnectAttr chaque fois que les statistiques de performances doivent être actualisées.

Valeur Description
NULL L'enregistrement des performances n'est pas activé.
Toute autre valeur Pointeur vers une structure SQLPERF.

SQL_COPT_SS_PERF_QUERY

L'attribut SQL_COPT_SS_PERF_QUERY retourne TRUE si l'enregistrement des longues requêtes est activé. La demande retourne FALSE si l'enregistrement des requêtes n'est pas actif.

SQL_COPT_SS_USER_DATA

L'attribut SQL_COPT_SS_USER_DATA extrait le pointeur de données utilisateur. Les données utilisateur sont stockées dans la mémoire détenue par le client et enregistrées par connexion. Si le pointeur de données utilisateur n'a pas été défini, SQL_UD_NOTSET, un pointeur NULL, est retourné.

Valeur Description
SQL_UD_NOTSET Aucun pointeur de données utilisateur n'est défini.
Toute autre valeur Pointeur vers les données utilisateur.

Prise en charge de SQLGetConnectAttr pour les noms de principaux du service (SPN)

SQLGetConnectAttr peut être utilisé pour interroger la valeur des nouveaux attributs de connexion SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED et SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption peut également être utilisé pour interroger ces valeurs.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD est disponible uniquement pour les connexions ouvertes qui utilisent l'authentification Windows.

Si SQL_COPT_SS_SERVER_SPN ou SQL_COPT_SS_FAILOVER_PARTNER n'a pas été défini, la valeur par défaut (une chaîne vide) est retournée.

Pour plus d’informations sur les noms de principal de service, consultez Noms de principaux de service (SPN) dans connexions clientes (ODBC).

Voir aussi

Fonction SQLGetConnectAttr
Détails de l’implémentation d’API ODBC
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)