CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS
本文會根據提供者提供CONNECTION_OPTIONS的其他詳細資料。 CREATE EXTERNAL DATA SOURCE CONNECTION_OPTIONS 引數可能會根據外部資料提供者而有所不同。
CREATE EXTERNAL DATA SOURCE的CONNECTION_OPTIONS引數最初是在 2019 SQL Server (15.x) 引進。 本檔適用于適用于 Windows 和 Linux SQL Server 2019 (15.x) ，以及 SQL Server 2019 巨量資料叢集。
-
key_value_pair是特定連線選項的關鍵字和值。 - 若要使用多個連線選項，請以分號進行分隔。
- 可能的鍵值組專屬於驅動程式。
本文的其餘部分包含廠商特定的連線選項。
SQL Server外部資料源
您只能在DSN / Connection String 關鍵字資料行下指定具有DSN 和連接字串關鍵字和屬性中的專案索引鍵/值組。 例如，不支援 SQL_ATTR_TXN_ISOLATION 關鍵字，因為這是使用 SQLSetConnectAttr設定的屬性，而不是連接字串。
Microsoft OLE DB 提供者的連接字串關鍵字和選項：
- Microsoft OLE DB Driver for SQL Server：搭配使用連接字串關鍵字搭配 OLE DB Driver for SQL Server
- SQL Native Client (已過時) Native Client OLE DB (SQLNCLI) 使用連接字串關鍵字
Microsoft ODBC DB 提供者的連接字串關鍵字和選項：
- Microsoft ODBC Driver for SQL Server：DSN 和連接字串關鍵字和屬性
- SQL Native Client (已過時) ODBC 驅動程式連接字串關鍵字
Oracle
您只能指定具有 Oracle 線路通訊協定資料表中專案的索引鍵/值組，如下所示：
| 屬性 (簡短名稱) | 預設 |
|---|---|
| AccountingInfo (AI) | 無 |
| action (ACT) | 無 |
| AlternateServers (ASRV) | 無 |
| AllowedOpenSSLVersions (AOV) | 最新 |
| ApplicationName (AN) | 無 |
| ApplicationUsingThreads (AUT) | 1 (已啟用) |
| ArraySize (AS) | 60000 |
| AuthenticationMethod (AM) | 1 (加密密碼) |
| BatchFailureReturnsError (BFRE) | 0 (已停用) |
| BindParamsAsUnicode (BPAU) | 0 (已停用) |
| BulkBinaryThreshold (BBT) | 32 |
| BulkCharacterThreshold (BCT) | -1 |
| BulkLoadBatchSize (BLBS) | 1024 |
| BulkLoadFieldDelimiter (BLFD) | 無 |
| BulkLoadOptions (BLO) | 0 |
| BulkLoadRecordDelimiter (BLRD) | 無 |
| CachedCursorLimit (CCL) | 32 |
| CachedDescriptionLimit (CDL) | 0 |
| CatalogIncludesSynonyms (CIS) | 1 (已啟用) |
| CatalogOptions (CO) | 0 (已停用) |
| ClientHostName (CHN) | 無 |
| ClientID (CID) | 無 |
| ClientUser (CU) | 無 |
| ConnectionReset (CR) | 0 (已停用) |
| ConnectionRetryCount (CRC) | 0 |
| ConnectionRetryDelay (CRD) | 3 |
| CredentialsWalletEntry (CWE) | 無 |
| CredentialsWalletPassword (CWPWD) | 無 |
| CredentialsWalletPath (CWPATH) | 無 |
| CryptoProtocolVersion (CPV) | TLSv1.2，TLSv1.1，TLSv1 |
| CryptoLibName (CLN) | 空字串 |
| DataIntegrityLevel (DIL) | 1 (已接受) |
| DataIntegrityTypes (DIT) | MD5， SHA1， SHA256， SHA384， SHA512 |
| DataSourceName (DSN) | 無 |
| DefaultLongDataBuffLen (DLDBL) | 1024 |
| DescribeAtPrepare (DAP) | 0 (已停用) |
| 描述 (n/a) | 無 |
| EditionName (EN) | 無 |
| EnableBulkLoad (EBL) | 0 (已停用) |
| EnableDescribeParam (EDP) | 0 (已停用) |
| EnableNcharSupport (ENS) (已被取代。) | 無 |
| EnableScrollableCursors (ESC) | 1 (已啟用) |
| EnableServerResultCache (ESRC) | 0 (已停用) |
| EnableStaticCursorsForLongData (ESCLD) | 0 (已停用) |
| EnableTimestampwithTimezone (ETWT) (已被取代) | 無 |
| EncryptionLevel (EL) | 1 (已接受) |
| EncryptionMethod (EM) | 0 (沒有加密) |
| EncryptionTypes (ET) | 未指定任何加密方法。 驅動程式會將所有加密方法的清單傳送至 Oracle 伺服器。 |
| FailoverGranularity (FG) | 0 (非不可部分完成) |
| FailoverMode (FM) | 0 (連線) |
| FailoverPreconnect (FP) | 0 (已停用) |
| FetchTSWTZasTimestamp (FTSWTZAT) | 0 (已停用) |
| GSSClient (GSSC) | native |
| HostName (HOST) | 無 |
| HostNameInCertificate (HNIC) | 無 |
| IANAAppCodePage (IACP) (UNIX 和 Linux) | 4 (ISO 8559-1 Latin-1) |
| ImpersonateUser (IU) | 無 |
| initializationString (IS) | 無 |
| KeepAlive (KA) | 0 (已停用) |
| KeyPassword (KP) | 無 |
| 金鑰存放區 (KS) | 無 |
| KeystorePassword (KSP) | 無 |
| LDAPDistinguishedName (LDAPDN) | 無 |
| LoadBalanceTimeout (LBT) | 0 |
| 負載平衡 (LB) | 0 (已停用) |
| LOBPrefetchSize (LPS) | 4000 |
| LocalTimezoneOffset (LTZO) | 「」 (空字串) |
| LockTimeout (LTO) | -1 |
| LoginTimeout (LT) | 15 |
| LogonID (UID) | 無 |
| MaxPoolSize (MXPS) | 100 |
| MinPoolSize (MNPS) | 0 |
| 模組 (MOD) | 無 |
| 密碼 (PWD) | 無 |
| 集區 (集區) | 0 (已停用) |
| PortNumber (PORT) | 無 |
| PRNGSeedFile (PSF) (UNIX 和 Linux) | /dev/random |
| PRNGSeedSource (PSS) (UNIX 和 Linux) | 0 (檔案) |
| ProcedureRetResults (PRR) | 0 (已停用) |
| ProgramID (PID) | 無 |
| ProxyHost (PXHN) | 空字串 |
| ProxyMode (PXM) | 0 (NONE) |
| ProxyPassword (PXPW) | 空字串 |
| ProxyPort (PXPT) | 0 |
| ProxyUser (PXU) | 空字串 |
| QueryTimeout (QT) | 0 |
| ReportCodepageConversionErrors (RCCE) | 0 (忽略錯誤) |
| ReportRecycleBin (RRB) | 0 (已停用) |
| SDUSize (SDU) | 16384 |
| ServerName (SRVR) | 無 |
| ServerType (ST) | 0 (伺服器預設) |
| ServiceName (SN) | 無。 如果未為 SID、服務名稱或 TNSNames 選項指定任何值，驅動程式預設會嘗試連線到 ORCL SID。 |
| SID (SID) | 無。 如果未為 SID、服務名稱或 TNSNames 選項指定任何值，驅動程式預設會嘗試連線到 ORCL SID。 |
| SSLLibName (SLN) | 空字串 |
| SupportBinaryXML (SBX) | 0 (已停用) |
| TimestampEscapeMapping (TEM) | 0 (Oracle 版本特定) |
| TNSNamesFile (TNF) | 無。 如果未為 SID、服務名稱或 TNSNames 選項指定任何值，驅動程式預設會嘗試連線到 ORCL SID。 |
| Truststore (TS) | 無 |
| TruststorePassword (TSP) | 無 |
| UseCurrentSchema (UCS) | 1 (已啟用) |
| UseDefaultEncryptionOptions | 1 (已啟用) |
| ValidateServerCertificate (VSC) | 1 (已啟用) |
| WireProtocolMode (WPM) | 2 |
Teradata
您只能指定索引鍵/值組，這些機碼值組具有 Teradata 連接器組態選項中提供的連接器組態選項中的專案。
適用于 Cosmos DB 的 MongoDB API
您只能在下列驅動程式組態選項中指定具有專案的機碼/值組。
| 機碼名稱 | 預設 | 必要 | 描述 |
|---|---|---|---|
| DefaultStringColumnLength | 255 | 否 | 可以包含在 STRING 資料行中的字元數上限。 您可以為此選項設定的最大值是2147483647。 |
| noCursorTimeout | False | 否 | 此選項會指定驅動程式是否允許資料來源伺服器上的作用中資料指標到期。 當為 FALSE 時，資料來源伺服器會在伺服器上設定的臨界值非活動期間之後逾時閒置資料指標。 當設定為 TRUE 時，驅動程式會防止資料來源伺服器逾時閒置資料指標，而且如果驅動程式應該意外結束或遺失與伺服器的連線，資料指標將會無限期地在伺服器上保持開啟。 您可以在 MongoDB 伺服器上調整閒置資料指標逾時的臨界值，如需詳細資訊，請參閱 https://docs.mongodb.com/v3.0/reference/parameters/ 。 |
| SamplingLimit | 100 | No | 驅動程式可取樣以產生暫存架構定義的記錄數目上限。 當此選項設定為 0 時，驅動程式會取樣資料庫中的每個檔。 請務必將驅動程式設定為取樣所有必要的資料。 未取樣的檔不會包含在架構定義中，因此無法在 ODBC 應用程式中使用。 一般而言，取樣大量檔會導致架構定義更精確且更能代表資料庫中所有資料。 不過，取樣程式在取樣許多檔時可能需要較長的時間，特別是當資料庫包含複雜的巢狀資料結構時。 |
| SamplingStrategy | 轉寄 | No | 此選項會指定驅動程式在產生暫存架構定義時如何取樣資料。 向前：驅動程式會從資料庫中的第一筆記錄開始取樣資料，然後取樣下一筆記錄，依此類推。 回溯：驅動程式會從資料庫中的最後一筆記錄開始取樣資料，然後取樣上述記錄，依此類推。 隨機：驅動程式會隨機從資料來源選取範例記錄，直到到達 SamplingLimit 為止。 |
| SSL | 清除 (0) | No | 此選項會指定驅動程式是否使用 SSL 連線到伺服器。 已啟用 (1) ：驅動程式會使用 SSL 連線到伺服器。停用 (0) ：驅動程式不會使用 SSL 連線到伺服器。 |
一般 ODBC
您可以為 PolyBase 泛型 ODBC 外部資料源指定的有效CONNECTION_OPTIONS是驅動程式特定的。 如果未使用 Microsoft 提供的 ODBC 提供者 (請參閱上一節) ，請參閱驅動程式的檔以取得有效的索引鍵/值組。
PolyBase 中有一些有效的索引鍵/值組可供所有一般 ODBC 驅動程式使用。 下列金鑰已新增至 CU5 中的 SQL Server 2019。
| 答案 | 可能值 | 描述 |
|---|---|---|
| PolyBaseOdbcSupportsRowCount | true、FALSE | 指出驅動程式是否支援 ODBC 目錄函式上呼叫的 SQLRowCount 函式。 預設值為 false。 例如：CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'。 |
| PolyBaseOdbcSupportsMetadataIdAttributes | true、FALSE | 指出驅動程式是否支援設定 METADATA_ID 語句屬性。 預設值為 false。 例如：CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'。 |
| PolyBaseOdbcSupportsBindOffset | true、FALSE | 指出驅動程式是否支援資料列系結結果集的系結位移。 如果沒有，請使用資料行系結。 預設值為 false。 例如：CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'。 |
| PolyBaseQoTopPushdownSyntax | TOP、LIMIT | 包含指定如何將 TOP 運算子向下推送至後端的資訊。 預設值為空字串，表示不支援 TOP 下推。 如果使用者指定 TOP， top {0} 則會當做格式字串使用。 如果使用者指定 LIMIT， limit {0} 則會當做格式字串使用。 此實作是驅動程式特定的，請參閱外部資料源和/或驅動程式檔。 例如：CONNECTION_OPTIONS= PolyBaseQoTopPushdownSyntax=TOP'。 |