適用於：
SQL Server 2016 (13.x) 和更新版本 Azure SQL 資料庫Azure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)
本文會根據提供者提供其他詳細數據 CONNECTION_OPTIONS 。
CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS 自變數可能會根據外部數據提供者而有所不同。
CONNECTION_OPTIONS
CREATE EXTERNAL DATA SOURCE 的自變數最初是在 SQL Server 2019 （15.x） 中引進的。 本文件適用於適用於 Windows 和 Linux 的 SQL Server 2019 （15.x），以及 SQL Server 2019 巨量數據叢集。
-
key_value_pair是特定連線選項的關鍵字和值。 - 若要使用多個連線選項，請以分號進行分隔。
- 可能的鍵值組專屬於驅動程式。
本文的其餘部分包含廠商特定的連線選項。
SQL Server 外部數據源
您只能指定 在 DSN 和 [ DSN / 連接字串關鍵字 ] 資料列底下具有專案之索引鍵/值組。 例如， SQL_ATTR_TXN_ISOLATION 不支持 關鍵詞，因為這是使用 SQLSetConnectAttr 設定的屬性，而不是在連接字串中。
備註
PolyBase 僅支援 odbc Driver 17 和 18 版Microsoft。 如需詳細資訊，請參閱 變更PolyBase的SQL Server 驅動程式版本。
Microsoft OLE DB 提供者的連接字串關鍵詞和選項：
Microsoft OLE DB Driver for SQL Server： 搭配 OLE DB Driver for SQL Server 使用連接字串關鍵詞
SQL Native Client （已淘汰） 搭配 SQL Server Native Client 使用連接字串關鍵詞
Microsoft ODBC DB 提供者的連接字串關鍵詞和選項：
- Microsoft ODBC Driver for SQL Server： DSN 和連接字串關鍵詞和屬性
- SQL Native Client （已淘汰） ODBC 驅動程式連接字串關鍵詞
Oracle公司
您只能指定具有 Oracle 線路通訊協定資料表中項目的機碼/值組，如下所示：
| 屬性 （簡短名稱） | 預設 |
|---|---|
| AccountingInfo （AI） | 沒有 |
| 行動（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） | 本地 |
| 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） | 沒有 |
| 共用 （POOL） | 0 (已停用) |
| PortNumber （PORT） | 沒有 |
| PRNGSeedFile （PSF） （僅限 UNIX 和 Linux） | /dev/random |
| PRNGSeedSource （PSS） （僅限 UNIX 和 Linux） | 0 （檔案） |
| ProcedureRetResults （PRR） | 0 (已停用) |
| ProgramID （PID） | 沒有 |
| ProxyHost （PXHN） | 空字串 |
| ProxyMode （PXM） | 0 （無） |
| 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。 |
| 信任存放區 （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，數據源伺服器會在伺服器上設定的臨界值閑置期間之後逾時閑置數據指標。 當設定為 TRUE時，驅動程式會防止數據源伺服器逾時閑置數據指標，而且如果驅動程式應該意外結束或失去與伺服器的連線，數據指標會無限期地在伺服器上保持開啟的風險。 您可以調整 MongoDB 伺服器上的閒置資料指標逾時閾值，如需詳細資訊，請參閱 Self-Managed 部署的 MongoDB 伺服器參數 。 |
SamplingLimit |
100 | 否 | 驅動程式可以取樣以產生暫存架構定義的記錄數目上限。 當此選項設定為 0 時，驅動程式會取樣資料庫中的每個檔。 請務必將驅動程式設定為取樣所有必要的數據。 未取樣的檔不會包含在架構定義中，因此無法在 ODBC 應用程式中使用。 一般而言，取樣大量檔會導致架構定義更精確且更能代表資料庫中所有數據。 不過，取樣程式在取樣許多檔時可能需要比預期更長的時間，特別是當資料庫包含複雜的巢狀數據結構時。 |
SamplingStrategy |
向前 | 否 | 此選項會指定驅動程式在產生暫存架構定義時如何取樣數據。 轉寄：驅動程式會從資料庫中的第一筆記錄開始取樣數據，然後取樣下一筆記錄等等。 回溯：驅動程式會從資料庫中最後一筆記錄開始取樣數據，然後取樣上述記錄等等。 隨機：驅動程式會隨機選取數據源中的範例記錄，直到到達SamplingLimit為止。 |
SSL |
清除 （0） |
否 | 此選項會指定驅動程式是否使用 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' 。 |