Freigeben über

CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS

Gilt für: SQL Server 2016 (13.x) und höher Azure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Dieser Artikel enthält zusätzliche Details je CONNECTION_OPTIONS nach Anbieter. Das ARGUMENT CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS kann je nach externem Datenanbieter variieren.

Das CONNECTION_OPTIONS Argument für CREATE EXTERNAL DATA SOURCE wurde erstmals in SQL Server 2019 (15.x) eingeführt. Dieses Dokument gilt für SQL Server 2019 (15.x) für Windows und Linux sowie SQL Server 2019 Big Data Cluster.

  • key_value_pair ist das Schlüsselwort sowie der Wert für eine bestimmte Verbindungsoption.
  • Wenn Sie mehrere Verbindungsoptionen verwenden möchten, trennen Sie diese durch ein Semikolon.
  • Mögliche Schlüsselwertpaare sind spezifisch für den Treiber.

Der rest dieses Artikels enthält anbieterspezifische Verbindungsoptionen.

Externe SQL Server-Datenquelle

Sie können nur die Schlüsselwertpaare angeben, die einen Eintrag in DSN- und Verbindungszeichenfolgenstichwörtern und -attributen unter der Spalte DSN/Connection String Keyword enthalten. Beispielsweise wird das SQL_ATTR_TXN_ISOLATION Schlüsselwort nicht unterstützt, da es sich hierbei um ein Attribut handelt, das mit SQLSetConnectAttr festgelegt wurde, nicht in der Verbindungszeichenfolge.

Hinweis

PolyBase unterstützt nur microsoft ODBC-Treiber, Version 17 und 18. Weitere Informationen finden Sie unter Ändern der SQL Server-Treiberversion für PolyBase.

Schlüsselwörter und Optionen für Verbindungszeichenfolgen für Microsoft OLE DB-Anbieter:

Schlüsselwörter und Optionen für Verbindungszeichenfolgen für Microsoft ODBC DB-Anbieter:

Orakel

Sie können nur die Schlüssel-Wert-Paare angeben, die einen Eintrag in der Oracle-Drahtprotokolltabelle wie folgt enthalten:

Attribut (Kurzname) Standard
AccountingInfo (AI) Nichts
Aktion (ACT) Nichts
AlternateServers (ASRV) Nichts
AllowedOpenSSLVersions (AOV) neueste
ApplicationName (AN) Nichts
ApplicationUsingThreads (AUT) 1 (Aktiviert)
ArraySize (AS) 60000
AuthenticationMethod (AM) 1 (Kennwort verschlüsseln)
BatchFailureReturnsError (BFRE) 0 (Deaktiviert)
BindParamsAsUnicode (BPAU) 0 (Deaktiviert)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) –1
BulkLoadBatchSize (BLBS) 1024
BulkLoadFieldDelimiter (BLFD) Nichts
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Nichts
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (Aktiviert)
CatalogOptions (CO) 0 (Deaktiviert)
ClientHostName (CHN) Nichts
ClientID (CID) Nichts
ClientUser (CU) Nichts
ConnectionReset (CR) 0 (Deaktiviert)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Nichts
CredentialsWalletPassword (CWPWD) Nichts
CredentialsWalletPath (CWPATH) Nichts
CryptoProtocolVersion (CPV) TLSv1.2,TLSv1.1,TLSv1
CryptoLibName (CLN) Leere Zeichenfolge
DataIntegrityLevel (DIL) 1 (akzeptiert)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Nichts
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (Deaktiviert)
Beschreibung (n/a) Nichts
EditionName (EN) Nichts
EnableBulkLoad (EBL) 0 (Deaktiviert)
EnableDescribeParam (EDP) 0 (Deaktiviert)
EnableNcharSupport (ENS) (veraltet.) Nichts
EnableScrollableCursors (ESC) 1 (Aktiviert)
EnableServerResultCache (ESRC) 0 (Deaktiviert)
EnableStaticCursorsForLongData (ESCLD) 0 (Deaktiviert)
EnableTimestampwithTimezone (ETWT) (veraltet) Nichts
EncryptionLevel (EL) 1 (akzeptiert)
EncryptionMethod (EM) 0 (keine Verschlüsselung)
EncryptionTypes (ET) Es werden keine Verschlüsselungsmethoden angegeben. Der Treiber sendet eine Liste aller Verschlüsselungsmethoden an den Oracle-Server.
FailoverGranularity (FG) 0 (Nicht-Atom)
FailoverMode (FM) 0 (Verbindung)
FailoverPreconnect (FP) 0 (Deaktiviert)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (Deaktiviert)
GSSClient (GSSC) Systemeigen
HostName (HOST) Nichts
HostNameInCertificate (HNIC) Nichts
IANAAppCodePage (IACP) (nur UNIX und Linux) 4 (ISO 8559-1 Lateinisch-1)
ImpersonateUser (IU) Nichts
InitializationString (IS) Nichts
KeepAlive (KA) 0 (Deaktiviert)
KeyPassword (KP) Nichts
Keystore (KS) Nichts
KeystorePassword (KSP) Nichts
LDAPDistinguishedName (LDAPDN) Nichts
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (Deaktiviert)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (leere Zeichenfolge)
LockTimeout (LTO) –1
LoginTimeout (LT) 15
LogonID (UID) Nichts
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Modul (MOD) Nichts
Kennwort (PWD) Nichts
Pooling (POOL) 0 (Deaktiviert)
PortNumber (PORT) Nichts
PRNGSeedFile (PSF) (nur UNIX und Linux) /dev/random
PRNGSeedSource (PSS) (nur UNIX und Linux) 0 (Datei)
ProcedureRetResults (PRR) 0 (Deaktiviert)
ProgramID (PID) Nichts
ProxyHost (PXHN) Leere Zeichenfolge
ProxyMode (PXM) 0 (NONE)
ProxyPassword (PXPW) Leere Zeichenfolge
ProxyPort (PXPT) 0
ProxyUser (PXU) Leere Zeichenfolge
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (Fehler ignorieren)
ReportRecycleBin (RRB) 0 (Deaktiviert)
SDUSize (SDU) 16384
ServerName (SRVR) Nichts
ServerType (ST) 0 (Serverstandard)
ServiceName (SN) Keiner. Wenn für die Option SID, Dienstname oder TNSNames kein Wert angegeben ist, versucht der Treiber standardmäßig, eine Verbindung mit der ORCL-SID herzustellen.
SID (SID) Keiner. Wenn für die Option SID, Dienstname oder TNSNames kein Wert angegeben ist, versucht der Treiber standardmäßig, eine Verbindung mit der ORCL-SID herzustellen.
SSLLibName (SLN) Leere Zeichenfolge
SupportBinaryXML (SBX) 0 (Deaktiviert)
TimestampEscapeMapping (TEM) 0 (Oracle Version Specific)
TNSNamesFile (TNF) Keiner. Wenn für die Option SID, Dienstname oder TNSNames kein Wert angegeben ist, versucht der Treiber standardmäßig, eine Verbindung mit der ORCL-SID herzustellen.
Truststore (TS) Nichts
TruststorePassword (TSP) Nichts
UseCurrentSchema (UCS) 1 (Aktiviert)
UseDefaultEncryptionOptions 1 (Aktiviert)
ValidateServerCertificate (VSC) 1 (Aktiviert)
WireProtocolMode (WPM) 2

Teradata

Sie können nur die Schlüssel-Wert-Paare angeben, die einen Eintrag in den Konfigurationsoptionen des Connectors enthalten, die in den Teradata Connector-Konfigurationsoptionen angegeben sind.

MongoDB-API für Cosmos DB

Sie können nur die Schlüssel-Wert-Paare angeben, die einen Eintrag in den folgenden Treiberkonfigurationsoptionen enthalten.

Schlüsselname Standard Erforderlich BESCHREIBUNG
DefaultStringColumnLength 255 Nein Die maximale Anzahl von Zeichen, die in STRING Spalten enthalten sein können. Der Maximalwert, den Sie für diese Option festlegen können, ist 2147483647.
noCursorTimeout Falsch Nein Diese Option gibt an, ob der Treiber aktive Cursor auf dem Datenquellenserver ablaufen lässt. Wenn FALSEder Datenquellenserver Leerlaufcursor nach dem auf dem Server festgelegten Schwellenwertinaktivitätszeitraum timeout. Wenn dieser auf festgelegt ist TRUE, verhindert der Treiber, dass der Datenquellenserver Leerlaufcursor nicht mehr anzeigt, und es besteht ein Risiko, dass der Cursor auf dem Server unbegrenzt geöffnet bleibt, wenn der Treiber die Verbindung mit dem Server unerwartet beenden oder verlieren soll. Sie können den Schwellenwert für Leerlaufcursortimeouts auf dem MongoDB-Server anpassen, siehe MongoDB Server Parameters for a Self-Managed Deployment for details.
SamplingLimit 100 Nein Die maximale Anzahl von Datensätzen, die vom Treiber zum Generieren einer temporären Schemadefinition verwendet werden können. Wenn diese Option auf "0" festgelegt ist, wird jedes Dokument in der Datenbank von den Treibern stichprobeniert.

Stellen Sie sicher, dass der Treiber so konfiguriert wird, dass alle erforderlichen Daten für sie beispielt werden. Dokumente, die nicht in der Schemadefinition enthalten sind, werden nicht in die Schemadefinition einbezogen und sind daher nicht in ODBC-Anwendungen verfügbar.

In der Regel führt das Sampling einer großen Anzahl von Dokumenten zu einer Schemadefinition, die genauer und besser in der Lage ist, alle Daten in der Datenbank darzustellen. Der Samplingprozess kann jedoch länger dauern als erwartet, wenn viele Dokumente in einer Stichprobe erfasst werden, insbesondere, wenn die Datenbank komplexe, geschachtelte Datenstrukturen enthält.
SamplingStrategy Vorwärts Nein Diese Option gibt an, wie die Treiberdaten beim Generieren einer temporären Schemadefinition beispielt.

Forward: Die Treiberbeispiele daten beginnend mit dem ersten Datensatz in der Datenbank, und dann wird der nächste Datensatz und so weiter.

Rückwärts: Die Treiberbeispiele daten beginnend mit dem letzten Datensatz in der Datenbank, und dann wird der vorherige Datensatz und so weiter beispielt.

Zufällig: Der Treiber wählt Stichprobendatensätze aus der Datenquelle zufällig aus, bis das SamplingLimit erreicht ist.
SSL Löschen (0) Nein Diese Option gibt an, ob der Treiber SSL zum Herstellen einer Verbindung mit dem Server verwendet.

Aktiviert (1): Der Treiber verwendet SSL, um eine Verbindung mit dem Server herzustellen.
Deaktiviert (0): Der Treiber verwendet nicht SSL, um eine Verbindung mit dem Server herzustellen.

Generisches ODBC

Gültig CONNECTION_OPTIONS , dass Sie für polyBase Generic ODBC External Data Source angeben können, sind treiberspezifisch. Wenn Sie keinen von Microsoft bereitgestellten ODBC-Anbieter verwenden (siehe vorherigen Abschnitt), lesen Sie die Dokumentation des Treibers für gültige Schlüssel-Wert-Paare.

Es gibt einige gültige Schlüssel-Wert-Paare in PolyBase, die für alle generischen ODBC-Treiber verfügbar sind. Die folgenden Schlüssel wurden sql Server 2019 in CU5 hinzugefügt.

Schlüssel Mögliche Werte BESCHREIBUNG
PolyBaseOdbcSupportsRowCount TRUE, FALSE Gibt an, ob der Treiber die SQLRowCount-Funktion unterstützt, die für ODBC-Katalogfunktionen aufgerufen wird. Der Standardwert ist "false". Beispiel: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes TRUE, FALSE Gibt an, ob der Treiber das Festlegen des METADATA_ID Anweisungsattributs unterstützt. Der Standardwert ist "false". Beispiel: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset TRUE, FALSE Gibt an, ob der Treiber Offsets für zeilenweise Bindung von Resultsets unterstützt. Wenn nicht, verwenden Sie die Spaltenbindung. Der Standardwert ist "false". Beispiel: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT Enthält Informationen, die angeben, wie der TOP Operator an das Back-End gedrückt wird. Der Standardwert ist eine leere Zeichenfolge, die angibt, dass keine Unterstützung für TOP Pushdowns vorhanden ist. Wenn der Benutzer angibt TOP, top {0} wird er als Formatzeichenfolge verwendet. Wenn der Benutzer angibt LIMIT, limit {0} wird er als Formatzeichenfolge verwendet. Diese Implementierung ist treiberspezifisch, konsultieren Sie die dokumentation zu externen Datenquellen und/oder Treibern. Beispiel: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'.

Verwandte Inhalte