Partager via

  • Article

Utilisation de mots clés de chaîne de connexion avec SQL Server Native Client

Certaines API SQL Server Native Client utilisent des chaînes de connexion pour spécifier des attributs de connexion. Les chaînes de connexion sont des listes de mots clés et de valeurs associées ; chaque mot clé identifie un attribut de connexion particulier.

[!REMARQUE]

SQL Server Native Client autorise l'ambiguïté dans les chaînes de connexion afin de maintenir la compatibilité descendante (par exemple, certains mots clés peuvent être spécifiés plusieurs fois et des mots clés en conflit peuvent être autorisés avec la résolution en fonction de la position ou de la précédence). Les versions ultérieures de SQL Server Native Client n'autoriseront peut-être pas l'ambiguïté dans les chaînes de connexion. Lors de la modification d'applications, il est conseillé d'utiliser SQL Server Native Client pour éliminer toute dépendance vis-à-vis de l'ambiguïté de chaîne de connexion.

Les sections suivantes décrivent les mots clés qui peuvent être utilisés avec le fournisseur OLE DB SQL Server Native Client, le pilote ODBC SQL Server Native Client et ActiveX Data Objects (ADO) lors de l'utilisation de SQL Server Native Client comme fournisseur de données.

Mots clés de chaîne de connexion du fournisseur OLE DB

Il existe deux manières pour les applications OLE DB d'initialiser des objets source de données :

  • IDBInitialize::Initialize

  • IDataInitialize::GetDataSource

Dans le premier cas, une chaîne du fournisseur peut être utilisée pour initialiser des propriétés de connexion en définissant la propriété DBPROP_INIT_PROVIDERSTRING dans le jeu de propriétés DBPROPSET_DBINIT. Dans le deuxième cas, une chaîne d'initialisation peut être passée à la méthode IDataInitialize::GetDataSource pour initialiser des propriétés de connexion. Les deux méthodes initialisent les mêmes propriétés de connexion OLE DB, mais des jeux de mots clés différents sont utilisés. Le jeu de mots clés utilisé par IDataInitialize::GetDataSource est au minimum la description des propriétés dans le groupe de propriétés d'initialisation.

Les propriétés booléennes définies dans les chaînes du fournisseur via des valeurs DBPROP_INIT_PROVIDERSTRING sont définies à l'aide des valeurs « yes » et « no ». Les propriétés booléennes définies dans les chaînes d'initialisation à l'aide de IDataInitialize::GetDataSource sont définies à l'aide des valeurs « true » et « false ».

Les applications qui utilisent IDataInitialize::GetDataSource peuvent également utiliser les mots clés utilisés par IDBInitialize::Initialize mais uniquement pour les propriétés qui n'ont pas de valeur par défaut. Si une application utilise à la fois le mot clé IDataInitialize::GetDataSource et le mot clé IDBInitialize::Initialize dans la chaîne d'initialisation, le paramètre de mot clé IDataInitialize::GetDataSource est utilisé. Il est fortement recommandé que les applications n'utilisent pas de mots clés IDBInitialize::Initialize dans les chaînes de connexion IDataInitialize:GetDataSource, car ce comportement peut ne pas être conservé dans les versions ultérieures.

[!REMARQUE]

Une chaîne de connexion transmise via IDataInitialize::GetDataSource est convertie en propriétés et appliquée via IDBProperties::SetProperties. Si les services de composants ont trouvé la description de la propriété dans IDBProperties::GetPropertyInfo, la propriété sera appliquée en tant que propriété autonome. Sinon, elle sera appliquée par le biais de la propriété DBPROP_PROVIDERSTRING. Par exemple, si vous spécifiez la chaîne de connexion Data Source=server1;Server=server2, la partie Data Source sera définie en tant que propriété, mais la partie Server passera dans la chaîne du fournisseur.

Si vous spécifiez plusieurs instances de la même propriété spécifique au fournisseur, la première valeur de la première propriété sera utilisée.

Les chaînes de connexion utilisées par les applications OLE DB utilisant DBPROP_INIT_PROVIDERSTRING avec IDBInitialize::Initialize ont la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Les valeurs d'attributs peuvent éventuellement être placées entre accolades, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs d'attributs contiennent des signes non alphanumériques. Il est supposé que la première accolade fermante dans la valeur termine la valeur ; par conséquent, les valeurs ne peuvent pas contenir d'accolade fermante.

Un espace après le signe égal (=) d'un mot clé de chaîne de connexion sera interprété comme un littéral, même si la valeur est placée entre guillemets.

Le tableau suivant décrit les mots clés qui peuvent être utilisés avec DBPROP_INIT_PROVIDERSTRING.

Mot clé

Propriété d'initialisation

Description

Addr

SSPROP_INIT_NETWORKADDRESS

Synonyme de « Address ».

Address

SSPROP_INIT_NETWORKADDRESS

Adresse réseau d'une instance de SQL Server dans l'organisation.

Pour plus d'informations sur la syntaxe d'adresse valide, consultez la description du mot clé ODBC Address, plus loin dans cette rubrique.

APP

SSPROP_INIT_APPNAME

Chaîne identifiant l'application.

AttachDBFileName

SSPROP_INIT_FILENAME

Nom du fichier primaire (incluez le nom de chemin d'accès complet) d'une base de données pouvant être attachée. Pour utiliser AttachDBFileName, vous devez également spécifier le nom de la base de données avec le mot clé Database de chaîne de fournisseur. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas (il utilise la base de données attachée comme base de données par défaut pour la connexion).

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

Synonyme de « AutoTranslate ».

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

Configure la traduction de caractères OEM/ANSI. Les valeurs reconnues sont « yes » et « no ».

Database

DBPROP_INIT_CATALOG

Nom de la base de données.

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

Spécifie le mode de gestion de type de données à utiliser. Les valeurs reconnues sont « 0 » pour les types de données de fournisseur et « 80 » pour les types de données SQL Server 2000.

Encrypt

SSPROP_INIT_ENCRYPT

Spécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « yes » et « no » . La valeur par défaut est « no ».

FailoverPartner

SSPROP_INIT_FAILOVERPARTNER

Nom du serveur de basculement utilisé pour la mise en miroir de bases de données.

FailoverPartnerSPN

SSPROP_INIT_FAILOVERPARTNERSPN

Nom principal de service du serveur partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.

Language

SSPROPT_INIT_CURRENTLANGUAGE

Langue de SQL Server.

MarsConn

SSPROP_INIT_MARSCONNECTION

Active ou désactive MARS (Multiple Active Result Set) sur la connexion si le serveur est SQL Server 2005 ou version ultérieure. Les valeurs possibles sont « yes » et « no » . La valeur par défaut est « no ».

Net

SSPROP_INIT_NETWORKLIBRARY

Synonyme de « Network ».

Network

SSPROP_INIT_NETWORKLIBRARY

Bibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server dans l'organisation.

Network Library

SSPROP_INIT_NETWORKLIBRARY

Synonyme de « Network ».

PacketSize

SSPROP_INIT_PACKETSIZE

Taille de paquet réseau. La valeur par défaut est 0, ce qui signifie que le serveur configurera la taille du paquet en fonction de la valeur de sp_configure 'network packet size'.

PersistSensitive

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

Accepte les chaînes « yes » et « no » comme valeurs. Lorsque « no » est spécifié, l'objet source de données n'est pas autorisé à rendre les informations d'authentification sensibles persistantes

PWD

DBPROP_AUTH_PASSWORD

Mot de passe de compte de connexion SQL Server.

Server

DBPROP_INIT_DATASOURCE

Nom d'une instance de SQL Server dans l'organisation.

Lorsque cette valeur n'est pas spécifiée, une connexion est établie à l'instance par défaut sur l'ordinateur local.

Pour plus d'informations sur la syntaxe d'adresse valide, consultez la description du mot clé ODBC Server dans cette rubrique.

ServerSPN

SSPROP_INIT_SERVERSPN

SPN du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.

Timeout

DBPROP_INIT_TIMEOUT

Durée (en secondes) pendant laquelle attendre que l'initialisation de source de données s'achève.

Trusted_Connection

DBPROP_AUTH_INTEGRATED

Lorsque la valeur « yes » est spécifiée, fait en sorte que le fournisseur OLE DB SQL Server Native Client utilise le mode d'authentification Windows pour la validation de connexion. Autrement, fait en sorte que le fournisseur OLE DB SQL Server Native Client utilise un nom d'utilisateur et un mot de passe SQL Server pour la validation de connexion, et les mots clés UID et PWD doivent être spécifiés.

TrustServerCertificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

Accepte les chaînes « yes » et « no » comme valeurs. La valeur par défaut est « no », ce qui signifie que le certificat de serveur sera validé.

UID

DBPROP_AUTH_USERID

Nom du compte de connexion SQL Server.

UseProcForPrepare

SSPROP_INIT_USEPROCFORPREP

Ce mot clé est désapprouvé et sa valeur est ignorée par le fournisseur OLE DB SQL Server Native Client.

WSID

SSPROP_INIT_WSID

Identificateur de station de travail.

Les chaînes de connexion utilisées par les applications OLE DB utilisant IDataInitialize::GetDataSource ont la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[quote]attribute-value[quote]

attribute-value ::= character-string

attribute-keyword ::= identifier

quote ::= " | '

L'utilisation des propriétés doit être conforme à la syntaxe autorisée dans l'étendue. Par exemple, WSID utilise des accolades ({}) pour les guillemets et Application Name utilise des guillemets simples (') ou doubles ("). Seules les propriétés de chaîne peuvent être mises entre guillemets. Une erreur est générée si vous tentez de placer entre guillemets un entier ou une propriété énumérée.

Les valeurs d'attributs peuvent éventuellement être placées entre guillemets simples ou doubles, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs contiennent des caractères non alphanumériques. Le caractère de guillemet utilisé peut également apparaître dans des valeurs, à condition d'être doublé.

Un espace après le signe égal d'un mot clé de chaîne de connexion sera interprété comme un littéral, même si la valeur est placée entre guillemets.

Si une chaîne de connexion a plusieurs des propriétés suivantes, la valeur de la dernière propriété sera utilisée.

Le tableau suivant décrit les mots clés qui peuvent être utilisés avec IDataInitialize::GetDataSource :

Mot clé

Propriété d'initialisation

Description

Application Name

SSPROP_INIT_APPNAME

Chaîne identifiant l'application.

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

Synonyme de « AutoTranslate ».

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

Configure la traduction de caractères OEM/ANSI. Les valeurs reconnues sont « true » et « false ».

Connect Timeout

DBPROP_INIT_TIMEOUT

Durée (en secondes) pendant laquelle attendre que l'initialisation de source de données s'achève.

Current Language

SSPROPT_INIT_CURRENTLANGUAGE

Nom de la langue de SQL Server.

Data Source

DBPROP_INIT_DATASOURCE

Nom d'une instance de SQL Server dans l'organisation.

Lorsque cette valeur n'est pas spécifiée, une connexion est établie à l'instance par défaut sur l'ordinateur local.

Pour plus d'informations sur la syntaxe d'adresse valide, consultez la description du mot clé ODBC Server, plus loin dans cette rubrique.

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

Spécifie le mode de gestion de type de données à utiliser. Les valeurs reconnues sont « 0 » pour les types de données de fournisseur et « 80 » pour les types de données SQL Server 2000.

Failover Partner

SSPROP_INIT_FAILOVERPARTNER

Nom du serveur de basculement utilisé pour la mise en miroir de bases de données.

Failover Partner SPN

SSPROP_INIT_FAILOVERPARTNERSPN

Nom principal de service du serveur partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.

Initial Catalog

DBPROP_INIT_CATALOG

Nom de la base de données.

Initial File Name

SSPROP_INIT_FILENAME

Nom du fichier primaire (incluez le nom de chemin d'accès complet) d'une base de données pouvant être attachée. Pour utiliser AttachDBFileName, vous devez également spécifier le nom de la base de données avec le mot clé DATABASE de chaîne de fournisseur. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas (il utilise la base de données attachée comme valeur par défaut pour la connexion).

Integrated Security

DBPROP_AUTH_INTEGRATED

Accepte la valeur « SSPI » pour l'authentification Windows.

MARS Connection

SSPROP_INIT_MARSCONNECTION

Active ou désactive MARS (Multiple Active Result Set) sur la connexion si le serveur est SQL Server 2005 ou SQL Server 2008. Les valeurs reconnues sont « true » et « false ». La valeur par défaut est « false ».

Network Address

SSPROP_INIT_NETWORKADDRESS

Adresse réseau d'une instance de SQL Server dans l'organisation.

Pour plus d'informations sur la syntaxe d'adresse valide, consultez la description du mot clé ODBC Address, plus loin dans cette rubrique.

Network Library

SSPROP_INIT_NETWORKLIBRARY

Bibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server dans l'organisation.

Packet Size

SSPROP_INIT_PACKETSIZE

Taille de paquet réseau. La valeur par défaut est 0, ce qui signifie que le serveur configurera la taille du paquet en fonction de la valeur de sp_configure 'network packet size'.

Password

DBPROP_AUTH_PASSWORD

Mot de passe de connexion SQL Server.

Persist Security Info

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

Accepte les chaînes « true » et « false » comme valeurs. Lorsque « false » est spécifié, l'objet source de données n'est pas autorisé à rendre les informations d'authentification sensibles persistantes

Provider

 

Pour SQL Server Native Client, ce doit être « SQLNCLI10 ».

Server SPN

SSPROP_INIT_SERVERSPN

Nom principal de service du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.

Trust Server Certificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

Accepte les chaînes « true » et « false » comme valeurs. La valeur par défaut est « false », ce qui signifie que le certificat de serveur sera validé.

Use Encryption for Data

SSPROP_INIT_ENCRYPT

Spécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « true » et « false ». La valeur par défaut est « false ».

User ID

DBPROP_AUTH_USERID

Nom du compte de connexion SQL Server.

Workstation ID

SSPROP_INIT_WSID

Identificateur de station de travail.

Remarque   Dans la chaîne de connexion, la propriété « Ancien Mot de passe » définit SSPROP_AUTH_OLD_PASSWORD, qui correspond au mot de passe en cours (peut-être périmé) qui n'est pas disponible via une propriété de chaîne de fournisseur.

Mots clés de chaîne de connexion du pilote ODBC

Les applications ODBC utilisent des chaînes de connexion comme paramètres des fonctions SQLDriverConnect et SQLBrowseConnect.

Les chaînes de connexion utilisées par ODBC ont la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Les valeurs d'attributs peuvent éventuellement être placées entre accolades, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs d'attributs contiennent des signes non alphanumériques. Il est supposé que la première accolade fermante dans la valeur termine la valeur ; les valeurs ne peuvent par conséquent pas contenir de caractères d'accolade fermante.

Le tableau suivant décrit les mots clés qui peuvent être utilisés avec une chaîne de connexion ODBC.

Mot clé

Description

Addr

Synonyme de « Address ».

Address

Adresse réseau du serveur exécutant une instance de SQL Server. Address est généralement le nom réseau du serveur, mais il peut s'agir d'autres noms tels qu'un canal, une adresse IP ou un port TCP/IP et une adresse de socket.

Si vous spécifiez une adresse IP, assurez-vous que les protocoles TCP/IP ou de canaux nommés sont activés dans le Gestionnaire de configuration SQL Server.

La valeur de Address est prioritaire par rapport à la valeur passée à Server dans les chaînes de connexion ODBC lors de l'utilisation de SQL Server Native Client. Notez également que Address=; se connecte au serveur spécifié dans le mot clé Server, tandis que Address= ;, Address=.;, Address=localhost; et Address=(local); provoquent tous l'établissement d'une connexion au serveur local.

La syntaxe complète du mot clé Address est la suivante :

[protocol:]Address[,port |\pipe\pipename]

protocol peut être tcp (TCP/IP), lpc (mémoire partagée) ou np (canaux nommés). Pour plus d'informations sur les protocoles, consultez Choix d'un protocole réseau.

Si le mot clé protocol ou Network n'est pas spécifié, SQL Server Native Client utilise l'ordre des protocoles spécifié dans le Gestionnaire de configuration SQL Server.

port est le port auquel se connecter, sur le serveur spécifié. Par défaut, SQL Server utilise le port 1433.

Pour plus d'informations sur les protocoles, consultez Choix d'un protocole réseau.

AnsiNPW

Lorsque la valeur « yes » est spécifiée, le pilote utilise les comportements ANSI pour gérer les comparaisons NULL, le remplissage des données caractères, les avertissements et la concaténation de NULL. Lorsque la valeur « no » est spécifiée, les comportements ANSI ne sont pas exposés. Pour plus d'informations sur les comportements ANSI NPW, consultez Conséquences des options ISO.

APP

Nom de l'application qui appelle SQLDriverConnect (facultatif). Si elle est spécifiée, cette valeur est stockée dans la colonne program_name de master.dbo.sysprocesses et est retournée par sp_who et la fonction APP_NAME.

AttachDBFileName

Nom du fichier primaire d'une base de données qui peut être attachée. Incluez le chemin d'accès complet et échappez tout caractère \ lors de l'utilisation d'une variable de chaîne de caractères C :

AttachDBFileName=c:\\MyFolder\\MyDB.mdf

Cette base de données est attachée et devient la base de données par défaut de la connexion. Pour utiliser AttachDBFileName, vous devez également spécifier le nom de la base de données dans le paramètre DATABASE de SQLDriverConnect ou l'attribut de connexion SQL_COPT_CURRENT_CATALOG. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas ; il utilise la base de données attachée comme valeur par défaut pour la connexion.

AutoTranslate

Lorsque la valeur « yes » est spécifiée, les chaînes de caractères ANSI transmises entre le client et le serveur sont converties au format Unicode afin de réduire les problèmes lors de la correspondance des caractères étendus entre les pages de codes sur le client et le serveur.

Les données SQL_C_CHAR clientes envoyées à une variable, un paramètre ou une colonne SQL Server de type char, varchar ou text sont converties du format caractère au format Unicode via la page de codes ANSI cliente, puis sont converties du format Unicode au format caractère via la page de codes ANSI du serveur.

Les données SQL Server de type char, varchar ou text envoyées à une variable SQL_C_CHAR cliente sont converties du format caractère au format Unicode via la page de codes ANSI du serveur, puis sont converties du format Unicode au format caractère via la page de codes ANSI du client.

Ces conversions sont effectuées sur le client par le pilote ODBC SQL Server Native Client. Cela requiert que la page de codes ANSI utilisée sur le serveur soit disponible sur le client.

Ces paramètres n'ont aucun effet sur les conversions effectuées pour les transferts suivants :

  • Données clientes SQL_C_WCHAR Unicode envoyées aux données de type char, varchar ou text sur le serveur.

  • Données serveur char, varchar ou text envoyées à une variable Unicode SQL_C_WCHAR sur le client.

  • Données clientes SQL_C_CHAR envoyées aux données Unicode de type nchar, nvarchar ou ntext sur le serveur.

  • Données serveur Unicode nchar, nvarchar ou ntext envoyées à une variable ANSI SQL_C_CHAR sur le client.

Lorsque la valeur « no » est spécifiée, la conversion de caractère n'est pas effectuée.

Le pilote ODBC SQL Server Native Client ne convertit pas les données clientes ANSI SQL_C_CHAR envoyées aux variables, paramètres ou colonnes de type char, varchar ou text sur le serveur. Aucune conversion n'est effectuée pour les données de type char, varchar ou text envoyées du serveur aux variables SQL_C_CHAR sur le client.

Si le client et SQL Server utilisent des pages de codes ANSI différentes, les caractères étendus peuvent être mal interprétés.

Database

Nom de la base de données SQL Server par défaut utilisée pour la connexion. Si Database n'est pas spécifié, la base de données par défaut définie pour la connexion est utilisée. La base de données par défaut de la source de données ODBC remplace la base de données par défaut définie pour la connexion. La base de données doit être une base de données existante à moins que AttachDBFileName ne soit également spécifié. Si AttachDBFileName est également spécifié, le fichier primaire vers lequel il pointe est attaché et le nom de la base de données spécifié par Database lui est assigné.

Driver

Nom du pilote retourné par SQLDrivers. La valeur de mot clé pour le pilote ODBC SQL Server Native Client est « {SQL Server Native Client 10.0} ». Le mot clé Server est requis si Driver est spécifié et que DriverCompletion a la valeur SQL_DRIVER_NOPROMPT.

Pour plus d'informations sur les noms de pilotes, consultez Utilisation des fichiers bibliothèques et de l'en-tête SQL Server Native Client.

DSN

Nom d'une source de données utilisateur ou système ODBC existante. Ce mot clé remplace toutes les valeurs qui peuvent être spécifiées dans les mots clés Server, Network et Address.

Encrypt

Spécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « yes » et « no » . La valeur par défaut est « no ».

Fallback

Ce mot clé est désapprouvé et sa valeur est ignorée par le pilote ODBC SQL Server Native Client.

Failover_Partner

Nom du serveur partenaire de basculement à utiliser s'il est impossible d'établir une connexion au serveur principal.

FailoverPartnerSPN

Nom principal de service du serveur partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le pilote.

FileDSN

Nom d'une source de données de fichier ODBC existante.

Language

Nom de la langue SQL Server (facultatif). SQL Server peut stocker des messages pour plusieurs langues dans sysmessages. Lors de la connexion à un ordinateur SQL Server avec plusieurs langues, Language spécifie le jeu de messages utilisé pour la connexion.

MARS_Connection

Active ou désactive MARS (Multiple Active Result Set) sur la connexion si le serveur est SQL Server 2005 ou SQL Server 2008. Les valeurs reconnues sont « yes » et « no ». La valeur par défaut est « no ».

Net

Synonyme de « Network ».

Network

Les valeurs valides sont dbnmpntw (canaux nommés) et dbmssocn (TCP/IP).

Pour plus d'informations sur les protocoles réseau, consultez Choix d'un protocole réseau.

Le fait de spécifier à la fois une valeur pour le mot clé Network et un préfixe de protocole sur le mot clé Server constitue une erreur.

PWD

Mot de passe du compte de connexion SQL Server spécifié dans le paramètre UID. Il n'est pas nécessaire de spécifier PWD si la connexion a un mot de passe NULL ou lors de l'utilisation de l'authentification Windows (Trusted_Connection = yes).

QueryLog_On

Lorsque la valeur « yes » est spécifiée, l'enregistrement des données de requêtes longues est activé sur la connexion. Lorsque la valeur « no » est spécifiée, les données de requêtes longues ne sont pas enregistrées dans le journal.

QueryLogFile

Chemin d'accès complet et nom de fichier d'un fichier à utiliser pour l'enregistrement des données sur les requêtes longues.

QueryLogTime

Chaîne de caractères numérique spécifiant le seuil d'enregistrement (en millisecondes) des requêtes longues. Toute requête qui n'obtient pas de réponse dans les délais spécifiées est écrite dans le fichier journal de requêtes longues.

QuotedId

Lorsque la valeur « yes » est spécifiée, QUOTED_IDENTIFIERS est défini à ON pour la connexion, SQL Server utilise les règles ISO concernant l'utilisation de guillemets dans les instructions SQL. Lorsque la valeur « no » est spécifiée, QUOTED_IDENTIFIERS est défini à OFF pour la connexion. SQL Server utilise dans ce cas les règles Transact-SQL héritées concernant l'utilisation de guillemets dans les instructions SQL. Pour plus d'informations, consultez Conséquences des options ISO.

Regional

Lorsque la valeur « yes » est spécifiée, le pilote ODBC SQL Server Native Client utilise les paramètres du client pour convertir monnaie, date et heure en données caractères. La conversion est unidirectionnelle uniquement ; le pilote ne reconnaît pas les formats standard non-ODBC pour les chaînes de date ou les valeurs monétaires contenues par exemple dans un paramètre utilisé dans une instruction INSERT ou UPDATE. Lorsque la valeur « no » est spécifiée, le pilote utilise les chaînes standard ODBC pour représenter les données de monnaie, date et heure converties en données caractères.

SaveFile

Nom d'un fichier source de données ODBC dans lequel les attributs de la connexion actuelle sont enregistrés si la connexion réussit.

Server

Nom d'une instance de SQL Server. La valeur doit être le nom d'un serveur sur le réseau, une adresse IP ou le nom d'un alias du Gestionnaire de configuration SQL Server.

Le mot clé Address remplace le mot clé Server.

Vous pouvez vous connecter à l'instance par défaut sur le serveur local en spécifiant l'un des éléments suivants :

  • Server=;

  • Server=.;

  • Server=(local);

  • Server=(localhost);

Pour spécifier une instance nommée de SQL Server, ajoutez \InstanceName.

Si aucun serveur n'est spécifié, une connexion est établie à l'instance par défaut sur l'ordinateur local.

Si vous spécifiez une adresse IP, assurez-vous que les protocoles TCP/IP ou de canaux nommés sont activés dans le Gestionnaire de configuration SQL Server.

La syntaxe complète du mot clé Server est la suivante :

Server=[protocol:]Server[,port]

protocol peut être tcp (TCP/IP), lpc (mémoire partagée) ou np (canaux nommés). Pour plus d'informations sur les protocoles, consultez Choix d'un protocole réseau.

Voici un exemple de spécification d'un canal nommé :

np:\\.\pipe\MSSQL$MYINST01\sql\query

Cette ligne spécifie le protocole de canal nommé, un canal nommé sur l'ordinateur local (\\.\pipe), le nom de l'instance de SQL Server (MSSQL$MYINST01) et le nom par défaut du canal nommé (sql/query).

Si un protocol ou le mot clé Network n'est pas spécifié, SQL Server Native Client utilise l'ordre des protocoles spécifié dans le Gestionnaire de configuration SQL Server.

port est le port auquel se connecter, sur le serveur spécifié. Par défaut, SQL Server utilise le port 1433.

Les espaces sont ignorés au début de la valeur passée à Server dans les chaînes de connexion ODBC lors de l'utilisation de SQL Server Native Client.

ServerSPN

Nom principal de service du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le pilote.

StatsLog_On

Lorsque la valeur « yes » est spécifiée, active la capture de données de performances du pilote ODBC SQL Server Native Client. Lorsque la valeur « no » est spécifiée, les données de performances du pilote ODBC SQL Server Native Client ne sont pas disponibles sur la connexion.

StatsLogFile

Chemin d'accès complet et nom de fichier d'un fichier utilisé pour enregistrer les statistiques de performances du pilote ODBC SQL Server Native Client.

Trusted_Connection

Lorsque la valeur « yes » est spécifiée, fait en sorte que le pilote ODBC SQL Server Native Client utilise le mode d'authentification Windows pour la validation de connexion. Autrement, fait en sorte que le pilote ODBC SQL Server Native Client utilise un nom d'utilisateur et un mot de passe SQL Server pour la validation de connexion, et les mots clés UID et PWD doivent être spécifiés.

TrustServerCertificate

En cas d'utilisation avec Encrypt, active le chiffrement à l'aide d'un certificat de serveur auto-signé.

UID

Compte de connexion SQL Server valide. Il n'est pas nécessaire de spécifier l'UID lors de l'utilisation de l'authentification Windows.

UseProcForPrepare

Ce mot clé est désapprouvé et sa valeur est ignorée par le pilote ODBC SQL Server Native Client.

WSID

ID de station de travail. En général, il s'agit du nom réseau de l'ordinateur sur lequel l'application réside (facultatif). Si elle est spécifiée, cette valeur est stockée dans la colonne hostname de master.dbo.sysprocesses et est retournée par sp_who et la fonction HOST_NAME.

[!REMARQUE]

Les paramètres de conversion régionaux s'appliquent aux types de données monnaie, numérique, date et heure. Le paramètre de conversion est applicable uniquement à la conversion sortante et est visible uniquement lorsque des valeurs de monnaie, numériques, de date ou d'heure sont converties en chaînes de caractères.

Le pilote ODBC SQL Server Native Client utilise les paramètres régionaux du Registre pour l'utilisateur actuel. Le pilote n'honore pas les paramètres régionaux du thread actuel si l'application le définit après une connexion par un appel à SetThreadLocale, par exemple.

La modification du comportement régional d'une source de données peut provoquer l'échec de l'application. Une application qui analyse des chaînes de date et s'attend à ce qu'elles apparaissent comme défini par ODBC pourrait être affectée de manière négative par la modification de cette valeur.

Mots clés de chaîne de connexion ActiveX Data Objects (ADO)

Les applications ADO définissent la propriété ConnectionString des objets ADODBConnection ou fournissent une chaîne de connexion comme paramètre à la méthode Open des objets ADODBConnection.

Les applications ADO peuvent également utiliser les mots clés utilisés par la méthode OLE DB IDBInitialize::Initialize, mais uniquement pour les propriétés qui n'ont pas de valeur par défaut. Si une application utilise à la fois les mots clés ADO et les mots clés IDBInitialize::Initialize dans la chaîne d'initialisation, le paramètre de mot clé ADO est utilisé. Il est vivement recommandé que les applications utilisent uniquement des mots clés de chaîne de connexion ADO.

Les chaînes de connexion utilisées par ADO ont la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=["]attribute-value["]

attribute-value ::= character-string

attribute-keyword ::= identifier

Les valeurs d'attributs peuvent éventuellement être placées entre guillemets doubles, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs contiennent des caractères non alphanumériques. Les valeurs d'attributs ne peuvent pas contenir de guillemets doubles.

Le tableau suivant décrit les mots clés qui peuvent être utilisés avec une chaîne de connexion ADO :

Mot clé

Propriété d'initialisation

Description

Application Name

SSPROP_INIT_APPNAME

Chaîne identifiant l'application.

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

Synonyme de « AutoTranslate ».

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

Configure la traduction de caractères OEM/ANSI. Les valeurs reconnues sont « true » et « false ».

Connect Timeout

DBPROP_INIT_TIMEOUT

Durée (en secondes) pendant laquelle attendre que l'initialisation de source de données s'achève.

Current Language

SSPROPT_INIT_CURRENTLANGUAGE

Nom de la langue de SQL Server.

Data Source

DBPROP_INIT_DATASOURCE

Nom d'une instance de SQL Server dans l'organisation.

Lorsque cette valeur n'est pas spécifiée, une connexion est établie à l'instance par défaut sur l'ordinateur local.

Pour plus d'informations sur la syntaxe d'adresse valide, consultez la description du mot clé ODBC Server dans cette rubrique.

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

Spécifie le mode de gestion de type de données qui sera utilisé. Les valeurs reconnues sont « 0 » pour les types de données de fournisseur et « 80 » pour les types de données SQL Server 2000.

Failover Partner

SSPROP_INIT_FAILOVERPARTNER

Nom du serveur de basculement utilisé pour la mise en miroir de bases de données.

Failover Partner SPN

SSPROP_INIT_FAILOVERPARTNERSPN

Nom principal de service du serveur partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.

Initial Catalog

DBPROP_INIT_CATALOG

Nom de la base de données.

Initial File Name

SSPROP_INIT_FILENAME

Nom du fichier primaire (incluez le nom de chemin d'accès complet) d'une base de données pouvant être attachée. Pour utiliser AttachDBFileName, vous devez également spécifier le nom de la base de données avec le mot clé DATABASE de chaîne de fournisseur. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas (il utilise la base de données attachée comme valeur par défaut pour la connexion).

Integrated Security

DBPROP_AUTH_INTEGRATED

Accepte la valeur « SSPI » pour l'authentification Windows.

MARS Connection

SSPROP_INIT_MARSCONNECTION

Active ou désactive MARS (Multiple Active Result Set) sur la connexion si le serveur est SQL Server 2005 ou version ultérieure. Les valeurs reconnues sont « true » et « false ». La valeur par défaut est « false ».

Network Address

SSPROP_INIT_NETWORKADDRESS

Adresse réseau d'une instance de SQL Server dans l'organisation.

Pour plus d'informations sur la syntaxe d'adresse valide, consultez la description du mot clé ODBC Address dans cette rubrique.

Network Library

SSPROP_INIT_NETWORKLIBRARY

Bibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server dans l'organisation.

Packet Size

SSPROP_INIT_PACKETSIZE

Taille de paquet réseau. La valeur par défaut est 0, ce qui signifie que le serveur configurera la taille du paquet en fonction de la valeur de sp_configure 'network packet size'.

Password

DBPROP_AUTH_PASSWORD

Mot de passe de connexion SQL Server.

Persist Security Info

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

Accepte les chaînes « true » et « false » comme valeurs. Lorsque « false » est spécifié, l'objet source de données n'est pas autorisé à rendre les informations d'authentification sensibles persistantes.

Provider

 

Pour SQL Server Native Client, ce doit être « SQLNCLI10 ».

Server SPN

SSPROP_INIT_SERVERSPN

Nom principal de service du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.

Trust Server Certificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

Accepte les chaînes « true » et « false » comme valeurs. La valeur par défaut est « false », ce qui signifie que le certificat de serveur sera validé.

Use Encryption for Data

SSPROP_INIT_ENCRYPT

Spécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « true » et « false ». La valeur par défaut est « false ».

User ID

DBPROP_AUTH_USERID

Nom du compte de connexion SQL Server.

Workstation ID

SSPROP_INIT_WSID

Identificateur de station de travail.

Remarque   Dans la chaîne de connexion, la propriété « Ancien Mot de passe » définit SSPROP_AUTH_OLD_PASSWORD, qui correspond au mot de passe en cours (peut-être périmé) qui n'est pas disponible via une propriété de chaîne de fournisseur.

Historique des modifications

Mise à jour du contenu

Mise à jour de la description de SSPROP_INIT_PACKETSIZE.