Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Область применения:
SQL Server 2016 (13.x) и более поздних версий База данных SQL Azure Управляемый экземпляр SQL AzureAzure Synapse Analytics AnalyticsPlatform System (PDW)
В этой статье приведены дополнительные сведения о CONNECTION_OPTIONS зависимости от поставщика. Аргумент CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS может отличаться в зависимости от внешнего поставщика данных.
Аргумент CONNECTION_OPTIONSCREATE EXTERNAL DATA SOURCE был впервые представлен в SQL Server 2019 (15.x). Этот документ относится к SQL Server 2019 (15.x) для Windows и Linux, а также к кластерам больших данных SQL Server 2019.
-
key_value_pair— это ключевое слово и значение для конкретного параметра соединения. - Чтобы использовать несколько параметров подключения, укажите их через точку с запятой.
- Возможные пары "ключ-значение" зависят от драйвера.
Оставшаяся часть этой статьи содержит параметры подключения, относящиеся к поставщику.
Внешний источник данных SQL Server
Можно указать только пары "ключ-значение", которые имеют запись в dsN и ключевых словах строки подключения и атрибутах в столбце ключевого слова DSN / Строка подключения . Например, ключевое SQL_ATTR_TXN_ISOLATION слово не поддерживается, так как это набор атрибутов с помощью SQLSetConnectAttr, а не в строке подключения.
Замечание
PolyBase поддерживает только драйвер Microsoft ODBC версии 17 и 18. Дополнительные сведения см. в разделе "Изменение версии драйвера SQL Server для PolyBase".
Ключевые слова и параметры строки подключения для поставщиков Microsoft OLE DB:
Microsoft OLE DB Driver for SQL Server: использование ключевых слов строки подключения с драйвером OLE DB для SQL Server
Sql Native Client (не рекомендуется) с помощью ключевых слов строки подключения с собственным клиентом SQL Server
Ключевые слова и параметры строки подключения для поставщиков базы данных Microsoft ODBC:
- Драйвер Microsoft ODBC для SQL Server: ключевые слова и атрибуты строки подключения и DSN
- Ключевые слова строки подключения драйвера ODBC для собственного клиента SQL (не рекомендуется)
Оракул
Вы можете указать только пары "ключ-значение", имеющие запись в таблице протокола Oracle wire, как показано ниже.
| Атрибут (короткое имя) | По умолчанию |
|---|---|
| AccountingInfo (AI) | Отсутствует |
| Действие (ACT) | Отсутствует |
| AlternateServers (ASRV) | Отсутствует |
| AllowedOpenSSLVersions (AOV) | последний |
| ApplicationName (AN) | Отсутствует |
| ApplicationUsingThreads (AUT) | 1 (включено) |
| ArraySize (AS) | 60 000 |
| 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 |
| ОписаниеAtPrepare (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. |
| Отработка отказа (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) |
| ОлицетворенияUser (IU) | Отсутствует |
| InitializationString (IS) | Отсутствует |
| KeepAlive (KA) | 0 (отключено) |
| KeyPassword (KP) | Отсутствует |
| Хранилище ключей (KS) | Отсутствует |
| KeystorePassword (KSP) | Отсутствует |
| LDAPDistinguishedName (LDAPDN) | Отсутствует |
| LoadBalanceTimeout (LBT) | 0 |
| LoadBalancing (LB) | 0 (отключено) |
| LOBPrefetchSize (LPS) | 4000 |
| LocalTimezoneOffset (LTZO) | "" (пустая строка) |
| LockTimeout (LTO) | -1 |
| LoginTimeout (LT) | 15 |
| Вход в систему (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 |
| Имя сервера (SRVR) | Отсутствует |
| ServerType (ST) | 0 (по умолчанию для сервера) |
| ServiceName (SN) | Нет. Если для параметра SID, Имени службы или TNSNames не задано никакого значения, драйвер пытается подключиться к идентификатору БЕЗОПАСНОСТИ ORCL по умолчанию. |
| SID (SID) | Нет. Если для параметра SID, Имени службы или TNSNames не задано никакого значения, драйвер пытается подключиться к идентификатору БЕЗОПАСНОСТИ ORCL по умолчанию. |
| SSLLibName (SLN) | Пустая строка |
| SupportBinaryXML (SBX) | 0 (отключено) |
| TimestampEscapeMapping (TEM) | 0 (Для конкретной версии Oracle) |
| TNSNamesFile (TNF) | Нет. Если для параметра SID, Имени службы или TNSNames не задано никакого значения, драйвер пытается подключиться к идентификатору БЕЗОПАСНОСТИ ORCL по умолчанию. |
| Truststore (TS) | Отсутствует |
| TruststorePassword (TSP) | Отсутствует |
| UseCurrentSchema (UCS) | 1 (включено) |
| UseDefaultEncryptionOptions | 1 (включено) |
| ValidateServerCertificate (VSC) | 1 (включено) |
| WireProtocolMode (WPM) | 2 |
Teradata
Можно указать только пары "ключ-значение", имеющие запись в параметрах конфигурации соединителя, указанных в параметрах конфигурации соединителя Teradata.
API MongoDB для Cosmos DB
Можно указать только пары "ключ-значение", имеющие запись в следующих параметрах конфигурации драйвера.
| Имя ключа | По умолчанию | Обязательно | Описание |
|---|---|---|---|
DefaultStringColumnLength |
255 | нет | Максимальное количество символов, которые могут содержаться в STRING столбцах. Максимальное значение, которое можно задать для этого параметра, — 2147483647. |
noCursorTimeout |
Неправда | нет | Этот параметр указывает, разрешен ли драйверу истекать срок действия активных курсоров на сервере источника данных. Когда FALSEсервер источника данных будет истекать время ожидания курсоров бездействия после порогового периода бездействия, заданного на сервере. Если задано значение TRUE, драйвер запрещает серверу источника данных от времени ожидания курсоров простоя, и существует риск того, что если драйвер должен выйти или потерять подключение к серверу неожиданно, курсор остается открытым на сервере на неопределенный срок. Пороговое значение для времени ожидания простоя курсоров на сервере MongoDB см. в разделе "Параметры сервера MongoDB" для Self-Managed развертывания . |
SamplingLimit |
100 | нет | Максимальное количество записей, которые драйвер может использовать для создания временного определения схемы. Если для этого параметра задано значение 0, драйвер примеры каждого документа в базе данных. Обязательно настройте драйвер для выборки всех необходимых данных. Документы, которые не являются примерами, не включаются в определение схемы и поэтому не становятся доступными в приложениях ODBC. Как правило, выборка большого количества документов приводит к определению схемы, которое более точно и лучше может представлять все данные в базе данных. Однако процесс выборки может занять больше времени, чем ожидалось, если выборка многих документов, особенно если база данных содержит сложные вложенные структуры данных. |
SamplingStrategy |
Вперёд | нет | Этот параметр указывает, как данные драйвера образцы данных при создании временного определения схемы. Переадресация: данные драйверов, начиная с первой записи в базе данных, а затем примеры следующей записи и т. д. Назад: данные драйвера, начиная с последней записи в базе данных, затем примеры предыдущей записи и т. д. Случайный. Драйвер выбирает образцы записей из источника данных случайным образом, пока не будет достигнут ВыборкаLimit. |
SSL |
Очистить (0) |
нет | Этот параметр указывает, использует ли драйвер SSL для подключения к серверу. Включено (1): драйвер использует SSL для подключения к серверу. Отключено (0): драйвер не использует SSL для подключения к серверу. |
Базовый протокол ODBC
Допустимо, CONNECTION_OPTIONS что для универсального источника данных ODBC для PolyBase можно указать драйвер. Если вы не используете поставщик ODBC, предоставленный Корпорацией Майкрософт (см. предыдущий раздел), ознакомьтесь с документацией драйвера по допустимым парам "ключ-значение".
В PolyBase есть некоторые допустимые пары "ключ-значение", доступные для всех универсальных драйверов ODBC. Следующие ключи были добавлены в SQL Server 2019 в CU5.
| Ключ | Возможные значения | Описание |
|---|---|---|
PolyBaseOdbcSupportsRowCount |
TRUE, FALSE |
Указывает, поддерживает ли драйвер функцию SQLRowCount, вызываемую в функциях каталога ODBC. По умолчанию — 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 pushdown. Если пользователь указывает TOP, top {0} используется в качестве строки форматирования. Если пользователь указывает LIMIT, limit {0} используется в качестве строки форматирования. Эта реализация зависит от драйвера, обратитесь к документации по внешнему источнику данных и /или драйверу. Например: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'. |