Compartir a través de


SQLGetConnectAttr

Se aplica a: SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)

El controlador ODBC de SQL Server Native Client define atributos de conexión específicos del controlador. Algunos de los atributos están disponibles para SQLGetConnectAttr, y la función se usa para notificar sus valores actuales. Los valores presentados para estos atributos no se garantizan hasta que se haya realizado una conexión o el atributo se haya establecido mediante SQLSetConnectAttr.

En este tema se enumeran los atributos de solo lectura. Para obtener información sobre los otros atributos de conexión específicos del controlador ODBC de SQL Server Native Client, vea SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

El atributo SQL_COPT_SS_CONNECTION_DEAD notifica el estado de una conexión a un servidor. El controlador consulta el estado actual de la conexión en la red.

Nota:

El atributo de conexión ODBC estándar SQL_ATTR_CONNECTION_DEAD devuelve el estado más reciente de la conexión. Éste podría no ser el estado de la conexión actual.

Valor Descripción
SQL_CD_TRUE Se ha perdido la conexión al servidor.
SQL_CD_FALSE La conexión está abierta y disponible para procesar una instrucción.

SQL_COPT_SS_CLIENT_CONNECTION_ID

El atributo de SQL_COPT_SS_CLIENT_CONNECTION_ID recupera el identificador de conexión del cliente, el cual se puede utilizar para encontrar:

  • Información de diagnóstico en el registro de XEvents, si se ha habilitado.

  • Información sobre errores de conexión en el búfer del anillo de conexión.

  • Información de diagnóstico de los registros de seguimiento de acceso a datos, si se ha habilitado.

Para obtener más información, vea Obtener acceso a la información de diagnóstico en el registro de eventos extendidos.

Valor Descripción
SQL_ERROR Error en la conexión
SQL_SUCCESS La conexión se realizó correctamente. El identificador de conexión del cliente se encuentra en el búfer de salida.

SQL_COPT_SS_PERF_DATA

El atributo SQL_COPT_SS_PERF_DATA devuelve un puntero a una estructura SQLPERF que contiene las estadísticas de rendimiento del controlador actual. SQLGetConnectAttr devolverá NULL si el registro de rendimiento no está habilitado. El controlador no actualiza de manera dinámica las estadísticas en la estructura SQLPERF. Llama a SQLGetConnectAttr cada vez que se actualicen las estadísticas de rendimiento.

Valor Description
NULL El registro de rendimiento no está habilitado.
Cualquier otro valor Un puntero a una estructura SQLPERF.

SQL_COPT_SS_PERF_QUERY

El atributo SQL_COPT_SS_PERF_QUERY devuelve TRUE si está habilitado el registro de consultas de larga ejecución. La solicitud devuelve FALSE si el registro de consultas no está activo.

SQL_COPT_SS_USER_DATA

El atributo SQL_COPT_SS_USER_DATA recupera el puntero de datos de usuario. Los datos de usuario se almacenan en la memoria propiedad del cliente y se registran por conexión. Si el puntero de datos de usuario no se ha establecido, SQL_UD_NOTSET, se devuelve un puntero NULL.

Valor Descripción
SQL_UD_NOTSET No se establece ningún puntero de datos de usuario.
Cualquier otro valor Un puntero a los datos de usuario.

Compatibilidad de SQLGetConnectAttr con los Nombres principales de servicio (SPN)

SQLGetConnectAttr se puede usar para consultar el valor de los nuevos atributos de conexión SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED y SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption también se puede usar para consultar estos valores).

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD solo está disponible para las conexiones abiertas que usan la autenticación de Windows.

Si no se ha establecido SQL_COPT_SS_SERVER_SPN o SQL_COPT_SS_FAILOVER_PARTNER, se devuelve el valor predeterminado (una cadena vacía).

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

Consulte también

Función SQLGetConnectAttr
Detalles de implementación de la API de ODBC
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)