Compartilhar via


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:

Palavras-chave e opções de cadeia de conexão para provedores ODBC DB da Microsoft:

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'.

Próximas etapas