Freigeben über


CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS

Dieser Artikel enthält zusätzliche Details zu CONNECTION_OPTIONS je nach Anbieter. Das CREATE EXTERNAL DATA SOURCE CONNECTION_OPTIONS-Argument kann je nach externem Datenanbieter unterschiedlich sein.

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 restliche Artikel enthält anbieterspezifische Verbindungsoptionen.

Externer SQL Server-Datenquelle

Sie können nur die Schlüssel-Wert-Paare angeben, für die ein Eintrag unter DSN- und Verbindungszeichenfolgen-Schlüsselwörter und Attribute in der Spalte DSN/Verbindungszeichenfolgen-Schlüsselwort vorhanden ist. Das SQL_ATTR_TXN_ISOLATION-Schlüsselwort wird beispielsweise nicht unterstützt, da es sich um einen Attributsatz handelt, der SQLSetConnectAttr verwendet, und nicht in der Verbindungszeichenfolge enthalten ist.

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

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

Oracle

Sie können nur die Schlüssel-Wert-Paare angeben, für die ein Eintrag in der Oracle-Wire-Protokolltabelle vorhanden ist, der wie folgt aussieht:

Attribut (Kurzname) Standard
AccountingInfo (AI) Keine
Aktion (ACT) Keine
AlternateServers (ASRV) Keine
AllowedOpenSSLVersions (AOV) latest
ApplicationName (AN) Keine
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) Keine
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Keine
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (Aktiviert)
CatalogOptions (CO) 0 (Deaktiviert)
ClientHostName (CHN) Keine
ClientID (CID) Keine
ClientUser (CU) Keine
ConnectionReset (CR) 0 (Deaktiviert)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Keine
CredentialsWalletPassword (CWPWD) Keine
CredentialsWalletPath (CWPATH) Keine
CryptoProtocolVersion (CPV) TLSv1.2,TLSv1.1,TLSv1
CryptoLibName (CLN) leere Zeichenfolge
DataIntegrityLevel (DIL) 1 (Akzeptiert)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Keine
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (Deaktiviert)
Description (n/a) Keine
EditionName (EN) Keine
EnableBulkLoad (EBL) 0 (Deaktiviert)
EnableDescribeParam (EDP) 0 (Deaktiviert)
EnableNcharSupport (ENS) (veraltet.) Keine
EnableScrollableCursors (ESC) 1 (Aktiviert)
EnableServerResultCache (ESRC) 0 (Deaktiviert)
EnableStaticCursorsForLongData (ESCLD) 0 (Deaktiviert)
EnableTimestampwithTimezone (ETWT) (veraltet) Keine
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 atomisch)
FailoverMode (FM) 0 (Verbindung)
FailoverPreconnect (FP) 0 (Deaktiviert)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (Deaktiviert)
GSSClient (GSSC) Systemeigen
HostName (HOST) Keine
HostNameInCertificate (HNIC) Keine
IANAAppCodePage (IACP) (nur UNIX und Linux) 4 (ISO 8559-1 Latin-1)
ImpersonateUser (IU) Keine
InitializationString (IS) Keine
KeepAlive (KA) 0 (Deaktiviert)
KeyPassword (KP) Keine
Keystore (KS) Keine
KeystorePassword (KSP) Keine
LDAPDistinguishedName (LDAPDN) Keine
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (Deaktiviert)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (Leere Zeichenfolge)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
LogonID (UID) Keine
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Module (MOD) Keine
Password (PWD) Keine
Pooling (POOL) 0 (Deaktiviert)
PortNumber (PORT) Keine
PRNGSeedFile (PSF) (nur UNIX und Linux) /dev/random
PRNGSeedSource (PSS) (nur UNIX und Linux) 0 (Datei)
ProcedureRetResults (PRR) 0 (Deaktiviert)
ProgramID (PID) Keine
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) Keine
ServerType (ST) 0 (Serverstandard)
ServiceName (SN) Keine. Wenn kein Wert für die Option SID, Dienstname oder TNSNames angegeben ist, versucht der Treiber standardmäßig, eine Verbindung mit der ORCL-SID herzustellen.
SID (SID) Keine. Wenn kein Wert für die Option SID, Dienstname oder TNSNames 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-versionsspezifisch)
TNSNamesFile (TNF) Keine. Wenn kein Wert für die Option SID, Dienstname oder TNSNames angegeben ist, versucht der Treiber standardmäßig, eine Verbindung mit der ORCL-SID herzustellen.
Truststore (TS) Keine
TruststorePassword (TSP) Keine
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, für ein Eintrag in den Connector-Konfigurationsoptionen, die in Konfigurationsoptionen für Teradata Connector beschrieben werden, vorhanden ist.

MongoDB-API für Cosmos DB

Sie können nur die Schlüssel-Wert-Paare angeben, die über einen Eintrag in den nachfolgenden Treiberkonfigurationsoptionen verfügen.

Schlüsselname Standard Erforderlich Beschreibung
DefaultStringColumnLength 255 Nein Die maximale Anzahl von Zeichen, die in STRING-Spalten enthalten sein kann. Der Maximalwert, den Sie für diese Option festlegen können, beträgt 2.147.483.647.
noCursorTimeout False Nein Diese Option gibt an, ob der Treiber zulässt, dass aktive Cursor auf dem Datenquellenserver aufgrund eines Timeouts ungültig werden. Wenn FALSCH angegeben wird, deaktiviert der Datenquellenserver inaktive Cursor nach dem Schwellenwert für den Inaktivitätszeitraum, der auf dem Server festgelegt ist, aufgrund eines Timeout. Wenn sie auf TRUE festgelegt ist, verhindert der Treiber, dass der Datenquellenserver inaktive Cursor zeitlich begrenzt, und es besteht die Gefahr, dass der Cursor auf dem Server auf unbestimmte Zeit geöffnet bleibt, wenn der Treiber unerwartet beendet wird oder die Verbindung zum Server getrennt wird. Sie können den Timeout-Schwellenwert für inaktive Cursor auf dem MongoDB-Server anpassen, ausführliche Informationen finden Sie unter https://docs.mongodb.com/v3.0/reference/parameters/.
SamplingLimit 100 Nein Die maximale Anzahl von Datensätzen, die der Treiber abfragen kann, um eine temporäre Schemadefinition zu generieren. Wenn diese Option auf „0“ festgelegt ist, wird jedes Dokument in der Datenbank vom Treiber abgefragt.

Stellen Sie sicher, dass der Treiber alle erforderlichen Daten erfasst. Nicht abgefragte Dokumente werden nicht in die Schemadefinition aufgenommen und sind daher nicht in ODBC-Anwendungen verfügbar.

In der Regel führt die Stichprobenentnahme aus einer großen Anzahl von Dokumenten zu einer Schemadefinition, die genauer und besser in der Lage ist, alle Daten in der Datenbank darzustellen. Der Stichprobenentnahme kann jedoch länger dauern als erwartet, wenn viele Dokumente abgefragt werden, insbesondere wenn die Datenbank komplexe, geschachtelte Datenstrukturen enthält.
SamplingStrategy Forward No Diese Option gibt an, wie die Treiber Datenstichroben beim Generieren einer temporären Schemadefinition erfasst.

Forward: Der Treiber fragt Stichprobendaten aus dem ersten Datensatz der Datenbank ab, dann aus dem nächsten Datensatz und so weiter.
Backward: Der Treiber beginnt mit dem Erfassen von Stichprobendaten beim letzten Datensatz der Datenbank, dann werden Daten aus dem vorhergehenden Datensatz abgefragt und so weiter.
Random: Der Treiber wählt Datensätze für die Stichprobe aus der Datenquelle zufällig aus, bis der SamplingLimit-Wert erreicht ist.
SSL Clear (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 SSL nicht zum Herstellen einer Verbindung mit dem Server.

Generisches ODBC

Die gültigen CONNECTION_OPTIONS-Werte, die Sie für generische externe ODBC-Datenquellen für PolyBase angeben können, sind treiberspezifisch. Wenn kein von Microsoft bereitgestellter ODBC-Anbieter (siehe vorheriger Abschnitt) verwendet wird, finden Sie in der Dokumentation des Treibers 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 zu 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 in 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-Anweisungsattributes unterstützt. Der Standardwert ist "false". Beispiel: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset true, FALSE Gibt an, ob der Treiber Bindungsoffsets für die 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 zum Back-End gepusht wird. Der Standardwert ist eine leere Zeichenfolge, die angibt, dass kein TOP-Pushdown unterstützt wird. Wenn der Benutzer TOP angibt, wird top {0} als Formatzeichenfolge verwendet. Wenn der Benutzer LIMIT angibt, wird limit {0} als Formatzeichenfolge verwendet. Diese Implementierung ist treiberspezifisch. Weitere Informationen finden Sie in der Dokumentation der externen Datenquelle und/oder der Treiberdokumentation. Beispiel: CONNECTION_OPTIONS= PolyBaseQoTopPushdownSyntax=TOP'.

Nächste Schritte