Condividi tramite


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_pair rappresenta 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:

Parole chiave e opzioni delle stringhe di connessione per i provider di database ODBC Microsoft:

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'.

Passaggi successivi