CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS
Este artigo fornece detalhes adicionais para CONNECTION_OPTIONS dependendo do provedor. O argumento CREATE EXTERNAL DATA SOURCE CONNECTION_OPTIONS pode variar dependendo do provedor de dados externo.
O argumento CONNECTION_OPTIONS para CREATE EXTERNAL DATA SOURCE foi introduzido pela primeira vez no SQL Server 2019 (15.x). Este documento se aplica a SQL Server 2019 (15.x) para Windows e Linux, bem como 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, palavras-chave de cadeia de conexão e atributos na coluna DSN/Connection String Keyword. Por exemplo, não há suporte para a palavra-chave SQL_ATTR_TXN_ISOLATION, pois esse é um conjunto de atributos usando SQLSetConnectAttr, não na cadeia de conexão.
Palavras-chave e opções de cadeia de conexão para provedores OLE DB da Microsoft:
- Driver do Microsoft OLE DB para SQL Server: Usando palavras-chave de cadeia de conexão com o Driver do OLE DB para SQL Server
- SQL Native Client (preterido) Native Client OLE DB (SQLNCLI) Usando palavras-chave de cadeia de conexão
Palavras-chave e opções de cadeia de conexão para provedores ODBC DB da Microsoft:
- Microsoft ODBC Driver for SQL Server: DSN, palavras-chave de cadeia de conexão e atributos
- SQL Native Client (preterido) Palavras-chave da cadeia de conexão do Driver ODBC
Oracle
Você só pode especificar os pares chave-valor que têm uma entrada na tabela de protocolo de transmissão Oracle da seguinte maneira:
| Atributo (nome curto) | Padrão |
|---|---|
| AccountingInfo (AI) | Nenhum |
| Action (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 |
| CachedDescriptionLimit (CDL) | 0 |
| CatalogIncludesSynonyms (CIS) | 1 (habilitado) |
| CatalogOptions (CO) | 0 (desabilitado) |
| ClientHostName (CHN) | Nenhum |
| ClientID (CID) | Nenhum |
| ClientUser (CU) | 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/d) | 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) | nativa |
| HostName (HOST) | Nenhum |
| HostNameInCertificate (HNIC) | Nenhum |
| IANAAppCodePage (IACP) (somente UNIX e Linux) | 4 (ISO 8559-1 Latin-1) |
| ImpersonateUser (IU) | Nenhum |
| InitializationString (IS) | Nenhum |
| KeepAlive (KA) | 0 (desabilitado) |
| KeyPassword (KP) | Nenhum |
| Keystore (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 |
| MinPoolSize (MNPS) | 0 |
| Module (MOD) | Nenhum |
| Password (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 de servidor) |
| ServiceName (SN) | Nenhum. Se nenhum valor for especificado para a opção SID, Nome de 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 de 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 de 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 opções de configuração do driver abaixo.
| 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 colunas STRING. 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 FALSE, o servidor de fonte de dados atingirá o tempo limite de 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 de cursores ociosos e há o risco de que, se o driver deve sair ou perder a conexão com o servidor inesperadamente, o cursor permanecerá aberto no servidor indefinidamente. Você pode ajustar o limite para tempos limite do cursor ocioso no servidor MongoDB, consulte https://docs.mongodb.com/v3.0/reference/parameters/ 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ária. Quando essa opção é definida como 0, o driver cria uma amostra de cada documento no banco de dados. Certifique-se de configurar o driver para criar amostra 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, consequentemente, 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 aninhadas complexas. |
| SamplingStrategy | Encaminhar | Não | Essa opção especifica como o driver amostra dados ao gerar uma definição de esquema temporária. Avançar: o driver amostra dados começando do primeiro registro no banco de dados e, em seguida, amostra o próximo registro e assim por diante. Recuar: o driver amostra dados começando 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 | Clear (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
As CONNECTION_OPTIONS válidas que você pode especificar para a Fonte de Dados Externa ODBC Genérica do PolyBase são específicas 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 à configuração do atributo de instrução METADATA_ID. 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 enviar por push o operador TOP para o back-end. O padrão é uma cadeia de caracteres vazia, indicando a falta de suporte para pushdown TOP. 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'. |