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_paircorrespond 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 :
- Microsoft OLE DB Driver pour SQL Server : Utilisation de mots clés de chaîne de connexion avec OLE DB Driver pour SQL Server
- SQL Native Client (déconseillé) OLE DB (SQLNCLI) Native Client avec des mots clés de chaîne de connexion
Mots clés et options de chaîne de connexion pour les fournisseurs Microsoft ODBC DB :
- Microsoft ODBC Driver for SQL Server : mots clés et attributs de chaîne de connexion et DSN
- Mots clés de chaîne de connexion du pilote ODBC SQL Native Client (déconseillé)
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'. |