CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS
Questo articolo fornisce dettagli aggiuntivi per CONNECTION_OPTIONS a seconda del provider. L'argomento CREATE EXTERNAL DATA SOURCE CONNECTION_OPTIONS può variare a seconda del provider di dati esterno.
L'argomento CONNECTION_OPTIONS per CREATE EXTERNAL DATA SOURCE è stato introdotto in SQL Server 2019 (15.x). Questo documento si applica a SQL Server 2019 (15.x) per Windows e Linux, nonché SQL Server 2019 cluster Big Data.
-
key_value_pairrappresenta la parola chiave e il valore per un'opzione di connessione specifica. - Per usare più opzioni di connessione, separarle con un punto e virgola.
- Le possibili coppie di valori chiave sono specifiche del driver.
La parte restante di questo articolo contiene opzioni di connessione specifiche del fornitore.
SQL Server'origine dati esterna
È possibile specificare solo le coppie chiave-valore con una voce in parole chiave DSN e String stringhe di connessione e attributi nella colonna DSN/Connection String Keyword . Ad esempio, la parola chiave SQL_ATTR_TXN_ISOLATION non è supportata, perché è un set di attributi usando SQLSetConnectAttr, non nella stringa di connessione.
Parole chiave e opzioni delle stringhe di connessione per i provider MICROSOFT OLE DB:
- Microsoft OLE DB Driver per SQL Server: Uso delle parole chiave stringa di connessione con OLE DB Driver per SQL Server
- SQL Native Client (deprecato) Native Client OLE DB (SQLNCLI) Usando le parole chiave della stringa di connessione
Parole chiave e opzioni delle stringhe di connessione per i provider di database ODBC Microsoft:
- Driver ODBC Microsoft per SQL Server: parole chiave e parole chiave stringa di connessione DSN e attributi
- Parole chiave delle stringhe di connessione del driver ODBC (deprecate) di SQL Native Client (deprecate)
Oracle
È possibile specificare solo le coppie chiave-valore con una voce nella tabella del protocollo di fili Oracle come indicato di seguito:
| Attributo (nome breve) | Predefinito |
|---|---|
| AccountingInfo (IA) | Nessuno |
| Azione (ACT) | Nessuno |
| AlternateServers (ASRV) | Nessuno |
| AllowedOpenSSLVersions (AOV) | più recenti |
| ApplicationName (AN) | Nessuno |
| ApplicationUsingThreads (AUT) | 1 (abilitato) |
| ArraySize (AS) | 60000 |
| AuthenticationMethod (AM) | 1 (Crittografa password) |
| BatchFailureReturnsError (BFRE) | 0 (Disabilitato) |
| BindParamsAsUnicode (BPAU) | 0 (Disabilitato) |
| BulkBinaryThreshold (BBT) | 32 |
| BulkCharacterThreshold (BCT) | -1 |
| BulkLoadBatchSize (BLBS) | 1024 |
| BulkLoadFieldDelimiter (BLFD) | Nessuno |
| BulkLoadOptions (BLO) | 0 |
| BulkLoadRecordDelimiter (BLRD) | Nessuno |
| CachedCursorLimit (CCL) | 32 |
| CachedDescriptionLimit (CDL) | 0 |
| CatalogIncludesSynonyms (CIS) | 1 (abilitato) |
| CatalogOptions (CO) | 0 (Disabilitato) |
| ClientHostName (CHN) | Nessuno |
| ClientID (CID) | Nessuno |
| ClientUser (CU) | Nessuno |
| ConnectionReset (CR) | 0 (Disabilitato) |
| ConnectionRetryCount (CRC) | 0 |
| ConnectionRetryDelay (CRD) | 3 |
| CredentialsWalletEntry (CWE) | Nessuno |
| CredentialsWalletPassword (CWPWD) | Nessuno |
| CredentialsWalletPath (CWPATH) | Nessuno |
| CryptoProtocolVersion (CPV) | TLSv1.2,TLSv1.1,TLSv1 |
| CryptoLibName (CLN) | stringa vuota |
| DataIntegrityLevel (DIL) | 1 (accettato) |
| DataIntegrityTypes (DIT) | MD5, SHA1, SHA256, SHA384, SHA512 |
| DataSourceName (DSN) | Nessuno |
| DefaultLongDataBuffLen (DLDBL) | 1024 |
| DescribeAtPrepare (DAP) | 0 (Disabilitato) |
| Descrizione (n/a) | Nessuno |
| EditionName (EN) | Nessuno |
| EnableBulkLoad (EBL) | 0 (disabilitato) |
| EnableDescribeParam (EDP) | 0 (disabilitato) |
| EnableNcharSupport (ENS) (deprecato). | Nessuno |
| EnableScrollableCursors (ESC) | 1 (abilitato) |
| EnableServerResultCache (ESRC) | 0 (disabilitato) |
| EnableStaticCursorsForLongData (ESCLD) | 0 (disabilitato) |
| EnableTimestampwithTimezone (ETWT) (deprecato) | Nessuno |
| EncryptionLevel (EL) | 1 (accettato) |
| EncryptionMethod (EM) | 0 (nessuna crittografia) |
| EncryptionTypes (ET) | Non vengono specificati metodi di crittografia. Il driver invia un elenco di tutti i metodi di crittografia al server Oracle. |
| FailoverGranularity (FG) | 0 (non atomico) |
| FailoverMode (FM) | 0 (connessione) |
| FailoverPreconnect (FP) | 0 (disabilitato) |
| FetchTSWTZasTimestamp (FTSWTZAT) | 0 (disabilitato) |
| GSSClient (GSSC) | nativi |
| HostName (HOST) | Nessuno |
| HostNameInCertificate (HNIC) | Nessuno |
| IANAAppCodePage (solo IACP) (SOLO UNIX e Linux) | 4 (ISO 8559-1 Latino-1) |
| ImpersonateUser (IU) | Nessuno |
| InitializationString (IS) | Nessuno |
| KeepAlive (KA) | 0 (disabilitato) |
| KeyPassword (KP) | Nessuno |
| Archivio chiavi (KS) | Nessuno |
| KeystorePassword (KSP) | Nessuno |
| LDAPDistinguishedName (LDAPDN) | Nessuno |
| LoadBalanceTimeout (LBT) | 0 |
| LoadBalancing (LB) | 0 (disabilitato) |
| LOBPrefetchSize (LPS) | 4000 |
| LocalTimezoneOffset (LTZO) | "" (stringa vuota) |
| LockTimeout (LTO) | -1 |
| LoginTimeout (LT) | 15 |
| LOGONID (UID) | Nessuno |
| MaxPoolSize (MXPS) | 100 |
| MinPoolSize (MNPS) | 0 |
| Modulo (MOD) | Nessuno |
| Password (PWD) | Nessuno |
| Pooling (POOL) | 0 (disabilitato) |
| PortNumber (PORT) | Nessuno |
| PRNGSeedFile (PSF) (solo UNIX e Linux) | /dev/random |
| PRNGSeedSource (PSS) (solo UNIX e Linux) | 0 (file) |
| ProcedureRetResults (PRR) | 0 (disabilitato) |
| ProgramID (PID) | Nessuno |
| ProxyHost (PXHN) | stringa vuota |
| ProxyMode (PXM) | 0 (NESSUNO) |
| ProxyPassword (PXPW) | stringa vuota |
| ProxyPort (PXPT) | 0 |
| ProxyUser (PXU) | stringa vuota |
| QueryTimeout (QT) | 0 |
| ReportCodepageConversionErrors (RCCE) | 0 (Ignora errori) |
| ReportRecycleBin (RRB) | 0 (disabilitato) |
| SDUSize (SDU) | 16384 |
| ServerName (SRVR) | Nessuno |
| ServerType (ST) | 0 (impostazione predefinita del server) |
| ServiceName (SN) | Nessuno. Se non viene specificato alcun valore per l'opzione SID, Service Name o TNSNames, il driver tenta di connettersi al SID ORCL per impostazione predefinita. |
| SID (SID) | Nessuno. Se non viene specificato alcun valore per l'opzione SID, Service Name o TNSNames, il driver tenta di connettersi al SID ORCL per impostazione predefinita. |
| SSLLibName (SLN) | stringa vuota |
| SupportBinaryXML (SBX) | 0 (disabilitato) |
| TimestampEscapeMapping (TEM) | 0 (specifica della versione oracle) |
| TNSNamesFile (TNF) | Nessuno. Se non viene specificato alcun valore per l'opzione SID, Service Name o TNSNames, il driver tenta di connettersi al SID ORCL per impostazione predefinita. |
| Truststore (TS) | Nessuno |
| TruststorePassword (TSP) | Nessuno |
| UseCurrentSchema (UCS) | 1 (abilitato) |
| UseDefaultEncryptionOptions | 1 (abilitato) |
| ValidateServerCertificate (VSC) | 1 (abilitato) |
| WireProtocolMode (WPM) | 2 |
Teradata
È possibile specificare solo le coppie chiave-valore con una voce nelle opzioni di configurazione del connettore disponibili nelle opzioni di configurazione del connettore Teradata.
API MongoDB per Cosmos DB
È possibile specificare solo le coppie chiave-valore con una voce nelle opzioni di configurazione del driver riportate di seguito.
| Nome della chiave | Predefinito | Obbligatoria | Descrizione |
|---|---|---|---|
| DefaultStringColumnLength | 255 | No | Numero massimo di caratteri che possono essere contenuti nelle colonne STRING. Il valore massimo che è possibile impostare per questa opzione è 2147483647. |
| noCursorTimeout | False | No | Questa opzione specifica se il driver consente la scadenza dei cursori attivi nel server di origine dati. Se FALSE, il server di origine dati verifica il timeout dei cursori inattivi dopo il periodo di inattività soglia impostato nel server. Se è impostata su TRUE, il driver impedisce al server di origine dati di timeout il timeout dei cursori inattive e c'è il rischio che se il driver deve uscire o perdere la connessione al server in modo imprevisto, il cursore rimarrà aperto nel server per un periodo illimitato. È possibile modificare la soglia per i timeout del cursore inattivi nel server MongoDB, vedere https://docs.mongodb.com/v3.0/reference/parameters/ per informazioni dettagliate. |
| SamplingLimit | 100 | No | Numero massimo di record che il driver può campionare per generare una definizione di schema temporanea. Quando questa opzione è impostata su 0, il driver campiona ogni documento nel database. Assicurarsi di configurare il driver per campionare tutti i dati necessari. I documenti non campionati non vengono inclusi nella definizione dello schema e di conseguenza non diventano disponibili nelle applicazioni ODBC. In genere, il campionamento di un numero elevato di documenti comporta una definizione dello schema più accurata e in grado di rappresentare tutti i dati nel database. Tuttavia, il processo di campionamento potrebbe richiedere più tempo del previsto quando vengono campionati molti documenti, soprattutto se il database contiene strutture di dati complesse e nidificate. |
| SamplingStrategy | Inoltra | No | Questa opzione specifica il modo in cui il driver campiona i dati durante la generazione di una definizione di schema temporanea. Avanti: il driver campiona i dati a partire dal primo record nel database, quindi campiona il record successivo e così via. Indietro: il driver campiona i dati a partire dall'ultimo record nel database, quindi campiona il record precedente e così via. Casuale: il driver seleziona i record di esempio dall'origine dati in modo casuale fino al raggiungimento di SamplingLimit. |
| SSL | Cancella (0) | No | Questa opzione specifica se il driver usa SSL per connettersi al server. Abilitato (1): il driver usa SSL per connettersi al server. Disabilitato (0): il driver non usa SSL per connettersi al server. |
ODBC generico
Le CONNECTION_OPTIONS valide che è possibile specificare per l'origine dati esterna ODBC generica PolyBase sono specifiche del driver. Se non si usa un provider ODBC fornito da Microsoft (vedere la sezione precedente), consultare la documentazione del driver per le coppie chiave-valore valide.
Esistono alcune coppie chiave-valore valide in PolyBase disponibili per tutti i driver ODBC generici. Le chiavi seguenti sono state aggiunte a SQL Server 2019 in CU5.
| Chiave | Valori possibili | Descrizione |
|---|---|---|
| PolyBaseOdbcSupportsRowCount | true, FALSE | Indica se il driver supporta o meno la funzione SQLRowCount chiamata nelle funzioni del catalogo ODBC. L'impostazione predefinita è false. Ad esempio: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'. |
| PolyBaseOdbcSupportsMetadataIdAttributes | true, FALSE | Indica se il driver supporta o meno l'impostazione dell'attributo dell'istruzione METADATA_ID. L'impostazione predefinita è false. Ad esempio: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'. |
| PolyBaseOdbcSupportsBindOffset | true, FALSE | Indica se il driver supporta gli offset di associazione per l'associazione a livello di riga dei set di risultati. In caso contrario, usare l'associazione di colonne. L'impostazione predefinita è false. Ad esempio: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'. |
| PolyBaseQoTopPushdownSyntax | TOP, LIMIT | Contiene informazioni che specificano come eseguire il push dell'operatore TOP nel back-end. Il valore predefinito è una stringa vuota, che indica una mancanza di supporto per il pushdown TOP. Se l'utente specifica TOP, top {0} viene usato come stringa di formato. Se l'utente specifica LIMIT, limit {0} viene usato come stringa di formato. Questa implementazione è specifica del driver, consultare la documentazione esterna sull'origine dati e/o sul driver. Ad esempio: CONNECTION_OPTIONS= PolyBaseQoTopPushdownSyntax=TOP'. |