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

 

Certaines API SQL Server Native Client utilisent des chaînes de connexion pour spécifier des attributs de connexion. Les chaînes de connexion sont des listes de mots clés et de valeurs associées ; chaque mot clé identifie un attribut de connexion particulier.

Remarque : SQL Server Native Client autorise l’ambiguïté dans les chaînes de connexion pour assurer la compatibilité descendante (par exemple, certains mots clés peuvent être spécifiés plusieurs fois et mots clés en conflit peuvent être autorisés avec la résolution basée sur la position ou la priorité). Les versions ultérieures de SQL Server Native Client n'autoriseront peut-être pas l'ambiguïté dans les chaînes de connexion. Lors de la modification d'applications, il est conseillé d'utiliser SQL Server Native Client pour éliminer toute dépendance vis-à-vis de l'ambiguïté de chaîne de connexion.

Les sections suivantes décrivent les mots clés qui peuvent être utilisés avec le fournisseur OLE DB SQL Server Native Client, le pilote ODBC SQL Server Native Client et ActiveX Data Objects (ADO) lors de l'utilisation de SQL Server Native Client comme fournisseur de données.

Les applications ODBC utilisent des chaînes de connexion comme paramètres à la SQLDriverConnect et SQLBrowseConnect fonctions.

Les chaînes de connexion utilisées par ODBC ont la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

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

attribute-value ::= character-string

attribute-keyword ::= identifier

Les valeurs d'attributs peuvent éventuellement être placées entre accolades, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs d'attributs contiennent des signes non alphanumériques. Il est supposé que la première accolade fermante dans la valeur termine la valeur ; par conséquent, les valeurs ne peuvent pas contenir de caractères d'accolade fermante.

Le tableau suivant décrit les mots clés qui peuvent être utilisés avec une chaîne de connexion ODBC.

Mot cléDescription
AddrSynonyme de « Address ».
AdresseAdresse réseau du serveur exécutant une instance de SQL Server. Adresse est généralement le nom réseau du serveur, mais peuvent être des autres noms comme un canal, une adresse IP ou une adresse de port et les sockets TCP/IP.

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 adresse est prioritaire sur la valeur transmise à Server dans les chaînes de connexion ODBC lors de l’utilisation SQL Server Native Client. Notez également que Address=; se connecte au serveur spécifié dans le Server (mot clé), tandis que Address= ;, Address=.;, Address=localhost;, et Address=(local); tous provoquent une connexion au serveur local.

La syntaxe complète de la adresse mot clé est la suivante :

[protocol:]Address[,port |\pipe\pipename]

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

Si ni protocole ni le réseau mot clé est spécifié, SQL Server Native Client 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.
AnsiNPWLorsque la valeur « yes » est spécifiée, le pilote utilise les comportements ANSI pour gérer les comparaisons NULL, le remplissage des données caractères, les avertissements et la concaténation de NULL. Lorsque la valeur « no » est spécifiée, les comportements ANSI ne sont pas exposés. Pour plus d’informations sur les comportements ANSI NPW, consultez effets des Options ISO.
APPLICATIONNom de l’application qui appelle SQLDriverConnect (facultatif). Si spécifié, cette valeur est stockée dans le master.dbo.sysprocesses colonne nom_programme et est retourné par sp_who et APP_NAME fonctions.
ApplicationIntentDéclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite. La valeur par défaut est ReadWrite. Exemple :

 ApplicationIntent=ReadOnly

Pour plus d’informations sur SQL Server prise en charge du Client natif de Groupes de disponibilité AlwaysOn, consultez SQL Server Native Client prend en charge pour la haute disponibilité, récupération d’urgence.
AttachDBFileNameNom du fichier primaire d'une base de données qui peut être attachée. Incluez le chemin d'accès complet et échappez tout caractère \ lors de l'utilisation d'une variable de chaîne de caractères C :

 AttachDBFileName=c:\\MyFolder\\MyDB.mdf

Cette base de données est attachée et devient la base de données par défaut de la connexion. Pour utiliser AttachDBFileName vous devez également spécifier le nom de la base de données, que ce soit le SQLDriverConnect paramètre de base de données ou l’attribut de connexion SQL_COPT_CURRENT_CATALOG. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas ; il utilise la base de données attachée comme valeur par défaut pour la connexion.
AutoTranslateLorsque la valeur « yes » est spécifiée, les chaînes de caractères ANSI transmises entre le client et le serveur sont converties au format Unicode afin de réduire les problèmes lors de la correspondance des caractères étendus entre les pages de codes sur le client et le serveur.

Données SQL_C_CHAR clientes envoyées à un SQL Server char, varchar, ou texte colonne, paramètre ou variable est converties du format caractère Unicode à l’aide de la page de codes client ANSI (ACP), puis sont convertie du format Unicode des caractères à l’aide de la page de codes ANSI du serveur doit.

 SQL Serverchar, varchar, ou texte données envoyées à une variable SQL_C_CHAR cliente sont converties du format caractère Unicode à l’aide de la page de codes ANSI du serveur, puis sont converties Unicode à caractère via la page de codes ANSI du client.

Ces conversions sont effectuées sur le client par le pilote ODBC SQL Server Native Client. Cela requiert que la page de codes ANSI utilisée sur le serveur soit disponible sur le client.

Ces paramètres n'ont aucun effet sur les conversions effectuées pour les transferts suivants :

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

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

*Les données de client ANSI SQL_C_CHAR envoyées au format Unicode nchar, nvarchar, ou ntext sur le serveur.

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

Lorsque la valeur « no » est spécifiée, la conversion de caractère n'est pas effectuée.

Le SQL Server pilote ODBC Native Client ne traduit pas les données SQL_C_CHAR clientes ANSI envoyées à char, varchar, ou texte variables, paramètres ou colonnes sur le serveur. Aucune traduction n’est effectuée sur char, varchar, ou texte les données envoyées à partir du serveur aux variables SQL_C_CHAR sur le client.

Si le client et SQL Server utilisent des pages de codes ANSI différentes, les caractères étendus peuvent être mal interprétés.
Base de donnéesNom de la base de données SQL Server par défaut utilisée pour la connexion. Si base de données n’est pas spécifié, la base de données par défaut définie pour la connexion est utilisée. La base de données par défaut de la source de données ODBC remplace la base de données par défaut définie pour la connexion. La base de données doit être une base de données, sauf si AttachDBFileName est également spécifié. Si AttachDBFileName est également spécifié, le fichier primaire, il pointe vers est attaché et le nom de la base de données spécifié par base de données.
PiloteNom du pilote tel que retourné par SQLDrivers. La valeur de mot clé pour le pilote ODBC SQL Server Native Client est « {SQL Server Native Client 11.0} ». Le Server (mot clé) est requis si pilote est spécifié et DriverCompletion est définie sur SQL_DRIVER_NOPROMPT.

Pour plus d’informations sur les noms de pilote, consultez la page à l’aide de l’en-tête de SQL Server Native Client et fichiers de la bibliothèque.
DSNNom d'une source de données utilisateur ou système ODBC existante. Ce mot clé remplace toutes les valeurs qui peuvent être spécifiés dans le Server, réseau, et adresse mots clés.
ChiffrerSpécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « yes » et « no ». La valeur par défaut est « no ».
SecoursCe mot clé est déconseillé et sa valeur est ignorée par le pilote ODBC SQL Server Native Client.
Failover_PartnerNom du partenaire de basculement à utiliser s'il est impossible d'établir une connexion au serveur principal.
FailoverPartnerSPNNom principal de service du partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le pilote.
FileDSNNom d'une source de données de fichier ODBC existante.
LangueNom de la langue SQL Server (facultatif). SQL Serverpeut stocker des messages pour plusieurs langues dans sysmessages. Si vous vous connectez à un SQL Server avec plusieurs langues, langage Spécifie le jeu de messages sont utilisés pour la connexion.
MARS_ConnectionActive ou désactive MARS (Multiple Active Result Set) sur la connexion. Les valeurs reconnues sont « yes » et « no ». La valeur par défaut est « no ».
MultiSubnetFailoverToujours spécifier multiSubnetFailover = Yes lors de la connexion à l’écouteur d’un SQL Server groupe de disponibilité ou un SQL Server Instance de Cluster de basculement. multiSubnetFailover = Yes configure SQL Server Native Client pour fournir une détection plus rapide et une connexion au serveur actif. Les valeurs possibles sont Yes et No. La valeur par défaut est non. Exemple :

 MultiSubnetFailover=Yes

Pour plus d’informations sur SQL Server prise en charge du Client natif de Groupes de disponibilité AlwaysOn, consultez SQL Server Native Client prend en charge pour la haute disponibilité, récupération d’urgence.
NETSynonyme de « Network ».
RéseauLes valeurs valides sont dbnmpntw (canaux nommés) et dbmssocn (TCP/IP).

Il s’agit d’une erreur pour spécifier une valeur pour le réseau (mot clé) et le protocole de préfixe dans les Server (mot clé).
MOT DE PASSEMot de passe du compte de connexion SQL Server spécifié dans le paramètre UID. PWD ne doit pas être spécifié si la connexion a un mot de passe NULL ou lors de l’utilisation de l’authentification Windows (Trusted_Connection = yes).
QueryLog_OnLorsque la valeur « yes » est spécifiée, l'enregistrement des données de requêtes longues est activé sur la connexion. Lorsque la valeur « no » est spécifiée, les données de requêtes longues ne sont pas enregistrées dans le journal.
QueryLogFileChemin d'accès complet et nom de fichier d'un fichier à utiliser pour l'enregistrement des données sur les requêtes longues.
QueryLogTimeChaîne de caractères numérique spécifiant le seuil d'enregistrement (en millisecondes) des requêtes longues. Toute requête qui n'obtient pas de réponse dans les délais spécifiées est écrite dans le fichier journal de requêtes longues.
QuotedIdLorsque la valeur « yes » est spécifiée, QUOTED_IDENTIFIERS est défini à ON pour la connexion, SQL Server utilise les règles ISO concernant l'utilisation de guillemets dans les instructions SQL. Lorsque la valeur « no » est spécifiée, QUOTED_IDENTIFIERS est défini à OFF pour la connexion. SQL Server utilise dans ce cas les règles Transact-SQL héritées concernant l'utilisation de guillemets dans les instructions SQL. Pour plus d’informations, consultez effets des Options ISO.
RégionalLorsque la valeur « yes » est spécifiée, le pilote ODBC SQL Server Native Client utilise les paramètres du client pour convertir monnaie, date et heure en données caractères. La conversion est unidirectionnelle uniquement ; le pilote ne reconnaît pas les formats standard non-ODBC pour les chaînes de date ou les valeurs monétaires contenues par exemple dans un paramètre utilisé dans une instruction INSERT ou UPDATE. Lorsque la valeur « no » est spécifiée, le pilote utilise les chaînes standard ODBC pour représenter les données de monnaie, date et heure converties en données caractères.
SaveFileNom d'un fichier source de données ODBC dans lequel les attributs de la connexion actuelle sont enregistrés si la connexion réussit.
ServeurNom d'une instance de SQL Server. La valeur doit être le nom d'un serveur sur le réseau, une adresse IP ou le nom d'un alias du Gestionnaire de configuration SQL Server.

Le adresse mot clé substitue le Server (mot clé).

Vous pouvez vous connecter à l’instance par défaut sur le serveur local en spécifiant l’une des opérations suivantes :

 Server = ;

 Server =. ;

 Server=(local) ;

 Server=(local) ;

 Server=(localhost) ;

 Server=(LocalDB)\ instancename ;

Pour plus d’informations sur la prise en charge de la base de données locale, consultez SQL Server Native Client prend en charge pour la base de données locale.

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

 Server=[protocol:]Server[,port]

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

Voici un exemple de spécification d'un canal nommé :

 np:\\.\pipe\MSSQL$MYINST01\sql\query

Cette ligne spécifie le protocole de canal nommé, un canal nommé sur l'ordinateur local (\\.\pipe), le nom de l'instance de SQL Server (MSSQL$MYINST01) et le nom par défaut du canal nommé (sql/query).

Si ni un protocole ni le réseau mot clé est spécifié, SQL Server Native Client 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 ODBC lors de l’utilisation SQL Server Native Client.
ServerSPNNom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le pilote.
StatsLog_OnLorsque la valeur « yes » est spécifiée, active la capture de données de performances du pilote ODBC SQL Server Native Client. Lorsque la valeur « no » est spécifiée, les données de performances du pilote ODBC SQL Server Native Client ne sont pas disponibles sur la connexion.
StatsLogFileChemin d'accès complet et nom de fichier d'un fichier utilisé pour enregistrer les statistiques de performances du pilote ODBC SQL Server Native Client.
Trusted_ConnectionLorsque la valeur « yes » est spécifiée, fait en sorte que le pilote ODBC SQL Server Native Client utilise le mode d'authentification Windows pour la validation de connexion. Autrement, fait en sorte que le pilote ODBC SQL Server Native Client utilise un nom d'utilisateur et un mot de passe SQL Server pour la validation de connexion, et les mots clés UID et PWD doivent être spécifiés.
TrustServerCertificateLorsqu’il est utilisé avec Encrypt, Active le chiffrement à l’aide d’un certificat de serveur auto-signé.
UIDCompte de connexion SQL Server valide. Il n'est pas nécessaire de spécifier l'UID lors de l'utilisation de l'authentification Windows.
UseProcForPrepareCe mot clé est déconseillé et sa valeur est ignorée par le SQL Server pilote ODBC natif de Client.
WSIDID de station de travail. En général, il s'agit du nom réseau de l'ordinateur sur lequel l'application réside (facultatif). Si spécifié, cette valeur est stockée dans le master.dbo.sysprocesses colonne nom d’hôte et est retourné par sp_who et HOST_NAME (fonction).

Remarque : les paramètres de conversion régionaux s’appliquent à monétaire, numérique, date et types de données. Le paramètre de conversion est applicable uniquement à la conversion sortante et est visible uniquement lorsque des valeurs de monnaie, numériques, de date ou d'heure sont converties en chaînes de caractères.

Le pilote ODBC SQL Server Native Client utilise les paramètres régionaux du Registre pour l'utilisateur actuel. Le pilote n’honore pas les paramètres régionaux du thread actuel si l’application définit une fois la connexion, par exemple, l’appel SetThreadLocale.

La modification du comportement régional d'une source de données peut provoquer l'échec de l'application. Une application qui analyse des chaînes de date et s'attend à ce qu'elles apparaissent comme défini par ODBC pourrait être affectée de manière négative par la modification de cette valeur.

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 second cas, une chaîne d’initialisation peut être passée à IDataInitialize::GetDataSource méthode 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 des 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 du fournisseur via des valeurs DBPROP_INIT_PROVIDERSTRING sont définies à l'aide des valeurs « yes » et « no ». Les propriétés booléennes définies dans les chaînes d’initialisation à l’aide de IDataInitialize::GetDataSource sont définies en utilisant les valeurs « true » et « false ».

Les applications à l’aide de IDataInitialize::GetDataSource pouvez é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 la IDBInitialize::Initialize mot clé dans la chaîne d’initialisation, le IDataInitialize::GetDataSource paramètre de mot clé est utilisé. Il est fortement recommandé que les applications n’utilisent pas IDBInitialize::Initialize mots-clés de IDataInitialize : GetDatasource chaînes de connexion, que ce comportement ne peut pas être maintenu dans les futures versions.

System_CAPS_ICON_note.jpg Remarque


Une chaîne de connexion passée via IDataInitialize::GetDataSource est convertie en propriétés et appliquée via IDBProperties::SetProperties. Si les services de composants trouvés dans la description de la propriété IDBProperties::GetPropertyInfo, cette propriété sera appliquée en tant que 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, Source de données est défini comme une propriété, mais Server passera 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é sera utilisée.

Chaînes de connexion utilisées par les applications OLE DB utilisant DBPROP_INIT_PROVIDERSTRING avec IDBInitialize::Initialize ont la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

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

attribute-value ::= character-string

attribute-keyword ::= identifier

Les valeurs d'attributs peuvent éventuellement être placées entre accolades, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs d'attributs contiennent des signes non alphanumériques. Il est supposé que la première accolade fermante dans la valeur termine la valeur ; par conséquent, les valeurs ne peuvent pas contenir de caractères d'accolade fermante.

Un caractère d’espace après que le signe = d’un mot-clé de chaîne de connexion sera interprété comme un littéral, même si la valeur est placée entre guillemets.

Le tableau suivant décrit les mots clés qui peuvent être utilisés avec DBPROP_INIT_PROVIDERSTRING.

Mot cléPropriété d'initialisationDescription
AddrSSPROP_INIT_NETWORKADDRESSSynonyme de « Address ».
AdresseSSPROP_INIT_NETWORKADDRESSAdresse réseau d'une instance de SQL Server dans l'organisation.

Pour plus d’informations sur la syntaxe d’adresse valides, consultez la description de la adresse mot-clé ODBC, plus loin dans cette rubrique.
APPLICATIONSSPROP_INIT_APPNAMEChaîne identifiant l'application.
ApplicationIntentSSPROP_INIT_APPLICATIONINTENTDéclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite.

La valeur par défaut est ReadWrite. Pour plus d’informations sur SQL Server prise en charge du Client natif de Groupes de disponibilité AlwaysOn, consultez SQL Server Native Client prend en charge pour la haute disponibilité, récupération d’urgence.
AttachDBFileNameSSPROP_INIT_FILENAMENom 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é base de données de chaîne fournisseur. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas (il utilise la base de données attachée comme valeur par défaut pour la connexion).
Traduire automatiquementSSPROP_INIT_AUTOTRANSLATESynonyme de « AutoTranslate ».
AutoTranslateSSPROP_INIT_AUTOTRANSLATEConfigure la traduction de caractères OEM/ANSI. Les valeurs reconnues sont « yes » et « no ».
Base de donnéesDBPROP_INIT_CATALOGNom de la base de données.
DataTypeCompatibilitySSPROP_INIT_DATATYPECOMPATIBILITYSpé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.
ChiffrerSSPROP_INIT_ENCRYPTSpécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « yes » et « no ». La valeur par défaut est « no ».
FailoverPartnerSSPROP_INIT_FAILOVERPARTNERNom du serveur de basculement utilisé pour la mise en miroir de bases de données.
FailoverPartnerSPNSSPROP_INIT_FAILOVERPARTNERSPNNom principal de service du partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.
LangueSSPROPT_INIT_CURRENTLANGUAGELangue de SQL Server.
MarsConnSSPROP_INIT_MARSCONNECTIONActive ou désactive MARS (Multiple Active Result Set) sur la connexion si le serveur est SQL Server 2005 ou version ultérieure. Les valeurs possibles sont « yes » et « no ». La valeur par défaut est « no ».
NETSSPROP_INIT_NETWORKLIBRARYSynonyme de « Network ».
RéseauSSPROP_INIT_NETWORKLIBRARYBibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server dans l'organisation.
Bibliothèque réseauSSPROP_INIT_NETWORKLIBRARYSynonyme de « Network ».
PaquetSSPROP_INIT_PACKETSIZETaille de paquet réseau. La valeur par défaut est 4096.
PersistSensitiveDBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFOAccepte les chaînes « yes » et « no » comme valeurs. Lorsque « no » est spécifié, l'objet source de données n'est pas autorisé à rendre les informations d'authentification sensibles persistantes
MOT DE PASSEDBPROP_AUTH_PASSWORDMot de passe de compte de connexion SQL Server.
ServeurDBPROP_INIT_DATASOURCENom 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 valides, consultez la description de la Server mot clé ODBC dans cette rubrique.
ServerSPNSSPROP_INIT_SERVERSPNNom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.
TimeoutDBPROP_INIT_TIMEOUTDurée (en secondes) pendant laquelle attendre que l'initialisation de source de données s'achève.
Trusted_ConnectionDBPROP_AUTH_INTEGRATEDLorsque la valeur « yes » est spécifiée, fait en sorte que le fournisseur OLE DB SQL Server Native Client utilise le mode d'authentification Windows pour la validation de connexion. Autrement, fait en sorte que le fournisseur OLE DB SQL Server Native Client utilise un nom d'utilisateur et un mot de passe SQL Server pour la validation de connexion, et les mots clés UID et PWD doivent être spécifiés.
TrustServerCertificateSSPROP_INIT_TRUST_SERVER_CERTIFICATEAccepte 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é.
UIDDBPROP_AUTH_USERIDNom du compte de connexion SQL Server.
UseProcForPrepareSSPROP_INIT_USEPROCFORPREPCe mot clé est déconseillé et sa valeur est ignorée par le fournisseur OLE DB SQL Server Native Client.
WSIDSSPROP_INIT_WSIDIdentificateur de station de travail.

Chaînes de connexion utilisées par les applications OLE DB à l’aide de 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 ({}) guillemets et nom de l’Application utilise unique (') ou doubles (») caractères de guillemets. Seules les propriétés de chaîne peuvent être mises entre guillemets. Si vous tentez de placer entre guillemets un entier ou une propriété énumérée, une erreur indiquant que la chaîne de connexion n'est pas conforme à la spécification OLE DB sera générée.

Les valeurs d'attributs peuvent éventuellement être placées entre guillemets simples ou doubles, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs contiennent des caractères non alphanumériques. Le caractère de guillemet utilisé peut également apparaître dans des valeurs, à condition d'être doublé.

Un caractère d’espace après que le signe = 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ées avec IDataInitialize::GetDataSource:

Mot cléPropriété d'initialisationDescription
Application NameSSPROP_INIT_APPNAMEChaîne identifiant l'application.
Intention de l’applicationSSPROP_INIT_APPLICATIONINTENTDéclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite.

La valeur par défaut est ReadWrite. Pour plus d’informations sur SQL Server prise en charge du Client natif de Groupes de disponibilité AlwaysOn, consultez SQL Server Native Client prend en charge pour la haute disponibilité, récupération d’urgence.
Traduire automatiquementSSPROP_INIT_AUTOTRANSLATESynonyme de « AutoTranslate ».
AutoTranslateSSPROP_INIT_AUTOTRANSLATEConfigure la traduction de caractères OEM/ANSI. Les valeurs reconnues sont « true » et « false ».
Connect TimeoutDBPROP_INIT_TIMEOUTDurée (en secondes) pendant laquelle attendre que l'initialisation de source de données s'achève.
Langue actuelleSSPROPT_INIT_CURRENTLANGUAGENom de la langue de SQL Server.
Source de donnéesDBPROP_INIT_DATASOURCENom 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 valides, consultez la description de la Server mot-clé ODBC, plus loin dans cette rubrique.
DataTypeCompatibilitySSPROP_INIT_DATATYPECOMPATIBILITYSpé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.
Partenaire de basculementSSPROP_INIT_FAILOVERPARTNERNom du serveur de basculement utilisé pour la mise en miroir de bases de données.
SPN du partenaire de basculementSSPROP_INIT_FAILOVERPARTNERSPNNom principal de service du partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.
Catalogue initialDBPROP_INIT_CATALOGNom de la base de données.
Nom de fichier initialSSPROP_INIT_FILENAMENom 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é base de données de chaîne fournisseur. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas (il utilise la base de données attachée comme valeur par défaut pour la connexion).
Sécurité intégréeDBPROP_AUTH_INTEGRATEDAccepte la valeur « SSPI » pour l'authentification Windows.
Connexion MARSSSPROP_INIT_MARSCONNECTIONActive ou désactive MARS (Multiple Active Result Set) sur la connexion. Les valeurs reconnues sont « true » et « false ». La valeur par défaut est « false ».
Adresse réseauSSPROP_INIT_NETWORKADDRESSAdresse réseau d'une instance de SQL Server dans l'organisation.

Pour plus d’informations sur la syntaxe d’adresse valides, consultez la description de la adresse mot-clé ODBC, plus loin dans cette rubrique.
Bibliothèque réseauSSPROP_INIT_NETWORKLIBRARYBibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server dans l'organisation.
Packet SizeSSPROP_INIT_PACKETSIZETaille de paquet réseau. La valeur par défaut est 4096.
Mot de passeDBPROP_AUTH_PASSWORDMot de passe de compte de connexion SQL Server.
Persist Security InfoDBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFOAccepte les chaînes « true » et « false » comme valeurs. Lorsque « false » est spécifié, l'objet source de données n'est pas autorisé à rendre les informations d'authentification sensibles persistantes
ProviderPour SQL Server Native Client, ce doit être « SQLNCLI11 ».
SPN du serveurSSPROP_INIT_SERVERSPNNom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.
Approuver le certificat de serveurSSPROP_INIT_TRUST_SERVER_CERTIFICATEAccepte 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 DataSSPROP_INIT_ENCRYPTSpécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « true » et « false ». La valeur par défaut est « false ».
ID d’utilisateurDBPROP_AUTH_USERIDNom du compte de connexion SQL Server.
ID de station de travailSSPROP_INIT_WSIDIdentificateur de station de travail.

Remarque dans la chaîne de connexion, la propriété « Ancien mot de passe » définit SSPROP_AUTH_OLD_PASSWORD, qui est en cours (peut-être périmé) mot de passe n’est pas disponible via une propriété de chaîne du fournisseur.

Applications ADO attribuent la ConnectionString propriété du ADODBConnection des objets ou de fournir une chaîne de connexion en tant que paramètre à la Open méthode de ADODBConnection objets.

Les applications ADO peuvent également utiliser les mots clés utilisés par OLE DB IDBInitialize::Initialize (méthode), mais uniquement pour les propriétés qui n’ont pas de valeur par défaut. Si une application utilise les deux mots clés ADO et IDBInitialize::Initialize mots clés dans la chaîne d’initialisation, le paramètre de mot clé ADO seront utilisés. Il est vivement recommandé que les applications utilisent uniquement des mots clés de chaîne de connexion ADO.

Les chaînes de connexion utilisées par ADO ont la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

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

attribute-value ::= character-string

attribute-keyword ::= identifier

Les valeurs d'attributs peuvent éventuellement être placées entre guillemets doubles, et ceci est d'ailleurs recommandé. Cela évite tout problème lorsque des valeurs contiennent des caractères non alphanumériques. Les valeurs d'attributs ne peuvent pas contenir de guillemets doubles.

Le tableau suivant décrit les mots clés qui peuvent être utilisés avec une chaîne de connexion ADO :

Mot cléPropriété d'initialisationDescription
Intention de l’applicationSSPROP_INIT_APPLICATIONINTENTDéclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite.

La valeur par défaut est ReadWrite. Pour plus d’informations sur SQL Server prise en charge du Client natif de Groupes de disponibilité AlwaysOn, consultez SQL Server Native Client prend en charge pour la haute disponibilité, récupération d’urgence.
Application NameSSPROP_INIT_APPNAMEChaîne identifiant l'application.
Traduire automatiquementSSPROP_INIT_AUTOTRANSLATESynonyme de « AutoTranslate ».
AutoTranslateSSPROP_INIT_AUTOTRANSLATEConfigure la traduction de caractères OEM/ANSI. Les valeurs reconnues sont « true » et « false ».
Connect TimeoutDBPROP_INIT_TIMEOUTDurée (en secondes) pendant laquelle attendre que l'initialisation de source de données s'achève.
Langue actuelleSSPROPT_INIT_CURRENTLANGUAGENom de la langue de SQL Server.
Source de donnéesDBPROP_INIT_DATASOURCENom 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 valides, consultez la description de la Server mot clé ODBC dans cette rubrique.
DataTypeCompatibilitySSPROP_INIT_DATATYPECOMPATIBILITYSpé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.
Partenaire de basculementSSPROP_INIT_FAILOVERPARTNERNom du serveur de basculement utilisé pour la mise en miroir de bases de données.
SPN du partenaire de basculementSSPROP_INIT_FAILOVERPARTNERSPNNom principal de service du partenaire de basculement. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.
Catalogue initialDBPROP_INIT_CATALOGNom de la base de données.
Nom de fichier initialSSPROP_INIT_FILENAMENom 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é base de données de chaîne fournisseur. Si la base de données a été attachée précédemment, SQL Server ne la rattache pas (il utilise la base de données attachée comme valeur par défaut pour la connexion).
Sécurité intégréeDBPROP_AUTH_INTEGRATEDAccepte la valeur « SSPI » pour l'authentification Windows.
Connexion MARSSSPROP_INIT_MARSCONNECTIONActive ou désactive MARS (Multiple Active Result Set) sur la connexion si le serveur est SQL Server 2005 ou version ultérieure. Les valeurs reconnues sont « true » et « false ». La valeur par défaut est « false ».
Adresse réseauSSPROP_INIT_NETWORKADDRESSAdresse réseau d'une instance de SQL Server dans l'organisation.

Pour plus d’informations sur la syntaxe d’adresse valides, consultez la description de la adresse mot clé ODBC dans cette rubrique.
Bibliothèque réseauSSPROP_INIT_NETWORKLIBRARYBibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server dans l'organisation.
Packet SizeSSPROP_INIT_PACKETSIZETaille de paquet réseau. La valeur par défaut est 4096.
Mot de passeDBPROP_AUTH_PASSWORDMot de passe de compte de connexion SQL Server.
Persist Security InfoDBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFOAccepte les chaînes « true » et « false » comme valeurs. Lorsque « false » est spécifié, l'objet source de données n'est pas autorisé à rendre les informations d'authentification sensibles persistantes.
ProviderPour SQL Server Native Client, ce doit être « SQLNCLI11 ».
SPN du serveurSSPROP_INIT_SERVERSPNNom principal de service (SPN) du serveur. La valeur par défaut est une chaîne vide. Une chaîne vide fait en sorte que SQL Server Native Client utilise le nom principal de service par défaut généré par le fournisseur.
Approuver le certificat de serveurSSPROP_INIT_TRUST_SERVER_CERTIFICATEAccepte 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 DataSSPROP_INIT_ENCRYPTSpécifie si les données doivent être chiffrées avant d'être envoyées sur le réseau. Les valeurs possibles sont « true » et « false ». La valeur par défaut est « false ».
ID d’utilisateurDBPROP_AUTH_USERIDNom du compte de connexion SQL Server.
ID de station de travailSSPROP_INIT_WSIDIdentificateur de station de travail.

Remarque dans la chaîne de connexion, la propriété « Ancien mot de passe » définit SSPROP_AUTH_OLD_PASSWORD, qui est en cours (peut-être périmé) mot de passe n’est pas disponible via une propriété de chaîne du fournisseur.

Création d’Applications avec SQL Server Native Client

Ajouts de la communauté

Afficher: