Utilisation de mots clés de chaîne de connexion avec OLE DB Driver pour SQL Server
S’applique à :
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Certaines API dans OLE DB Driver pour SQL Server 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.
Notes
OLE DB Driver pour SQL Server 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 d’OLE DB Driver pour SQL Server n'autoriseront peut-être pas l'ambiguïté dans les chaînes de connexion. Une bonne pratique quand vous modifiez des applications est d’utiliser OLE DB Driver pour SQL Server pour ne pas dépendre 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 Driver pour SQL Server et ActiveX Data Objects (ADO) lors de l'utilisation d’OLE DB Driver pour SQL Server comme fournisseur de données.
Mots clés de chaîne de connexion OLE DB Driver
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 en utilisant des valeurs yes et no. Les propriétés booléennes définies dans les chaînes d’initialisation avec IDataInitialize::GetDataSource sont définies en utilisant des valeurs true et false.
Les applications qui utilisent IDataInitialize::GetDataSource peuvent également se servir des mots clés utilisés par IDBInitialize::Initialize, mais seulement 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é. Nous vous recommandons de ne pas utiliser de mots clés IDBInitialize::Initialize dans les chaînes de connexion IDataInitialize:GetDataSource des applications, car ce comportement peut ne pas être conservé dans les versions futures.
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.
Utilisation de IDBInitialize::Initialize
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-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Si vous le souhaitez, vous pouvez placer les valeurs des attributs entre des accolades, et ceci est d’ailleurs une bonne pratique. Cette pratique évite les problèmes quand des valeurs d’attribut ont des signes qui ne sont pas alphanumériques. Il est supposé que la première accolade fermante dans la valeur représente la fin de la valeur : les valeurs ne peuvent donc pas contenir de caractères d’accolade fermante.
Un espace après le signe = d’un mot clé d’une chaîne de connexion est 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 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 Adresse est prioritaire sur la valeur passée à Serveur dans les chaînes de connexion lors de l’utilisation d’OLE DB Driver pour SQL Server. 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 les mots clés protocole et réseau ne sont pas spécifiés, OLE DB Driver pour SQL Server utilise l’ordre des protocoles spécifié dans SQL Server Configuration Manager. port est le port auquel se connecter, sur le serveur spécifié. Par défaut, SQL Server utilise le port 1433. |
| 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.Par défaut, il s’agit de ReadWrite. Pour plus d’informations sur la prise en charge d’OLE DB Driver pour SQL Server pour les Groupes de disponibilité Always On, consultez Prise en charge par OLE DB Driver pour SQL Server de la haute disponibilité et de la récupération. |
| 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 était attachée auparavant, SQL Server ne la rattache pas (il utilise la base de données attachée comme valeur par défaut pour la connexion). |
| Authentification1 | SSPROP_AUTH_MODE | Spécifie l’authentification SQL ou Microsoft Entra utilisée. Les valeurs autorisées sont :
REMARQUE : Le mot clé ActiveDirectoryIntegrated peut également être utilisé pour l’authentification Windows à SQL Server. Il remplace les mots clés d’authentification Integrated Security (ou Trusted_Connection). Il est recommandé que les applications qui utilisent des mots clés Integrated Security (ou Trusted_Connection) ou leurs propriétés correspondantes définissent la valeur du mot clé Authentication (ou de sa propriété correspondante) sur ActiveDirectoryIntegrated pour activer le nouveau chiffrement et le comportement de validation de certificat.REMARQUE : Il est recommandé que les applications utilisant l’authentification SQL Server définissent la valeur du mot clé Authentication (ou de sa propriété correspondante) sur SqlPassword pour activer le nouveau chiffrement et le comportement de validation de certificat. |
| 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. |
| ConnectRetryCount | SSPROP_INIT_CONNECT_RETRY_COUNT | Contrôle le nombre de tentatives de reconnexion si la connexion est perdue. Les valeurs valides sont comprises entre 0 et 255. La valeur par défaut est 1. La valeur 0 n’entraîne aucune tentative de reconnexion. Pour plus d’informations, consultez Résilience des connexions inactives. |
| ConnectRetryInterval | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Spécifie le nombre de secondes entre chaque nouvelle tentative de connexion si la connexion est perdue. Les valeurs valides sont comprises entre 1 et 60. La valeur par défaut est 10. Pour plus d’informations, consultez Résilience des connexions inactives. |
| 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. |
| Chiffrer1 | 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 Optional, Mandatory et Strict. La valeur par défaut est Mandatory. Pour les versions 18.x.x, consultez Différences entre les versions principales de MSOLEDBSQL. |
| 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 force OLE DB Driver pour SQL Server à utiliser le nom principal de service par défaut, généré par le fournisseur. |
| HostNameInCertificate | SSPROP_INIT_HOST_NAME_CERTIFICATE | Nom d’hôte à utiliser pour valider le certificat SQL Server TLS/SSL. Si le mot clé HostNameInCertificate n’est pas défini, le pilote utilise la valeur de mot clé Server sur l’URL de connexion comme nom d’hôte pour valider le certificat TLS/SSL SQL Server. REMARQUE : Cette propriété est ignorée si le certificat de serveur est approuvé. Si le chiffrement est défini sur Strict, le certificat sera toujours validé. |
| 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. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Spécifiez toujours MultiSubnetFailover=Yes lors de la connexion à l’écouteur de groupe de disponibilité d’un groupe de disponibilité SQL Server ou d’une instance de cluster de basculement SQL Server. MultiSubnetFailover=Yes configure OLE DB Driver pour SQL Server pour accélérer la détection du serveur (actuellement) actif et la connexion à ce dernier. Les valeurs possibles sont Yes et No. Par défaut, il s’agit de No. Par exemple :MultiSubnetFailover=YesPour plus d’informations sur la prise en charge d’OLE DB Driver pour SQL Server pour les Groupes de disponibilité Always On, consultez Prise en charge par OLE DB Driver pour SQL Server de la haute disponibilité et de la récupération. |
| 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 du paquet Tabular Data Stream (TDS). La valeur par défaut est 0 (la valeur réelle est déterminée par le serveur). |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Accepte les chaînes yes et no comme valeurs. Quand no est utilisé, l’objet source de données n’est pas autorisé à conserver les informations d’authentification sensibles |
| PWD | DBPROP_AUTH_PASSWORD | Mot de passe de compte de connexion SQL Server. |
| Serveur | DBPROP_INIT_DATASOURCE | 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. Lorsque cette valeur n'est pas spécifiée, une connexion est établie à l'instance par défaut sur l'ordinateur local. 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’une des options suivantes : Server=; Server=.; Server=(local); Server=(local); Server=(localhost); Server=(localdb)\nom_instance; Pour plus d’informations sur la prise en charge de LocalDB, consultez Prise en charge de la base de données locale par OLE DB Driver pour SQL Server. 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). L’exemple suivant spécifie un canal nommé : np:\\.\pipe\MSSQL$MYINST01\sql\queryLa ligne ci-dessus spécifie le protocole de canal nommé ( np), un canal nommé sur la machine locale (\\.\pipe), le nom de l’instance SQL Server (MSSQL$MYINST01) et le nom par défaut du canal nommé (sql/query).Si les mots clés protocole et réseau ne sont pas spécifiés, OLE DB Driver pour SQL Server utilise l’ordre des protocoles spécifié dans SQL Server Configuration Manager. 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 serveur lors de l'utilisation d’OLE DB Driver pour SQL Server. |
| ServerCertificate | SSPROP_INIT_SERVER_CERTIFICATE | Spécifie le chemin vers un fichier de certificat à comparer avec le certificat TLS/SSL SQL Server. Cette option peut être utilisée uniquement quand le chiffrement Strict est activé. Les formats de certificat acceptés sont PEM, DER et CER. S’il est spécifié, le certificat SQL Server est vérifié en contrôlant si le certificat fourni est une correspondance exacte. |
| 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 force OLE DB Driver pour SQL Server à utiliser le nom principal de service 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. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Affecte la séquence de connexion quand la première IP résolue du nom d’hôte ne répond pas et qu’il existe plusieurs IP associées au nom d’hôte. TNIR interagit avec MultiSubnetFailover pour fournir plusieurs séquences de connexion. Les valeurs possibles sont Yes et No. La valeur par défaut est Yes. Pour plus d’informations, consultez Utilisation de la résolution d’adresses IP réseau transparente. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Quand la valeur est yes, cette option indique à OLE DB Driver pour SQL Server d’utiliser l’authentification Windows pour la validation de la connexion. Sinon, OLE DB Driver pour SQL Server utilise 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. |
| TrustServerCertificate1 | 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. |
| UseFMTONLY | SSPROP_INIT_USEFMTONLY | Contrôle la façon dont les métadonnées sont récupérées pendant la connexion à SQL Server 2012 (11.x) et les versions ultérieures. Les valeurs possibles sont yes et no. La valeur par défaut est no.Par défaut, OLE DB Driver pour SQL Server utilise les procédures stockées sp_describe_first_result_set et sp_describe_undeclared_parameters pour récupérer les métadonnées. Ces procédures stockées ont quelques limitations (par exemple, elles échouent sur les tables temporaires). La définition de UseFMTONLY sur yes indique au pilote d’utiliser à la place SET FMTONLY pour la récupération des métadonnées. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Ce mot clé est déconseillé et sa valeur est ignorée par le fournisseur OLE DB Driver pour SQL Server. |
| WSID | SSPROP_INIT_WSID | Identificateur de station de travail. |
[1] : Pour améliorer la sécurité, le chiffrement et le comportement de validation des certificats changent quand vous utilisez les propriétés d’initialisation de jeton d’authentification ou d’accès, ou les mots clés de chaîne de connexion correspondants. Pour plus d’informations, consultez Chiffrement et validation des certificats.
Utilisation de IDataInitialize::GetDataSource
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-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
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. Une erreur Connection String doesn't conform to OLE DB specification est générée si vous tentez de placer entre guillemets un entier ou une propriété énumérée.
Les valeurs d’attribut peuvent éventuellement être placées entre guillemets simples ou doubles, ce qui est recommandé. Cette pratique évite tout problème quand des valeurs ont des caractères qui ne sont pas alphanumériques. Le caractère entre guillemets utilisé peut également apparaître dans des valeurs si les guillemets sont doubles.
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 |
|---|---|---|
| Jeton d'accès1 | SSPROP_AUTH_ACCESS_TOKEN | Jeton d’accès utilisé pour s’authentifier auprès de Microsoft Entra ID. REMARQUE : Il est erroné de spécifier ce mot clé ainsi que les mots clés de chaîne de connexion UID, PWD, Trusted_Connection ou Authentication ou leurs propriétés/mots clés correspondants. |
| Nom d’application | SSPROP_INIT_APPNAME | Chaîne identifiant l'application. |
| Intention de l’application | 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.Par défaut, il s’agit de ReadWrite. Pour plus d’informations sur la prise en charge d’OLE DB Driver pour SQL Server pour les Groupes de disponibilité Always On, consultez Prise en charge par OLE DB Driver pour SQL Server de la haute disponibilité et de la récupération. |
| Authentification1 | SSPROP_AUTH_MODE | Spécifie l’authentification SQL ou Microsoft Entra utilisée. Les valeurs autorisées sont :
REMARQUE : Le mot clé ActiveDirectoryIntegrated peut également être utilisé pour l’authentification Windows à SQL Server. Il remplace les mots clés d’authentification Integrated Security (ou Trusted_Connection). Il est recommandé que les applications qui utilisent des mots clés Integrated Security (ou Trusted_Connection) ou leurs propriétés correspondantes définissent la valeur du mot clé Authentication (ou de sa propriété correspondante) sur ActiveDirectoryIntegrated pour activer le nouveau chiffrement et le comportement de validation de certificat.REMARQUE : Il est recommandé que les applications utilisant l’authentification SQL Server définissent la valeur du mot clé Authentication (ou de sa propriété correspondante) sur SqlPassword pour activer le nouveau chiffrement et le comportement de validation de certificat. |
| Traduire automatiquement | 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. |
| Nombre de nouvelles tentatives de connexion | SSPROP_INIT_CONNECT_RETRY_COUNT | Contrôle le nombre de tentatives de reconnexion si la connexion est perdue. Les valeurs valides sont comprises entre 0 et 255. La valeur par défaut est 1. La valeur 0 n’entraîne aucune tentative de reconnexion. Pour plus d’informations, consultez Résilience des connexions inactives. |
| Intervalle avant nouvelle tentative de connexion | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Spécifie le nombre de secondes entre chaque nouvelle tentative de connexion si la connexion est perdue. Les valeurs valides sont comprises entre 1 et 60. La valeur par défaut est 10. Pour plus d’informations, consultez Résilience des connexions inactives. |
| Current Language | SSPROPT_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é Server dans cet article. |
| 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 force OLE DB Driver pour SQL Server à utiliser le nom principal de service par défaut, généré par le fournisseur. |
| Nom d’hôte dans le certificat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Nom d’hôte à utiliser pour valider le certificat SQL Server TLS/SSL. Si le mot clé Host Name In Certificate n’est pas défini, le pilote utilise la valeur de mot clé Data Source sur l’URL de connexion comme nom d’hôte pour valider le certificat TLS/SSL SQL Server. REMARQUE : Cette propriété est ignorée si le certificat de serveur est approuvé. Si l’utilisation du chiffrement pour les données est définie sur Strict, le certificat sera toujours validé. |
| 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 était attachée auparavant, 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. Par défaut, il s’agit de false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Spécifiez toujours MultiSubnetFailover=True lors de la connexion à l’écouteur de groupe de disponibilité d’un groupe de disponibilité SQL Server ou d’une instance de cluster de basculement SQL Server. MultiSubnetFailover=True configure OLE DB Driver pour SQL Server pour accélérer la détection du serveur (actuellement) actif et la connexion à ce dernier. Les valeurs possibles sont True et False. Par défaut, il s’agit de False. Par exemple :MultiSubnetFailover=TruePour plus d’informations sur la prise en charge d’OLE DB Driver pour SQL Server pour les Groupes de disponibilité Always On, consultez Prise en charge par OLE DB Driver pour SQL Server de la haute disponibilité et de la récupération. |
| 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é Address dans cet article. |
| 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 du paquet Tabular Data Stream (TDS). La valeur par défaut est 0 (la valeur réelle est déterminée par le serveur). |
| 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. Quand la valeur est false, l’objet de source de données n’est pas autorisé à conserver les informations d’authentification sensibles |
| Fournisseur | Pour OLE DB Driver pour SQL Server, cette valeur doit être « MSOLEDBSQL19 » ou « MSOLEDBSQL ». | |
| Certificat de serveur | SSPROP_INIT_SERVER_CERTIFICATE | Spécifie le chemin vers un fichier de certificat à comparer avec le certificat TLS/SSL SQL Server. Cette option peut être utilisée uniquement quand le chiffrement Strict est activé. Les formats de certificat acceptés sont PEM, DER et CER. S’il est spécifié, le certificat SQL Server est vérifié en contrôlant si le certificat fourni est une correspondance exacte. |
| 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 force OLE DB Driver pour SQL Server à utiliser le nom principal de service par défaut, généré par le fournisseur. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Affecte la séquence de connexion quand la première IP résolue du nom d’hôte ne répond pas et qu’il existe plusieurs IP associées au nom d’hôte. TNIR interagit avec MultiSubnetFailover pour fournir plusieurs séquences de connexion. Les valeurs possibles sont True et False. La valeur par défaut est True. Pour plus d’informations, consultez Utilisation de la résolution d’adresses IP réseau transparente. |
| Faire confiance au certificat de serveur1 | 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é. |
| Utiliser le chiffrement pour les données1 | 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 Optional, Mandatory et Strict. La valeur par défaut est Mandatory. Pour les versions 18.x.x, consultez Différences entre les versions principales de MSOLEDBSQL. |
| Use FMTONLY | SSPROP_INIT_USEFMTONLY | Contrôle la façon dont les métadonnées sont récupérées pendant la connexion à SQL Server 2012 (11.x) et les versions ultérieures. Les valeurs possibles sont true et false. La valeur par défaut est false.Par défaut, OLE DB Driver pour SQL Server utilise les procédures stockées sp_describe_first_result_set et sp_describe_undeclared_parameters pour récupérer les métadonnées. Ces procédures stockées ont quelques limitations (par exemple, elles échouent sur les tables temporaires). La définition de Use FMTONLY sur true indique au pilote d’utiliser à la place SET FMTONLY pour la récupération des métadonnées. |
| ID d'utilisateur | DBPROP_AUTH_USERID | Nom du compte de connexion SQL Server. |
| Workstation ID | SSPROP_INIT_WSID | Identificateur de station de travail. |
[1] : Pour améliorer la sécurité, le chiffrement et le comportement de validation de certificat sont modifiés lorsque vous utilisez les propriétés d’initialisation de jeton d’authentification/d’accès ou les mots clés de chaîne de connexion correspondants. Pour plus d’informations, consultez Chiffrement et validation de certificat.
Notes
Dans la chaîne de connexion, la propriété Old Password définit SSPROP_AUTH_OLD_PASSWORD, qui correspond au mot de passe actuel (éventuellement expiré) non 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 se servir des 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é. Nous vous recommandons d’utiliser uniquement des mots clés de chaîne de connexion ADO dans les applications.
Les chaînes de connexion utilisées par ADO ont la syntaxe suivante :
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Les valeurs d’attribut peuvent éventuellement être placées entre guillemets doubles, ce qui est recommandé. Cette pratique évite tout problème quand des valeurs ont des caractères qui ne sont pas alphanumériques. Les valeurs d’attribut 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 |
|---|---|---|
| Jeton d'accès1 | SSPROP_AUTH_ACCESS_TOKEN | Jeton d’accès utilisé pour s’authentifier auprès de Microsoft Entra ID. REMARQUE : Il est erroné de spécifier ce mot clé ainsi que les mots clés de chaîne de connexion UID, PWD, Trusted_Connection ou Authentication ou leurs propriétés/mots clés correspondants. |
| Intention de l’application | 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.Par défaut, il s’agit de ReadWrite. Pour plus d’informations sur la prise en charge d’OLE DB Driver pour SQL Server pour les Groupes de disponibilité Always On, consultez Prise en charge par OLE DB Driver pour SQL Server de la haute disponibilité et de la récupération. |
| Nom d’application | SSPROP_INIT_APPNAME | Chaîne identifiant l'application. |
| Authentification1 | SSPROP_AUTH_MODE | Spécifie l’authentification SQL ou Microsoft Entra utilisée. Les valeurs autorisées sont :
REMARQUE : Le mot clé ActiveDirectoryIntegrated peut également être utilisé pour l’authentification Windows à SQL Server. Il remplace les mots clés d’authentification Integrated Security (ou Trusted_Connection). Il est recommandé que les applications qui utilisent des mots clés Integrated Security (ou Trusted_Connection) ou leurs propriétés correspondantes définissent la valeur du mot clé Authentication (ou de sa propriété correspondante) sur ActiveDirectoryIntegrated pour activer le nouveau chiffrement et le comportement de validation de certificat.REMARQUE : Il est recommandé que les applications utilisant l’authentification SQL Server définissent la valeur du mot clé Authentication (ou de sa propriété correspondante) sur SqlPassword pour activer le nouveau chiffrement et le comportement de validation de certificat. |
| Traduire automatiquement | 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. |
| Nombre de nouvelles tentatives de connexion | SSPROP_INIT_CONNECT_RETRY_COUNT | Contrôle le nombre de tentatives de reconnexion si la connexion est perdue. Les valeurs valides sont comprises entre 0 et 255. La valeur par défaut est 1. La valeur 0 n’entraîne aucune tentative de reconnexion. Pour plus d’informations, consultez Résilience des connexions inactives. |
| Intervalle avant nouvelle tentative de connexion | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Spécifie le nombre de secondes entre chaque nouvelle tentative de connexion si la connexion est perdue. Les valeurs valides sont comprises entre 1 et 60. La valeur par défaut est 10. Pour plus d’informations, consultez Résilience des connexions inactives. |
| Current Language | SSPROPT_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é Server dans cet article. |
| 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 force OLE DB Driver pour SQL Server à utiliser le nom principal de service par défaut, généré par le fournisseur. |
| Nom d’hôte dans le certificat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Nom d’hôte à utiliser pour valider le certificat SQL Server TLS/SSL. Si le mot clé Host Name In Certificate n’est pas défini, le pilote utilise la valeur de mot clé Data Source sur l’URL de connexion comme nom d’hôte pour valider le certificat TLS/SSL SQL Server. REMARQUE : Cette propriété est ignorée si le certificat de serveur est approuvé. Si l’utilisation du chiffrement pour les données est définie sur Strict, le certificat sera toujours validé. |
| 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 était attachée auparavant, 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. Par défaut, il s’agit de false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Spécifiez toujours MultiSubnetFailover=True lors de la connexion à l’écouteur de groupe de disponibilité d’un groupe de disponibilité SQL Server ou d’une instance de cluster de basculement SQL Server. MultiSubnetFailover=True configure OLE DB Driver pour SQL Server pour accélérer la détection du serveur (actuellement) actif et la connexion à ce dernier. Les valeurs possibles sont True et False. Par défaut, il s’agit de False. Par exemple :MultiSubnetFailover=TruePour plus d’informations sur la prise en charge d’OLE DB Driver pour SQL Server pour les Groupes de disponibilité Always On, consultez Prise en charge par OLE DB Driver pour SQL Server de la haute disponibilité et de la récupération. |
| 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é Address dans cet article. |
| 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 du paquet Tabular Data Stream (TDS). La valeur par défaut est 0 (la valeur réelle est déterminée par le serveur). |
| 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. Quand la valeur est false, l’objet de source de données n’est pas autorisé à conserver les informations d’authentification sensibles. |
| Fournisseur | Pour OLE DB Driver pour SQL Server, la valeur est MSOLEDBSQL19 ou MSOLEDBSQL. |
|
| Certificat de serveur | SSPROP_INIT_SERVER_CERTIFICATE | Spécifie le chemin vers un fichier de certificat à comparer avec le certificat TLS/SSL SQL Server. Cette option peut être utilisée uniquement quand le chiffrement Strict est activé. Les formats de certificat acceptés sont PEM, DER et CER. S’il est spécifié, le certificat SQL Server est vérifié en contrôlant si le certificat fourni est une correspondance exacte. |
| 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 force OLE DB Driver pour SQL Server à utiliser le nom principal de service par défaut, généré par le fournisseur. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Affecte la séquence de connexion quand la première IP résolue du nom d’hôte ne répond pas et qu’il existe plusieurs IP associées au nom d’hôte. TNIR interagit avec MultiSubnetFailover pour fournir plusieurs séquences de connexion. Les valeurs possibles sont True et False. La valeur par défaut est True. Pour plus d’informations, consultez Utilisation de la résolution d’adresses IP réseau transparente. |
| Faire confiance au certificat de serveur1 | 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é. |
| Utiliser le chiffrement pour les données1 | 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 Optional, Mandatory et Strict. La valeur par défaut est Mandatory. Pour les versions 18.x.x, consultez Différences entre les versions principales de MSOLEDBSQL. |
| Use FMTONLY | SSPROP_INIT_USEFMTONLY | Contrôle la façon dont les métadonnées sont récupérées pendant la connexion à SQL Server 2012 (11.x) et les versions ultérieures. Les valeurs possibles sont true et false. La valeur par défaut est false.Par défaut, OLE DB Driver pour SQL Server utilise les procédures stockées sp_describe_first_result_set et sp_describe_undeclared_parameters pour récupérer les métadonnées. Ces procédures stockées ont quelques limitations (par exemple, elles échouent sur les tables temporaires). La définition de Use FMTONLY sur true indique au pilote d’utiliser à la place SET FMTONLY pour la récupération des métadonnées. |
| ID d'utilisateur | DBPROP_AUTH_USERID | Nom du compte de connexion SQL Server. |
| Workstation ID | SSPROP_INIT_WSID | Identificateur de station de travail. |
[1] : Pour améliorer la sécurité, le chiffrement et le comportement de validation de certificat sont modifiés lorsque vous utilisez les propriétés d’initialisation de jeton d’authentification/d’accès ou les mots clés de chaîne de connexion correspondants. Pour plus d’informations, consultez Chiffrement et validation de certificat.
Notes
Dans la chaîne de connexion, la propriété « Old Password » définit SSPROP_AUTH_OLD_PASSWORD, qui correspond au mot de passe actuel (éventuellement expiré) non disponible via une propriété de chaîne de fournisseur.
Voir aussi
Génération d’applications avec OLE DB Driver pour SQL Server
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour