Partager via

Utilisation des mots-clés de connexion avec le pilote OLE DB pour SQL Server

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Base de données SQL dans Microsoft Fabric

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 pour assurer la compatibilité ascendante (par exemple, certains mots-clés peuvent être spécifiés plusieurs fois, et les mots-clés en conflit peuvent être autorisés avec une résolution en fonction de la position ou de la priorité). 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 de fournisseur peut être utilisée pour initialiser les 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 les 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és par IDataInitialize::GetDataSource est au minimum la description des propriétés 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 de fournisseur via les 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 utilisant IDataInitialize::GetDataSource sont définies à l’aide des valeurs true et false.

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

Notes

Une chaîne de connexion, qui est transmise à travers 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é est appliquée en tant que propriété autonome. Sinon, elle sera appliquée via la propriété DBPROP_PROVIDERSTRING. Par exemple, si vous spécifiez la chaîne Data Source=server1;Server=server2de connexion, Data Source est définie en tant que propriété, mais Server passe à 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 avec DBPROP_INIT_PROVIDERSTRING et 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.
Address 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 peut être d’autres noms tels qu’un canal, une adresse IP ou un port TCP/IP et une adresse de socket.

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

La valeur de Address prévaut sur la valeur passée à Server dans les chaînes de connexion lors de l’utilisation du pilote OLE DB pour SQL Server. Address=; se connecte au serveur spécifié dans le Server mot clé, tandis que Address= ;, Address=.;, Address=localhost;et Address=(local); toutes provoquent une connexion au serveur local.

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

[protocole :]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 les protocoles clients.

Si aucun protocole ni le Network mot clé n’est spécifié, OLE DB Driver pour SQL Server utilise l’ordre de protocole spécifié dans le Gestionnaire de configuration SQL Server.

port est le port auquel se connecter, sur le serveur spécifié. Par défaut, SQL Server utilise le port 1433.
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 dans la chaîne de connexion du 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).
Authentication 1 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: ID d’utilisateur et authentification par mot de passe avec une identité Microsoft Entra.
  • ActiveDirectoryIntegrated: Authentification intégrée avec l’ID Microsoft Entra.

    • Remarque : Le ActiveDirectoryIntegrated mot clé peut également être utilisé pour l’authentification Windows auprès de SQL Server. Il remplace les mots clés d’authentification Integrated Security (ou Trusted_Connection). Les applications utilisant Integrated Security (ou Trusted_Connection) mots-clés ou leurs propriétés correspondantes doivent définir Authentication à ActiveDirectoryIntegrated pour activer le nouveau comportement de chiffrement et de validation de certificats.

  • ActiveDirectoryInteractive: Authentification interactive avec une identité Microsoft Entra. L’authentification multifacteur Microsoft Entra est prise en charge.
  • ActiveDirectoryMSI: Authentification Identité Géré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 utilisateur et du mot de passe.

    • Remarque : Les applications utilisant l’authentification SQL Server doivent définir la valeur du mot clé (ou sa propriété correspondante) pour Authentication activer le SqlPassword chiffrement et de validation de certificat.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Synonyme de AutoTranslate.
AutoTranslate SSPROP_INIT_AUTOTRANSLATE Configure la traduction de caractères OEM/ANSI. Les valeurs reconnues sont yes et no.
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. Une valeur de 0 entraînerait aucune tentative de reconnexion. Pour plus d’informations, consultez Résilience de connexion inactive dans le pilote OLE DB.
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 de connexion inactive dans le pilote OLE DB.
Database DBPROP_INIT_CATALOG Nom de la base de données.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Spécifie le mode de gestion de type de données à utiliser. Les valeurs reconnues sont 0 pour les types de données de fournisseur et 80 pour les types de données SQL Server 2000 (8.x).
Encrypt 1 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 HostNameInCertificate mot clé n’est pas défini, le pilote utilise la Server valeur du mot clé 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 Encrypt est défini sur Strict, le certificat sera toujours validé.
Language 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 afin de fournir une détection et une connexion plus rapides au serveur actif (actuellement). 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.
Network SSPROP_INIT_NETWORKLIBRARY Bibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server dans l'organisation.
Network Library SSPROP_INIT_NETWORKLIBRARY Synonyme de Network.
PacketSize SSPROP_INIT_PACKETSIZE Taille du paquet Tabular Data Stream (TDS). La valeur par défaut est 0 (la valeur réelle sera 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.
Server 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 Address mot clé remplace le Server mot clé.

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)\<instancename>;

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 Server mot clé est la suivante :

[protocole :]Serveur[,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 aucun protocole ni le Network mot clé n’est spécifié, OLE DB Driver pour SQL Server utilise l’ordre de protocole spécifié dans le Gestionnaire de configuration SQL Server.

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

Les espaces sont ignorés au début de la valeur passée pour Server dans les chaînes de connexion lors de l'utilisation du OLE DB Driver for 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.
Timeout 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.
TrustServerCertificate 1 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). Définir UseFMTONLY à yes indique au pilote d’utiliser SET FMTONLY pour la récupération des métadonnées à la place.
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 de certificat sont modifiés lors de l’utilisation des propriétés d’initialisation de jeton d’authentification ou d’accès ou de leurs mots clés de chaîne de connexion correspondants. Pour plus d’informations, consultez Chiffrement et validation des certificats.

Utiliser IDataInitialize ::GetDataSource

Les chaînes de connexion utilisées par les applications OLE DB avec 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 les crochets ({}) comme caractères de guillemet et Application Name utilise les 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
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN Jeton d’accès utilisé pour s’authentifier auprès de Microsoft Entra ID.

Remarque : il s'agit d'une erreur 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.
Application Name SSPROP_INIT_APPNAME Chaîne identifiant l'application.
Application Intent 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.
Authentication 1 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: ID d’utilisateur et authentification par mot de passe avec une identité Microsoft Entra.
  • ActiveDirectoryIntegrated: Authentification intégrée avec l’ID Microsoft Entra.

    • Remarque : Le ActiveDirectoryIntegrated mot clé peut également être utilisé pour l’authentification Windows auprès de SQL Server. Il remplace les mots clés d’authentification Integrated Security (ou Trusted_Connection). Les applications utilisant les mots-clés Integrated Security (ou Trusted_Connection) ou leurs propriétés correspondantes doivent définir la valeur du mot-clé Authentication (ou de sa propriété correspondante) pour activer le nouveau comportement de chiffrement et de validation de certificat ActiveDirectoryIntegrated.

  • ActiveDirectoryInteractive: Authentification interactive avec une identité Microsoft Entra. L’authentification multifacteur Microsoft Entra est prise en charge.
  • ActiveDirectoryMSI: Authentification Identité Géré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 utilisateur et du mot de passe.

    • Remarque : Les applications utilisant l’authentification SQL Server doivent définir la valeur du mot clé (ou sa propriété correspondante) pour Authentication activer le SqlPassword chiffrement et de validation de certificat.
Auto Translate 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.
Connect Retry Count 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. Une valeur de 0 n'entraînerait aucune tentative de reconnexion. Pour plus d’informations, consultez Résilience de connexion inactive dans le pilote OLE DB.
Connect Retry Interval 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 de connexion inactive dans le pilote OLE DB.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Nom de la langue de SQL Server.
Data Source DBPROP_INIT_DATASOURCE Nom d'une instance de SQL Server dans l'organisation.

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

Pour plus d’informations sur la syntaxe d’adresse valide, consultez la description du Server mot clé, 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.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nom d’hôte à utiliser pour valider le certificat SQL Server TLS/SSL. Si le Host Name In Certificate mot clé n’est pas défini, le pilote utilise la Data Source valeur du mot clé 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 Use Encryption for Data est défini sur Strict, le certificat sera toujours validé.
Initial Catalog DBPROP_INIT_CATALOG Nom de la base de données.
Initial File Name SSPROP_INIT_FILENAME Nom du fichier primaire (incluez le nom de chemin d'accès complet) d'une base de données pouvant être attachée. Pour utiliser AttachDBFileName, vous devez également spécifier le nom de la base de données avec le mot clé de chaîne DATABASE 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).
Integrated Security DBPROP_AUTH_INTEGRATED Accepte la valeur SSPI pour l’authentification Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Active ou désactive MARS (Multiple Active Result Set) sur la connexion. 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 afin de fournir une détection et une connexion plus rapides au serveur actif (actuellement). 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 Address mot clé, 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 sera déterminée par le serveur).
Password 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
Provider Pour OLE DB Driver pour SQL Server, la valeur est MSOLEDBSQL19 ou MSOLEDBSQL.
Server Certificate 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.
Trust Server Certificate 1 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 1 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). Définir Use FMTONLY à true indique au pilote d’utiliser SET FMTONLY pour la récupération des métadonnées à la place.
User ID 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 lors de l’utilisation des propriétés d’initialisation du jeton d’authentification/d’accès ou de leurs 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 Old Password propriété définit SSPROP_AUTH_OLD_PASSWORD, qui est le mot de passe actuel (éventuellement expiré) 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 en tant que 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 IDBInitialize::Initialize mots clés 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
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN Jeton d’accès utilisé pour s’authentifier auprès de Microsoft Entra ID.

Remarque : c'est une erreur de spécifier ce mot-clé, ainsi que les mots-clés de UID, PWD, Trusted_Connection, Authentication des chaînes de connexion ou leurs propriétés/mots-clés correspondants.
Application Intent 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.
Application Name SSPROP_INIT_APPNAME Chaîne identifiant l'application.
Authentication 1 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: ID d’utilisateur et authentification par mot de passe avec une identité Microsoft Entra.
  • ActiveDirectoryIntegrated: Authentification intégrée avec l’ID Microsoft Entra.

    • Remarque : Le ActiveDirectoryIntegrated mot clé peut également être utilisé pour l’authentification Windows auprès de SQL Server. Il remplace les mots clés d’authentification Integrated Security (ou Trusted_Connection). Les applications utilisant Integrated Security (ou Trusted_Connection) mots-clés ou leurs propriétés correspondantes doivent définir Authentication à ActiveDirectoryIntegrated pour activer le nouveau comportement de chiffrement et de validation de certificats.

  • ActiveDirectoryInteractive: Authentification interactive avec une identité Microsoft Entra. L’authentification multifacteur Microsoft Entra est prise en charge.
  • ActiveDirectoryMSI: Authentification Identité Géré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 utilisateur et du mot de passe.

    • Remarque : Les applications utilisant l’authentification SQL Server doivent définir la valeur du mot clé (ou sa propriété correspondante) pour Authentication activer le SqlPassword chiffrement et de validation de certificat.
Auto Translate 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.
Connect Retry Count 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. Une valeur de 0 entraînerait aucune tentative de reconnexion. Pour plus d’informations, consultez Résilience de connexion inactive dans le pilote OLE DB.
Connect Retry Interval 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 de connexion inactive dans le pilote OLE DB.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Nom de la langue de SQL Server.
Data Source DBPROP_INIT_DATASOURCE Nom d'une instance de SQL Server dans l'organisation.

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

Pour plus d’informations sur la syntaxe d’adresse valide, consultez la description du Server mot clé, 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 (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.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nom d’hôte à utiliser pour valider le certificat SQL Server TLS/SSL. Si le Host Name In Certificate mot clé n’est pas défini, le pilote utilise la Data Source valeur du mot clé 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 Use Encryption for Data est défini sur Strict, le certificat sera toujours validé.
Initial Catalog DBPROP_INIT_CATALOG Nom de la base de données.
Initial File Name SSPROP_INIT_FILENAME Nom du fichier primaire (incluez le nom de chemin d'accès complet) d'une base de données pouvant être attachée. Pour utiliser AttachDBFileName, vous devez également spécifier le nom de la base de données avec le mot clé de chaîne DATABASE 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).
Integrated Security DBPROP_AUTH_INTEGRATED Accepte la valeur SSPI pour l’authentification Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Active ou désactive MARS (Multiple Active Result Set) sur la connexion si le serveur est SQL Server 2005 (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 afin de fournir une détection et une connexion plus rapides au serveur actif (actuellement). 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 Address mot clé, 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 sera déterminée par le serveur).
Password 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.
Provider Pour OLE DB Driver pour SQL Server, la valeur est MSOLEDBSQL19 ou MSOLEDBSQL.
Server Certificate 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.
Trust Server Certificate 1 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 1 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). Définir Use FMTONLY à true indique au pilote d’utiliser SET FMTONLY pour la récupération des métadonnées à la place.
User ID 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 lors de l’utilisation des propriétés d’initialisation du jeton d’authentification/d’accès ou de leurs 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 est le mot de passe actuel (éventuellement expiré) qui n’est pas disponible via une propriété de chaîne de fournisseur.

Contenu connexe

  • Last updated on