SQLSetConnectAttr

El controlador ODBC de SQL Server Native Client omite la configuración de SQL_ATTR_CONNECTION_TIMEOUT.

SQL_ATTR_TRANSLATE_LIB también se omite; No se admite la especificación de otra biblioteca de traducción. Para permitir que las aplicaciones se puedan migrar fácilmente para usar un controlador ODBC de Microsoft para SQL Server, cualquier valor establecido con SQL_ATTR_TRANSLATE_LIB se copiará en un búfer en el Administrador de controladores y se eliminará.

El controlador ODBC de SQL Server Native Client implementa el aislamiento de transacciones de lectura repetible como serializable.

SQL Server 2005 introdujo compatibilidad con un nuevo atributo de aislamiento de transacción, SQL_COPT_SS_TXN_ISOLATION. Establecer SQL_COPT_SS_TXN_ISOLATION en SQL_TXN_SS_SNAPSHOT indica que la transacción tendrá lugar en el nivel de aislamiento de instantáneas.

La promoción de atributos de instrucción ODBC a atributos de conexión puede tener consecuencias imprevistas. Los atributos de instrucción que solicitan cursores de servidor para el procesamiento del conjunto de resultados se pueden promover a la conexión. Por ejemplo, establecer el atributo de instrucción ODBC SQL_ATTR_CONCURRENCY en un valor más restrictivo que el valor predeterminado SQL_CONCUR_READ_ONLY dirige al controlador para usar cursores dinámicos para todas las instrucciones enviadas en la conexión. La ejecución de una función de catálogo ODBC en una instrucción de la conexión devuelve SQL_SUCCESS_WITH_INFO y un registro de diagnóstico que indica que el comportamiento del cursor se ha cambiado a solo lectura. Se produce un error al intentar ejecutar una instrucción SELECT de Transact-SQL que contiene una cláusula COMPUTE en la misma conexión.

El controlador ODBC de SQL Server Native Client admite una serie de extensiones específicas del controlador para los atributos de conexión ODBC definidos en sqlncli.h. El controlador ODBC de SQL Server Native Client puede requerir que el atributo se establezca antes de la conexión, o puede omitir el atributo si ya está establecido. En la tabla siguiente se enumeran las restricciones.

El uso de un atributo de conexión previa y el comando de Transact-SQL equivalente para la misma sesión, base de datos o estado de SQL Server puede producir un comportamiento inesperado. Por ejemplo

SQLSetConnectAttr(SQL_COPT_SS_QUOTED_IDENT, SQL_QI_ON) // turn ON via attribute  
SQLDriverConnect(...);  
SQLExecDirect("SET QUOTED_IDENTIFIER OFF") // turn OFF via Transact-SQL  
SQLSetConnectAttr(SQL_ATTR_CURRENT_CATALOG, ...) // restores to pre-connect attribute value  

SQL_COPT_SS_ANSI_NPW

SQL_COPT_SS_ANSI_NPW habilita o deshabilita el uso del control ISO de NULL en comparaciones y concatenación, relleno de tipos de datos de caracteres y advertencias. Para obtener más información, consulte SET ANSI_NULLS, SET ANSI_PADDING, SET ANSI_WARNINGS y SET CONCAT_NULL_YIELDS_NULL.

Si usa la agrupación de conexiones, SQL_COPT_SS_ANSI_NPW debe establecerse en la cadena de conexión, en lugar de con SQLSetConnectAttr. Una vez realizada una conexión, cualquier intento de cambiar este atributo producirá un error en modo silencioso cuando se use la agrupación de conexiones.

SQL_COPT_SS_APPLICATION_INTENT

Declara el tipo de carga de trabajo de la aplicación al conectarse a un servidor. Los valores posibles son Readonly y ReadWrite. Por ejemplo:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_APPLICATION_INTENT, TEXT("Readonly"), SQL_NTS)  

El valor predeterminado es ReadWrite. Para obtener más información sobre la compatibilidad de SQL Server Native Client con grupos de disponibilidad AlwaysOn, consulte Compatibilidad de SQL Server Native Client con alta disponibilidad y recuperación ante desastres.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME especifica el nombre del archivo principal de una base de datos adjuntable. Esta base de datos se adjunta y se convierte en la base de datos predeterminada para la conexión. Para usar SQL_COPT_SS_ATTACHDBFILENAME debe especificar el nombre de la base de datos como el valor del atributo de conexión SQL_ATTR_CURRENT_CATALOG o en el parámetro DATABASE = de sqlDriverConnect. Si la base de datos se adjuntó anteriormente, SQL Server no volverá a adjuntarla.

SQL_COPT_SS_BCP

SQL_COPT_SS_BCP habilita funciones de copia masiva en una conexión. Para obtener más información, vea Funciones de copia masiva.

SQL_COPT_SS_BROWSE_CONNECT

Este atributo se usa para personalizar el conjunto de resultados devuelto por SQLBrowseConnect. SQL_COPT_SS_BROWSE_CONNECT habilita o deshabilita la devolución de información adicional de una instancia enumerada de SQL Server. Esto puede incluir información como si el servidor es un clúster, nombres de instancias diferentes y el número de versión.

SQL_COPT_SS_BROWSE_SERVER

Este atributo se usa para personalizar el conjunto de resultados devuelto por SQLBrowseConnect. SQL_COPT_SS_BROWSE_SERVER especifica el nombre del servidor para el que SQLBrowseConnect devuelve la información.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL habilita o deshabilita el uso del control ISO de NULL al concatenar cadenas. Para obtener más información, consulte SET CONCAT_NULL_YIELDS_NULL.

SQL_COPT_SS_ENCRYPT

Controla el cifrado de una conexión.

El cifrado usa el certificado en el servidor. Debe comprobarlo una entidad de certificación, a menos que el atributo de conexión SQL_COPT_SS_TRUST_SERVER_CERTIFICATE esté establecido en SQL_TRUST_SERVER_CERTIFICATE_YES o la cadena de conexión contenga "TrustServerCertificate=yes". Si alguna de estas condiciones es true, se puede usar un certificado generado y firmado por el servidor para cifrar la conexión si no hay ningún certificado en el servidor.

SQL_COPT_SS_ENLIST_IN_DTC

El cliente llama al método Microsoft Distributed Transaction Coordinator (MS DTC) OLE DB ITransactionDispenser::BeginTransaction para iniciar una transacción de MS DTC y crear un objeto de transacción MS DTC que represente la transacción. A continuación, la aplicación llama SQLSetConnectAttr a con la opción SQL_COPT_SS_ENLIST_IN_DTC para asociar el objeto de transacción a la conexión ODBC. Toda la actividad de base de datos relacionada se realizará bajo la protección de la transacción ms DTC. La aplicación llama SQLSetConnectAttr a con SQL_DTC_DONE para finalizar la asociación DTC de la conexión.

SQL_COPT_SS_ENLIST_IN_XA

Para iniciar una transacción de XA con un procesador de transacciones compatible con XA (TP), el cliente llama a la función Open Group tx_begin . A continuación, la aplicación llama SQLSetConnectAttr a con un parámetro SQL_COPT_SS_ENLIST_IN_XA de TRUE para asociar la transacción XA a la conexión ODBC. Toda la actividad de base de datos relacionada se realizará bajo la protección de la transacción XA. Para finalizar una asociación de XA con una conexión ODBC, el cliente debe llamar SQLSetConnectAttr a con un parámetro SQL_COPT_SS_ENLIST_IN_XA de FALSE. Para obtener más información, consulte la documentación del Coordinador de transacciones distribuidas de Microsoft.

SQL_COPT_SS_FALLBACK_CONNECT

Este atributo ya no se admite.

SQL_COPT_SS_FAILOVER_PARTNER

Se usa para especificar o recuperar el nombre del asociado de conmutación por error usado para la creación de reflejo de la base de datos en SQL Server y es una cadena de caracteres terminada en null que se debe establecer antes de que se realice inicialmente la conexión a SQL Server.

Después de realizar la conexión, la aplicación puede consultar este atributo mediante SQLGetConnectAttr para determinar la identidad del asociado de conmutación por error. Si el servidor principal no tiene asociado de conmutación por error, esta propiedad devolverá una cadena vacía. Esto permite que una aplicación inteligente almacene en caché el servidor de copia de seguridad determinado más recientemente, pero estas aplicaciones deben tener en cuenta que la información solo se actualiza cuando la conexión se establece por primera vez o se restablece, si se agrupa y puede dejar de estar actualizada para las conexiones a largo plazo.

Para obtener más información, consulte Uso de la creación de reflejo de la base de datos.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY fuerza el uso de la autenticación de Windows para la validación de acceso en el inicio de sesión del servidor. Cuando se usa la autenticación de Windows, el controlador omite los valores de identificador de usuario y contraseña proporcionados como parte del procesamiento de SQLConnect, SQLDriverConnect o SQLBrowseConnect .

SQL_COPT_SS_MARS_ENABLED

Este atributo habilita o deshabilita varios conjuntos de resultados activos (MARS). De forma predeterminada, MARS está deshabilitado. Este atributo debe establecerse antes de establecer una conexión a SQL Server. Una vez abierta la conexión de SQL Server, MARS permanecerá habilitado o deshabilitado durante la vida útil de la conexión.

Para obtener más información sobre MARS, consulte Uso de varios conjuntos de resultados activos (MARS).

SQL_COPT_SS_MULTISUBNET_FAILOVER

Si la aplicación se conecta a un grupo de disponibilidad (AG) de grupos de disponibilidad AlwaysOn en subredes diferentes, esta propiedad de conexión configura SQL Server Native Client para proporcionar una detección y conexión más rápidas al servidor activo (actualmente). Por ejemplo:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_MULTISUBMIT_FAILOVER, SQL_IS_ON, SQL_IS_INTEGER)  

Para obtener más información sobre la compatibilidad de SQL Server Native Client con grupos de disponibilidad AlwaysOn, consulte Compatibilidad de SQL Server Native Client con alta disponibilidad y recuperación ante desastres.

SQL_COPT_SS_OLDPWD

La expiración de contraseñas para la autenticación de SQL Server se incorporó en SQL Server 2005. El atributo SQL_COPT_SS_OLDPWD se ha agregado para permitir que el cliente proporcione tanto la contraseña antigua como la nueva para la conexión. Cuando se establece esta propiedad, el proveedor no usará el grupo de conexiones para la primera conexión o para las conexiones posteriores, ya que la cadena de conexión contendrá la "contraseña antigua" que ahora ha cambiado.

Para obtener más información, consulte Cambio de contraseñas mediante programación.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA inicia o detiene el registro de datos de rendimiento. El nombre del archivo de registro de datos debe establecerse antes de iniciar el registro de datos. Consulte SQL_COPT_SS_PERF_DATA_LOG a continuación.

Para obtener más información, vea SQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG asigna el nombre del archivo de registro usado para registrar los datos de rendimiento. El nombre del archivo de registro es una cadena ANSI o Unicode terminada en null en función de la compilación de la aplicación. El argumento StringLength debe ser SQL_NTS.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW indica al controlador que escriba una entrada de registro de estadísticas en el disco. El argumento StringLength debe ser SQL_NTS.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY inicia o detiene el registro de consultas de larga duración. El nombre del archivo de registro de consultas debe proporcionarse antes de iniciar el registro. La aplicación puede definir la "ejecución prolongada" estableciendo el intervalo para el registro.

Para obtener más información, vea SQLGetConnectAttr.

SQL_COPT_SS_PERF_QUERY_INTERVAL

SQL_COPT_SS_PERF_QUERY_INTERVAL establece el umbral de registro de consultas en milisegundos. Las consultas que no se resuelven dentro del umbral se registran en el archivo de registro de consultas de larga duración. No hay ningún límite superior en el umbral de consulta. Un valor de umbral de consulta de cero provoca el registro de todas las consultas.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG asigna el nombre de un archivo de registro para grabar datos de consulta de larga duración. El nombre del archivo de registro es una cadena ANSI o Unicode terminada en null en función de la compilación de la aplicación. El argumento StringLength debe ser SQL_NTS o la longitud de la cadena en bytes.

SQL_COPT_SS_PRESERVE_CURSORS

Este atributo permite consultar y establecer si la conexión conservará o no los cursores al confirmar o revertir una transacción. La configuración es SQL_PC_ON o SQL_PC_OFF. El valor predeterminado es SQL_PC_OFF. Esta configuración controla si el controlador cerrará los cursores para usted cuando llame a SQLEndTran (o SQLTransact).

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT permite los identificadores entrecomillados en las instrucciones ODBC y Transact-SQL enviadas en la conexión. Al proporcionar identificadores entre comillas, el controlador ODBC de SQL Server Native Client permite nombres de objeto no válidos como "Mi tabla", que contiene un carácter de espacio en el identificador. Para obtener más información, consulte SET QUOTED_IDENTIFIER.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE hace que el controlador traduzca caracteres entre las páginas de códigos de cliente y servidor a medida que se intercambian datos MBCS. El atributo afecta solo a los datos almacenados en columnaschar, varchar y text de SQL Server.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE hace que el controlador habilite o deshabilite la validación de certificados al usar el cifrado. Este atributo es un valor de lectura y escritura, pero establecerlo después de establecer una conexión no tiene ningún efecto.

Las aplicaciones cliente pueden consultar esta propiedad después de abrir una conexión para determinar la configuración real de cifrado y validación en uso.

SQL_COPT_SS_TXN_ISOLATION

SQL_COPT_SS_TXN_ISOLATION establece el atributo de aislamiento de instantánea específico de SQL Server. El aislamiento de instantáneas no se puede establecer mediante SQL_ATTR_TXN_ISOLATION porque el valor es específico de SQL Server. Sin embargo, se puede recuperar mediante SQL_ATTR_TXN_ISOLATION o SQL_COPT_SS_TXN_ISOLATION.

Para obtener más información sobre el aislamiento de instantáneas, consulte Trabajar con aislamiento de instantáneas.

SQL_COPT_SS_USE_PROC_FOR_PREP

Este atributo ya no se admite.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA establece el puntero de datos de usuario. Los datos de usuario son la memoria propiedad del cliente registrada por conexión.

Para obtener más información, vea SQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Este atributo determina si recibirá una advertencia si hay una pérdida de datos durante una conversión de página de códigos. Esto solo se aplica a los datos procedentes del servidor.

Compatibilidad de SQLSetConnectAttr con nombres de entidad de seguridad de servicio (SPN)

SQLSetConnectAttr se puede usar para establecer el valor de los nuevos atributos de conexión SQL_COPT_SS_SERVER_SPN y SQL_COPT_SS_FAILOVER_PARTNER_SPN. Estos atributos no se pueden establecer cuando se abre una conexión; Si intenta establecer estos atributos cuando se abre una conexión, se devuelve el error HY011 con el mensaje "Operación no válida en este momento". (SQLSetConnectOption también se puede usar para establecer estos valores).

Para obtener más información sobre los SPN, consulte Nombres de entidad de seguridad de servicio (SPN) en Conexiones de cliente (ODBC).

SQL_COPT_SS_CONNECTION_DEAD

Se trata de un atributo de solo lectura.

Para obtener más información sobre SQL_COPT_SS_CONNECTION_DEAD, vea SQLGetConnectAttr y Conexión a un origen de datos (ODBC).

Ejemplo

En este ejemplo se registran los datos de rendimiento.

SQLPERF*     pSQLPERF;  
SQLINTEGER   nValue;  
  
// See if you are already logging. SQLPERF* will be NULL if not.  
SQLGetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA, &pSQLPERF,  
    sizeof(SQLPERF*), &nValue);  
  
if (pSQLPERF == NULL)  
    {  
    // Set the performance log file name.  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG,  
        (SQLPOINTER) "\\My LogDirectory\\MyServerLog.txt", SQL_NTS);  
  
    // Start logging...  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,  
        (SQLPOINTER) SQL_PERF_START, SQL_IS_INTEGER);  
    }  
else  
    {  
    // Take a snapshot now so that your performance statistics are discernible.  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
    }  
  
    // ...perform some action...  
  
// ...take a performance data snapshot...  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
  
    // ...perform more actions...  
  
// ...take another snapshot...  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
  
// ...and disable logging.  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,  
    (SQLPOINTER) SQL_PERF_STOP, SQL_IS_INTEGER);  
  
// Continue on...  

Véase también

Función SQLSetConnectAttr
Detalles de implementación de la API de ODBC
Funciones de copia masiva
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
SET CONCAT_NULL_YIELDS_NULL (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
Función SQLPrepare
SQLGetInfo