Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
SQL Server 2016 (13.x) e versioni successive Database SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di strumenti analitici (PDW)
Questo articolo fornisce dettagli aggiuntivi a CONNECTION_OPTIONS seconda del provider. L'argomento CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS può variare a seconda del provider di dati esterno.
L'argomento CONNECTION_OPTIONSper CREATE EXTERNAL DATA SOURCE è stato introdotto per la prima volta in SQL Server 2019 (15.x). Questo documento si applica a SQL Server 2019 (15.x) per Windows e Linux, nonché ai cluster Big Data di SQL Server 2019.
-
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 chiave-valore sono specifiche del driver.
La parte restante di questo articolo contiene opzioni di connessione specifiche del fornitore.
Origine dati esterna di SQL Server
È possibile specificare solo le coppie chiave-valore con una voce in DSN e Parole chiave stringa di connessione e attributi nella colonna DSN/Stringa di connessione Parola chiave . Ad esempio, la SQL_ATTR_TXN_ISOLATION parola chiave non è supportata, perché si tratta di un set di attributi che usa SQLSetConnectAttr, non nella stringa di connessione.
Annotazioni
PolyBase supporta solo Microsoft ODBC Driver versione 17 e 18. Per altre informazioni, vedere Modificare la versione del driver di SQL Server per PolyBase.
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 della stringa di connessione con OLE DB Driver per SQL Server
SQL Native Client (deprecato) Uso delle parole chiave della stringa di connessione con SQL Server Native Client
Parole chiave e opzioni delle stringhe di connessione per i provider di database ODBC Microsoft:
- Driver MICROSOFT ODBC per SQL Server: parole chiave e attributi delle stringhe di connessione e DSN
- Parole chiave della stringa di connessione del driver ODBC (deprecato) di SQL Native Client
Oracolo
È possibile specificare solo le coppie chiave-valore con una voce nella tabella del protocollo di collegamento Oracle come indicato di seguito:
| Attributo (nome breve) | Impostazione predefinita |
|---|---|
| AccountingInfo (IA) | Nessuno |
| Azione (ACT) | Nessuno |
| AlternateServers (ASRV) | Nessuno |
| AllowedOpenSSLVersions (AOV) | più recente |
| ApplicationName (AN) | Nessuno |
| ApplicationUsingThreads (AUT) | 1 (abilitato) |
| ArraySize (AS) | 60000 |
| AuthenticationMethod (AM) | 1 (Crittografa password) |
| BatchFailureReturnsError (BFRE) | 0 (Disattivato) |
| BindParamsAsUnicode (BPAU) | 0 (Disattivato) |
| 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 (Disattivato) |
| ClientHostName (CHN) | Nessuno |
| ClientID (CID) | Nessuno |
| ClientUser (CU) | Nessuno |
| ConnectionReset (CR) | 0 (Disattivato) |
| 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 (Disattivato) |
| Descrizione (n/a) | Nessuno |
| EditionName (EN) | Nessuno |
| EnableBulkLoad (EBL) | 0 (Disattivato) |
| EnableDescribeParam (EDP) | 0 (Disattivato) |
| EnableNcharSupport (ENS) (deprecato). | Nessuno |
| EnableScrollableCursors (ESC) | 1 (abilitato) |
| EnableServerResultCache (ESRC) | 0 (Disattivato) |
| EnableStaticCursorsForLongData (ESCLD) | 0 (Disattivato) |
| 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 (Disattivato) |
| FetchTSWTZasTimestamp (FTSWTZAT) | 0 (Disattivato) |
| GSSClient (GSSC) | nativo |
| 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 (Disattivato) |
| KeyPassword (KPI) | Nessuno |
| Keystore (KS) | Nessuno |
| KeystorePassword (KSP) | Nessuno |
| LDAPDistinguishedName (LDAPDN) | Nessuno |
| LoadBalanceTimeout (LBT) | 0 |
| LoadBalancing (LB) | 0 (Disattivato) |
| 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 (Disattivato) |
| PortNumber (PORT) | Nessuno |
| PRNGSeedFile (PSF) (solo UNIX e Linux) | /dev/random |
| PRNGSeedSource (PSS) (solo UNIX e Linux) | 0 (file) |
| ProcedureRetResults (PRR) | 0 (Disattivato) |
| 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 (Disattivato) |
| 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 (Disattivato) |
| TimestampEscapeMapping (TEM) | 0 (specifico 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 seguenti.
| Nome chiave | Impostazione predefinita | Obbligatorio | Descrizione |
|---|---|---|---|
DefaultStringColumnLength |
255 | NO | Numero massimo di caratteri che possono essere contenuti nelle STRING colonne. Il valore massimo che è possibile impostare per questa opzione è 2147483647. |
noCursorTimeout |
Falso | NO | Questa opzione specifica se il driver consente la scadenza dei cursori attivi nel server di origine dati. Quando FALSE, il server di origine dati verifica il timeout dei cursori inattivi dopo il periodo di inattività soglia impostato nel server. Se impostato su TRUE, il driver impedisce al server di origine dati di timeout il timeout dei cursori inattive e si rischia che se il driver deve uscire o perdere la connessione al server in modo imprevisto, il cursore rimane aperto nel server per un periodo illimitato. È possibile modificare la soglia per i timeout del cursore inattivi nel server MongoDB. Per informazioni dettagliate, vedere Parametri del server MongoDB per una distribuzione Self-Managed . |
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 esegue l'esempio di 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 pertanto 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 meglio 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 annidate. |
SamplingStrategy |
Avanti | NO | Questa opzione specifica il modo in cui il driver campiona i dati durante la generazione di una definizione di schema temporanea. Inoltra: 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 a quando non viene raggiunto CampionamentoLimit. |
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
Valido CONNECTION_OPTIONS che è possibile specificare per l'origine dati esterna ODBC generica PolyBase sono specifici 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. Il valore predefinito è false. Ad esempio: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'. |
PolyBaseOdbcSupportsMetadataIdAttributes |
TRUE, FALSE |
Indica se il driver supporta o meno l'impostazione dell'attributo di METADATA_ID istruzione. Il valore predefinito è false. Ad esempio: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'. |
PolyBaseOdbcSupportsBindOffset |
TRUE, FALSE |
Indica se il driver supporta o meno gli offset di associazione per l'associazione a livello di riga dei set di risultati. In caso contrario, usare l'associazione di colonne. Il valore predefinito è 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 la mancanza di supporto per TOP il pushdown. 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 l'origine dati esterna e/o la documentazione del driver. Ad esempio: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'. |