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_pairist 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:
- Microsoft OLE DB Driver for SQL Server: Verwenden von Verbindungszeichenfolgen-Schlüsselwörtern mit dem OLE DB-Treiber für SQL Server
- SQL Native Client (veraltet) Native Client OLE DB (SQLNCLI) Verwenden von Verbindungszeichenfolgen-Schlüsselwörtern
Verbindungszeichenfolgen-Schlüsselwörter und Optionen für Microsoft ODBC DB-Anbieter:
- Microsoft ODBC Driver for SQL Server: DSN- und Verbindungszeichenfolgen-Schlüsselwörter und Attribute
- SQL Native Client (veraltet) ODBC-Treiber-Verbindungszeichenfolgen-Schlüsselwörter
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'. |