Bagikan melalui


CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS

Artikel ini menyediakan detail tambahan untuk CONNECTION_OPTIONS tergantung pada penyedia. Argumen CREATE EXTERNAL DATA SOURCE CONNECTION_OPTIONS dapat bervariasi tergantung pada penyedia data eksternal.

Argumen CONNECTION_OPTIONS untuk CREATE EXTERNAL DATA SOURCE pertama kali diperkenalkan pada SQL Server 2019 (15.x). Dokumen ini berlaku untuk SQL Server 2019 (15.x) untuk Windows dan Linux, serta SQL Server 2019 Kluster Big Data.

  • key_value_pair adalah kata kunci dan nilai untuk opsi koneksi tertentu.
  • Untuk menggunakan beberapa opsi koneksi, pisahkan dengan titik koma.
  • Pasangan nilai kunci yang mungkin khusus untuk driver.

Sisa artikel ini berisi opsi koneksi khusus vendor.

SQL Server sumber data eksternal

Anda hanya dapat menentukan pasangan kunci-nilai yang memiliki entri di DSN dan Kata Kunci dan Atribut String Koneksi di bawah kolom Kata Kunci String Koneksi/ DSN . Misalnya, kata kunci SQL_ATTR_TXN_ISOLATION tidak didukung, karena itu adalah set atribut menggunakan SQLSetConnectAttr, bukan dalam string koneksi.

Kata kunci dan opsi string koneksi untuk penyedia Microsoft OLE DB:

Kata kunci dan opsi string koneksi untuk penyedia Microsoft ODBC DB:

Oracle

Anda hanya dapat menentukan pasangan kunci-nilai yang memiliki entri dalam tabel protokol kawat Oracle sebagai berikut:

Atribut (Nama Pendek) Default
AccountingInfo (AI) Tidak ada
Tindakan (ACT) Tidak ada
AlternateServers (ASRV) Tidak ada
AllowedOpenSSLVersions (AOV) terbaru
ApplicationName (AN) Tidak ada
ApplicationUsingThreads (AUT) 1 (Diaktifkan)
ArraySize (AS) 60000
AuthenticationMethod (AM) 1 (Enkripsi Kata Sandi)
BatchFailureReturnsError (BFRE) 0 (Dinonaktifkan)
BindParamsAsUnicode (BPAU) 0 (Dinonaktifkan)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) -1
BulkLoadBatchSize (BLBS) 1024
BulkLoadFieldDelimiter (BLFD) Tidak ada
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Tidak ada
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (Diaktifkan)
CatalogOptions (CO) 0 (Dinonaktifkan)
ClientHostName (CHN) Tidak ada
ClientID (CID) Tidak ada
ClientUser (CU) Tidak ada
ConnectionReset (CR) 0 (Dinonaktifkan)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Tidak ada
CredentialsWalletPassword (CWPWD) Tidak ada
CredentialsWalletPath (CWPATH) Tidak ada
CryptoProtocolVersion (CPV) TLSv1.2,TLSv1.1,TLSv1
CryptoLibName (CLN) String kosong
DataIntegrityLevel (DIL) 1 (Diterima)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Tidak ada
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (Dinonaktifkan)
Deskripsi (n/a) Tidak ada
EditionName (EN) Tidak ada
EnableBulkLoad (EBL) 0 (Dinonaktifkan)
EnableDescribeParam (EDP) 0 (Dinonaktifkan)
EnableNcharSupport (ENS) (tidak digunakan lagi.) Tidak ada
EnableScrollableCursors (ESC) 1 (Diaktifkan)
EnableServerResultCache (ESRC) 0 (Dinonaktifkan)
EnableStaticCursorsForLongData (ESCLD) 0 (Dinonaktifkan)
EnableTimestampwithTimezone (ETWT) (tidak digunakan lagi) Tidak ada
EncryptionLevel (EL) 1 (Diterima)
EncryptionMethod (EM) 0 (Tanpa Enkripsi)
EncryptionTypes (ET) Tidak ada metode enkripsi yang ditentukan. Driver mengirimkan daftar semua metode enkripsi ke server Oracle.
FailoverGranularity (FG) 0 (Non-Atomik)
FailoverMode (FM) 0 (Koneksi)
FailoverPreconnect (FP) 0 (Dinonaktifkan)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (Dinonaktifkan)
GSSClient (GSSC) Asli
HostName (HOST) Tidak ada
HostNameInCertificate (HNIC) Tidak ada
IANAAppCodePage (IACP) (hanya UNIX dan Linux) 4 (ISO 8559-1 Latin-1)
ImpersonateUser (IU) Tidak ada
InitializationString (IS) Tidak ada
KeepAlive (KA) 0 (Dinonaktifkan)
KeyPassword (KP) Tidak ada
Keystore (KS) Tidak ada
KeystorePassword (KSP) Tidak ada
LDAPDistinguishedName (LDAPDN) Tidak ada
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (Dinonaktifkan)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (String Kosong)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
LogonID (UID) Tidak ada
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Modul (MOD) Tidak ada
Kata sandi (PWD) Tidak ada
Pooling (POOL) 0 (Dinonaktifkan)
PortNumber (PORT) Tidak ada
PRNGSeedFile (PSF) (hanya UNIX dan Linux) /dev/random
PRNGSeedSource (PSS) (hanya UNIX dan Linux) 0 (File)
ProcedureRetResults (PRR) 0 (Dinonaktifkan)
ProgramID (PID) Tidak ada
ProxyHost (PXHN) String kosong
ProxyMode (PXM) 0 (TIDAK ADA)
ProxyPassword (PXPW) String kosong
ProxyPort (PXPT) 0
ProxyUser (PXU) String kosong
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (Abaikan Kesalahan)
ReportRecycleBin (RRB) 0 (Dinonaktifkan)
SDUSize (SDU) 16384
ServerName (SRVR) Tidak ada
ServerType (ST) 0 (Default Server)
ServiceName (SN) Tidak ada. Jika tidak ada nilai yang ditentukan untuk opsi SID, Nama Layanan, atau TNSNames, driver mencoba menyambungkan ke ORCL SID secara default.
SID (SID) Tidak ada. Jika tidak ada nilai yang ditentukan untuk opsi SID, Nama Layanan, atau TNSNames, driver mencoba menyambungkan ke ORCL SID secara default.
SSLLibName (SLN) String kosong
SupportBinaryXML (SBX) 0 (Dinonaktifkan)
TimestampEscapeMapping (TEM) 0 (Spesifik Versi Oracle)
TNSNamesFile (TNF) Tidak ada. Jika tidak ada nilai yang ditentukan untuk opsi SID, Nama Layanan, atau TNSNames, driver mencoba menyambungkan ke ORCL SID secara default.
Truststore (TS) Tidak ada
TruststorePassword (TSP) Tidak ada
UseCurrentSchema (UCS) 1 (Diaktifkan)
UseDefaultEncryptionOptions 1 (Diaktifkan)
ValidasiServerCertificate (VSC) 1 (Diaktifkan)
WireProtocolMode (WPM) 2

Teradata

Anda hanya dapat menentukan pasangan kunci-nilai yang memiliki entri dalam opsi konfigurasi konektor yang disediakan di Opsi Konfigurasi Konektor Teradata.

MongoDB API untuk Cosmos DB

Anda hanya dapat menentukan pasangan kunci-nilai yang memiliki entri dalam opsi konfigurasi driver di bawah ini.

Nama kunci Default Diperlukan Deskripsi
DefaultStringColumnLength 255 Tidak Jumlah maksimum karakter yang dapat dimuat dalam kolom STRING. Nilai maksimum yang dapat Anda tetapkan untuk opsi ini adalah 2147483647.
noCursorTimeout Salah Tidak Opsi ini menentukan apakah driver memungkinkan kursor aktif pada server sumber data kedaluwarsa. Ketika FALSE, server sumber data akan kehabisan waktu kursor menganggur setelah periode tidak aktif ambang yang ditetapkan di server. Ketika diatur ke TRUE, driver mencegah server sumber data kehabisan waktu kursor diam, dan ada risiko bahwa jika driver harus keluar atau kehilangan koneksi ke server secara tak terduga, kursor akan tetap terbuka di server tanpa batas waktu. Anda dapat menyesuaikan ambang batas untuk batas waktu kursor menganggur di server MongoDB, lihat https://docs.mongodb.com/v3.0/reference/parameters/ untuk detailnya.
SamplingLimit 100 Tidak Jumlah maksimum rekaman yang dapat diambil sampel driver untuk menghasilkan definisi skema sementara. Ketika opsi ini diatur ke 0, driver mengambil sampel setiap dokumen dalam database.

Pastikan untuk mengonfigurasi driver untuk mengambil sampel semua data yang diperlukan. Dokumen yang tidak diambil sampelnya tidak disertakan dalam definisi skema, dan akibatnya tidak tersedia dalam aplikasi ODBC.

Biasanya, pengambilan sampel sejumlah besar dokumen menghasilkan definisi skema yang lebih akurat dan lebih mampu mewakili semua data dalam database. Namun, proses pengambilan sampel mungkin memakan waktu lebih lama dari yang diharapkan ketika banyak dokumen diambil sampelnya, terutama jika database berisi struktur data berlapis yang kompleks.
SamplingStrategy Maju Tidak Opsi ini menentukan bagaimana driver mengambil sampel data saat membuat definisi skema sementara.

Teruskan: Driver mengambil sampel data mulai dari rekaman pertama dalam database, lalu mengambil sampel rekaman berikutnya, dan sebagainya.
Mundur: Driver mengambil sampel data mulai dari rekaman terakhir dalam database, lalu mengambil sampel rekaman sebelumnya, dan sebagainya.
Acak: Driver memilih rekaman sampel dari sumber data secara acak hingga SamplingLimit tercapai.
SSL Bersihkan (0) Tidak Opsi ini menentukan apakah driver menggunakan SSL untuk menyambungkan ke server. Diaktifkan (1): Driver menggunakan SSL untuk menyambungkan ke server. Dinonaktifkan (0): Driver tidak menggunakan SSL untuk menyambungkan ke server.

ODBC Generik

CONNECTION_OPTIONS valid yang dapat Anda tentukan untuk PolyBase Generic ODBC External Data Source bersifat spesifik untuk driver. Jika tidak menggunakan penyedia ODBC yang disediakan Microsoft (lihat bagian sebelumnya), lihat dokumentasi driver untuk pasangan kunci-nilai yang valid.

Ada beberapa pasangan kunci-nilai yang valid di PolyBase yang tersedia untuk semua driver ODBC generik. Kunci berikut ditambahkan ke SQL Server 2019 di CU5.

Kunci Nilai yang memungkinkan Deskripsi
PolyBaseOdbcSupportsRowCount true, FALSE Menunjukkan apakah driver mendukung fungsi SQLRowCount yang dipanggil pada fungsi katalog ODBC atau tidak. Defaultnya adalah false. Misalnya: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes true, FALSE Menunjukkan apakah driver mendukung pengaturan atribut pernyataan METADATA_ID atau tidak. Defaultnya adalah false. Misalnya: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset true, FALSE Menunjukkan apakah driver mendukung offset ikatan untuk pengikatan set hasil secara baris atau tidak. Jika tidak, gunakan pengikatan kolom. Defaultnya adalah false. Misalnya: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax ATAS, BATAS Berisi informasi yang menentukan cara menurunkan operator TOP ke backend. Defaultnya adalah string kosong, menunjukkan kurangnya dukungan untuk pushdown TOP. Jika pengguna menentukan TOP, top {0} digunakan sebagai string format. Jika pengguna menentukan LIMIT, limit {0} digunakan sebagai string format. Implementasi ini khusus untuk driver, konsultasikan dengan sumber data eksternal dan/atau dokumentasi driver. Contoh: CONNECTION_OPTIONS= PolyBaseQoTopPushdownSyntax=TOP'.

Langkah berikutnya