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)