Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL Server 2016 (13.x) e versões posteriores Banco de Dados SQLdo Azure Azure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Este artigo fornece detalhes adicionais para CONNECTION_OPTIONS dependendo 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 aplica-se 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 para uma opção de conexão específica. - Para usar várias opções de conexão, separe-as por ponto-e-vírgula.
- Os possíveis pares de valores-chave 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 e atributos da cadeia de conexão na coluna DSN / palavra-chave da cadeia de conexão . Por exemplo, a SQL_ATTR_TXN_ISOLATION palavra-chave não é suportada, porque é um conjunto de atributos usando SQLSetConnectAttr, não na cadeia de conexão.
Observação
PolyBase suporta apenas o 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 abreviado) | Predefinido |
|---|---|
| AccountingInfo (IA) | Nenhum |
| Ação (ACT) | Nenhum |
| AlternateServers (ASRV) | Nenhum |
| AllowedOpenSSLVersions (AOV) | mais recente |
| ApplicationName (AN) | Nenhum |
| ApplicationUsingThreads (AUT) | 1 (Ativado) |
| ArraySize (AS) | 60000 |
| Método de autenticação (AM) | 1 (Criptografar senha) |
| BatchFailureReturnsError (BFRE) | 0 (Desativado) |
| BindParamsAsUnicode (BPAU) | 0 (Desativado) |
| BulkBinaryThreshold (BBT) | 32 |
| BulkCharacterThreshold (BCT) | -1 |
| BulkLoadBatchSize (BLBS) | 1024 |
| BulkLoadFieldDelimiter (BLFD) | Nenhum |
| BulkLoadOptions (BLO) | 0 |
| BulkLoadRecordDelimiter (BLRD) | Nenhum |
| CachedCursorLimit (CCL) | 32 |
| CachedDescriptionLimit (CDL) | 0 |
| CatalogIncludesSynonyms (CIS) | 1 (Ativado) |
| Opções de catálogo (CO) | 0 (Desativado) |
| ClientHostName (CHN) | Nenhum |
| ID do Cliente (CID) | Nenhum |
| ClientUser () | Nenhum |
| ConnectionReset (CR) | 0 (Desativado) |
| ConnectionRetryCount (CRC) | 0 |
| ConnectionRetryDelay (CRD) | 3 |
| CredenciaisWalletEntry (CWE) | Nenhum |
| CredenciaisWalletPassword (CWPWD) | Nenhum |
| CredentialsWalletPath (CWPATH) | Nenhum |
| CryptoProtocolVersion (CPV) | TLSv1.2, TLSv1.1, TLSv1 |
| CryptoLibName (CLN) | Cadeia vazia |
| DataIntegrityLevel (DIL) | 1 (Aceito) |
| DataIntegrityTypes (DIT) | MD5, SHA1, SHA256, SHA384, SHA512 |
| DataSourceName (DSN) | Nenhum |
| DefaultLongDataBuffLen (DLDBL) | 1024 |
| DescribeAtPrepare (DAP) | 0 (Desativado) |
| Descrição (n/a) | Nenhum |
| EditionName (PT) | Nenhum |
| EnableBulkLoad (EBL) | 0 (Desativado) |
| EnableDescribeParam (EDP) | 0 (Desativado) |
| EnableNcharSupport (ENS) (preterido.) | Nenhum |
| EnableScrollableCursors (ESC) | 1 (Ativado) |
| EnableServerResultCache (ESRC) | 0 (Desativado) |
| EnableStaticCursorsForLongData (ESCLD) | 0 (Desativado) |
| EnableTimestampwithTimezone (ETWT) (preterido) | Nenhum |
| Nível de Encriptação (EL) | 1 (Aceito) |
| Método de criptografia (EM) | 0 (Sem encriptação) |
| EncryptionTypes (ET) | Nenhum método de criptografia é especificado. O driver envia uma lista de todos os métodos de criptografia para o servidor Oracle. |
| FailoverGranularidade (FG) | 0 (Não Atómico) |
| FailoverMode (FM) | 0 (Conexão) |
| FailoverPreconnect (FP) | 0 (Desativado) |
| FetchTSWTZasTimestamp (FTSWTZAT) | 0 (Desativado) |
| GSSClient (GSSC) | nativo |
| HostName (HOST) | Nenhum |
| HostNameInCertificate (HNIC) | Nenhum |
| IANAAppCodePage (IACP) (somente UNIX e Linux) | 4 (ISO 8559-1, latim-1) |
| ImpersonateUser (IU) | Nenhum |
| InitializationString (IS) | Nenhum |
| KeepAlive (KA) | 0 (Desativado) |
| KeyPassword (KP) | Nenhum |
| Porta-chaves (KS) | Nenhum |
| KeystorePassword (KSP) | Nenhum |
| LDAPDistinguishedName (LDAPDN) | Nenhum |
| LoadBalanceTimeout (LBT) | 0 |
| Balanceamento de carga (LB) | 0 (Desativado) |
| LOBPrefetchSize (LPS) | 4000 |
| LocalTimezoneOffset (LTZO) | "" (String vazia) |
| LockTimeout (LTO) | -1 |
| LoginTimeout (LT) | 15 |
| ID de logon (UID) | Nenhum |
| MaxPoolSize (MXPS) | 100 |
| MinPoolSize (MNPS) | 0 |
| Módulo (MOD) | Nenhum |
| Senha (PWD) | Nenhum |
| Agrupamento (POOL) | 0 (Desativado) |
| Número da porta (PORT) | Nenhum |
| PRNGSeedFile (PSF) (somente UNIX e Linux) | /dev/aleatório |
| PRNGSeedSource (PSS) (somente UNIX e Linux) | 0 (Ficheiro) |
| ProcedimentoRetResults (PRR) | 0 (Desativado) |
| ID do Programa (PID) | Nenhum |
| ProxyHost (PXHN) | Cadeia vazia |
| ProxyMode (PXM) | 0 (NENHUM) |
| ProxyPassword (PXPW) | Cadeia vazia |
| ProxyPort (PXPT) | 0 |
| ProxyUser (PXU) | Cadeia vazia |
| QueryTimeout (QT) | 0 |
| ReportCodepageConversionErrors (RCCE) | 0 (Ignorar erros) |
| ReportRecycleBin (RRB) | 0 (Desativado) |
| SDUSize (SDU) | 16384 |
| Nome do servidor (SRVR) | Nenhum |
| Tipo de servidor (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 vazia |
| SupportBinaryXML (SBX) | 0 (Desativado) |
| 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. |
| Armazenamento de confiança (TS) | Nenhum |
| TruststorePassword (TSP) | Nenhum |
| UseCurrentSchema (UCS) | 1 (Ativado) |
| UseDefaultEncryptionOptions | 1 (Ativado) |
| ValidateServerCertificate (VSC) | 1 (Ativado) |
| 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 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 | Predefinido | 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 | Esta opção especifica se o driver permite que cursores ativos no servidor de fonte de dados expirem. Quando FALSEo , o servidor de fonte de dados expirará 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 atinja o tempo limite dos cursores ociosos e há um risco de que, se o driver encerrar ou perder a conexão com o servidor inesperadamente, o cursor permaneça aberto no servidor indefinidamente. Você pode ajustar o limite para tempos limite de cursor ocioso no servidor MongoDB, consulte Parâmetros do servidor MongoDB para uma implantação Self-Managed para obter detalhes. |
SamplingLimit |
100 | Não | O número máximo de registros que o driver pode obter para gerar uma definição de esquema temporária. Quando essa opção é definida como 0, o driver obtém amostras de todos os documentos no banco de dados. Certifique-se de configurar o driver para obter amostras de 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 |
Avançar | Não | Esta opção especifica como o driver faz amostras de dados ao gerar uma definição de esquema temporário. Encaminhar: o driver faz amostras de dados a partir do primeiro registro no banco de dados, depois amostras do próximo registro e assim por diante. Para trás: o driver faz amostras de dados a partir do último registro no banco de dados, depois faz amostras do registro anterior e assim por diante. Aleatório: O driver seleciona registros de amostra da fonte de dados aleatoriamente até que o SamplingLimit seja atingido. |
SSL |
Limpar (0) |
Não | Esta opção especifica se o driver usa SSL para se conectar ao servidor. Ativado (1): O driver usa SSL para se conectar ao servidor. Desativado (0): O driver não usa SSL para se conectar ao servidor. |
ODBC genérico
Válido CONNECTION_OPTIONS que você pode especificar para PolyBase Generic ODBC External Data Source são específicos 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 de chave-valor válidos.
Existem 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 suporta ou não a função SQLRowCount que está sendo chamada em funções de catálogo ODBC. O valor padrão é falso. Por exemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'. |
PolyBaseOdbcSupportsMetadataIdAttributes |
TRUE, FALSE |
Indica se o driver suporta ou não a configuração do METADATA_ID atributo de instrução. O valor padrão é falso. Por exemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'. |
PolyBaseOdbcSupportsBindOffset |
TRUE, FALSE |
Indica se o driver suporta ou não deslocamentos de ligação para vinculação em linha de conjuntos de resultados. Caso contrário, use a vinculação de coluna. O valor padrão é falso. Por exemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'. |
PolyBaseQoTopPushdownSyntax |
TOP, LIMIT |
Contém informações especificando como empurrar o TOP operador para o back-end. O padrão é uma cadeia de caracteres vazia, indicando uma 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. Esta 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'. |