Utilisation de mots clés de chaîne de connexion avec SQL Server Native Client
S’applique à : 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Important
SQL Server Native Client (SNAC) n’est pas fourni avec :
- 2022 - SQL Server 16 (16.x) et versions ultérieures
- SQL Server Management Studio 19 et versions ultérieures
SQL Server Native Client (SQLNCLI ou SQLNCLI11) et le fournisseur Microsoft OLE DB hérité pour SQL Server (SQLOLEDB) ne sont pas recommandés pour le nouveau développement d’applications.
Pour les nouveaux projets, utilisez l'un des pilotes suivants :
Pour SQLNCLI qui est fourni en tant que composant du moteur de base de données SQL Server (versions 2012 à 2019), consultez cette exception du cycle de vie du support.
Certaines API SQL Server Native Client utilisent des chaîne 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.
Remarque
SQL Server Native Client autorise l’ambiguïté dans les chaîne de connexion s à 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 la résolution en fonction de la position ou de la priorité). Il est recommandé de modifier des applications pour utiliser SQL Server Native Client pour éliminer toute dépendance à chaîne de connexion ambiguïté.
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 en tant que fournisseur de données.
Mots clés de chaîne de connexion du pilote ODBC
Les applications ODBC utilisent des chaîne de connexion en tant que 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 d’Adresse est prioritaire sur la valeur passée au serveur dans les chaîne 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 aucun protocole ni le mot clé Réseau n’est spécifié, SQL Server Native Client utilise 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 la colonne master.dbo.sysprocesses program_name 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=ReadOnlyPour plus d’informations sur la prise en charge de SQL Server Native Client pour les groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre. |
| 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.mdfCette 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 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. Le client SQL_C_CHAR données envoyées à une variable de texte, un paramètre ou une variable de texte SQL Server, un paramètre ou une colonne est converti de caractère en Unicode à l’aide de la page de codes ANSI (ACP) cliente, puis convertie d’Unicode en caractère à l’aide de l’ACP du serveur. Les données char, varchar ou texte SQL Server envoyées à un client SQL_C_CHAR variable sont converties de caractère en Unicode à l’aide du serveur ACP, puis converties d’Unicode en caractères à 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 clientes envoyées à char, varchar ou texte sur le serveur. * données char, varchar ou serveur de texte envoyées à une variable de SQL_C_WCHAR Unicode sur le client. * ANSI SQL_C_CHAR données clientes envoyées à nchar Unicode, nvarchar ou ntext sur le serveur. * Données du serveur Unicode nchar, nvarchar ou ntext envoyées à une variable 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 en caractères, varchar ou variables de texte , paramètres ou colonnes 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 différents fournisseurs d’accès, 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 auquel il pointe est attaché et donné le nom de la base de données spécifié par la base de données. |
| Driver | Nom du pilote tel qu’il est retourné par SQLDrivers. La valeur du mot clé du pilote ODBC SQL Server Native Client est « {SQL Server Native Client 11.0} ». Le mot clé serveur est requis si Driver est spécifié et 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. Ce 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. |
| Sujet de base | Ce mot clé est déconseillé 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 entraîne l’utilisation du SPN généré par le pilote par défaut de SQL Server Native Client. |
| FileDSN | Nom d'une source de données de fichier ODBC existante. |
| Langage | Nom du langage SQL Server (facultatif). SQL Server peut stocker des messages pour plusieurs langues dans sysmessages. Si vous vous connectez à un serveur SQL Server avec plusieurs langues, la langue spécifie quel ensemble de messages sont utilisés 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 du groupe de disponibilité d’un groupe de disponibilité SQL Server ou d’une instance de cluster de basculement SQL Server. multiSubnetFailover=Oui configure SQL Server Native Client pour fournir une détection et une connexion plus rapides au serveur actif (actuellement). Les valeurs possibles sont Yes et No. La valeur par défaut est No. Par exemple :MultiSubnetFailover=YesPour plus d’informations sur la prise en charge de SQL Server Native Client pour les groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre. |
| Net | Synonyme de « Network ». |
| Réseau | Les valeurs valides sont dbnmpntw (canaux nommés) et dbmssocn (TCP/IP). Il s’agit d’une erreur pour spécifier à la fois une valeur pour le mot clé Réseau et un préfixe de protocole sur le mot clé serveur . |
| PWD | Mot de passe du compte de connexion SQL Server spécifié dans le paramètre UID. 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 | Quand « oui », QUOTED_IDENTIFIER est défini sur ON pour la connexion, SQL Server utilise les règles ISO relatives à l’utilisation de guillemets dans les instructions SQL. Quand ce n’est pas le cas, QUOTED_IDENTIFIER est désactivé 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 client lors de la conversion de données monétaires, de date et d’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. |
| 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)\ instancename ; Pour plus d’informations sur la prise en charge de LocalDB, consultez prise en charge de SQL Server Native Client pour 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\queryCette ligne spécifie le protocole de canal nommé, un canal nommé sur l’ordinateur local ( \\.\pipe), le nom de l’instance SQL Server (MSSQL$MYINST01) et le nom par défaut du canal nommé (sql/query).Si aucun protocole ni le mot clé Réseau n’est spécifié, SQL Server Native Client utilise 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îne 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 entraîne l’utilisation du SPN généré par le pilote par défaut de SQL Server Native Client. |
| StatsLog_On | Quand « oui », active la capture des données de performances du pilote ODBC SQL Server Native Client. Quand « non », les données de performances du pilote ODBC SQL Server Native Client ne sont pas disponibles sur la connexion. |
| StatsLogFile | Chemin complet et nom de fichier d’un fichier utilisé pour enregistrer les statistiques de performances du pilote ODBC SQL Server Native Client. |
| Trusted_Connection | Quand « oui », indique au pilote ODBC SQL Server Native Client d’utiliser le mode d’authentification Windows pour la validation de 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 connexion, et les mots clés UID et PWD doivent être spécifiés. |
| TrustServerCertificate | Lorsqu’il est utilisé avec Encrypt, 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 | Ce mot clé est déconseillé 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ôte de 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 de Registre des paramètres régionaux pour l’utilisateur actuel. Le pilote ne respecte pas les paramètres régionaux du thread actuel si l’application la 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 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 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 Address , 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 de SQL Server Native Client pour les groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre. |
| 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é précédemment attachée, SQL Server ne la rattache pas (elle utilise la base de données jointe 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 amène SQL Server Native Client à utiliser le SPN généré par le fournisseur par défaut. |
| Langage | 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 du 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 amène SQL Server Native Client à utiliser le SPN généré par le fournisseur par défaut. |
| 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 | Quand « oui », indique au fournisseur OLE DB SQL Server Native Client d’utiliser le mode d’authentification Windows pour la validation de connexion. Sinon, indique au fournisseur OLE DB SQL Server Native Client d’utiliser 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éconseillé 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 de SQL Server Native Client pour les groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre. |
| 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 du 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 de 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 amène SQL Server Native Client à utiliser le SPN généré par le fournisseur par défaut. |
| 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é précédemment attachée, SQL Server ne la rattache pas (elle utilise la base de données jointe 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 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 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 amène SQL Server Native Client à utiliser le SPN généré par le fournisseur par défaut. |
| 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 de SQL Server Native Client pour les groupes de disponibilité Always On, consultez prise en charge de SQL Server Native Client pour la haute disponibilité, reprise d’activité après sinistre. |
| 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 du 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 amène SQL Server Native Client à utiliser le SPN généré par le fournisseur par défaut. |
| 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é précédemment attachée, SQL Server ne la rattache pas (elle utilise la base de données jointe 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 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 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 amène SQL Server Native Client à utiliser le SPN généré par le fournisseur par défaut. |
| 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 en cours (peut-être périmé) qui n'est pas disponible via une propriété de chaîne de fournisseur.