Dela via

SKAPA EXTERN DATAKÄLLA (Transact-SQL) CONNECTION_OPTIONS

gäller för: SQL Server 2016 (13.x) och senare Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Den här artikeln innehåller ytterligare information om CONNECTION_OPTIONS beroende på providern. Argumentet SKAPA EXTERN DATAKÄLLACONNECTION_OPTIONS kan variera beroende på den externa dataprovidern.

Argumentet CONNECTION_OPTIONS för CREATE EXTERNAL DATA SOURCE introducerades först i SQL Server 2019 (15.x). Det här dokumentet gäller för SQL Server 2019 (15.x) för Windows och Linux samt SQL Server 2019 Big Data Clusters.

  • key_value_pair är nyckelordet och värdet för ett specifikt anslutningsalternativ.
  • Om du vill använda flera anslutningsalternativ separerar du dem med ett semikolon.
  • Möjliga nyckelvärdepar är specifika för drivrutinen.

Resten av den här artikeln innehåller leverantörsspecifika anslutningsalternativ.

EXTERN SQL Server-datakälla

Du kan bara ange nyckel/värde-par som har en post i DSN och Nyckelord och attribut för anslutningssträngar under kolumnen DSN/Anslutningssträng nyckelord . Nyckelordet SQL_ATTR_TXN_ISOLATION stöds till exempel inte eftersom det är en attributuppsättning med SQLSetConnectAttr, inte i anslutningssträngen.

Anmärkning

PolyBase stöder endast Microsoft ODBC Driver version 17 och 18. Mer information finns i Ändra SQL Server-drivrutinsversionen för PolyBase.

Nyckelord och alternativ för anslutningssträngar för Microsoft OLE DB-leverantörer:

Nyckelord och alternativ för anslutningssträngar för Microsoft ODBC DB-leverantörer:

Orakel

Du kan bara ange nyckel/värde-par som har en post i Oracle Wire Protocol-tabellen enligt följande:

Attribut (kort namn) Förinställning
AccountingInfo (AI) Ingen
Åtgärd (ACT) Ingen
AlternateServers (ASRV) Ingen
AllowedOpenSSLVersions (AOV) senaste
ApplicationName (AN) Ingen
ApplicationUsingThreads (AUT) 1 (aktiverad)
ArraySize (AS) 60000
AuthenticationMethod (AM) 1 (Kryptera lösenord)
BatchFailureReturnsError (BFRE) 0 (inaktiverad)
BindParamsAsUnicode (BPAU) 0 (inaktiverad)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) -1
BulkLoadBatchSize (BLBS) 1024
BulkLoadFieldDelimiter (BLFD) Ingen
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Ingen
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (aktiverad)
CatalogOptions (CO) 0 (inaktiverad)
ClientHostName (CHN) Ingen
ClientID (CID) Ingen
ClientUser (CU) Ingen
ConnectionReset (CR) 0 (inaktiverad)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Ingen
CredentialsWalletPassword (CWPWD) Ingen
CredentialsWalletPath (CWPATH) Ingen
CryptoProtocolVersion (CPV) TLSv1.2,TLSv1.1,TLSv1
CryptoLibName (CLN) Tom sträng
DataIntegrityLevel (DIL) 1 (accepterad)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Ingen
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (inaktiverad)
Beskrivning (n/a) Ingen
EditionName (EN) Ingen
EnableBulkLoad (EBL) 0 (inaktiverad)
EnableDescribeParam (EDP) 0 (inaktiverad)
EnableNcharSupport (ENS) (inaktuell.) Ingen
EnableScrollableCursors (ESC) 1 (aktiverad)
EnableServerResultCache (ESRC) 0 (inaktiverad)
EnableStaticCursorsForLongData (ESCLD) 0 (inaktiverad)
EnableTimestampwithTimezone (ETWT) (inaktuell) Ingen
EncryptionLevel (EL) 1 (accepterad)
EncryptionMethod (EM) 0 (ingen kryptering)
EncryptionTypes (ET) Inga krypteringsmetoder har angetts. Drivrutinen skickar en lista över alla krypteringsmetoder till Oracle-servern.
FailoverGranularity (FG) 0 (icke-atomisk)
FailoverMode (FM) 0 (anslutning)
FailoverPreconnect (FP) 0 (inaktiverad)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (inaktiverad)
GSSClient (GSSC) infödd
HostName (VÄRD) Ingen
HostNameInCertificate (HNIC) Ingen
IANAAppCodePage (IACP) (endast UNIX och Linux) 4 (ISO 8559-1 Latin-1)
ImpersonateUser (IU) Ingen
InitializationString (IS) Ingen
KeepAlive (KA) 0 (inaktiverad)
KeyPassword (KP) Ingen
Nyckelarkiv (KS) Ingen
KeystorePassword (KSP) Ingen
LDAPDistinguishedName (LDAPDN) Ingen
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (inaktiverad)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (tom sträng)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
Inloggnings-ID (UID) Ingen
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Modul (MOD) Ingen
Lösenord (PWD) Ingen
Poolning (POOL) 0 (inaktiverad)
PortNumber (PORT) Ingen
PRNGSeedFile (PSF) (endast UNIX och Linux) /dev/random
PRNGSeedSource (PSS) (endast UNIX och Linux) 0 (fil)
ProcedureRetResults (PRR) 0 (inaktiverad)
ProgramID (PID) Ingen
ProxyHost (PXHN) Tom sträng
ProxyMode (PXM) 0 (INGEN)
ProxyPassword (PXPW) Tom sträng
ProxyPort (PXPT) 0
ProxyUser (PXU) Tom sträng
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (Ignorera fel)
ReportRecycleBin (RRB) 0 (inaktiverad)
SDUSize (SDU) 16384
ServerName (SRVR) Ingen
ServerType (ST) 0 (standardserver)
ServiceName (SN) Ingen. Om inget värde anges för antingen sid-, tjänstnamns- eller TNSNames-alternativet försöker drivrutinen ansluta till ORCL-SID som standard.
SID (SID) Ingen. Om inget värde anges för antingen sid-, tjänstnamns- eller TNSNames-alternativet försöker drivrutinen ansluta till ORCL-SID som standard.
SSLLibName (SLN) Tom sträng
SupportBinaryXML (SBX) 0 (inaktiverad)
TimestampEscapeMapping (TEM) 0 (oracleversionsspecifik)
TNSNamesFile (TNF) Ingen. Om inget värde anges för antingen sid-, tjänstnamns- eller TNSNames-alternativet försöker drivrutinen ansluta till ORCL-SID som standard.
Truststore (TS) Ingen
TruststorePassword (TSP) Ingen
UseCurrentSchema (UCS) 1 (aktiverad)
UseDefaultEncryptionOptions 1 (aktiverad)
ValidateServerCertificate (VSC) 1 (aktiverad)
WireProtocolMode (WPM) 2

Teradata

Du kan bara ange nyckel/värde-par som har en post i konfigurationsalternativen för anslutningsappen som anges i konfigurationsalternativen för Teradata-anslutningsappen.

MongoDB API för Cosmos DB

Du kan bara ange nyckel/värde-par som har en post i följande alternativ för drivrutinskonfiguration.

Nyckelnamn Förinställning Krävs Beskrivning
DefaultStringColumnLength 255 Nej Det maximala antalet tecken som kan ingå i STRING kolumner. Det högsta värde som du kan ange för det här alternativet är 2147483647.
noCursorTimeout Falsk Nej Det här alternativet anger om drivrutinen tillåter att aktiva markörer på datakällservern upphör att gälla. När FALSEöverskrider datakällservern inaktiva markörer efter den tröskelvärdesperiod för inaktivitet som angetts på servern. När den är inställd TRUEpå hindrar drivrutinen datakällservern från att ta tid på inaktiva markörer, och det finns en risk att markören förblir öppen på servern på obestämd tid om drivrutinen skulle avsluta eller förlora anslutningen till servern oväntat. Du kan justera tröskelvärdet för tidsgränser för inaktiv markör på MongoDB-servern. Mer information finns i MongoDB-serverparametrar för en Self-Managed distribution .
SamplingLimit 100 Nej Det maximala antalet poster som drivrutinen kan sampla för att generera en tillfällig schemadefinition. När det här alternativet är inställt på 0 tar drivrutinen exempel på varje dokument i databasen.

Se till att konfigurera drivrutinen så att alla nödvändiga data samplas. Dokument som inte samplas tas inte med i schemadefinitionen och blir därför inte tillgängliga i ODBC-program.

Sampling av ett stort antal dokument resulterar vanligtvis i en schemadefinition som är mer exakt och bättre kan representera alla data i databasen. Samplingsprocessen kan dock ta längre tid än förväntat när många dokument samplas, särskilt om databasen innehåller komplexa, kapslade datastrukturer.
SamplingStrategy Framåt Nej Det här alternativet anger hur drivrutinen tar exempel på data när en tillfällig schemadefinition genereras.

Vidarebefordra: Drivrutinen tar exempel på data från den första posten i databasen och tar sedan exempel på nästa post och så vidare.

Bakåt: Drivrutinen tar exempel på data från den sista posten i databasen och tar sedan exempel på föregående post och så vidare.

Slumpmässigt: Drivrutinen väljer exempelposter från datakällan slumpmässigt tills SamplingLimit har nåtts.
SSL Rensa (0) Nej Det här alternativet anger om drivrutinen använder SSL för att ansluta till servern.

Aktiverad (1): Drivrutinen använder SSL för att ansluta till servern.
Inaktiverad (0): Drivrutinen använder inte SSL för att ansluta till servern.

ODBC (allmän)

Giltigt CONNECTION_OPTIONS som du kan ange för PolyBase Generic ODBC Extern datakälla är drivrutinsspecifika. Om du inte använder en ODBC-leverantör från Microsoft (se föregående avsnitt) läser du drivrutinsdokumentationen för giltiga nyckel/värde-par.

Det finns några giltiga nyckel/värde-par i PolyBase som är tillgängliga för alla allmänna ODBC-drivrutiner. Följande nycklar lades till i SQL Server 2019 i CU5.

Nyckel Möjliga värden Beskrivning
PolyBaseOdbcSupportsRowCount TRUE, FALSE Anger om drivrutinen stöder SQLRowCount-funktionen som anropas på ODBC-katalogfunktioner. Standardvärdet är false. Till exempel: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes TRUE, FALSE Anger om drivrutinen stöder inställning av instruktionsattributet METADATA_ID . Standardvärdet är false. Till exempel: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset TRUE, FALSE Anger om drivrutinen stöder bindningsförskjutningar för radvis bindning av resultatuppsättningar. Om inte använder du kolumnbindning. Standardvärdet är false. Till exempel: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT Innehåller information som anger hur du push-överför operatorn TOP till serverdelen. Standardvärdet är en tom sträng som indikerar bristande stöd för TOP pushdown. Om användaren anger TOPanvänds , top {0} som formatsträng. Om användaren anger LIMITanvänds , limit {0} som formatsträng. Den här implementeringen är drivrutinsspecifik, läs dokumentationen om den externa datakällan och/eller drivrutinen. Till exempel: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'.

Relaterat innehåll