Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk:
SQL Server 2016 (13.x) dan versi yang lebih baru Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)
Artikel ini menyediakan detail tambahan untuk CONNECTION_OPTIONS bergantung pada penyedia. Argumennya 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_pairadalah 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.
Oracle
Anda hanya dapat menentukan pasangan kunci-nilai yang memiliki entri dalam tabel protokol kawat Oracle sebagai berikut:
| Atribut (Nama Pendek) | Bawaan |
|---|---|
| InfoAccountingInfo (AI) | Tidak ada |
| Tindakan (ACT) | Tidak ada |
| Server Alternatif (ASRV) | Tidak ada |
| Diizinkan OpenSSLVersions (AOV) | terbaru |
| Nama Aplikasi (AN) | Tidak ada |
| ApplicationUsingThreads (AUT) | 1 (Diaktifkan) |
| Ukuran Array (AS) | 60000 |
| Metode Autentikasi (AM) | 1 (Enkripsi Kata Sandi) |
| BatchFailureReturnsError (BFRE) | 0 (Dinonaktifkan) |
| BindParamsAsUnicode (BPAU) | 0 (Dinonaktifkan) |
| BulkBinaryThreshold (BBT) | 32 |
| BulkCharacterThreshold (BCT) | -1 |
| BulkLoadBatchSize (BLBS) | 1024 |
| Pembatas BulkLoadFieldDelimiter (BLFD) | Tidak ada |
| BulkLoadOptions (BLO) | 0 |
| Pembatas RecordBeban Massal (BLRD) | Tidak ada |
| CachedCursorLimit (CCL) | 32 |
| CachedDescriptionLimit (CDL) | 0 |
| KatalogTermasukSinonim (CIS) | 1 (Diaktifkan) |
| Opsi Katalog (CO) | 0 (Dinonaktifkan) |
| ClientHostName (CHN) | Tidak ada |
| ID Klien (CID) | Tidak ada |
| ClientUser (CU) | Tidak ada |
| ConnectionReset (CR) | 0 (Dinonaktifkan) |
| ConnectionRetryCount (CRC) | 0 |
| ConnectionRetryDelay (CRD) | 3 |
| KredensialDompetEntri (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 |
| Nama Edisi (ID) | Tidak ada |
| AktifkanBulkLoad (EBL) | 0 (Dinonaktifkan) |
| AktifkanDescribeParam (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 |
| Tingkat Enkripsi (EL) | 1 (Diterima) |
| Metode Enkripsi (EM) | 0 (Tanpa Enkripsi) |
| Enkripsi (ET) | Tidak ada metode enkripsi yang ditentukan. Driver mengirimkan daftar semua metode enkripsi ke server Oracle. |
| FailoverGranularity (FG) | 0 (Non-Atom) |
| Mode Failover (FM) | 0 (Koneksi) |
| FailoverPreconnect (FP) | 0 (Dinonaktifkan) |
| AmbilTSWTZasStempel Waktu (FTSWTZAT) | 0 (Dinonaktifkan) |
| GSSClient (GSSC) | pribumi |
| Nama Host (HOST) | Tidak ada |
| HostNameInCertificate (HNIC) | Tidak ada |
| IANAAppCodePage (IACP) (hanya UNIX dan Linux) | 4 (ISO 8559-1 Latin-1) |
| Menyamar sebagai Pengguna (IU) | Tidak ada |
| InisialisasiString (IS) | Tidak ada |
| Tetap Hidup (KA) | 0 (Dinonaktifkan) |
| Kata Sandi Kunci (KP) | Tidak ada |
| Penyimpanan Kunci (KS) | Tidak ada |
| KeystorePassword (KSP) | Tidak ada |
| LDAPDistinguishedName (LDAPDN) | Tidak ada |
| Batas Waktu Keseimbangan Beban (LBT) | 0 |
| Penyeimbangan Beban (LB) | 0 (Dinonaktifkan) |
| LOBPrefetchSize (LPS) | 4000 |
| LocalTimezoneOffset (LTZO) | "" (String Kosong) |
| LockTimeout (LTO) | -1 |
| LoginTimeout (LT) | 15 |
| ID Masuk (UID) | Tidak ada |
| MaxPoolSize (MXPS) | 100 |
| Ukuran MinPoolSize (MNPS) | 0 |
| Modul (MOD) | Tidak ada |
| Kata sandi (PWD) | Tidak ada |
| Pooling (POOL) | 0 (Dinonaktifkan) |
| Nomor Port (PORT) | Tidak ada |
| PRNGSeedFile (PSF) (hanya UNIX dan Linux) | /dev/random |
| PRNGSeedSource (PSS) (hanya UNIX dan Linux) | 0 (Berkas) |
| ProsedurHasil Ulang (PRR) | 0 (Dinonaktifkan) |
| ProgramID (PID) | Tidak ada |
| Host Proksi (PXHN) | String kosong |
| Mode Proksi (PXM) | 0 (TIDAK ADA) |
| Kata Sandi Proksi (PXPW) | String kosong |
| Proxy Port (PXPT) | 0 |
| Pengguna Proksi (PXU) | String kosong |
| Waktu Tunggu Kueri (QT) | 0 |
| ReportCodepageConversionErrors (RCCE) | 0 (Abaikan Kesalahan) |
| LaporanDaur Ulang Bin (RRB) | 0 (Dinonaktifkan) |
| SDUSize (SDU) | 16384 |
| Nama Server (SRVR) | Tidak ada |
| Tipe Server (ST) | 0 (Default Server) |
| Nama Layanan (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. |
| SSLLibNama (SLN) | String kosong |
| DukunganBinerXML (SBX) | 0 (Dinonaktifkan) |
| TimestampEscapeMapping (TEM) | 0 (Khusus 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. |
| Toko Kepercayaan (TS) | Tidak ada |
| Kata Sandi Truststore (TSP) | Tidak ada |
| UseCurrentSchema (UCS) | 1 (Diaktifkan) |
| UseDefaultEncryptionOptions | 1 (Diaktifkan) |
| MemvalidasiSertifikatServer (VSC) | 1 (Diaktifkan) |
| Mode Protokol Kawat (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'. |