Uso de palabras clave de cadena de conexión con el controlador OLE DB para SQL Server
Se aplica a:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
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:
El controlador OLE DB para SQL Server permite la ambigüedad en las cadenas de conexión para mantener la compatibilidad con versiones anteriores (por ejemplo, algunas palabras clave pueden especificarse más de una vez y pueden permitirse palabras clave en conflicto cuya resolución se base en la posición o en la precedencia). 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 conjunto de propiedades DBPROPSET_DBINIT. En el segundo caso, se puede pasar una cadena de inicialización al método IDataInitialize::GetDataSource 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 usado por IDataInitialize::GetDataSource es, como mínimo, la descripción de propiedades 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 a través de los valores DBPROP_INIT_PROVIDERSTRING se establecen con los valores yes y no. Las propiedades booleanas establecidas en las cadenas de inicialización mediante IDataInitialize::GetDataSource se establecen con los valores true y false.
Las aplicaciones que usan IDataInitialize::GetDataSource también pueden usar las palabras clave empleadas por IDBInitialize::Initialize, pero solo para las propiedades que no tienen un valor predeterminado. Si una aplicación usa tanto la palabra clave IDataInitialize::GetDataSource como la palabra clave IDBInitialize::Initialize en la cadena de inicialización, se usa el valor de palabra clave IDataInitialize::GetDataSource. Se recomienda que las aplicaciones no usen las palabras clave IDBInitialize::Initialize en las cadenas de conexión IDataInitialize:GetDataSource, puesto que es posible que este comportamiento no se mantenga en versiones futuras.
Nota:
Una cadena de conexión pasada a través de IDataInitialize::GetDataSource se convierte en propiedades y se aplica por medio de IDBProperties::SetProperties. Si los servicios del componente encuentran la descripción de propiedad en IDBProperties::GetPropertyInfo, esta propiedad se aplica como propiedad independiente. De lo contrario, se aplicará a través de la propiedad DBPROP_PROVIDERSTRING. Por ejemplo, si se especifica la cadena de conexión Data Source=server1;Server=server2, Data Source se establecerá como propiedad, pero Server irá 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 usadas por las aplicaciones OLE DB que emplean DBPROP_INIT_PROVIDERSTRING con IDBInitialize::Initialize tienen la siguiente sintaxis:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-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 pueden utilizarse con DBPROP_INIT_PROVIDERSTRING.
| Palabra clave | Propiedad de inicialización | Descripción |
|---|---|---|
| Addr | SSPROP_INIT_NETWORKADDRESS | Sinónimo de Address. |
| Dirección | 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 también 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 que se pasa a Server en las cadenas de conexión cuando se usa OLE DB Driver for SQL Server. Tenga también en cuenta que Address=; se conecta al servidor especificado en la palabra clave Server, mientras que Address= ;, Address=.;, Address=localhost; y Address=(local); establecen una conexión al servidor local.La sintaxis completa de la palabra clave Address es la siguiente: [protocolo:]Address[,puerto |\canalización\nombreDeCanalización] protocolo puede ser tcp (TCP/IP), lpc (memoria compartida) o np (canalizaciones con nombre). Para más información sobre protocolos, consulte Configuración de protocolos de cliente. Si no se especifica un objeto protocol ni la palabra clave Network, OLE DB Driver for SQL Server utilizará el orden de protocolo especificado en Configuration Manager 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, debe especificar también el nombre de la base de datos con la palabra clave Database de la cadena 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. |
| Authentication1 | SSPROP_AUTH_MODE | Especifica la autenticación usada para SQL o Microsoft Entra. Los valores válidos son:
NOTA: La palabra clave ActiveDirectoryIntegrated 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). Se recomienda que las aplicaciones que usen palabras clave Integrated Security (o Trusted_Connection) o sus propiedades correspondientes establezcan el valor de la palabra clave Authentication (o su propiedad correspondiente) en ActiveDirectoryIntegrated para habilitar el nuevo comportamiento de cifrado y validación de certificados.NOTA: Se recomienda que las aplicaciones que usan la autenticación de SQL Server establezcan el valor de la palabra clave Authentication (o su propiedad correspondiente) en SqlPassword para habilitar el 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 daría como resultado que no se intentara volver a conectar. Para obtener más información, vea Resistencia de conexión inactiva. |
| 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, vea Resistencia de conexión inactiva. |
| Base de datos | 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. |
| Encrypt1 | 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 palabra clave HostNameInCertificate, el controlador usa el valor de palabra clave Server 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 está establecido en Strict, el certificado siempre se validará. |
| Idioma | 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 | Especifique siempre MultiSubnetFailover=Yes al conectarse a la escucha de grupo de disponibilidad de un grupo de disponibilidad de SQL Server o a 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 del servidor activo y una conexión con él más rápidas. Los valores posibles son Yes y No. El valor predeterminado es No. Por ejemplo:MultiSubnetFailover=YesPara 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 palabra clave Address reemplaza a la palabra clave Server. 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)\nombreDeInstancia; 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 palabra clave Server es la siguiente: Server= [protocol: ]Server[ ,port] 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\queryLa 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 un objeto protocol ni la palabra clave Network, OLE DB Driver for SQL Server utilizará el orden de protocolo especificado en Configuration Manager 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. Se omiten los espacios al principio del valor pasado a Server en las cadenas de conexión cuando se utiliza 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. |
| Tiempo de espera | 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. |
| TrustServerCertificate1 | 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 utilice SET FMTONLY en su lugar para la recuperación de metadatos. |
| 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, el comportamiento de cifrado y validación de certificados se modifica al usar las propiedades de inicialización de token de acceso o autenticación, o sus palabras clave de cadena de conexión correspondientes. Para obtener más información, vea Cifrado y validación de certificados.
Uso de IDataInitialize::GetDataSource
Las cadenas de conexión empleadas por las aplicaciones OLE DB que usan IDataInitialize::GetDataSource tienen la siguiente sintaxis:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
El uso de la propiedad debe cumplir la sintaxis permitida en su ámbito. Por ejemplo, WSID usa llaves ( {} ) para los caracteres de comillas y Application Name usa 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 pueden usarse con IDataInitialize::GetDataSource:
| Palabra clave | Propiedad de inicialización | Descripción |
|---|---|---|
| Token de acceso1 | 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 las palabras clave de cadena de conexión UID, PWD, Trusted_Connection o Authentication o sus propiedades o palabras clave correspondientes. |
| Nombre de la aplicación | 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. |
| Authentication1 | SSPROP_AUTH_MODE | Especifica la autenticación usada para SQL o Microsoft Entra. Los valores válidos son:
NOTA: La palabra clave ActiveDirectoryIntegrated 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). Se recomienda que las aplicaciones que usen palabras clave Integrated Security (o Trusted_Connection) o sus propiedades correspondientes establezcan el valor de la palabra clave Authentication (o su propiedad correspondiente) en ActiveDirectoryIntegrated para habilitar el nuevo comportamiento de cifrado y validación de certificados.NOTA: Se recomienda que las aplicaciones que usan la autenticación de SQL Server establezcan el valor de la palabra clave Authentication (o su propiedad correspondiente) en SqlPassword para habilitar el 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. |
| Recuento de reintentos de conexión | 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 daría como resultado que no se intentara volver a conectar. Para obtener más información, vea Resistencia de conexión inactiva. |
| Intervalo de reintentos de conexión | 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, vea Resistencia de conexión inactiva. |
| Current Language | SSPROPT_INIT_CURRENTLANGUAGE | Nombre del lenguaje SQL Server. |
| Data Source (Origen de datos) | 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 válida para las direcciones, vea la descripción de la palabra clave Server 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. |
| Nombre de host en certificado | 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 palabra clave Nombre de host en certificado, el controlador usa el valor de la palabra clave Origen de datos 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 (Usar cifrado para datos) está establecida en Strict, siempre se validará el certificado. |
| Catálogo original | DBPROP_INIT_CATALOG | Nombre de la base de datos. |
| Nombre de archivo inicial | 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, debe especificar también el nombre de la base de datos con la palabra clave DATABASE de la cadena 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. |
| Seguridad integrada | 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 | Especifique siempre MultiSubnetFailover=True al conectarse a la escucha de grupo de disponibilidad de un grupo de disponibilidad de SQL Server o a 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 del servidor activo y una conexión con él más rápidas. Los valores posibles son True y False. El valor predeterminado es False. Por ejemplo:MultiSubnetFailover=TruePara 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 válida para las direcciones, vea la descripción de la palabra clave Server en este tema. |
| 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). |
| Contraseña | 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 |
| Proveedor | En el caso de OLE DB Driver for SQL Server, debe ser "MSOLEDBSQL19" o "MSOLEDBSQL". | |
| Certificado de servidor | 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. |
| Certificado de servidor de confianza1 | 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. |
| Utilizar cifrado para los datos1 | 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 utilice SET FMTONLY en su lugar para la recuperación de metadatos. |
| Id. de usuario | 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 comportamiento de cifrado y validación de certificados se modifica cuando se usan las propiedades de inicialización de token de acceso y autenticación 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 Old Password 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 del proveedor.
Palabras clave de la cadena de conexión Objetos de datos ActiveX (ADO)
Las aplicaciones ADO establecen la propiedad ConnectionString de los objetos ADODBConnection o proporcionan una cadena de conexión como parámetro al método Open de los objetos ADODBConnection.
Las aplicaciones ADO también pueden usar las palabras clave que emplea el método IDBInitialize::Initialize de OLE DB, pero solo para las propiedades que no tienen un valor predeterminado. Si una aplicación usa tanto palabras clave de ADO como palabras clave IDBInitialize::Initialize en la cadena de inicialización, se usa el valor 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-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-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 pueden utilizarse con una cadena de conexión ADO.
| Palabra clave | Propiedad de inicialización | Descripción |
|---|---|---|
| Token de acceso1 | 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 las palabras clave de cadena de conexión UID, PWD, Trusted_Connection o Authentication o sus propiedades o palabras clave 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. |
| Nombre de la aplicación | SSPROP_INIT_APPNAME | Cadena que identifica la aplicación. |
| Authentication1 | SSPROP_AUTH_MODE | Especifica la autenticación usada para SQL o Microsoft Entra. Los valores válidos son:
NOTA: La palabra clave ActiveDirectoryIntegrated 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). Se recomienda que las aplicaciones que usen palabras clave Integrated Security (o Trusted_Connection) o sus propiedades correspondientes establezcan el valor de la palabra clave Authentication (o su propiedad correspondiente) en ActiveDirectoryIntegrated para habilitar el nuevo comportamiento de cifrado y validación de certificados.NOTA: Se recomienda que las aplicaciones que usan la autenticación de SQL Server establezcan el valor de la palabra clave Authentication (o su propiedad correspondiente) en SqlPassword para habilitar el 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. |
| Recuento de reintentos de conexión | 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 daría como resultado que no se intentara volver a conectar. Para obtener más información, vea Resistencia de conexión inactiva. |
| Intervalo de reintentos de conexión | 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, vea Resistencia de conexión inactiva. |
| Current Language | SSPROPT_INIT_CURRENTLANGUAGE | Nombre del lenguaje SQL Server. |
| Data Source (Origen de datos) | 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 válida para las direcciones, vea la descripción de la palabra clave Server 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. |
| 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. |
| Nombre de host en certificado | 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 palabra clave Nombre de host en certificado, el controlador usa el valor de la palabra clave Origen de datos 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 (Usar cifrado para datos) está establecida en Strict, siempre se validará el certificado. |
| Catálogo original | DBPROP_INIT_CATALOG | Nombre de la base de datos. |
| Nombre de archivo inicial | 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, debe especificar también el nombre de la base de datos con la palabra clave DATABASE de la cadena 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. |
| Seguridad integrada | 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 | Especifique siempre MultiSubnetFailover=True al conectarse a la escucha de grupo de disponibilidad de un grupo de disponibilidad de SQL Server o a 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 del servidor activo y una conexión con él más rápidas. Los valores posibles son True y False. El valor predeterminado es False. Por ejemplo:MultiSubnetFailover=TruePara 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 válida para las direcciones, vea la descripción de la palabra clave Server en este tema. |
| 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). |
| Contraseña | 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. |
| Proveedor | En el caso de OLE DB Driver for SQL Server, el valor es MSOLEDBSQL19 o MSOLEDBSQL. |
|
| Certificado de servidor | 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. |
| Certificado de servidor de confianza1 | 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. |
| Utilizar cifrado para los datos1 | 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 utilice SET FMTONLY en su lugar para la recuperación de metadatos. |
| Id. de usuario | 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 comportamiento de cifrado y validación de certificados se modifica cuando se usan las propiedades de inicialización de token de acceso y autenticación 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 anterior" 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 del proveedor.
Consulte también
Compilación de aplicaciones con el controlador OLE DB para SQL Server
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de