Compartir a través de

CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores , Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

En este artículo se proporcionan detalles adicionales en CONNECTION_OPTIONS función del proveedor. El argumento CREATE EXTERNAL DATA SOURCECONNECTION_OPTIONS puede variar en función del proveedor de datos externo.

El CONNECTION_OPTIONS argumento de CREATE EXTERNAL DATA SOURCE se introdujo por primera vez en SQL Server 2019 (15.x). Este documento se aplica a SQL Server 2019 (15.x) para Windows y Linux, así como a clústeres de macrodatos de SQL Server 2019.

  • key_value_pair es la palabra clave y el valor de una opción de conexión específica.
  • Para usar varias opciones de conexión, sepárelas mediante punto y coma.
  • Los posibles pares clave-valor son específicos del controlador.

El resto de este artículo contiene opciones de conexión específicas del proveedor.

Origen de datos externo de SQL Server

Solo puede especificar los pares clave-valor que tienen una entrada en DSN y Las palabras clave y los atributos de cadena de conexión en la columna DSN/Connection String Keyword . Por ejemplo, no se admite la SQL_ATTR_TXN_ISOLATION palabra clave porque es un conjunto de atributos mediante SQLSetConnectAttr, no en la cadena de conexión.

Nota:

PolyBase solo admite microsoft ODBC Driver versión 17 y 18. Para obtener más información, vea Cambiar la versión del controlador de SQL Server para PolyBase.

Palabras clave y opciones de cadena de conexión para proveedores OLE DB de Microsoft:

Palabras clave y opciones de cadena de conexión para proveedores de base de datos ODBC de Microsoft:

Oráculo

Solo puede especificar los pares clave-valor que tienen una entrada en la tabla del protocolo de conexión de Oracle como se indica a continuación:

Atributo (nombre corto) Predeterminado
AccountingInfo (AI) Ninguno
Acción (ACT) Ninguno
AlternateServers (ASRV) Ninguno
AllowedOpenSSLVersions (AOV) más reciente
ApplicationName (AN) Ninguno
ApplicationUsingThreads (AUT) 1 (habilitado)
ArraySize (AS) 60000
AuthenticationMethod (AM) 1 (Cifrar contraseña)
BatchFailureReturnsError (BFRE) 0 (Deshabilitado)
BindParamsAsUnicode (BPAU) 0 (Deshabilitado)
BulkBinaryThreshold (BBT) 32
BulkCharacterThreshold (BCT) -1
BulkLoadBatchSize (BLBS) 1024
BulkLoadFieldDelimiter (BLFD) Ninguno
BulkLoadOptions (BLO) 0
BulkLoadRecordDelimiter (BLRD) Ninguno
CachedCursorLimit (CCL) 32
CachedDescriptionLimit (CDL) 0
CatalogIncludesSynonyms (CIS) 1 (habilitado)
CatalogOptions (CO) 0 (Deshabilitado)
ClientHostName (CHN) Ninguno
ClientID (CID) Ninguno
ClientUser (CU) Ninguno
ConnectionReset (CR) 0 (Deshabilitado)
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
CredentialsWalletEntry (CWE) Ninguno
CredentialsWalletPassword (CWPWD) Ninguno
CredentialsWalletPath (CWPATH) Ninguno
CryptoProtocolVersion (CPV) TLSv1.2,TLSv1.1,TLSv1
CryptoLibName (CLN) Cadena vacía
DataIntegrityLevel (DIL) 1 (aceptado)
DataIntegrityTypes (DIT) MD5, SHA1, SHA256, SHA384, SHA512
DataSourceName (DSN) Ninguno
DefaultLongDataBuffLen (DLDBL) 1024
DescribeAtPrepare (DAP) 0 (Deshabilitado)
Descripción (n/a) Ninguno
EditionName (EN) Ninguno
EnableBulkLoad (EBL) 0 (Deshabilitado)
EnableDescribeParam (EDP) 0 (Deshabilitado)
EnableNcharSupport (ENS) (en desuso). Ninguno
EnableScrollableCursors (ESC) 1 (habilitado)
EnableServerResultCache (ESRC) 0 (Deshabilitado)
EnableStaticCursorsForLongData (ESCLD) 0 (Deshabilitado)
EnableTimestampwithTimezone (ETWT) (en desuso) Ninguno
EncryptionLevel (EL) 1 (aceptado)
EncryptionMethod (EM) 0 (sin cifrado)
EncryptionTypes (ET) No se especifica ningún método de cifrado. El controlador envía una lista de todos los métodos de cifrado al servidor oracle.
FailoverGranularity (FG) 0 (no atómica)
FailoverMode (FM) 0 (conexión)
FailoverPreconnect (FP) 0 (Deshabilitado)
FetchTSWTZasTimestamp (FTSWTZAT) 0 (Deshabilitado)
GSSClient (GSSC) nativo
HostName (HOST) Ninguno
HostNameInCertificate (HNIC) Ninguno
IANAAppCodePage (IACP) (solo UNIX y Linux) 4 (ISO 8559-1 Latin-1)
ImpersonateUser (IU) Ninguno
InitializationString (IS) Ninguno
KeepAlive (KA) 0 (Deshabilitado)
KeyPassword (KP) Ninguno
Almacén de claves (KS) Ninguno
KeystorePassword (KSP) Ninguno
LDAPDistinguishedName (LDAPDN) Ninguno
LoadBalanceTimeout (LBT) 0
LoadBalancing (LB) 0 (Deshabilitado)
LOBPrefetchSize (LPS) 4000
LocalTimezoneOffset (LTZO) "" (cadena vacía)
LockTimeout (LTO) -1
LoginTimeout (LT) 15
LogonID (UID) Ninguno
MaxPoolSize (MXPS) 100
MinPoolSize (MNPS) 0
Módulo (MOD) Ninguno
Contraseña (PWD) Ninguno
Agrupación (POOL) 0 (Deshabilitado)
PortNumber (PUERTO) Ninguno
PRNGSeedFile (PSF) (solo UNIX y Linux) /dev/random
PRNGSeedSource (SOLO PSS) (solo UNIX y Linux) 0 (archivo)
ProcedureRetResults (PRR) 0 (Deshabilitado)
ProgramID (PID) Ninguno
ProxyHost (PXHN) Cadena vacía
ProxyMode (PXM) 0 (NONE)
ProxyPassword (PXPW) Cadena vacía
ProxyPort (PXPT) 0
ProxyUser (PXU) Cadena vacía
QueryTimeout (QT) 0
ReportCodepageConversionErrors (RCCE) 0 (Omitir errores)
ReportRecycleBin (RRB) 0 (Deshabilitado)
SDUSize (SDU) 16384
ServerName (SRVR) Ninguno
ServerType (ST) 0 (valor predeterminado del servidor)
ServiceName (SN) Ninguno. Si no se especifica ningún valor para la opción SID, Nombre de servicio o TNSNames, el controlador intenta conectarse al SID ORCL de forma predeterminada.
SID (SID) Ninguno. Si no se especifica ningún valor para la opción SID, Nombre de servicio o TNSNames, el controlador intenta conectarse al SID ORCL de forma predeterminada.
SSLLibName (SLN) Cadena vacía
SupportBinaryXML (SBX) 0 (Deshabilitado)
TimestampEscapeMapping (TEM) 0 (específico de la versión de Oracle)
TNSNamesFile (TNF) Ninguno. Si no se especifica ningún valor para la opción SID, Nombre de servicio o TNSNames, el controlador intenta conectarse al SID ORCL de forma predeterminada.
Truststore (TS) Ninguno
TruststorePassword (TSP) Ninguno
UseCurrentSchema (UCS) 1 (habilitado)
UseDefaultEncryptionOptions 1 (habilitado)
ValidateServerCertificate (VSC) 1 (habilitado)
WireProtocolMode (WPM) 2

Teradatos

Solo puede especificar los pares clave-valor que tienen una entrada en las opciones de configuración del conector proporcionadas en las opciones de configuración del conector de Teradata.

API de MongoDB para Cosmos DB

Solo puede especificar los pares clave-valor que tienen una entrada en las siguientes opciones de configuración del controlador.

Nombre de clave Predeterminado Obligatorio Descripción
DefaultStringColumnLength 255 No Número máximo de caracteres que se pueden contener en STRING columnas. El valor máximo que puede establecer para esta opción es 2147483647.
noCursorTimeout Falso No Esta opción especifica si el controlador permite que los cursores activos en el servidor de origen de datos expiren. Cuando FALSE, el servidor de origen de datos agotará el tiempo de espera de los cursores inactivos después del período de inactividad del umbral establecido en el servidor. Cuando se establece TRUEen , el controlador impide que el servidor de origen de datos agote el tiempo de espera de los cursores inactivos y existe el riesgo de que si el controlador debe salir o perder la conexión con el servidor de forma inesperada, el cursor permanece abierto en el servidor indefinidamente. Puede ajustar el umbral de los tiempos de espera de cursor inactivos en el servidor de MongoDB, consulte Parámetros del servidor de MongoDB para obtener más información sobre una implementación de Self-Managed .
SamplingLimit 100 No Número máximo de registros que el controlador puede muestrear para generar una definición de esquema temporal. Cuando esta opción se establece en 0, el controlador muestra todos los documentos de la base de datos.

Asegúrese de configurar el controlador para muestrear todos los datos necesarios. Los documentos que no están muestreados no se incluyen en la definición de esquema y, por tanto, no están disponibles en las aplicaciones ODBC.

Normalmente, el muestreo de un gran número de documentos da como resultado una definición de esquema más precisa y más capaz de representar todos los datos de la base de datos. Sin embargo, el proceso de muestreo puede tardar más de lo esperado cuando se muestrean muchos documentos, especialmente si la base de datos contiene estructuras de datos complejas y anidadas.
SamplingStrategy Adelante No Esta opción especifica cómo muestra los datos del controlador al generar una definición de esquema temporal.

Reenvío: el controlador muestra los datos a partir del primer registro de la base de datos, luego muestra el siguiente registro, etc.

Atrás: el controlador muestra los datos a partir del último registro de la base de datos, luego muestra el registro anterior, etc.

Aleatorio: el controlador selecciona registros de ejemplo del origen de datos de forma aleatoria hasta que se alcanza SamplingLimit.
SSL Borrar (0) No Esta opción especifica si el controlador usa SSL para conectarse al servidor.

Habilitado (1): el controlador usa SSL para conectarse al servidor.
Deshabilitado (0): el controlador no usa SSL para conectarse al servidor.

ODBC genérico

Válido CONNECTION_OPTIONS que puede especificar para el origen de datos externo ODBC genérico de PolyBase son específicos del controlador. Si no usa un proveedor ODBC proporcionado por Microsoft (consulte la sección anterior), consulte la documentación del controlador para ver los pares clave-valor válidos.

Hay algunos pares clave-valor válidos en PolyBase que están disponibles para todos los controladores ODBC genéricos. Las claves siguientes se agregaron a SQL Server 2019 en CU5.

Clave Valores posibles Descripción
PolyBaseOdbcSupportsRowCount TRUE, FALSE Indica si el controlador admite o no la función SQLRowCount a la que se llama en funciones de catálogo ODBC. El valor predeterminado es False. Por ejemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsRowCount=TRUE'.
PolyBaseOdbcSupportsMetadataIdAttributes TRUE, FALSE Indica si el controlador admite o no la configuración del atributo de instrucción METADATA_ID . El valor predeterminado es False. Por ejemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsMetadataIdAttributes=TRUE'.
PolyBaseOdbcSupportsBindOffset TRUE, FALSE Indica si el controlador admite o no desplazamientos de enlace para el enlace de filas de conjuntos de resultados. Si no es así, use el enlace de columnas. El valor predeterminado es False. Por ejemplo: CONNECTION_OPTIONS='PolyBaseOdbcSupportsBindOffset=TRUE'.
PolyBaseQoTopPushdownSyntax TOP, LIMIT Contiene información que especifica cómo insertar el TOP operador en el back-end. El valor predeterminado es una cadena vacía, lo que indica la falta de compatibilidad con TOP la inserción. Si el usuario especifica TOP, top {0} se usa como cadena de formato. Si el usuario especifica LIMIT, limit {0} se usa como cadena de formato. Esta implementación es específica del controlador, consulte la documentación del origen de datos externo o del controlador. Por ejemplo: CONNECTION_OPTIONS=PolyBaseQoTopPushdownSyntax=TOP'.

Contenido relacionado