Partager via


Utilisation de mots clés de chaîne de connexion avec OLE DB Driver pour SQL Server

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Télécharger le pilote OLE DB

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-string

  • empty-string ::=

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

  • attribute-value ::= character-string

  • attribute-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 :
  • (not set): Mode d’authentification déterminé par les autres mots clés.
  • ActiveDirectoryPassword:Identifiant utilisateur et authentification par mot de passe avec une identité Microsoft Entra.
  • ActiveDirectoryIntegrated: Authentification intégrée avec Microsoft Entra ID.

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

  • ActiveDirectoryInteractive: Authentification interactive avec une identité Microsoft Entra. L’authentification multifacteur Microsoft Entra est prise en charge.
  • ActiveDirectoryMSI: Authentification d’une identité managée. Pour une identité affectée par l’utilisateur, l’ID d’utilisateur doit être défini sur l’ID d’objet de l’identité d’utilisateur.
  • ActiveDirectoryServicePrincipal: Authentification avec un principal de service Microsoft Entra. L’identifiant utilisateur doit être défini sur l’ID de l’application (client). Le mot de passe doit être défini sur le secret de l’application (client).
  • SqlPassword: Authentification à l’aide de l’ID d’utilisateur et du mot de passe.

  • 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=Yes

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.
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\query

La 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-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. 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 :
  • (not set): Mode d’authentification déterminé par les autres mots clés.
  • ActiveDirectoryPassword:Identifiant utilisateur et authentification par mot de passe avec une identité Microsoft Entra.
  • ActiveDirectoryIntegrated: Authentification intégrée avec Microsoft Entra ID.

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

  • ActiveDirectoryInteractive: Authentification interactive avec une identité Microsoft Entra. L’authentification multifacteur Microsoft Entra est prise en charge.
  • ActiveDirectoryMSI: Authentification d’une identité managée. Pour une identité affectée par l’utilisateur, l’ID d’utilisateur doit être défini sur l’ID d’objet de l’identité d’utilisateur.
  • ActiveDirectoryServicePrincipal: Authentification avec un principal de service Microsoft Entra. L’identifiant utilisateur doit être défini sur l’ID de l’application (client). Le mot de passe doit être défini sur le secret de l’application (client).
  • SqlPassword: Authentification à l’aide de l’ID d’utilisateur et du mot de passe.

  • 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=True

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

  • empty-string ::=

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

  • attribute-value ::= character-string

  • attribute-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 :
  • (not set): Mode d’authentification déterminé par les autres mots clés.
  • ActiveDirectoryPassword:Identifiant utilisateur et authentification par mot de passe avec une identité Microsoft Entra.
  • ActiveDirectoryIntegrated: Authentification intégrée avec Microsoft Entra ID.

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

  • ActiveDirectoryInteractive: Authentification interactive avec une identité Microsoft Entra. L’authentification multifacteur Microsoft Entra est prise en charge.
  • ActiveDirectoryMSI: Authentification d’une identité managée. Pour une identité affectée par l’utilisateur, l’ID d’utilisateur doit être défini sur l’ID d’objet de l’identité d’utilisateur.
  • ActiveDirectoryServicePrincipal: Authentification avec un principal de service Microsoft Entra. L’identifiant utilisateur doit être défini sur l’ID de l’application (client). Le mot de passe doit être défini sur le secret de l’application (client).
  • SqlPassword: Authentification à l’aide de l’ID d’utilisateur et du mot de passe.

  • 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=True

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