SQLGetConnectAttrSQLGetConnectAttr

SE APLICA A: síSQL Server síAzure SQL Database síAzure SQL Data Warehouse síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

El controlador ODBC de SQL ServerSQL Server Native Client define los atributos de conexión específicos del controlador.The SQL ServerSQL Server Native Client ODBC driver defines driver-specific connection attributes. Algunos de los atributos están disponibles para SQLGetConnectAttr, y la función se usa para notificar sus valores actuales.Some of the attributes are available to SQLGetConnectAttr, and the function is used to report their current settings. 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.The values reported for these attributes are not guaranteed until after a connection has been made or the attribute has been set using SQLSetConnectAttr.

En este tema se enumeran los atributos de solo lectura.This topic lists the read only attributes. Para obtener información sobre otros atributos de conexión específicos del controlador de ODBC de SQL ServerSQL Server Native Client, vea SQLSetConnectAttr.For information about the other SQL ServerSQL Server Native Client ODBC driver-specific connection attributes, see SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEADSQL_COPT_SS_CONNECTION_DEAD

El atributo SQL_COPT_SS_CONNECTION_DEAD notifica el estado de una conexión a un servidor.The SQL_COPT_SS_CONNECTION_DEAD attribute reports the state of a connection to a server. El controlador consulta el estado actual de la conexión en la red.The driver queries the network for the current state of the connection.

Nota

El atributo de conexión ODBC estándar SQL_ATTR_CONNECTION_DEAD devuelve el estado más reciente de la conexión.The standard ODBC connection attribute SQL_ATTR_CONNECTION_DEAD returns the most recent state of the connection. Éste podría no ser el estado de la conexión actual.This might not be the current connection state.

ValorValue DescripciónDescription
SQL_CD_TRUESQL_CD_TRUE Se ha perdido la conexión al servidor.The connection to the server has been lost.
SQL_CD_FALSESQL_CD_FALSE La conexión está abierta y disponible para procesar una instrucción.The connection is open and available for statement processing.

SQL_COPT_SS_CLIENT_CONNECTION_IDSQL_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:The SQL_COPT_SS_CLIENT_CONNECTION_ID attribute retrieves the client connection ID, which can then be used to locate:

  • Información de diagnóstico en el registro de XEvents, si se ha habilitado.Diagnostic information in the XEvents log, when enabled.

  • Información sobre errores de conexión en el búfer del anillo de conexión.Connection error information in the connection ring buffer.

  • Información de diagnóstico de los registros de seguimiento de acceso a datos, si se ha habilitado.Diagnostic information in the data access tracing logs, when enabled.

Para obtener más información, consulte acceso a información de diagnóstico en el registro de eventos extendidos.For more information, see Accessing Diagnostic Information in the Extended Events Log.

ValorValue DescripciónDescription
SQL_ERRORSQL_ERROR Error en la conexión.The connection failed.
SQL_SUCCESSSQL_SUCCESS La conexión se realizó correctamente.The connection succeeded. El identificador de conexión del cliente se encuentra en el búfer de salida.The client connection ID will be found in the output buffer.

SQL_COPT_SS_PERF_DATASQL_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.The SQL_COPT_SS_PERF_DATA attribute returns a pointer to a SQLPERF structure containing the current driver performance statistics. SQLGetConnectAttr devolverá NULL si el registro de rendimiento no está habilitado.SQLGetConnectAttr will return NULL if performance logging is not enabled. El controlador no actualiza de manera dinámica las estadísticas en la estructura SQLPERF.The statistics in the SQLPERF structure are not dynamically updated by the driver. Llama a SQLGetConnectAttr cada vez que se actualicen las estadísticas de rendimiento.Call SQLGetConnectAttr each time the performance statistics need to be refreshed.

ValorValue DescripciónDescription
NULLNULL El registro de rendimiento no está habilitado.Performance logging is not enabled.
Cualquier otro valorAny other value Un puntero a una estructura SQLPERF.A pointer to a SQLPERF structure.

SQL_COPT_SS_PERF_QUERYSQL_COPT_SS_PERF_QUERY

El atributo SQL_COPT_SS_PERF_QUERY devuelve TRUE si está habilitado el registro de consultas de larga ejecución.The SQL_COPT_SS_PERF_QUERY attribute returns TRUE if logging of long running queries is enabled. La solicitud devuelve FALSE si el registro de consultas no está activo.The request returns FALSE if query logging is not active.

SQL_COPT_SS_USER_DATASQL_COPT_SS_USER_DATA

El atributo SQL_COPT_SS_USER_DATA recupera el puntero de datos de usuario.The SQL_COPT_SS_USER_DATA attribute retrieves the user-data pointer. Los datos de usuario se almacenan en la memoria propiedad del cliente y se registran por conexión.User data is stored in client-owned memory and recorded per connection. Si el puntero de datos de usuario no se ha establecido, SQL_UD_NOTSET, se devuelve un puntero NULL.If the user-data pointer has not been set, SQL_UD_NOTSET, a NULL pointer, is returned.

ValorValue DescripciónDescription
SQL_UD_NOTSETSQL_UD_NOTSET No se establece ningún puntero de datos de usuario.No user-data pointer is set.
Cualquier otro valorAny other value Un puntero a los datos de usuario.A pointer to the user data.

Compatibilidad de SQLGetConnectAttr con los Nombres principales de servicio (SPN)SQLGetConnectAttr Support for Service Principal Names (SPNs)

SQLGetConnectAttr puede usarse 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.SQLGetConnectAttr can be used to query the value of the new connection attributes SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED, and SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption también se puede usar para consultar estos valores.)(SQLGetConnectOption can also be used to query these values.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD solo está disponible para las conexiones abiertas que usan la autenticación de Windows.SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD is only available for open connections that use Windows Authentication.

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).If SQL_COPT_SS_SERVER_SPN or SQL_COPT_SS_FAILOVER_PARTNER has not been set, the default value (an empty string) is returned.

Para obtener más información acerca de los SPN, vea Service Principal Names (SPN) en conexiones cliente (ODBC).For more information about SPNs, see Service Principal Names (SPNs) in Client Connections (ODBC).

Vea tambiénSee Also

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