Partage via


CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS

Cet article fournit des détails supplémentaires pour CONNECTION_OPTIONS en fonction du fournisseur. L’argument CONNECTION_OPTIONS pour CREATE EXTERNAL DATA SOURCE peut varier en fonction du fournisseur de données externe.

L’argument CONNECTION_OPTIONS pour CREATE EXTERNAL DATA SOURCE a été introduit dans SQL Server 2019 (15.x). Ce document s’applique à SQL Server 2019 (15.x) pour Windows et Linux, ainsi qu’aux clusters Big Data SQL Server 2019.

  • key_value_pair correspond au mot clé et à la valeur d’une option de connexion spécifique.
  • Pour utiliser plusieurs options de connexion, séparez-les par un point-virgule.
  • Les paires clé-valeur possibles sont spécifiques au pilote.

Le reste de cet article contient des options de connexion spécifiques au fournisseur.

Source de données externes SQL Server

Vous pouvez uniquement spécifier les paires clé-valeur qui ont une entrée dans Attributs et mots clés de chaîne de connexion et DSN sous la colonne Mot clé de chaîne de connexion / DSN. Par exemple, le mot clé SQL_ATTR_TXN_ISOLATION n’est pas pris en charge, car il s’agit d’un jeu d’attributs utilisant SQLSetConnectAttr, qui ne figure pas dans la chaîne de connexion.

Mots clés et options de chaîne de connexion pour les fournisseurs Microsoft OLE DB :

Mots clés et options de chaîne de connexion pour les fournisseurs Microsoft ODBC DB :

Oracle

Vous pouvez uniquement spécifier les paires clé-valeur qui ont une entrée dans la table de protocole filaire Oracle comme suit :

Attribut (nom court) Default
AccountingInfo (AI) Aucun
Action (ACT) Aucun
AlternateServers (ASRV) Aucun
AllowedOpenSSLVersions (AOV) latest
ApplicationName (AN) Aucun
ApplicationUsingThreads (AUT) 1 (activé)
ArraySize (AS) 60000
AuthenticationMethod (AM) 1 (chiffrer le mot de passe)
BatchFailureReturnsError (BFRE) 0 (désactivé)
BindParamsAsUnicode (BPAU) 0 (désactivé)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) -1
BulkLoadBatchSize (BLBS) 1 024
BulkLoadFieldDelimiter (BLFD) Aucun
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Aucun
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (activé)
CatalogOptions (CO) 0 (désactivé)
ClientHostName (CHN) Aucun
ClientID (CID) Aucun
ClientUser (CU) Aucun
ConnectionReset (CR) 0 (désactivé)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Aucun
CredentialsWalletPassword (CWPWD) Aucun
CredentialsWalletPath (CWPATH) Aucun
CryptoProtocolVersion (CPV) TLSv1.2,TLSv1.1,TLSv1
CryptoLibName (CLN) Chaîne vide
DataIntegrityLevel (DIL) 1 (accepté)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Aucun
DefaultLongDataBuffLen (DLDBL) 1 024
DescribeAtPrepare (DAP) 0 (désactivé)
Description (n/a) Aucun
EditionName (EN) Aucun
EnableBulkLoad (EBL) 0 (désactivé)
EnableDescribeParam (EDP) 0 (désactivé)
EnableNcharSupport (ENS) (déconseillé.) Aucun
EnableScrollableCursors (ESC) 1 (activé)
EnableServerResultCache (ESRC) 0 (désactivé)
EnableStaticCursorsForLongData (ESCLD) 0 (désactivé)
EnableTimestampwithTimezone (ETWT) (déconseillé) Aucun
EncryptionLevel (EL) 1 (accepté)
EncryptionMethod (EM) 0 (pas de chiffrement)
EncryptionTypes (ET) Aucune méthode de chiffrement n’est spécifiée. Le pilote envoie une liste de toutes les méthodes de chiffrement au serveur Oracle.
FailoverGranularity (FG) 0 (non atomique)
FailoverMode (FM) 0 (connexion)
FailoverPreconnect (FP) 0 (désactivé)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (désactivé)
GSSClient (GSSC) native
HostName (HOST) Aucun
HostNameInCertificate (HNIC) Aucun
IANAAppCodePage (IACP) (UNIX et Linux uniquement) 4 (ISO 8559-1 Latin-1)
ImpersonateUser (IU) Aucun
InitializationString (IS) Aucun
KeepAlive (KA) 0 (désactivé)
KeyPassword (KP) Aucun
Keystore (KS) Aucun
KeystorePassword (KSP) Aucun
LDAPDistinguishedName (LDAPDN) Aucun
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (désactivé)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (chaîne vide)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
LogonID (UID) Aucun
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Module (MOD) Aucun
Password (PWD) Aucun
Pooling (POOL) 0 (désactivé)
PortNumber (PORT) Aucun
PRNGSeedFile (PSF) (UNIX et Linux uniquement) /dev/random
PRNGSeedSource (PSS) (UNIX et Linux uniquement) 0 (fichier)
ProcedureRetResults (PRR) 0 (désactivé)
ProgramID (PID) Aucun
ProxyHost (PXHN) Chaîne vide
ProxyMode (PXM) 0 (AUCUN)
ProxyPassword (PXPW) Chaîne vide
ProxyPort (PXPT) 0
ProxyUser (PXU) Chaîne vide
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (ignorer les erreurs)
ReportRecycleBin (RRB) 0 (désactivé)
SDUSize (SDU) 16384
ServerName (SRVR) Aucun
ServerType (ST) 0 (valeur de serveur par défaut)
ServiceName (SN) Aucune. Si aucune valeur n’est spécifiée pour l’option SID, Service Name ou TNSNames, le pilote tente de se connecter au SID ORCL par défaut.
SID (SID) Aucune. Si aucune valeur n’est spécifiée pour l’option SID, Service Name ou TNSNames, le pilote tente de se connecter au SID ORCL par défaut.
SSLLibName (SLN) Chaîne vide
SupportBinaryXML (SBX) 0 (désactivé)
TimestampEscapeMapping (TEM) 0 (spécifique à la version d’Oracle)
TNSNamesFile (TNF) Aucune. Si aucune valeur n’est spécifiée pour l’option SID, Service Name ou TNSNames, le pilote tente de se connecter au SID ORCL par défaut.
Truststore (TS) Aucun
TruststorePassword (TSP) Aucun
UseCurrentSchema (UCS) 1 (activé)
UseDefaultEncryptionOptions 1 (activé)
ValidateServerCertificate (VSC) 1 (activé)
WireProtocolMode (WPM) 2

Teradata

Vous ne pouvez spécifier que les paires clé-valeur qui ont une entrée dans les options de configuration du connecteur fournies dans les options de configuration du connecteur Teradata.

API MongoDB pour Cosmos DB

Vous ne pouvez spécifier que les paires clé-valeur qui ont une entrée dans les options de configuration du pilote ci-dessous.

Nom de clé Default Obligatoire Description
DefaultStringColumnLength 255 Non Nombre maximal de caractères pouvant être contenus dans les colonnes STRING. La valeur maximale que vous pouvez définir pour cette option est 2147483647.
noCursorTimeout False Non Cette option spécifie si le pilote autorise l’expiration des curseurs actifs sur le serveur de source de données. Lorsque la valeur est FALSE, le serveur de source de données fait expirer les curseurs inactifs après la période d’inactivité de seuil définie sur le serveur. Lorsque la valeur est TRUE, le pilote empêche le serveur de source de données de bloquer les curseurs inactifs et il existe un risque que le curseur reste ouvert sur le serveur indéfiniment si le pilote quitte ou perd la connexion au serveur de façon inattendue. Vous pouvez ajuster le seuil d’expiration des curseurs inactifs sur le serveur MongoDB. Consultez https://docs.mongodb.com/v3.0/reference/parameters/ pour plus d’informations.
SamplingLimit 100 Non Nombre maximal d’enregistrements que le pilote peut échantillonner pour générer une définition de schéma temporaire. Lorsque cette option est définie sur 0, le pilote échantillonne chaque document de la base de données.

Veillez à configurer le pilote pour échantillonner toutes les données nécessaires. Les documents qui ne sont pas échantillonnés ne sont pas inclus dans la définition de schéma et ne sont donc pas disponibles dans les applications ODBC.

En règle générale, l’échantillonnage d’un grand nombre de documents entraîne une définition de schéma plus précise et mieux capable de représenter toutes les données de la base de données. Toutefois, le processus d’échantillonnage peut prendre plus de temps que prévu lorsque de nombreux documents sont échantillonnés, en particulier si la base de données contient des structures de données complexes et imbriquées.
SamplingStrategy Transférer Non Cette option spécifie comment le pilote échantillonne les données lors de la génération d’une définition de schéma temporaire.

Forward : Le pilote extrait les données à partir du premier enregistrement de la base de données, puis échantillonne l’enregistrement suivant, et ainsi de suite.
Backward : Le pilote extrait les données à partir du dernier enregistrement de la base de données, puis échantillonne l’enregistrement précédent, et ainsi de suite.
Random : le pilote sélectionne des exemples d’enregistrements à partir de la source de données au hasard jusqu’à ce que la limite d’échantillonnage soit atteinte.
SSL Clear (0) Non Cette option spécifie si le pilote utilise SSL pour se connecter au serveur. Activée (1) : le pilote utilise SSL pour se connecter au serveur. Désactivée (0) : le pilote n’utilise pas SSL pour se connecter au serveur.

ODBC générique

Les CONNECTION_OPTIONS valides que vous pouvez spécifier pour la source de données externe ODBC générique PolyBase sont spécifiques au pilote. Si vous n’utilisez pas de fournisseur ODBC fourni par Microsoft (voir la section précédente), consultez la documentation du pilote pour vérifier les paires clé-valeur valides.

Il existe certaines paires clé-valeur valides dans PolyBase qui sont disponibles pour tous les pilotes ODBC génériques. Les clés suivantes ont été ajoutées à SQL Server 2019 dans la CU5.

Clé Valeurs possibles Description
PolyBaseOdbcSupportsRowCount true, FALSE Indique si le pilote prend en charge la fonction SQLRowCount appelée sur les fonctions de catalogue ODBC. La valeur par défaut est false. Par exemple : CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes true, FALSE Indique si le pilote prend en charge la définition de l’attribut d’instruction METADATA_ID. La valeur par défaut est false. Par exemple : CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset true, FALSE Indique si le pilote prend en charge les décalages de liaison pour la liaison selon les lignes des jeux de résultats. Si ce n’est pas le cas, utilisez la liaison de colonne. La valeur par défaut est false. Par exemple : CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT Contient des informations spécifiant comment pousser l’opérateur TOP vers le back-end. La valeur par défaut est une chaîne vide, indiquant l’absence de prise en charge du pushdown de TOP. Si l’utilisateur spécifie TOP, top {0} est utilisé comme chaîne de format. Si l’utilisateur spécifie LIMIT, limit {0} est utilisé comme chaîne de format. Cette implémentation est spécifique au pilote. Consultez la documentation de la source de données externe et/ou du pilote. Par exemple : CONNECTION_OPTIONS= PolyBaseQoTopPushdownSyntax=TOP'.

Étapes suivantes