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

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

Important

SQL Server Native Client (souvent abrégé en SNAC) a été supprimé dans SQL Server 2022 (16.x) et SQL Server Management Studio 19 (SSMS). SQL Server Native Client (SQLNCLI ou SQLNCLI11) et le fournisseur Microsoft OLE DB pour SQL Server (SQLOLEDB) hérité ne sont pas recommandés dans les nouveaux développements. Utilisez à la place le nouveau Microsoft OLE DB Driver (MSOLEDBSQL) pour SQL Server ou le Microsoft ODBC Driver for SQL Server le plus récent. Pour SQLNCLI fourni en tant que composant du moteur de base de données SQL Server (versions 2012 à 2019), consultez cette exception de cycle de vie de support.

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.

Pour plus d’informations, consultez Utilisation de mots clés de chaîne de connexion avec OLE DB Driver pour SQL Server.

Notes

SQL Server Native Client autorise l’ambiguïté dans les chaînes de connexion pour maintenir la compatibilité descendante (par exemple, certains mots clés peuvent être spécifiés plusieurs fois, et les mots clés en conflit peuvent être autorisés avec une résolution basée sur la position ou la priorité). Il est recommandé de modifier des applications pour utiliser SQL Server Native Client afin d’éliminer toute dépendance vis-à-vis de l’ambiguïté des chaînes 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 les objets de données ActiveX (ADO) lors de l’utilisation de SQL Server Native Client comme fournisseur de données.

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

Les applications ODBC utilisent des chaînes de connexion comme paramètres pour les 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 ; par conséquent, les valeurs ne peuvent 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 ».
Adresse 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 sur 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); entraîne 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]

Leprotocole peut avoir la valeur tcp (TCP/IP), lpc (mémoire partagée) ou np (canaux nommés). Pour plus d’informations sur les protocoles, consultez Configurer des protocoles clients.

Si ni le protocole ni le mot clé réseau ne sont spécifiés, SQL Server Native Client utiliseront l’ordre de protocole spécifié dans 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.
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 Effets des options ISO.
APP Nom de l’application appelant SQLDriverConnect (facultatif). Si elle est spécifiée, cette valeur est stockée dans le program_name de colonnemaster.dbo.sysprocesses et est retournée par sp_who et les fonctions APP_NAME.
ApplicationIntent Déclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite. La valeur par défaut est ReadWrite. Par exemple :

ApplicationIntent=ReadOnly

Pour plus d’informations sur la prise en charge par SQL Server Native Client des groupes de disponibilité Always On, consultez SQL Server Native Client Prise en charge de la haute disponibilité, de la récupération d’urgence.
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 SQLDriverConnect DATABASE ou l’attribut de connexion SQL_COPT_CURRENT_CATALOG. Si la base de données a été précédemment attachée, SQL Server ne la rattache pas ; elle utilise la base de données jointe comme base de données 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 de SQL_C_CHAR client envoyées à une variable SQL Server char, varchar ou texte, un paramètre ou une colonne sont converties de caractère en Unicode à l’aide de la page de codes ANSI (ACP) du client, puis converties d’Unicode en caractère à l’aide de l’ACP du serveur.

SQL Server données char, varchar ou texte envoyées à un client SQL_C_CHAR variable est convertie de caractère en Unicode à l’aide de l’ACP serveur, puis convertie d’Unicode en caractère à l’aide de l’acp 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 :

* Unicode SQL_C_WCHAR données client envoyées à char, varchar ou texte sur le serveur.

* Données de serveur char, varchar ou texte envoyées à une variable SQL_C_WCHAR Unicode sur le client.

* ANSI SQL_C_CHAR données client envoyées à Unicode nchar, nvarchar ou ntext sur le serveur.

* Données de serveur Unicode nchar, nvarchar ou ntext envoyées à une variable de SQL_C_CHAR ANSI 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 traduit pas le caractère ANSI client SQL_C_CHAR données envoyées aux variables, paramètres ou colonnes char, varchar ou texte sur le serveur. Aucune traduction n’est effectuée sur les données char, varchar ou texte envoyées du serveur à SQL_C_CHAR variables sur le client.

Si le client et SQL Server utilisent des points de contrôle d’accès différents, les caractères étendus peuvent être mal interprétés.
Sauvegarde de la base de données Nom de la base de données SQL Server par défaut pour la connexion. Si La base de données n’est pas spécifiée, 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, sauf si AttachDBFileName est également spécifié. Si AttachDBFileName est également spécifié, le fichier principal vers lequel il pointe est attaché et donne le nom de base de données spécifié par Database.
Driver Nom du pilote tel que retourné par SQLDrivers. La valeur mot clé pour le pilote ODBC SQL Server Native Client est « {SQL Server Native Client 11.0} ». Le mot clé de serveur est requis si Driver est spécifié et si DriverCompletion est défini sur SQL_DRIVER_NOPROMPT.

Pour plus d’informations sur les noms de pilotes, consultez Utilisation des fichiers d’en-tête et de bibliothèque SQL Server Native Client.
DSN Nom d'une source de données utilisateur ou système ODBC existante. Cette mot clé remplace toutes les valeurs qui peuvent être spécifiées dans les mots clés Serveur, Réseau et Adresse.
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 »/« mandatory » (18.0+), « no »/« optional » (18.0+) et « strict » (18.0+). La valeur par défaut est « oui » dans la version 18.0+ et « non » dans les versions précédentes.
Secours Cette mot clé est déconseillée et son paramètre est ignoré par le pilote ODBC SQL Server Native Client.
Failover_Partner Nom du partenaire de basculement à utiliser s'il est impossible d'établir une connexion au serveur principal.
FailoverPartnerSPN Nom principal de service du partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide oblige SQL Server Native Client à utiliser le SPN généré par le pilote par défaut.
FileDSN Nom d'une source de données de fichier ODBC existante.
Langage SQL Server nom de langue (facultatif). SQL Server pouvez stocker des messages pour plusieurs langues dans sysmessages. Si vous vous connectez à un SQL Server avec plusieurs langues, Language spécifie l’ensemble de messages utilisé pour la connexion.
MARS_Connection Active ou désactive MARS (Multiple Active Result Set) sur la connexion. Les valeurs reconnues sont « yes » et « no ». La valeur par défaut est « no ».
MultiSubnetFailover Spécifiez toujours multiSubnetFailover=Oui lors de la connexion à l’écouteur de groupe de disponibilité d’un SQL Server groupe de disponibilité ou d’une instance de cluster de basculement SQL Server. multiSubnetFailover=Yes configure SQL Server Native Client pour fournir une détection et une connexion plus rapides au serveur (actuellement) actif. Les valeurs possibles sont Yes et No. La valeur par défaut est No. Par exemple :

MultiSubnetFailover=Yes

Pour plus d’informations sur la prise en charge par SQL Server Native Client pour Always On groupes de disponibilité, consultez SQL Server Native Client Prise en charge de la haute disponibilité et de la récupération d’urgence.
Net Synonyme de « Network ».
Réseau Les valeurs valides sont dbnmpntw (canaux nommés) et dbmssocn (TCP/IP).

Il s’agit d’une erreur de spécifier à la fois une valeur pour l’mot clé réseau et un préfixe de protocole sur le serveur mot clé.
PWD Mot de passe du compte de connexion SQL Server spécifié dans le paramètre UID. Le PWD n’a pas besoin d’être spécifié 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 « oui », QUOTED_IDENTIFIERS est activé pour la connexion, SQL Server utilise les règles ISO relatives à 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 suit ensuite les règles Transact-SQL héritées concernant l’utilisation de guillemets dans les instructions SQL. Pour plus d’informations, consultez Effets des options ISO.
Regional Quand « oui », le pilote ODBC SQL Server Native Client utilise les paramètres du client lors de la conversion des données de devise, de date et d’heure en données de 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.
Serveur 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=(local);

Server=(localhost);

Server=(localdb)\nom_instance;

Pour plus d’informations sur la prise en charge de LocalDB, consultez SQL Server Native Client prise en charge de LocalDB.

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]

Leprotocole peut avoir la valeur tcp (TCP/IP), lpc (mémoire partagée) ou np (canaux nommés).

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 du SQL Server instance (MSSQL$MYINST01) et le nom par défaut du canal nommé (sql/query).

Si ni un protocole ni le mot clé réseau n’est spécifié, SQL Server Native Client utilisera l’ordre de protocole spécifié dans 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 au serveur dans les chaînes de connexion ODBC lors de l’utilisation de SQL Server Native Client.
ServerSPN Nom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide oblige SQL Server Native Client à utiliser le SPN généré par le pilote par défaut.
StatsLog_On Lorsque « oui », active la capture des données de performances du pilote ODBC SQL Server Native Client. Quand « non », SQL Server Native Client données de performances du pilote ODBC ne sont pas disponibles sur la connexion.
StatsLogFile Chemin d’accès complet et nom de fichier d’un fichier utilisé pour enregistrer SQL Server Native Client statistiques de performances du pilote ODBC.
Trusted_Connection Lorsque « oui », indique au pilote ODBC SQL Server Native Client d’utiliser le mode d’authentification Windows pour la validation de la connexion. Sinon, indique au pilote ODBC SQL Server Native Client d’utiliser un nom d’utilisateur et un mot de passe SQL Server pour la validation de la connexion, et les mots clés UID et PWD doivent être spécifiés.
TrustServerCertificate Lorsqu’il est utilisé avec Chiffrer, active le chiffrement à l’aide d’un certificat de serveur auto-signé.
UID Un 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 Cette mot clé est déconseillée et son paramètre est ignoré 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 le nom d’hôtede colonne 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 monétaire, 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 du Registre des paramètres régionaux pour l’utilisateur actuel. Le pilote n’honore pas les paramètres régionaux du thread actuel si l’application les définit après la connexion, par exemple en appelant SetThreadLocale.

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 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. L’ensemble de mots clés utilisé par IDataInitialize::GetDataSource est au minimum la description des propriétés présentes dans le groupe de propriétés d’initialisation.

Lorsqu'un paramètre de chaîne du fournisseur qui a une propriété OLE DB correspondante définie à une certaine valeur par défaut ou explicitement définie avec une valeur, la valeur de la propriété OLE DB remplace le paramètre dans la chaîne du fournisseur.

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 utilisant 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.

Notes

Une chaîne de connexion passée 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, cette propriété sera appliquée comme une 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, Data Source sera défini en tant que propriété, mais Server sera placé dans une chaîne de 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é est 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 de caractères 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 ».
Adresse 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 d’adresse, plus loin dans cette rubrique.
APP SSPROP_INIT_APPNAME Chaîne identifiant l'application.
ApplicationIntent SSPROP_INIT_APPLICATIONINTENT Déclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite.

La valeur par défaut est ReadWrite. Pour plus d’informations sur la prise en charge par SQL Server Native Client des groupes de disponibilité Always On, consultez SQL Server Native Client Prise en charge de la haute disponibilité, de la récupération d’urgence.
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 valeur par défaut pour la connexion).
Traduire automatiquement 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 ».
Sauvegarde de la base de données 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 partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide SQL Server Native Client utilise le SPN par défaut généré par le fournisseur.
Langue SSPROP_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 (9.x) 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 ».
Réseau 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 4096.
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.
Serveur 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 de serveur dans cette rubrique.
ServerSPN SSPROP_INIT_SERVERSPN Nom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide oblige SQL Server Native Client à utiliser le SPN par défaut généré par le fournisseur.
Délai d'expiration 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 « oui », indique au SQL Server Native Client fournisseur OLE DB d’utiliser le mode d’authentification Windows pour la validation de la connexion. Sinon, indique au SQL Server Native Client fournisseur OLE DB d’utiliser un nom d’utilisateur et un mot de passe SQL Server pour la validation de la 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 Cette mot clé est déconseillée et son paramètre est ignoré 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 Nom de l’application utilise des guillemets simples ( ' ) ou doubles ( " ). Seules les propriétés de chaîne peuvent être mises entre guillemets. Si vous tentez de placer entre guillemets un entier ou une propriété énumérée, une erreur indiquant que la chaîne de connexion n'est pas conforme à la spécification OLE DB sera géné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 répertoriées dans le tableau suivant, 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
Nom d’application SSPROP_INIT_APPNAME Chaîne identifiant l'application.
Intention de l’application SSPROP_INIT_APPLICATIONINTENT Synonyme de « ApplicationIntent ».
ApplicationIntent SSPROP_INIT_APPLICATIONINTENT Déclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite.

La valeur par défaut est ReadWrite. Pour plus d’informations sur la prise en charge par SQL Server Native Client pour Always On groupes de disponibilité, consultez SQL Server Native Client Prise en charge de la haute disponibilité et de la récupération d’urgence.
Traduire automatiquement 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 SSPROP_INIT_CURRENTLANGUAGE Nom de la langue de SQL Server.
Source de données 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 de serveur, 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 du fournisseur et « 80 » pour les types de données SQL Server 2000 (8.x).
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 partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide oblige SQL Server Native Client à utiliser le SPN par défaut généré par le fournisseur.
Catalogue initial DBPROP_INIT_CATALOG Nom de la base de données.
Nom de fichier initial 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).
Sécurité intégrée 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. 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 d’adresse, 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 4096.
Mot de passe DBPROP_AUTH_PASSWORD Mot de passe de compte 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
Fournisseur Pour SQL Server Native Client, il doit s’agir de « SQLNCLI11 ».
Server SPN SSPROP_INIT_SERVERSPN Nom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide SQL Server Native Client utilise le SPN par défaut généré par le fournisseur.
Faire confiance au certificat de serveur 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 ».
ID d'utilisateur 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 actuel (éventuellement périmé) qui n’est pas disponible via une propriété de chaîne de fournisseur.

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
Intention de l’application SSPROP_INIT_APPLICATIONINTENT Synonyme de « ApplicationIntent ».
ApplicationIntent SSPROP_INIT_APPLICATIONINTENT Déclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite.

La valeur par défaut est ReadWrite. Pour plus d’informations sur la prise en charge par SQL Server Native Client des groupes de disponibilité Always On, consultez SQL Server Native Client Prise en charge de la haute disponibilité, de la récupération d’urgence.
Nom d’application SSPROP_INIT_APPNAME Chaîne identifiant l'application.
Traduire automatiquement 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 SSPROP_INIT_CURRENTLANGUAGE Nom de la langue de SQL Server.
Source de données 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 de serveur 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 partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide oblige SQL Server Native Client à utiliser le SPN par défaut généré par le fournisseur.
Catalogue initial DBPROP_INIT_CATALOG Nom de la base de données.
Nom de fichier initial 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).
Sécurité intégrée 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 (9.x) 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 d’adresse, 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 4096.
Mot de passe DBPROP_AUTH_PASSWORD Mot de passe de compte 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.
Fournisseur Pour SQL Server Native Client, il doit s’agir de « SQLNCLI11 ».
Server SPN SSPROP_INIT_SERVERSPN Nom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide oblige SQL Server Native Client à utiliser le SPN par défaut généré par le fournisseur.
Faire confiance au certificat de serveur 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 ».
ID d'utilisateur 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 actuel (éventuellement périmé) qui n’est pas disponible via une propriété de chaîne de fournisseur.

Voir aussi

Génération d’applications avec SQL Server Native Client