Compartir vía

Uso de palabras clave de cadena de conexión con el controlador OLE DB para SQL Server

Aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Analítica (PDW)Base de datos SQL en Microsoft Fabric

Descargar controlador OLE DB

Algunas API de OLE DB Driver for SQL Server usan cadenas de conexión para especificar atributos de conexión. Las cadenas de conexión son una lista de palabras clave y valores asociados; cada palabra clave identifica un atributo de conexión determinado.

Nota:

OLE DB Driver for SQL Server permite la ambigüedad en las cadenas de conexión para mantener la compatibilidad con versiones anteriores (por ejemplo, es posible especificar algunas palabras clave más de una vez, y se pueden permitir palabras clave en conflicto con resolución según la posición o prioridad). En futuras versiones de OLE DB Driver for SQL Server no se permitirán ambigüedades en las cadenas de conexión. Al modificar aplicaciones, es recomendable usar OLE DB Driver for SQL Server a fin de eliminar cualquier dependencia sobre la ambigüedad de las cadenas de conexión.

En las siguientes secciones se describen las palabras clave que pueden utilizarse con OLE DB Driver for SQL Server y los Objetos de datos ActiveX (ADO) cuando se utiliza OLE DB Driver for SQL Server como proveedor de datos.

Palabras clave de cadena de conexión de OLE DB Driver

Las aplicaciones OLE DB pueden inicializar los objetos de origen de datos de dos formas:

  • IDBInitialize::Initialize
  • IDataInitialize::GetDataSource

En el primer caso, se puede usar una cadena de proveedor para inicializar las propiedades de conexión estableciendo la propiedad DBPROP_INIT_PROVIDERSTRING en el DBPROPSET_DBINIT conjunto de propiedades. En el segundo caso, se puede pasar una cadena de inicialización al IDataInitialize::GetDataSource método para inicializar las propiedades de conexión. Ambos métodos inicializan las mismas propiedades de conexión OLE DB, pero se utilizan conjuntos diferentes de palabras clave. El conjunto de palabras clave que usa IDataInitialize::GetDataSource es, como mínimo, la descripción de las propiedades dentro del grupo de propiedades de inicialización.

En cualquier configuración de cadena de proveedor que tenga una propiedad OLE DB correspondiente establecida en algún valor predeterminado o establecida explícitamente en un valor, el valor de la propiedad OLE DB invalidará la configuración de la cadena de proveedor.

Las propiedades booleanas establecidas en las cadenas de proveedor mediante los valores DBPROP_INIT_PROVIDERSTRING se establecen con los valores yes y no. Las propiedades booleanas establecidas en cadenas de inicialización mediante IDataInitialize::GetDataSource se establecen mediante los valores true y false.

Las aplicaciones que usan IDataInitialize::GetDataSource también pueden usar las palabras clave usadas por IDBInitialize::Initialize, pero solo para las propiedades que no tienen un valor predeterminado. Si una aplicación usa la IDataInitialize::GetDataSource palabra clave y la IDBInitialize::Initialize palabra clave en la cadena de inicialización, se usa la configuración de la palabra clave IDataInitialize::GetDataSource. Se recomienda que las aplicaciones no usen IDBInitialize::Initialize palabras clave en IDataInitialize:GetDataSource cadenas de conexión, ya que es posible que este comportamiento no se mantenga en versiones futuras.

Nota:

Una cadena de conexión que se pasa a través IDataInitialize::GetDataSource se convierte en propiedades y se aplica a través de IDBProperties::SetProperties. Si los servicios de componentes encontraron la descripción de la propiedad en IDBProperties::GetPropertyInfo, esta propiedad se aplicará como una propiedad independiente. De lo contrario, se aplicará a través de la propiedad DBPROP_PROVIDERSTRING. Por ejemplo, si especifica la cadena Data Source=server1;Server=server2de conexión , Data Source se establecerá como una propiedad, pero Server pasará a una cadena de proveedor.

Si especifica varias instancias de la misma propiedad específica del proveedor, se utilizará el primer valor de la primera propiedad.

Uso de IDBInitialize::Initialize

Las cadenas de conexión que usan las aplicaciones OLE DB con DBPROP_INIT_PROVIDERSTRINGIDBInitialize::Initialize tienen la sintaxis siguiente:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=[{]attribute-value[}]
  • attribute-value ::= character-string
  • attribute-keyword ::= identifier

Los valores de atributo pueden incluirse opcionalmente entre llaves y es una práctica recomendable. Esta práctica evita que se produzcan problemas cuando los valores de atributo contienen caracteres no alfanuméricos. Se supone que la primera llave de cierre termina el valor, de modo que los valores no pueden contener caracteres de llave de cierre.

Un carácter de espacio después del signo = de una palabra clave de cadena de conexión se interpreta como un literal, incluso aunque el valor vaya entre comillas.

En la tabla siguiente se describen las palabras clave que se pueden usar con DBPROP_INIT_PROVIDERSTRING.

Palabra clave Propiedad de inicialización Descripción
Addr SSPROP_INIT_NETWORKADDRESS Sinónimo de Address.
Address SSPROP_INIT_NETWORKADDRESS Dirección de red del servidor en el que se ejecuta una instancia de SQL Server. Address suele ser el nombre de red del servidor, pero puede ser otros nombres, como una canalización, una dirección IP o un puerto TCP/IP y una dirección de socket.

Si especifica una dirección IP, asegúrese de que los protocolos TCP/IP o de canalizaciones con nombre estén habilitados en el Administrador de configuración de SQL Server.

El valor de Address tiene prioridad sobre el valor pasado a Server en cadenas de conexión cuando se usa OLE DB Driver for SQL Server. Address=; se conecta al servidor especificado en la Server palabra clave , mientras que Address= ;, Address=.;, Address=localhost;y Address=(local); provocan una conexión al servidor local.

La sintaxis completa de la Address palabra clave es la siguiente:

[protocolo:]Address[,port|\pipe\pipename]

protocolo puede ser tcp (TCP/IP), lpc (memoria compartida) o np (canalizaciones con nombre). Para obtener más información sobre los protocolos, consulte Configuración de protocolos de cliente.

Si no se especifica ni el protocolo ni la Network palabra clave , OLE DB Driver for SQL Server usará el orden de protocolo especificado en el Administrador de configuración de SQL Server.

port es el puerto al que se va a conectar en el servidor especificado. De forma predeterminada, SQL Server usa el puerto 1433.
APP SSPROP_INIT_APPNAME Cadena que identifica la aplicación.
ApplicationIntent SSPROP_INIT_APPLICATIONINTENT Declara el tipo de carga de trabajo de la aplicación al conectarse a un servidor. Los valores posibles son ReadOnly y ReadWrite.

El valor predeterminado es ReadWrite. Para más información sobre la compatibilidad de OLE DB Driver for SQL Server con Grupos de disponibilidad AlwaysOn, consulte Compatibilidad de OLE DB Driver for SQL Server con alta disponibilidad y recuperación ante desastres.
AttachDBFileName SSPROP_INIT_FILENAME Nombre del archivo principal (incluido el nombre de la ruta de acceso completa) de una base de datos adjuntable. Para usar AttachDBFileName, también debe especificar el nombre de la base de datos con la palabra clave Database de cadena de proveedor. Si la base de datos se ha adjuntado previamente, SQL Server no vuelve a adjuntarla, sino que utiliza la base de datos adjuntada como valor predeterminado para la conexión.
Authentication 1 SSPROP_AUTH_MODE Especifica la autenticación usada para SQL o Microsoft Entra. Los valores válidos son:
  • (not set): modo de autenticación determinado por otras palabras clave.
  • ActiveDirectoryPassword: ID de usuario y autenticación mediante contraseña con una identidad de Microsoft Entra.
  • ActiveDirectoryIntegrated: autenticación integrada con el identificador de Microsoft Entra.

    • Nota: La ActiveDirectoryIntegrated palabra clave también puede usarse para la autenticación de Windows en SQL Server. Reemplaza las palabras clave de autenticación Integrated Security (o Trusted_Connection). Las aplicaciones que usen Integrated Security (o Trusted_Connection) palabras clave o sus propiedades correspondientes deben establecer el valor de la Authentication palabra clave (o su propiedad correspondiente) a ActiveDirectoryIntegrated para habilitar el nuevo comportamiento de cifrado y validación de certificados.

  • ActiveDirectoryInteractive: autenticación interactiva con una identidad de Microsoft Entra. Este método admite la autenticación multifactor de Microsoft Entra.
  • ActiveDirectoryMSI: autenticación de Managed Identity. En el caso de una identidad asignada por el usuario, el identificador de usuario se establece en el identificador de objeto de la identidad del usuario.
  • ActiveDirectoryServicePrincipal: autenticación con un principal de servicio de Microsoft Entra. El identificador de usuario debe establecerse en el identificador de la aplicación (cliente). La contraseña debe establecerse en el secreto de la aplicación (cliente).
  • SqlPassword: autenticación mediante el identificador de usuario y la contraseña.

    • Nota: Las aplicaciones que usan autenticación SQL Server deben establecer el valor de la Authentication palabra clave (o su propiedad correspondiente) para SqlPassword habilitar un nuevo comportamiento de cifrado y validación de certificados.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Sinónimo de AutoTranslate.
AutoTranslate SSPROP_INIT_AUTOTRANSLATE Configura la traducción de caracteres OEM/ANSI. Los valores reconocidos son yes y no.
ConnectRetryCount SSPROP_INIT_CONNECT_RETRY_COUNT Controla el número de intentos de reconexión si se pierde la conexión. Los valores válidos oscilan entre 0 y 255. El valor predeterminado es 1. Un valor de 0 no daría como resultado ningún intento de volver a conectarse. Para obtener más información, consulte Resistencia de conexión inactiva en el controlador OLE DB.
ConnectRetryInterval SSPROP_INIT_CONNECT_RETRY_INTERVAL Especifica el número de segundos entre cada reintento de conexión si se pierde la conexión. Los valores válidos oscilan entre 1 y 60. El valor predeterminado es 10. Para obtener más información, consulte Resistencia de conexión inactiva en el controlador OLE DB.
Database DBPROP_INIT_CATALOG Nombre de la base de datos.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Especifica el modo de administración de tipos de datos que debe utilizarse. Los valores reconocidos son 0 para los tipos de datos del proveedor y 80 para los tipos de datos de SQL Server 2000 (8.x).
Encrypt 1 SSPROP_INIT_ENCRYPT Especifica si los datos deben cifrarse antes de enviarse a través de la red. Los valores posibles son Optional, Mandatory y Strict. El valor predeterminado es Mandatory. Para las versiones 18.x.x, consulte Diferencias de versión principal de MSOLEDBSQL.
FailoverPartner SSPROP_INIT_FAILOVERPARTNER Nombre del servidor de conmutación por error utilizado para la creación de reflejo de la base de datos.
FailoverPartnerSPN SSPROP_INIT_FAILOVERPARTNERSPN SPN del asociado de conmutación por error. El valor predeterminado es una cadena vacía. Una cadena vacía hace que OLE DB Driver for SQL Server utilice el SPN predeterminado generado por el proveedor.
HostNameInCertificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nombre de host que se va a usar al validar el certificado TLS/SSL de SQL Server. Si no se establece la HostNameInCertificate palabra clave , el controlador usa el valor de palabra Server clave en la dirección URL de conexión como nombre de host para validar el certificado TLS/SSL de SQL Server.
Nota: Esta propiedad se omite si el certificado de servidor es de confianza. Si Encrypt se establece en Strict, el certificado siempre se validará.
Language SSPROP_INIT_CURRENTLANGUAGE Lenguaje SQL Server.
MarsConn SSPROP_INIT_MARSCONNECTION Habilita o deshabilita conjuntos de resultados activos múltiples (MARS) en la conexión si el servidor es SQL Server 2005 (9.x) o posterior. Los valores posibles son yes y no. El valor predeterminado es no.
MultiSubnetFailover SSPROP_INIT_MULTISUBNETFAILOVER MultiSubnetFailover=Yes Especifique siempre al conectarse al agente de escucha del grupo de disponibilidad de un grupo de disponibilidad de SQL Server o una instancia de clúster de conmutación por error de SQL Server. MultiSubnetFailover=Yes configura el controlador OLE DB para SQL Server para proporcionar una detección más rápida y conexión al servidor actualmente activo. Los valores posibles son Yes y No. El valor predeterminado es No. Por ejemplo:

MultiSubnetFailover=Yes

Para más información sobre la compatibilidad de OLE DB Driver for SQL Server con Grupos de disponibilidad AlwaysOn, consulte Compatibilidad de OLE DB Driver for SQL Server con alta disponibilidad y recuperación ante desastres.
Net SSPROP_INIT_NETWORKLIBRARY Sinónimo de Network.
Network SSPROP_INIT_NETWORKLIBRARY Biblioteca de red que se utiliza para establecer una conexión a una instancia de SQL Server en la organización.
Network Library SSPROP_INIT_NETWORKLIBRARY Sinónimo de Network.
PacketSize SSPROP_INIT_PACKETSIZE Tamaño de paquete de flujo TDS. El valor predeterminado es 0 (el servidor determinará el valor real).
PersistSensitive DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Acepta las cadenas yes y no como valores. Al usar no, no se permite que el objeto de origen de datos conserve ninguna información confidencial de autenticación
PWD DBPROP_AUTH_PASSWORD Contraseña de inicio de sesión de SQL Server.
Server DBPROP_INIT_DATASOURCE Nombre de una instancia de SQL Server. El valor debe ser el nombre de un servidor de la red, una dirección IP o el nombre de un alias del Administrador de configuración de SQL Server.

Si no se especifica, se establece una conexión a la instancia predeterminada en el equipo local.

La Address palabra clave invalida la Server palabra clave .

Puede conectarse a la instancia predeterminada en el servidor local especificando una de las opciones siguientes:

Server=;
Server=.;
Server=(local);
Server=(local);
Server=(localhost);
Server=(localdb)\<instancename>;

Para más información sobre la compatibilidad con LocalDB, consulte Compatibilidad de OLE DB Driver for SQL Server con LocalDB.

Para especificar una instancia con nombre de SQL Server, anexe \<InstanceName>.

Cuando no se especifica ningún servidor, se establece una conexión a la instancia predeterminada en el equipo local.

Si especifica una dirección IP, asegúrese de que los protocolos TCP/IP o de canalizaciones con nombre estén habilitados en el Administrador de configuración de SQL Server.

La sintaxis completa de la Server palabra clave es la siguiente:

[protocolo:]Servidor[,puerto]

protocolo puede ser tcp (TCP/IP), lpc (memoria compartida) o np (canalizaciones con nombre).

En el ejemplo siguiente, se especifica una canalización con nombre:

np:\\.\pipe\MSSQL$MYINST01\sql\query

La línea anterior especifica el protocolo de canalización con nombre (np), una canalización con nombre en el equipo local (\\.\pipe), el nombre de la instancia de SQL Server (MSSQL$MYINST01) y el nombre predeterminado de la canalización con nombre (sql/query).

Si no se especifica ningún protocolo ni la Network palabra clave , OLE DB Driver for SQL Server usará el orden de protocolo especificado en el Administrador de configuración de SQL Server.

port es el puerto al que se va a conectar en el servidor especificado. De forma predeterminada, SQL Server usa el puerto 1433.

Los espacios se omiten al principio del valor pasado a Server en cadenas de conexión cuando se usa OLE DB Driver for SQL Server.
ServerCertificate SSPROP_INIT_SERVER_CERTIFICATE Especifica la ruta de acceso a un archivo de certificado que debe coincidir con el certificado TLS/SSL de SQL Server. Esta opción solo se puede usar cuando el cifrado Strict está habilitado. Los formatos de certificado permitidos son PEM, DER y CER. Si se especifica, el certificado de SQL Server se comprueba verificando si el certificado proporcionado constituye una coincidencia exacta.
ServerSPN SSPROP_INIT_SERVERSPN SPN del servidor. El valor predeterminado es una cadena vacía. Una cadena vacía hace que OLE DB Driver for SQL Server utilice el SPN predeterminado generado por el proveedor.
Timeout DBPROP_INIT_TIMEOUT Cantidad de tiempo (en segundos) que hay que esperar a que se complete la inicialización del origen de datos.
TransparentNetworkIPResolution SSPROP_INIT_TNIR Afecta la secuencia de conexión cuando la primera dirección IP resuelta del nombre de host no responde y hay varias direcciones IP asociadas con el nombre de host. TNIR interactúa con MultiSubnetFailover para proporcionar otras secuencias de conexión. Los valores posibles son Yes y No. El valor predeterminado es Yes. Para más información, vea Uso de resolución de IP de red transparente.
Trusted_Connection DBPROP_AUTH_INTEGRATED Si es yes, esta opción indica a OLE DB Driver for SQL Server que utilice la autenticación de Windows para la validación del inicio de sesión. De lo contrario, OLE DB Driver for SQL Server usará un nombre de usuario y una contraseña de SQL Server para la validación del inicio de sesión, y deben especificarse las palabras clave PWD y UID.
TrustServerCertificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Acepta las cadenas yes y no como valores. El valor predeterminado es no, que significa que se validará el certificado del servidor.
UID DBPROP_AUTH_USERID Nombre de inicio de sesión de SQL Server.
UseFMTONLY SSPROP_INIT_USEFMTONLY Controla cómo se recuperan los metadatos al conectarse a SQL Server 2012 (11.x) y versiones más recientes. Los valores posibles son yes y no. El valor predeterminado es no.

De forma predeterminada, OLE DB Driver for SQL Server usa los procedimientos almacenados sp_describe_first_result_set y sp_describe_undeclared_parameters para recuperar metadatos. Estos procedimientos almacenados tienen algunas limitaciones (por ejemplo, generarán un error al trabajar con tablas temporales). Al establecer UseFMTONLY en yes se indica al controlador que use SET FMTONLY para la recuperación de metadatos en su lugar.
UseProcForPrepare SSPROP_INIT_USEPROCFORPREP Esta palabra clave ha quedado en desuso y OLE DB Driver for SQL Server omite su valor.
WSID SSPROP_INIT_WSID Identificador de la estación de trabajo.

1 Para mejorar la seguridad, se modifica el comportamiento del cifrado y la validación de certificados al usar las propiedades de inicialización de autenticación, el token de acceso, o sus palabras clave correspondientes en la cadena de conexión. Para obtener más información, vea Cifrado y validación de certificados.

Usar IDataInitialize::GetDataSource

Las cadenas de conexión que usan IDataInitialize::GetDataSource las aplicaciones OLE DB tienen la sintaxis siguiente:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=[quote]attribute-value[quote]
  • attribute-value ::= character-string
  • attribute-keyword ::= identifier
  • quote ::= " | '

El uso de la propiedad debe cumplir la sintaxis permitida en su ámbito. Por ejemplo, WSID usa caracteres de comillas en llaves ({}) y Application Name utiliza caracteres de comillas simples (') o dobles ("). Solo se pueden entrecomillar las propiedades de cadena. Al intentar entrecomillar un entero o una propiedad enumerada se producirá un error Connection String doesn't conform to OLE DB specification.

Los valores de atributo pueden incluirse opcionalmente entre comillas simples o dobles, y es una práctica recomendada. Esta práctica evita que se produzcan problemas cuando los valores contienen caracteres no alfanuméricos. El carácter de comillas que se utilice también puede aparecer en los valores, siempre y cuando aparezca entre comillas dobles.

Un carácter de espacio después del signo = de una palabra clave de cadena de conexión se interpreta como un literal, aun cuando el valor esté entre comillas.

Si una cadena de conexión tiene más de una de las propiedades enumeradas en la tabla siguiente, se utilizará el valor de la última propiedad.

En la tabla siguiente se describen las palabras clave que se pueden usar con IDataInitialize::GetDataSource:

Palabra clave Propiedad de inicialización Descripción
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN El token de acceso que se usa para autenticarse en Microsoft Entra ID.

Nota: Es un error especificar esta palabra clave junto con las palabras clave de cadena de conexión UID, PWD, Trusted_Connection o Authentication, o con sus propiedades correspondientes.
Application Name SSPROP_INIT_APPNAME Cadena que identifica la aplicación.
Application Intent SSPROP_INIT_APPLICATIONINTENT Declara el tipo de carga de trabajo de la aplicación al conectarse a un servidor. Los valores posibles son ReadOnly y ReadWrite.

El valor predeterminado es ReadWrite. Para más información sobre la compatibilidad de OLE DB Driver for SQL Server con Grupos de disponibilidad AlwaysOn, consulte Compatibilidad de OLE DB Driver for SQL Server con alta disponibilidad y recuperación ante desastres.
Authentication 1 SSPROP_AUTH_MODE Especifica la autenticación usada para SQL o Microsoft Entra. Los valores válidos son:
  • (not set): modo de autenticación determinado por otras palabras clave.
  • ActiveDirectoryPassword: ID de usuario y autenticación mediante contraseña con una identidad de Microsoft Entra.
  • ActiveDirectoryIntegrated: autenticación integrada con el identificador de Microsoft Entra.

    • Nota: La ActiveDirectoryIntegrated palabra clave también puede usarse para la autenticación de Windows en SQL Server. Reemplaza las palabras clave de autenticación Integrated Security (o Trusted_Connection). Las aplicaciones que usen Integrated Security (o Trusted_Connection) palabras clave o sus propiedades correspondientes deben establecer el valor del Authentication (o su propiedad correspondiente) a ActiveDirectoryIntegrated para habilitar un nuevo comportamiento de cifrado y validación de certificados.

  • ActiveDirectoryInteractive: autenticación interactiva con una identidad de Microsoft Entra. Este método admite la autenticación multifactor de Microsoft Entra.
  • ActiveDirectoryMSI: autenticación de Managed Identity. En el caso de una identidad asignada por el usuario, el identificador de usuario se establece en el identificador de objeto de la identidad del usuario.
  • ActiveDirectoryServicePrincipal: autenticación con un principal de servicio de Microsoft Entra. El identificador de usuario debe establecerse en el identificador de la aplicación (cliente). La contraseña debe establecerse en el secreto de la aplicación (cliente).
  • SqlPassword: autenticación mediante el identificador de usuario y la contraseña.

    • Nota: Las aplicaciones que usan autenticación SQL Server deben establecer el valor de la Authentication palabra clave (o su propiedad correspondiente) para SqlPassword habilitar un nuevo comportamiento de cifrado y validación de certificados.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Configura la traducción de caracteres OEM/ANSI. Los valores reconocidos son true y false.
Connect Timeout DBPROP_INIT_TIMEOUT Cantidad de tiempo (en segundos) que hay que esperar a que se complete la inicialización del origen de datos.
Connect Retry Count SSPROP_INIT_CONNECT_RETRY_COUNT Controla el número de intentos de reconexión si se pierde la conexión. Los valores válidos oscilan entre 0 y 255. El valor predeterminado es 1. Un valor de 0 no daría como resultado ningún intento de volver a conectarse. Para obtener más información, consulte Resistencia de conexión inactiva en el controlador OLE DB.
Connect Retry Interval SSPROP_INIT_CONNECT_RETRY_INTERVAL Especifica el número de segundos entre cada reintento de conexión si se pierde la conexión. Los valores válidos oscilan entre 1 y 60. El valor predeterminado es 10. Para obtener más información, consulte Resistencia de conexión inactiva en el controlador OLE DB.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Nombre del lenguaje SQL Server.
Data Source DBPROP_INIT_DATASOURCE Nombre de una instancia de SQL Server en la organización.

Si no se especifica, se establece una conexión a la instancia predeterminada en el equipo local.

Para obtener más información sobre la sintaxis de dirección válida, vea la descripción de la Server palabra clave en este artículo.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Especifica el modo de administración de tipos de datos que debe utilizarse. Los valores reconocidos son 0 para los tipos de datos del proveedor y 80 para los tipos de datos de SQL Server 2000 (8.x).
Failover Partner SSPROP_INIT_FAILOVERPARTNER Nombre del servidor de conmutación por error utilizado para la creación de reflejo de la base de datos.
Failover Partner SPN SSPROP_INIT_FAILOVERPARTNERSPN SPN del asociado de conmutación por error. El valor predeterminado es una cadena vacía. Una cadena vacía hace que OLE DB Driver for SQL Server utilice el SPN predeterminado generado por el proveedor.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nombre de host que se va a usar al validar el certificado TLS/SSL de SQL Server. Si no se establece la Host Name In Certificate palabra clave , el controlador usa el valor de palabra Data Source clave en la dirección URL de conexión como nombre de host para validar el certificado TLS/SSL de SQL Server.
Nota: Esta propiedad se omite si el certificado de servidor es de confianza. Si Use Encryption for Data se establece en Strict, el certificado siempre se validará.
Initial Catalog DBPROP_INIT_CATALOG Nombre de la base de datos.
Initial File Name SSPROP_INIT_FILENAME Nombre del archivo principal (incluido el nombre de la ruta de acceso completa) de una base de datos adjuntable. Para usar AttachDBFileName, también debe especificar el nombre de la base de datos con la palabra clave de cadena DATABASE del proveedor. Si la base de datos se ha adjuntado previamente, SQL Server no vuelve a adjuntarla, sino que utiliza la base de datos adjuntada como valor predeterminado para la conexión.
Integrated Security DBPROP_AUTH_INTEGRATED Acepta el valor SSPI para la autenticación de Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Habilita o deshabilita conjuntos de resultados activos múltiples (MARS) en la conexión. Los valores reconocidos son true y false. El valor predeterminado es false.
MultiSubnetFailover SSPROP_INIT_MULTISUBNETFAILOVER MultiSubnetFailover=True Especifique siempre al conectarse al agente de escucha del grupo de disponibilidad de un grupo de disponibilidad de SQL Server o una instancia de clúster de conmutación por error de SQL Server. MultiSubnetFailover=True configura el Controlador OLE DB para SQL Server para proporcionar una detección y conexión más rápidas al servidor activo (actualmente). Los valores posibles son True y False. El valor predeterminado es False. Por ejemplo:

MultiSubnetFailover=True

Para más información sobre la compatibilidad de OLE DB Driver for SQL Server con Grupos de disponibilidad AlwaysOn, consulte Compatibilidad de OLE DB Driver for SQL Server con alta disponibilidad y recuperación ante desastres.
Network Address SSPROP_INIT_NETWORKADDRESS Dirección de red de una instancia de SQL Server en la organización.

Para obtener más información sobre la sintaxis de dirección válida, vea la descripción de la Address palabra clave en este artículo.
Network Library SSPROP_INIT_NETWORKLIBRARY Biblioteca de red que se utiliza para establecer una conexión a una instancia de SQL Server en la organización.
Packet Size SSPROP_INIT_PACKETSIZE Tamaño de paquete de flujo TDS. El valor predeterminado es 0 (el servidor determinará el valor real).
Password DBPROP_AUTH_PASSWORD Contraseña de inicio de sesión de SQL Server.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Acepta las cadenas true y false como valores. Si es false, no se permite que el objeto de origen de datos conserve ninguna información confidencial de autenticación
Provider En el caso de OLE DB Driver for SQL Server, el valor es MSOLEDBSQL19 o MSOLEDBSQL.
Server Certificate SSPROP_INIT_SERVER_CERTIFICATE Especifica la ruta de acceso a un archivo de certificado que debe coincidir con el certificado TLS/SSL de SQL Server. Esta opción solo se puede usar cuando el cifrado Strict está habilitado. Los formatos de certificado permitidos son PEM, DER y CER. Si se especifica, el certificado de SQL Server se comprueba verificando si el certificado proporcionado constituye una coincidencia exacta.
Server SPN SSPROP_INIT_SERVERSPN SPN del servidor. El valor predeterminado es una cadena vacía. Una cadena vacía hace que OLE DB Driver for SQL Server utilice el SPN predeterminado generado por el proveedor.
TransparentNetworkIPResolution SSPROP_INIT_TNIR Afecta la secuencia de conexión cuando la primera dirección IP resuelta del nombre de host no responde y hay varias direcciones IP asociadas con el nombre de host. TNIR interactúa con MultiSubnetFailover para proporcionar otras secuencias de conexión. Los valores posibles son True y False. El valor predeterminado es True. Para más información, vea Uso de resolución de IP de red transparente.
Trust Server Certificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Acepta las cadenas true y false como valores. El valor predeterminado es false, que significa que se validará el certificado del servidor.
Use Encryption for Data 1 SSPROP_INIT_ENCRYPT Especifica si los datos deben cifrarse antes de enviarse a través de la red. Los valores posibles son Optional, Mandatory y Strict. El valor predeterminado es Mandatory. Para las versiones 18.x.x, consulte Diferencias de versión principal de MSOLEDBSQL.
Use FMTONLY SSPROP_INIT_USEFMTONLY Controla cómo se recuperan los metadatos al conectarse a SQL Server 2012 (11.x) y versiones más recientes. Los valores posibles son true y false. El valor predeterminado es false.

De forma predeterminada, OLE DB Driver for SQL Server usa los procedimientos almacenados sp_describe_first_result_set y sp_describe_undeclared_parameters para recuperar metadatos. Estos procedimientos almacenados tienen algunas limitaciones (por ejemplo, generarán un error al trabajar con tablas temporales). Al establecer Use FMTONLY en true se indica al controlador que use SET FMTONLY para la recuperación de metadatos en su lugar.
User ID DBPROP_AUTH_USERID Nombre de inicio de sesión de SQL Server.
Workstation ID SSPROP_INIT_WSID Identificador de la estación de trabajo.

1 Para mejorar la seguridad, el cifrado y el comportamiento de validación de certificados se modifica cuando se usan las propiedades de inicialización de token de autenticación/acceso o sus palabras clave de cadena de conexión correspondientes. Para más información, consulte Cifrado y validación de certificados.

Nota:

En la cadena de conexión, la Old Password propiedad establece SSPROP_AUTH_OLD_PASSWORD, que es la contraseña actual (posiblemente expirada) que no está disponible a través de una propiedad de cadena de proveedor.

Palabras clave de cadena de conexión de ActiveX Data Objects (ADO)

Las aplicaciones de ADO configuran la propiedad ConnectionString de los objetos ADODBConnection o proporcionan una cadena de conexión como un parámetro para el método Open de los objetos ADODBConnection.

Las aplicaciones de ADO también pueden usar las palabras clave que usa el método OLE DB IDBInitialize::Initialize , pero solo para las propiedades que no tienen un valor predeterminado. Si una aplicación usa las palabras clave de ADO y las IDBInitialize::Initialize palabras clave de la cadena de inicialización, se usará la configuración de palabra clave de ADO. Se recomienda que las aplicaciones utilicen solamente palabras clave de cadena de conexión ADO.

Las cadenas de conexión utilizadas por ADO presentan la sintaxis siguiente:

  • connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
  • empty-string ::=
  • attribute ::= attribute-keyword=["]attribute-value["]
  • attribute-value ::= character-string
  • attribute-keyword ::= identifier

Los valores de atributo pueden incluirse opcionalmente entre comillas dobles y es una práctica recomendable. Esta práctica evita que se produzcan problemas cuando los valores contienen caracteres no alfanuméricos. Los valores de atributo no pueden incluir comillas dobles.

En la tabla siguiente se describen las palabras clave que se pueden usar con una cadena de conexión de ADO:

Palabra clave Propiedad de inicialización Descripción
Access Token 1 SSPROP_AUTH_ACCESS_TOKEN El token de acceso que se usa para autenticarse en Microsoft Entra ID.

Nota: Es un error especificar esta palabra clave y también UID, PWD, Trusted_Connection, o Authentication como palabras clave de cadena de conexión o sus propiedades correspondientes.
Application Intent SSPROP_INIT_APPLICATIONINTENT Declara el tipo de carga de trabajo de la aplicación al conectarse a un servidor. Los valores posibles son ReadOnly y ReadWrite.

El valor predeterminado es ReadWrite. Para más información sobre la compatibilidad de OLE DB Driver for SQL Server con Grupos de disponibilidad AlwaysOn, consulte Compatibilidad de OLE DB Driver for SQL Server con alta disponibilidad y recuperación ante desastres.
Application Name SSPROP_INIT_APPNAME Cadena que identifica la aplicación.
Authentication 1 SSPROP_AUTH_MODE Especifica la autenticación usada para SQL o Microsoft Entra. Los valores válidos son:
  • (not set): modo de autenticación determinado por otras palabras clave.
  • ActiveDirectoryPassword: ID de usuario y autenticación mediante contraseña con una identidad de Microsoft Entra.
  • ActiveDirectoryIntegrated: autenticación integrada con el identificador de Microsoft Entra.

    • Nota: La ActiveDirectoryIntegrated palabra clave también puede usarse para la autenticación de Windows en SQL Server. Reemplaza las palabras clave de autenticación Integrated Security (o Trusted_Connection). Las aplicaciones que usen Integrated Security (o Trusted_Connection) palabras clave o sus propiedades correspondientes deben establecer el valor de la palabra clave Authentication (o su propiedad correspondiente) a ActiveDirectoryIntegrated para habilitar nuevas funcionalidades de cifrado y validación de certificados.

  • ActiveDirectoryInteractive: autenticación interactiva con una identidad de Microsoft Entra. Este método admite la autenticación multifactor de Microsoft Entra.
  • ActiveDirectoryMSI: autenticación de Managed Identity. En el caso de una identidad asignada por el usuario, el identificador de usuario se establece en el identificador de objeto de la identidad del usuario.
  • ActiveDirectoryServicePrincipal: autenticación con un principal de servicio de Microsoft Entra. El identificador de usuario debe establecerse en el identificador de la aplicación (cliente). La contraseña debe establecerse en el secreto de la aplicación (cliente).
  • SqlPassword: autenticación mediante el identificador de usuario y la contraseña.

    • Nota: Las aplicaciones que usan autenticación SQL Server deben establecer el valor de la Authentication palabra clave (o su propiedad correspondiente) para SqlPassword habilitar un nuevo comportamiento de cifrado y validación de certificados.
Auto Translate SSPROP_INIT_AUTOTRANSLATE Configura la traducción de caracteres OEM/ANSI. Los valores reconocidos son true y false.
Connect Timeout DBPROP_INIT_TIMEOUT Cantidad de tiempo (en segundos) que hay que esperar a que se complete la inicialización del origen de datos.
Connect Retry Count SSPROP_INIT_CONNECT_RETRY_COUNT Controla el número de intentos de reconexión si se pierde la conexión. Los valores válidos oscilan entre 0 y 255. El valor predeterminado es 1. Un valor de 0 no daría como resultado ningún intento de volver a conectarse. Para obtener más información, consulte Resistencia de conexión inactiva en el controlador OLE DB.
Connect Retry Interval SSPROP_INIT_CONNECT_RETRY_INTERVAL Especifica el número de segundos entre cada reintento de conexión si se pierde la conexión. Los valores válidos oscilan entre 1 y 60. El valor predeterminado es 10. Para obtener más información, consulte Resistencia de conexión inactiva en el controlador OLE DB.
Current Language SSPROPT_INIT_CURRENTLANGUAGE Nombre del lenguaje SQL Server.
Data Source DBPROP_INIT_DATASOURCE Nombre de una instancia de SQL Server en la organización.

Si no se especifica, se establece una conexión a la instancia predeterminada en el equipo local.

Para obtener más información sobre la sintaxis de dirección válida, vea la descripción de la Server palabra clave en este artículo.
DataTypeCompatibility SSPROP_INIT_DATATYPECOMPATIBILITY Especifica el modo de administración de tipos de datos que se utilizará. Los valores reconocidos son 0 para los tipos de datos del proveedor y 80 para los tipos de datos de SQL Server 2000 (8.x).
Failover Partner SSPROP_INIT_FAILOVERPARTNER Nombre del servidor de conmutación por error utilizado para la creación de reflejo de la base de datos.
Failover Partner SPN SSPROP_INIT_FAILOVERPARTNERSPN SPN del asociado de conmutación por error. El valor predeterminado es una cadena vacía. Una cadena vacía hace que OLE DB Driver for SQL Server utilice el SPN predeterminado generado por el proveedor.
Host Name In Certificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nombre de host que se va a usar al validar el certificado TLS/SSL de SQL Server. Si no se establece la Host Name In Certificate palabra clave , el controlador usa el valor de palabra Data Source clave en la dirección URL de conexión como nombre de host para validar el certificado TLS/SSL de SQL Server.
Nota: Esta propiedad se omite si el certificado de servidor es de confianza. Si Use Encryption for Data se establece en Strict, el certificado siempre se validará.
Initial Catalog DBPROP_INIT_CATALOG Nombre de la base de datos.
Initial File Name SSPROP_INIT_FILENAME Nombre del archivo principal (incluido el nombre de la ruta de acceso completa) de una base de datos adjuntable. Para usar AttachDBFileName, también debe especificar el nombre de la base de datos con la palabra clave de cadena DATABASE del proveedor. Si la base de datos se ha adjuntado previamente, SQL Server no vuelve a adjuntarla, sino que utiliza la base de datos adjuntada como valor predeterminado para la conexión.
Integrated Security DBPROP_AUTH_INTEGRATED Acepta el valor SSPI para la autenticación de Windows.
MARS Connection SSPROP_INIT_MARSCONNECTION Habilita o deshabilita conjuntos de resultados activos múltiples (MARS) en la conexión si el servidor es SQL Server 2005 (9.x) o posterior. Los valores reconocidos son true y false. El valor predeterminado es false.
MultiSubnetFailover SSPROP_INIT_MULTISUBNETFAILOVER MultiSubnetFailover=True Especifique siempre al conectarse al agente de escucha del grupo de disponibilidad de un grupo de disponibilidad de SQL Server o una instancia de clúster de conmutación por error de SQL Server. MultiSubnetFailover=True configura el controlador OLE DB para SQL Server para proporcionar una detección y conexión más rápidas al servidor activo (actualmente). Los valores posibles son True y False. El valor predeterminado es False. Por ejemplo:

MultiSubnetFailover=True

Para más información sobre la compatibilidad de OLE DB Driver for SQL Server con Grupos de disponibilidad AlwaysOn, consulte Compatibilidad de OLE DB Driver for SQL Server con alta disponibilidad y recuperación ante desastres.
Network Address SSPROP_INIT_NETWORKADDRESS Dirección de red de una instancia de SQL Server en la organización.

Para obtener más información sobre la sintaxis de dirección válida, vea la descripción de la Address palabra clave en este artículo.
Network Library SSPROP_INIT_NETWORKLIBRARY Biblioteca de red que se utiliza para establecer una conexión a una instancia de SQL Server en la organización.
Packet Size SSPROP_INIT_PACKETSIZE Tamaño de paquete de flujo TDS. El valor predeterminado es 0 (el servidor determinará el valor real).
Password DBPROP_AUTH_PASSWORD Contraseña de inicio de sesión de SQL Server.
Persist Security Info DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Acepta las cadenas true y false como valores. Si es false, no se permite que el objeto de origen de datos conserve ninguna información confidencial de autenticación.
Provider En el caso de OLE DB Driver for SQL Server, el valor es MSOLEDBSQL19 o MSOLEDBSQL.
Server Certificate SSPROP_INIT_SERVER_CERTIFICATE Especifica la ruta de acceso a un archivo de certificado que debe coincidir con el certificado TLS/SSL de SQL Server. Esta opción solo se puede usar cuando el cifrado Strict está habilitado. Los formatos de certificado permitidos son PEM, DER y CER. Si se especifica, el certificado de SQL Server se comprueba verificando si el certificado proporcionado constituye una coincidencia exacta.
Server SPN SSPROP_INIT_SERVERSPN SPN del servidor. El valor predeterminado es una cadena vacía. Una cadena vacía hace que OLE DB Driver for SQL Server utilice el SPN predeterminado generado por el proveedor.
TransparentNetworkIPResolution SSPROP_INIT_TNIR Afecta la secuencia de conexión cuando la primera dirección IP resuelta del nombre de host no responde y hay varias direcciones IP asociadas con el nombre de host. TNIR interactúa con MultiSubnetFailover para proporcionar otras secuencias de conexión. Los valores posibles son True y False. El valor predeterminado es True. Para más información, vea Uso de resolución de IP de red transparente.
Trust Server Certificate 1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Acepta las cadenas true y false como valores. El valor predeterminado es false, que significa que se validará el certificado del servidor.
Use Encryption for Data 1 SSPROP_INIT_ENCRYPT Especifica si los datos deben cifrarse antes de enviarse a través de la red. Los valores posibles son Optional, Mandatory y Strict. El valor predeterminado es Mandatory. Para las versiones 18.x.x, consulte Diferencias de versión principal de MSOLEDBSQL.
Use FMTONLY SSPROP_INIT_USEFMTONLY Controla cómo se recuperan los metadatos al conectarse a SQL Server 2012 (11.x) y versiones más recientes. Los valores posibles son true y false. El valor predeterminado es false.

De forma predeterminada, OLE DB Driver for SQL Server usa los procedimientos almacenados sp_describe_first_result_set y sp_describe_undeclared_parameters para recuperar metadatos. Estos procedimientos almacenados tienen algunas limitaciones (por ejemplo, generarán un error al trabajar con tablas temporales). Al establecer Use FMTONLY en true se indica al controlador que use SET FMTONLY para la recuperación de metadatos en su lugar.
User ID DBPROP_AUTH_USERID Nombre de inicio de sesión de SQL Server.
Workstation ID SSPROP_INIT_WSID Identificador de la estación de trabajo.

1 Para mejorar la seguridad, el cifrado y el comportamiento de validación de certificados se modifica cuando se usan las propiedades de inicialización de token de autenticación/acceso o sus palabras clave de cadena de conexión correspondientes. Para más información, consulte Cifrado y validación de certificados.

Nota:

En la cadena de conexión, la propiedad "Contraseña antigua" establece SSPROP_AUTH_OLD_PASSWORD, que es la contraseña actual (posiblemente expirada) que no está disponible a través de una propiedad de cadena de proveedor.

Contenido relacionado

  • Last updated on