Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
SQL Server 2016 (13.x) e versões posteriores do Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)
Este artigo fornece detalhes adicionais para CONNECTION_OPTIONS depender do provedor. O argumento CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS pode variar dependendo do provedor de dados externo.
O CONNECTION_OPTIONS argumento para CREATE EXTERNAL DATA SOURCE foi introduzido pela primeira vez no SQL Server 2019 (15.x). Este documento se aplica ao SQL Server 2019 (15.x) para Windows e Linux, bem como aos Clusters de Big Data do SQL Server 2019.
- O
key_value_pairé a palavra-chave e o valor de uma opção de conexão específica. - Para usar várias opções de conexão, separe-as com ponto e vírgula.
- Os possíveis pares de chave-valor são específicos do driver.
O restante deste artigo contém opções de conexão específicas do fornecedor.
Fonte de dados externa do SQL Server
Você só pode especificar os pares chave-valor que têm uma entrada em DSN e palavras-chave de cadeia de conexão e atributos na coluna DSN/Palavra-chave cadeia de conexão . Por exemplo, não há suporte para a SQL_ATTR_TXN_ISOLATION palavra-chave, pois esse é um conjunto de atributos usando SQLSetConnectAttr, não na cadeia de conexão.
Observação
O PolyBase dá suporte apenas ao Microsoft ODBC Driver versão 17 e 18. Para obter mais informações, consulte Alterar a versão do driver do SQL Server para PolyBase.
Oráculo
Você só pode especificar os pares chave-valor que têm uma entrada na tabela de protocolo de fio oracle da seguinte maneira:
| Atributo (Nome Curto) | Padrão |
|---|---|
| AccountingInfo (IA) | Nenhum |
| Ação (ACT) | Nenhum |
| AlternateServers (ASRV) | Nenhum |
| AllowedOpenSSLVersions (AOV) | mais recente |
| ApplicationName (AN) | Nenhum |
| ApplicationUsingThreads (AUT) | 1 (Habilitado) |
| ArraySize (AS) | 60000 |
| AuthenticationMethod (AM) | 1 (Criptografar senha) |
| BatchFailureReturnsError (BFRE) | 0 (desabilitado) |
| BindParamsAsUnicode (BPAU) | 0 (desabilitado) |
| BulkBinaryThreshold (BBT) | 32 |
| BulkCharacterThreshold (BCT) | -1 |
| BulkLoadBatchSize (BLBS) | 1024 |
| BulkLoadFieldDelimiter (BLFD) | Nenhum |
| BulkLoadOptions (BLO) | 0 |
| BulkLoadRecordDelimiter (BLRD) | Nenhum |
| CachedCursorLimit (CCL) | 32 |
| CDL (CachedDescriptionLimit) | 0 |
| CatalogIncludesSynonyms (CIS) | 1 (Habilitado) |
| CatalogOptions (CO) | 0 (desabilitado) |
| ClientHostName (CHN) | Nenhum |
| ClientID (CID) | Nenhum |
| ClientUser () | Nenhum |
| ConnectionReset (CR) | 0 (desabilitado) |
| ConnectionRetryCount (CRC) | 0 |
| ConnectionRetryDelay (CRD) | 3 |
| CredentialsWalletEntry (CWE) | Nenhum |
| CredentialsWalletPassword (CWPWD) | Nenhum |
| CredentialsWalletPath (CWPATH) | Nenhum |
| CryptoProtocolVersion (CPV) | TLSv1.2, TLSv1.1, TLSv1 |
| CryptoLibName (CLN) | Cadeia de caracteres vazia |
| DataIntegrityLevel (DIL) | 1 (Aceito) |
| DataIntegrityTypes (DIT) | MD5, SHA1, SHA256, SHA384, SHA512 |
| DataSourceName (DSN) | Nenhum |
| DefaultLongDataBuffLen (DLDBL) | 1024 |
| DescribeAtPrepare (DAP) | 0 (desabilitado) |
| Descrição (n/a) | Nenhum |
| EditionName (EN) | Nenhum |
| EnableBulkLoad (EBL) | 0 (desabilitado) |
| EnableDescribeParam (EDP) | 0 (desabilitado) |
| EnableNcharSupport (ENS) (preterido.) | Nenhum |
| EnableScrollableCursors (ESC) | 1 (Habilitado) |
| EnableServerResultCache (ESRC) | 0 (desabilitado) |
| EnableStaticCursorsForLongData (ESCLD) | 0 (desabilitado) |
| EnableTimestampwithTimezone (ETWT) (preterido) | Nenhum |
| EncryptionLevel (EL) | 1 (Aceito) |
| EncryptionMethod (EM) | 0 (Sem criptografia) |
| EncryptionTypes (ET) | Nenhum método de criptografia é especificado. O driver envia uma lista de todos os métodos de criptografia para o servidor Oracle. |
| FailoverGranularity (FG) | 0 (não atômico) |
| FailoverMode (FM) | 0 (Conexão) |
| FailoverPreconnect (FP) | 0 (desabilitado) |
| FetchTSWTZasTimestamp (FTSWTZAT) | 0 (desabilitado) |
| GSSClient (GSSC) | nativo |
| HostName (HOST) | Nenhum |
| HostNameInCertificate (HNIC) | Nenhum |
| IANAAppCodePage (IACP) (somente UNIX e Linux) | 4 (ISO 8559-1 Latin-1) |
| IU (ImpersonateUser) | Nenhum |
| InitializationString (IS) | Nenhum |
| KeepAlive (KA) | 0 (desabilitado) |
| Palavra-chave (KP) | Nenhum |
| Repositório de chaves (KS) | Nenhum |
| KeystorePassword (KSP) | Nenhum |
| LDAPDistinguishedName (LDAPDN) | Nenhum |
| LoadBalanceTimeout (LBT) | 0 |
| LoadBalancing (LB) | 0 (desabilitado) |
| LOBPrefetchSize (LPS) | 4000 |
| LocalTimezoneOffset (LTZO) | "" (Cadeia de caracteres vazia) |
| LockTimeout (LTO) | -1 |
| LoginTimeout (LT) | 15 |
| LogonID (UID) | Nenhum |
| MaxPoolSize (MXPS) | 100 |
| MNPS (MinPoolSize) | 0 |
| Módulo (MOD) | Nenhum |
| Senha (PWD) | Nenhum |
| Pooling (POOL) | 0 (desabilitado) |
| PortNumber (PORT) | Nenhum |
| PRNGSeedFile (PSF) (somente UNIX e Linux) | /dev/random |
| PRNGSeedSource (PSS) (somente UNIX e Linux) | 0 (Arquivo) |
| ProcedureRetResults (PRR) | 0 (desabilitado) |
| ProgramID (PID) | Nenhum |
| ProxyHost (PXHN) | Cadeia de caracteres vazia |
| ProxyMode (PXM) | 0 (NONE) |
| ProxyPassword (PXPW) | Cadeia de caracteres vazia |
| ProxyPort (PXPT) | 0 |
| ProxyUser (PXU) | Cadeia de caracteres vazia |
| QueryTimeout (QT) | 0 |
| ReportCodepageConversionErrors (RCCE) | 0 (Ignorar erros) |
| ReportRecycleBin (RRB) | 0 (desabilitado) |
| SDUSize (SDU) | 16384 |
| ServerName (SRVR) | Nenhum |
| ServerType (ST) | 0 (Padrão do servidor) |
| ServiceName (SN) | Nenhum. Se nenhum valor for especificado para a opção SID, Nome do Serviço ou TNSNames, o driver tentará se conectar ao SID ORCL por padrão. |
| SID (SID) | Nenhum. Se nenhum valor for especificado para a opção SID, Nome do Serviço ou TNSNames, o driver tentará se conectar ao SID ORCL por padrão. |
| SSLLibName (SLN) | Cadeia de caracteres vazia |
| SupportBinaryXML (SBX) | 0 (desabilitado) |
| TimestampEscapeMapping (TEM) | 0 (Versão específica do Oracle) |
| TNSNamesFile (TNF) | Nenhum. Se nenhum valor for especificado para a opção SID, Nome do Serviço ou TNSNames, o driver tentará se conectar ao SID ORCL por padrão. |
| Truststore (TS) | Nenhum |
| TruststorePassword (TSP) | Nenhum |
| UseCurrentSchema (UCS) | 1 (Habilitado) |
| UseDefaultEncryptionOptions | 1 (Habilitado) |
| ValidateServerCertificate (VSC) | 1 (Habilitado) |
| WireProtocolMode (WPM) | 2 |
Teradata
Você só pode especificar os pares chave-valor que têm uma entrada nas opções de configuração do conector fornecidas nas Opções de Configuração do Conector do Teradata.
API do MongoDB para Cosmos DB
Você só pode especificar os pares chave-valor que têm uma entrada nas seguintes opções de configuração de driver.
| Nome da chave | Padrão | Obrigatório | Descrição |
|---|---|---|---|
DefaultStringColumnLength |
255 | Não | O número máximo de caracteres que podem ser contidos em STRING colunas. O valor máximo que você pode definir para essa opção é 2147483647. |
noCursorTimeout |
Falso | Não | Essa opção especifica se o driver permite que cursores ativos no servidor de fonte de dados expirem. Quando FALSEo servidor de fonte de dados acabará com os cursores ociosos após o período de inatividade limite definido no servidor. Quando definido como TRUE, o driver impede que o servidor de fonte de dados cronometre cursores ociosos e há o risco de que, se o driver deve parar ou perder a conexão com o servidor inesperadamente, o cursor permanece aberto no servidor indefinidamente. Você pode ajustar o limite de tempo limite de cursor ocioso no servidor MongoDB, consulte Parâmetros do servidor MongoDB para obter um Self-Managed Implantação para obter detalhes. |
SamplingLimit |
100 | Não | O número máximo de registros que o driver pode amostrar para gerar uma definição de esquema temporário. Quando essa opção é definida como 0, o driver amostra cada documento no banco de dados. Configure o driver para amostrar todos os dados necessários. Os documentos que não são amostrados não são incluídos na definição de esquema e, portanto, não ficam disponíveis em aplicativos ODBC. Normalmente, a amostragem de um grande número de documentos resulta em uma definição de esquema mais precisa e mais capaz de representar todos os dados no banco de dados. No entanto, o processo de amostragem pode levar mais tempo do que o esperado quando muitos documentos são amostrados, especialmente se o banco de dados contiver estruturas de dados complexas e aninhadas. |
SamplingStrategy |
Encaminhar | Não | Essa opção especifica como o driver amostra dados ao gerar uma definição de esquema temporário. Encaminhamento: o driver amostra dados a partir do primeiro registro no banco de dados e, em seguida, amostra o próximo registro e assim por diante. Versões anteriores: o driver amostra dados a partir do último registro no banco de dados e, em seguida, amostra o registro anterior e assim por diante. Aleatório: o driver seleciona registros de exemplo da fonte de dados aleatoriamente até que o SamplingLimit seja atingido. |
SSL |
Limpar (0) |
Não | Essa opção especifica se o driver usa SSL para se conectar ao servidor. Habilitado (1): o driver usa SSL para se conectar ao servidor. Desabilitado (0): o driver não usa SSL para se conectar ao servidor. |
ODBC Genérico
Válido CONNECTION_OPTIONS que você pode especificar para a Fonte de Dados Externa ODBC Genérica do PolyBase específica do driver. Se não estiver usando um provedor ODBC fornecido pela Microsoft (consulte a seção anterior), consulte a documentação do driver para obter pares chave-valor válidos.
Há alguns pares chave-valor válidos no PolyBase que estão disponíveis para todos os drivers ODBC genéricos. As chaves a seguir foram adicionadas ao SQL Server 2019 na CU5.
| Chave | Valores possíveis | Descrição |
|---|---|---|
PolyBaseOdbcSupportsRowCount |
TRUE, FALSE |
Indica se o driver dá suporte ou não à função SQLRowCount que está sendo chamada em funções de catálogo ODBC. O padrão é false. Por exemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'. |
PolyBaseOdbcSupportsMetadataIdAttributes |
TRUE, FALSE |
Indica se o driver dá suporte ou não à definição do atributo de METADATA_ID instrução. O padrão é false. Por exemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'. |
PolyBaseOdbcSupportsBindOffset |
TRUE, FALSE |
Indica se o driver dá suporte ou não a deslocamentos de associação para associação em linha de conjuntos de resultados. Caso contrário, use a associação de coluna. O padrão é false. Por exemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'. |
PolyBaseQoTopPushdownSyntax |
TOP, LIMIT |
Contém informações que especificam como efetuar push do TOP operador para o back-end. O padrão é uma cadeia de caracteres vazia, indicando a falta de suporte para TOP pushdown. Se o usuário especificar TOP, top {0} será usado como a cadeia de caracteres de formato. Se o usuário especificar LIMIT, limit {0} será usado como a cadeia de caracteres de formato. Essa implementação é específica do driver, consulte a fonte de dados externa e/ou a documentação do driver. Por exemplo: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'. |