Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
S’applique à :
SQL Server 2016 (13.x) et versions ultérieures d’Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)
Cet article fournit des détails CONNECTION_OPTIONS supplémentaires en fonction du fournisseur. L’argument CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS peut varier en fonction du fournisseur de données externe.
L’argument CONNECTION_OPTIONS de CREATE EXTERNAL DATA SOURCE a été introduit pour la première fois 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 externe SQL Server
Vous ne pouvez spécifier que les paires clé-valeur qui ont une entrée dans les mots clés et les mots clés de chaîne de connexion et les attributs sous la colonne mot clé de chaîne de connexion/ DSN . Par exemple, le SQL_ATTR_TXN_ISOLATION mot clé n’est pas pris en charge, car il s’agit d’un jeu d’attributs à l’aide de SQLSetConnectAttr, et non dans la chaîne de connexion.
Remarque
PolyBase prend uniquement en charge microsoft ODBC Driver version 17 et 18. Pour plus d’informations, consultez Modifier la version du pilote SQL Server pour PolyBase.
Oracle
Vous ne pouvez spécifier que les paires clé-valeur qui ont une entrée dans la table de protocole filaire Oracle comme suit :
| Attribut (nom court) | Par défaut |
|---|---|
| AccountingInfo (IA) | Aucun |
| Action (ACT) | Aucun |
| AlternateServers (ASRV) | Aucun |
| AllowedOpenSSLVersions (AOV) | le plus récent |
| 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) | 1024 |
| 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) | 1024 |
| 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 (Aucun 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) | natif |
| 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 |
| Magasin de clés (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 |
| Mot de passe (PWD) | Aucun |
| Regroupement (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 (NONE) |
| 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 (serveur par défaut) |
| ServiceName (SN) | Aucun. Si aucune valeur n’est spécifiée pour l’option SID, Nom du service ou TNSNames, le pilote tente de se connecter au SID ORCL par défaut. |
| SID (SID) | Aucun. Si aucune valeur n’est spécifiée pour l’option SID, Nom du service 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 Oracle) |
| TNSNamesFile (TNF) | Aucun. Si aucune valeur n’est spécifiée pour l’option SID, Nom du service 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 de pilote suivantes.
| Nom de clé | Par défaut | Obligatoire | Descriptif |
|---|---|---|---|
DefaultStringColumnLength |
255 | Non | Nombre maximal de caractères pouvant être contenus dans les STRING colonnes. La valeur maximale que vous pouvez définir pour cette option est 2147483647. |
noCursorTimeout |
Faux | Non | Cette option spécifie si le pilote autorise l’expiration des curseurs actifs sur le serveur de source de données. Quand FALSE, le serveur de source de données expire les curseurs inactifs après la période d’inactivité de seuil définie sur le serveur. Lorsqu’il est défini TRUEsur , le pilote empêche le serveur de source de données d’expirer les curseurs inactifs et il existe un risque que si le pilote doit quitter ou perdre la connexion au serveur de façon inattendue, le curseur reste ouvert sur le serveur indéfiniment. Vous pouvez ajuster le seuil des délais d’inactivité des curseurs sur le serveur MongoDB, voir Paramètres du serveur MongoDB pour un déploiement Self-Managed 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é 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. Transfert : Le pilote échantillonne les données à partir du premier enregistrement de la base de données, puis l’enregistrement suivant, et ainsi de suite. Descendant : le pilote échantillonne les données à partir du dernier enregistrement de la base de données, puis échantillonne l’enregistrement précédent, et ainsi de suite. Aléatoire : 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 |
Effacer (0) |
Non | Cette option spécifie si le pilote utilise SSL pour se connecter au serveur. Activé (1) : le pilote utilise SSL pour se connecter au serveur. Désactivé (0) : le pilote n’utilise pas SSL pour se connecter au serveur. |
ODBC générique
Valide CONNECTION_OPTIONS 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 connaître les paires clé-valeur valides.
Il existe des 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 CU5.
| Clé | Valeurs possibles | Descriptif |
|---|---|---|
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 en ligne 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 un manque de prise en charge de TOP pushdown. 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 source de données externe et/ou la documentation du pilote. Par exemple : CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'. |