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_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.
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:
- Driver Microsoft OLE DB untuk SQL Server: Menggunakan Kata Kunci String Koneksi dengan Driver OLE DB untuk SQL Server
- SQL Native Client (tidak digunakan lagi) Native Client OLE DB (SQLNCLI) Menggunakan kata kunci string koneksi
Kata kunci dan opsi string koneksi untuk penyedia Microsoft ODBC DB:
- Driver Microsoft ODBC untuk SQL Server: DSN dan Kata Kunci dan Atribut String Koneksi
- SQL Native Client (tidak digunakan lagi) kata kunci string koneksi Driver ODBC
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
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk