Udostępnij za pośrednictwem

TWORZENIE ZEWNĘTRZNEGO ŹRÓDŁA DANYCH (Transact-SQL) CONNECTION_OPTIONS

Dotyczy: SQL Server 2016 (13.x) i nowszych Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Ten artykuł zawiera dodatkowe szczegóły dotyczące CONNECTION_OPTIONS w zależności od dostawcy. Argument CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS może się różnić w zależności od zewnętrznego dostawcy danych.

Argument CONNECTION_OPTIONSCREATE EXTERNAL DATA SOURCE został wprowadzony po raz pierwszy w programie SQL Server 2019 (15.x). Ten dokument dotyczy programu SQL Server 2019 (15.x) dla systemów Windows i Linux, a także klastrów danych big data programu SQL Server 2019.

  • Jest key_value_pair to słowo kluczowe i wartość dla określonej opcji połączenia.
  • Aby użyć wielu opcji połączenia, oddziel je średnikami.
  • Możliwe pary wartości klucza są specyficzne dla sterownika.

W pozostałej części tego artykułu znajdują się opcje połączenia specyficzne dla dostawcy.

Zewnętrzne źródło danych programu SQL Server

Można określić tylko pary klucz-wartość, które mają wpis w nazwach DSN i parametry połączenia słowa kluczowe i atrybuty w kolumnie SŁOWO kluczowe DSN /Parametry połączenia . Na przykład SQL_ATTR_TXN_ISOLATION słowo kluczowe nie jest obsługiwane, ponieważ jest to atrybut ustawiony przy użyciu parametrów połączenia SQLSetConnectAttr.

Uwaga / Notatka

Technologia PolyBase obsługuje tylko sterownik Microsoft ODBC w wersji 17 i 18. Aby uzyskać więcej informacji, zobacz Zmienianie wersji sterownika programu SQL Server dla technologii PolyBase.

Słowa kluczowe i opcje parametrów połączenia dla dostawców microsoft OLE DB:

Słowa kluczowe i opcje parametrów połączenia dla dostawców bazy danych ODBC firmy Microsoft:

Wyrocznia

Można określić tylko pary klucz-wartość, które mają wpis w tabeli protokołu przewodowego Oracle w następujący sposób:

Atrybut (krótka nazwa) Wartość domyślna
AccountingInfo (AI) Żaden
Akcja (ACT) Żaden
Alternatywne serwery (ASRV) Żaden
AllowedOpenSSLVersions (AOV) najnowszy
ApplicationName (AN) Żaden
ApplicationUsingThreads (AUT) 1 (włączone)
ArraySize (AS) 60000
AuthenticationMethod (AM) 1 (Szyfruj hasło)
BatchFailureReturnsError (BFRE) 0 (wyłączone)
BindParamsAsUnicode (BPAU) 0 (wyłączone)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) -1
BulkLoadBatchSize (BLBS) 1024
BulkLoadFieldDelimiter (BLFD) Żaden
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Żaden
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (włączone)
CatalogOptions (CO) 0 (wyłączone)
ClientHostName (CHN) Żaden
ClientID (CID) Żaden
ClientUser (CU) Żaden
ConnectionReset (CR) 0 (wyłączone)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Żaden
CredentialsWalletPassword (CWPWD) Żaden
CredentialsWalletPath (CWPATH) Żaden
CryptoProtocolVersion (CPV) TLSv1.2,TLSv1.1,TLSv1
CryptoLibName (CLN) Pusty ciąg
DataIntegrityLevel (DIL) 1 (Zaakceptowane)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Żaden
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (wyłączone)
Opis (n/a) Żaden
EditionName (EN) Żaden
EnableBulkLoad (EBL) 0 (wyłączone)
EnableDescribeParam (EDP) 0 (wyłączone)
EnableNcharSupport (ENS) (przestarzałe). Żaden
EnableScrollableCursors (ESC) 1 (włączone)
EnableServerResultCache (ESRC) 0 (wyłączone)
EnableStaticCursorsForLongData (ESCLD) 0 (wyłączone)
EnableTimestampwithTimezone (ETWT) (przestarzałe) Żaden
EncryptionLevel (EL) 1 (Zaakceptowane)
EncryptionMethod (EM) 0 (bez szyfrowania)
EncryptionTypes (ET) Nie określono metod szyfrowania. Sterownik wysyła listę wszystkich metod szyfrowania do serwera Oracle.
Tryb failoverGranularity (FG) 0 (niepodzielne)
Tryb failoverMode (FM) 0 (połączenie)
Tryb failoverPołączenie (FP) 0 (wyłączone)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (wyłączone)
GSSClient (GSSC) ojczysty
Nazwa hosta (HOST) Żaden
HostNameInCertificate (HNIC) Żaden
IANAAppCodePage (tylko IACP) (tylko systemy UNIX i Linux) 4 (ISO 8559-1 Latin-1)
Personifikuj użytkownika (IU) Żaden
InitializationString (IS) Żaden
KeepAlive (KA) 0 (wyłączone)
KeyPassword (KP) Żaden
Magazyn kluczy (KS) Żaden
KeystorePassword (KSP) Żaden
LDAPDistinguishedName (LDAPDN) Żaden
LoadBalanceTimeout (LBT) 0
Równoważenie obciążenia (LB) 0 (wyłączone)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (pusty ciąg)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
Identyfikator logowania (UID) Żaden
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Moduł (MOD) Żaden
Hasło (PWD) Żaden
Buforowanie (PULA) 0 (wyłączone)
PortNumber (PORT) Żaden
PRNGSeedFile (tylko PSF) (tylko systemy UNIX i Linux) /dev/random
PRNGSeedSource (tylko systemy UNIX i Linux) 0 (plik)
ProcedureRetResults (PRR) 0 (wyłączone)
Identyfikator programu (PID) Żaden
ProxyHost (PXHN) Pusty ciąg
Tryb proxy (PXM) 0 (BRAK)
ProxyPassword (PXPW) Pusty ciąg
ProxyPort (PXPT) 0
ProxyUser (PXU) Pusty ciąg
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (Ignoruj błędy)
ReportRecycleBin (RRB) 0 (wyłączone)
SDUSize (SDU) 16384
ServerName (SRVR) Żaden
ServerType (ST) 0 (wartość domyślna serwera)
ServiceName (SN) Żaden. Jeśli dla opcji SID, Service Name lub TNSNames nie określono żadnej wartości, sterownik próbuje domyślnie nawiązać połączenie z identyfikatorem SID ORCL.
SID (SID) Żaden. Jeśli dla opcji SID, Service Name lub TNSNames nie określono żadnej wartości, sterownik próbuje domyślnie nawiązać połączenie z identyfikatorem SID ORCL.
SSLLibName (SLN) Pusty ciąg
SupportBinaryXML (SBX) 0 (wyłączone)
TimestampEscapeMapping (TEM) 0 (Oracle Version Specific)
TNSNamesFile (TNF) Żaden. Jeśli dla opcji SID, Service Name lub TNSNames nie określono żadnej wartości, sterownik próbuje domyślnie nawiązać połączenie z identyfikatorem SID ORCL.
Magazyn zaufania (TS) Żaden
TruststorePassword (TSP) Żaden
UseCurrentSchema (UCS) 1 (włączone)
UseDefaultEncryptionOptions 1 (włączone)
ValidateServerCertificate (VSC) 1 (włączone)
WireProtocolMode (WPM) 2

Teradata

Można określić tylko pary klucz-wartość, które mają wpis w opcjach konfiguracji łącznika podanych w opcjach konfiguracji łącznika Teradata Connector.

Interfejs API bazy danych MongoDB dla usługi Cosmos DB

Można określić tylko pary klucz-wartość, które mają wpis w następujących opcjach konfiguracji sterownika.

Nazwa klucza Wartość domyślna Wymagane Opis
DefaultStringColumnLength 255 Nie. Maksymalna liczba znaków, które mogą być zawarte w STRING kolumnach. Maksymalna wartość, którą można ustawić dla tej opcji, jest 2147483647.
noCursorTimeout Nieprawda Nie. Ta opcja określa, czy sterownik zezwala na wygaśnięcie aktywnych kursorów na serwerze źródła danych. Gdy FALSEserwer źródła danych przekroczy limit czasu bezczynności kursorów po okresie braku aktywności progu ustawionym na serwerze. W przypadku ustawienia TRUEparametru sterownik uniemożliwia serwerowi źródła danych limit czasu bezczynności kursorów i istnieje ryzyko, że jeśli sterownik powinien zamknąć lub nieoczekiwanie utracić połączenie z serwerem, kursor pozostaje otwarty na serwerze na czas nieokreślony. Aby uzyskać szczegółowe informacje, możesz dostosować próg limitu czasu bezczynności kursora na serwerze MongoDB. Aby uzyskać szczegółowe informacje, zobacz Parametry serwera bazy Self-Managed danych MongoDB .
SamplingLimit 100 Nie. Maksymalna liczba rekordów, które może próbkować sterownik w celu wygenerowania tymczasowej definicji schematu. Jeśli ta opcja jest ustawiona na 0, sterownik próbkuje każdy dokument w bazie danych.

Pamiętaj, aby skonfigurować sterownik, aby próbkować wszystkie niezbędne dane. Dokumenty, które nie są próbkowane, nie są uwzględniane w definicji schematu, a tym samym nie stają się dostępne w aplikacjach ODBC.

Zazwyczaj próbkowanie dużej liczby dokumentów powoduje, że definicja schematu jest dokładniejsza i lepiej w stanie reprezentować wszystkie dane w bazie danych. Jednak proces próbkowania może trwać dłużej niż oczekiwano, gdy wiele dokumentów jest próbkowanych, zwłaszcza jeśli baza danych zawiera złożone, zagnieżdżone struktury danych.
SamplingStrategy Naprzód Nie. Ta opcja określa sposób próbkowania danych sterownika podczas generowania tymczasowej definicji schematu.

Prześlij dalej: przykładowe dane sterownika rozpoczynające się od pierwszego rekordu w bazie danych, a następnie próbki następnego rekordu itd.

Wstecz: sterownik przykładuje dane zaczynające się od ostatniego rekordu w bazie danych, a następnie próbkuje poprzedni rekord itd.

Losowe: sterownik wybiera przykładowe rekordy ze źródła danych losowo do momentu osiągnięcia wartości SamplingLimit.
SSL Wyczyść (0) Nie. Ta opcja określa, czy sterownik używa protokołu SSL do nawiązania połączenia z serwerem.

Włączone (1): sterownik używa protokołu SSL do nawiązywania połączenia z serwerem.
Wyłączone (0): sterownik nie używa protokołu SSL do nawiązywania połączenia z serwerem.

Ogólne ODBC

Prawidłowe CONNECTION_OPTIONS , że można określić dla ogólnego zewnętrznego źródła danych ODBC polyBase są specyficzne dla sterownika. Jeśli nie korzystasz z dostawcy ODBC dostarczonego przez firmę Microsoft (zobacz poprzednią sekcję), zapoznaj się z dokumentacją sterownika, aby zapoznać się z prawidłowymi parami klucz-wartość.

Istnieje kilka prawidłowych par klucz-wartość w technologii PolyBase, które są dostępne dla wszystkich ogólnych sterowników ODBC. Następujące klucze zostały dodane do programu SQL Server 2019 w aktualizacji CU5.

Klawisz Możliwe wartości Opis
PolyBaseOdbcSupportsRowCount TRUE, FALSE Wskazuje, czy sterownik obsługuje funkcję SQLRowCount wywoływaną w funkcjach wykazu ODBC. Wartość domyślna to „false”. Na przykład: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes TRUE, FALSE Wskazuje, czy sterownik obsługuje ustawianie atrybutu instrukcji METADATA_ID . Wartość domyślna to „false”. Na przykład: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset TRUE, FALSE Wskazuje, czy sterownik obsługuje przesunięcia powiązania dla powiązania wierszy zestawów wyników. Jeśli nie, użyj powiązania kolumny. Wartość domyślna to „false”. Na przykład: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT Zawiera informacje określające sposób wypychania TOP operatora do zaplecza. Wartość domyślna to pusty ciąg wskazujący brak obsługi TOP wypychania. Jeśli użytkownik określa TOPwartość , top {0} jest używany jako ciąg formatu. Jeśli użytkownik określa LIMITwartość , limit {0} jest używany jako ciąg formatu. Ta implementacja jest specyficzna dla sterownika, zapoznaj się z dokumentacją zewnętrznego źródła danych i/lub sterownika. Na przykład: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'.

Treści powiązane