Bagikan melalui

CONNECTION_OPTIONS BUAT SUMBER DATA EKSTERNAL (Transact-SQL)

Berlaku untuk: SQL Server 2016 (13.x) dan yang lebih baru Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics AnalyticsPlatform System (PDW)

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

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

  • 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.

Sumber data eksternal SQL Server

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 DSN / Koneksi . Misalnya, SQL_ATTR_TXN_ISOLATION kata kunci tidak didukung, karena itu adalah set atribut menggunakan SQLSetConnectAttr, bukan dalam string koneksi.

Nota

PolyBase hanya mendukung Microsoft ODBC Driver versi 17 dan 18. Untuk informasi selengkapnya, lihat Mengubah versi driver SQL Server untuk PolyBase.

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) Bawaan
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
AktifkanBulkLoad (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-Atom)
FailoverMode (FM) 0 (Koneksi)
FailoverPreconnect (FP) 0 (Dinonaktifkan)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (Dinonaktifkan)
GSSClient (GSSC) pribumi
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 (Oracle Version Specific)
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)
MemvalidasiSertifikatServer (VSC) 1 (Diaktifkan)
WireProtocolMode (WPM) 2

Teradata

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

MongoDB API untuk Cosmos DB

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

Nama kunci Bawaan Diperlukan Deskripsi
DefaultStringColumnLength 255 Tidak. Jumlah maksimum karakter yang dapat dimuat dalam STRING kolom. Nilai maksimum yang dapat Anda atur untuk opsi ini adalah 2147483647.
noCursorTimeout Tidak benar Tidak. Opsi ini menentukan apakah driver memungkinkan kursor aktif pada server sumber data kedaluwarsa. Ketika FALSE, server sumber data akan kehabisan kursor diam 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 tiba-tiba, kursor tetap terbuka di server tanpa batas waktu. Anda dapat menyesuaikan ambang batas untuk batas waktu kursor menganggur di server MongoDB, lihat Parameter Server MongoDB untuk Penyebaran Self-Managed 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 akan 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 dengan demikian tidak tersedia dalam aplikasi ODBC.

Biasanya, pengambilan sampel sejumlah besar dokumen menghasilkan definisi skema yang lebih akurat dan lebih dapat 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 Teruskan Tidak. Opsi ini menentukan bagaimana driver mengambil sampel data saat menghasilkan 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 sampel rekaman 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

Valid CONNECTION_OPTIONS bahwa Anda dapat menentukan untuk PolyBase Generic ODBC External Data Source adalah driver spesifik. 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 mungkin Deskripsi
PolyBaseOdbcSupportsRowCount TRUE, FALSE Menunjukkan apakah driver mendukung fungsi SQLRowCount yang dipanggil pada fungsi katalog ODBC atau tidak. Secara default adalah false. Misalnya: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes TRUE, FALSE Menunjukkan apakah driver mendukung pengaturan METADATA_ID atribut pernyataan atau tidak. Secara default adalah false. Misalnya: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset TRUE, FALSE Menunjukkan apakah driver mendukung offset ikatan untuk pengikatan baris yang bijaksana dari kumpulan hasil. Jika tidak, gunakan pengikatan kolom. Secara default adalah false. Misalnya: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT Berisi informasi yang menentukan cara menurunkan TOP operator ke backend. Defaultnya adalah string kosong, menunjukkan kurangnya dukungan untuk TOP pushdown. Jika pengguna menentukan TOP, top {0} digunakan sebagai string format. Jika pengguna menentukan LIMIT, limit {0} digunakan sebagai string format. Implementasi ini khusus driver, lihat dokumentasi sumber data dan/atau driver eksternal. Misalnya: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'.

Konten terkait