Generar perfiles del rendimiento del controlador ODBC

El controlador ODBC de SQL Server Native Client puede generar perfiles de dos tipos de datos de rendimiento:

• Consultas de larga duración.

  El controlador puede escribir en un archivo de registro cualquier consulta que no obtenga una respuesta del servidor dentro de un período de tiempo especificado. Los programadores de aplicaciones o los administradores de bases de datos pueden investigar cada instrucción SQL registrada para determinar cómo pueden mejorar su rendimiento.

• Datos de rendimiento del controlador.

  El controlador puede registrar estadísticas de rendimiento y escribirlas en un archivo o ponerlas a disposición de una aplicación a través de una estructura de datos específica del controlador denominada SQLPERF. El archivo que contiene las estadísticas de rendimiento es un archivo delimitado por tabulaciones que se puede analizar fácilmente con cualquier hoja de cálculo que admita archivos delimitados por tabulaciones, como Microsoft Excel.

Cualquier tipo de generación de perfiles se puede activar mediante:

• Conexión a un origen de datos que especifica el registro.

• Llamar a SQLSetConnectAttr para establecer atributos específicos del controlador que controlan la generación de perfiles.

Cada proceso de aplicación obtiene su propia copia del controlador ODBC de SQL Server Native Client y la generación de perfiles es global a la combinación de una copia de controlador y un proceso de aplicación. Cuando cualquier elemento de la aplicación activa la generación de perfiles, la generación de perfiles registra información de todas las conexiones activas en el controlador desde esa aplicación. Incluso se incluyen las conexiones que no llamaron específicamente a la generación de perfiles.

Después de que el controlador haya abierto un registro de generación de perfiles (ya sea los datos de rendimiento o el registro de consultas de ejecución prolongada), no cierra el registro hasta que el Administrador de controladores ODBC descarga el controlador, cuando una aplicación libera todos los identificadores de entorno que abre en el controlador. Si la aplicación abre un nuevo identificador de entorno, se carga una nueva copia del controlador. Si la aplicación se conecta a un origen de datos que especifica el mismo archivo de registro o establece los atributos específicos del controlador para registrar en el mismo archivo, el controlador sobrescribe el registro anterior.

Si una aplicación inicia la generación de perfiles en un archivo de registro y una segunda aplicación intenta iniciar la generación de perfiles en el mismo archivo de registro, la segunda aplicación no puede registrar ningún dato de generación de perfiles. Si la segunda aplicación inicia la generación de perfiles después de que la primera aplicación haya descargado su controlador, la segunda sobrescribe el archivo de registro de la primera aplicación.

Si una aplicación se conecta a un origen de datos que tiene habilitada la generación de perfiles, el controlador devuelve SQL_ERROR si la aplicación llama a SQLSetConnectOption para iniciar el registro. Una llamada a SQLGetDiagRec devuelve lo siguiente:

SQLState: 01000, pfNative = 0  
ErrorMsg: [Microsoft][SQL Server Native Client]  
   An error has occurred during the attempt to access  
   the log file, logging disabled.  

El controlador deja de recopilar datos de rendimiento cuando se cierra un identificador de entorno. Si una aplicación de SQL Server Native Client tiene varias conexiones, cada una con su propio identificador de entorno, el controlador dejará de recopilar datos de rendimiento cuando se cierre cualquiera de los identificadores de entorno asociados.

Los datos de rendimiento del controlador se pueden almacenar en la estructura de datos SQLPERF o registrarse en un archivo delimitado por tabulaciones. Los datos incluyen las siguientes categorías de estadísticas:

• Perfil de aplicación

• Conexión

• Red

• Tiempo

En la tabla siguiente, las descripciones de los campos de la estructura de datos SQLPERF también se aplican a las estadísticas registradas en el archivo de registro de rendimiento.

Estadísticas de perfil de aplicación

Estadísticas de hora

Véase también

SQL Server Native Client (ODBC)
Temas de procedimientos de generación de perfiles del controlador ODBC (ODBC)