适用于：
SQL Server 2016 (13.x) 及更高版本Azure SQL 数据库Azure SQL 托管实例Azure Synapse Analytics分析平台系统 (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 仅支持 Microsoft ODBC 驱动程序版本 17 和 18。 有关详细信息，请参阅 更改 PolyBase 的 SQL Server 驱动程序版本。
神谕
只能指定 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） | 本机的 |
| 主机名 （HOST） | 没有 |
| HostNameInCertificate （HNIC） | 没有 |
| IANAAppCodePage （IACP） （仅 UNIX 和 Linux） | 4 （ISO 8559-1 拉丁语-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 （无） |
| 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
只能指定具有以下驱动程序配置选项中的条目的键值对。
| 密钥名称 | 违约 | 必选 | DESCRIPTION |
|---|---|---|---|
DefaultStringColumnLength |
255 | 否 | 列中 STRING 可包含的最大字符数。 可以为此选项设置的最大值是2147483647。 |
noCursorTimeout |
假 | 否 | 此选项指定驱动程序是否允许数据源服务器上的活动游标过期。 当 FALSE，数据源服务器将在服务器上设置的阈值非活动时间段后超时空闲游标。 设置为 |
SamplingLimit |
100 | 否 | 驱动程序可以采样以生成临时架构定义的最大记录数。 如果此选项设置为 0，驱动程序会采样数据库中的每个文档。 请确保将驱动程序配置为对所有必要的数据进行采样。 未采样的文档不会包含在架构定义中，因此在 ODBC 应用程序中不可用。 通常，对大量文档进行采样会导致架构定义更准确，并且能够更好地表示数据库中所有数据。 但是，当对许多文档进行采样时，采样过程所需的时间可能比预期长，尤其是在数据库包含复杂的嵌套数据结构时。 |
SamplingStrategy |
向前 | 否 | 此选项指定在生成临时架构定义时驱动程序如何对数据采样。 转发：驱动程序从数据库中的第一条记录开始对数据采样，然后对下一条记录进行采样，依此采样。 向后：驱动程序从数据库中的最后一条记录开始对数据进行采样，然后对上述记录进行采样，依此采样。 随机：驱动程序从数据源随机选择示例记录，直到到达 SamplingLimit。 |
SSL |
清除 （0） |
否 | 此选项指定驱动程序是否使用 SSL 连接到服务器。 已启用 （1）：驱动程序使用 SSL 连接到服务器。 已禁用 （0）：驱动程序不使用 SSL 连接到服务器。 |
泛型 ODBC
可以 CONNECTION_OPTIONS 指定 PolyBase 泛型 ODBC 外部数据源的有效是特定于驱动程序的。 如果不使用Microsoft提供的 ODBC 提供程序（请参阅上一部分），请参阅驱动程序的文档以获取有效的键值对。
PolyBase 中有一些有效的键值对可用于所有通用 ODBC 驱动程序。 以下密钥已添加到 CU5 中的 SQL Server 2019。
| 密钥 | 可能的值 | DESCRIPTION |
|---|---|---|
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'。 |