Partager via


Attributs de connexion

les attributs Connecter ion sont des caractéristiques de la connexion. Par exemple, étant donné que les transactions se produisent au niveau de la connexion, le niveau d'isolation de la transaction est un attribut de connexion. De même, le délai d’attente de connexion ou le nombre de secondes à attendre lors de la tentative de connexion avant l’expiration du délai d’attente est un attribut de connexion.

les attributs Connecter ion sont définis avec SQLSet Connecter Attr et leurs paramètres actuels récupérés avec SQLGet Connecter Attr. Si SQLSet Connecter Attr est appelé avant le chargement du pilote, le Gestionnaire de pilotes stocke les attributs dans sa structure de connexion et les définit dans le pilote dans le cadre du processus de connexion. Il n’est pas nécessaire qu’une application définisse tous les attributs de connexion ; tous les attributs de connexion ont des valeurs par défaut, dont certaines sont spécifiques au pilote.

Un attribut de connexion peut être défini avant ou après la connexion, ou selon l’attribut et le pilote. Le délai d’expiration de connexion (SQL_ATTR_LOGIN_TIMEOUT) s’applique au processus de connexion et est effectif uniquement s’il est défini avant la connexion. Les attributs qui spécifient s’il faut utiliser la bibliothèque de curseurs ODBC (SQL_ATTR_ODBC_CURSORS) et la taille des paquets réseau (SQL_ATTR_PACKET_SIZE) doivent être définis avant la connexion, car la bibliothèque de curseurs ODBC réside entre le Gestionnaire de pilotes et le pilote et doit donc être chargée avant le pilote.

Les attributs à spécifier si une source de données est en lecture seule ou en lecture-écriture (SQL_ATTR_ACCESS_MODE) et si le catalogue actuel (SQL_ATTR_CURRENT_CATALOG) peut être défini avant ou après la connexion, en fonction du pilote. Toutefois, les applications interopérables les définissent avant de se connecter, car certains pilotes ne prennent pas en charge la modification de celles-ci après la connexion.

Certains attributs de connexion ont une valeur par défaut avant la connexion, tandis que d’autres ne le font pas. Ceux qui sont SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE et SQL_ATTR_TRACEFILE.

Les attributs de connexion de traduction (SQL_ATTR_TRANSLATE_DLL et SQL_ATTR_TRANSLATE_OPTION) doivent être définis après la connexion.

Tous les autres attributs de connexion peuvent être définis à tout moment. Pour plus d’informations, consultez la description de la fonction SQLSet Connecter Attr. (les attributs Connecter ion ne peuvent pas être définis au niveau de l’environnement par un appel à SQLSetEnvAttr.)