• Artículo

Cómo crear perfiles de datos de rendimiento del controlador (ODBC)

La estructura SQLPERF se define en Odbcss.h.

Hay disponible un ejemplo completo que muestra directamente la creación de un archivo de registro de datos de rendimiento y la visualización de los datos de rendimiento de la estructura de datos SQLPERF. El código de ejemplo completo está en el archivo CreateAndDisplayPerformanceLog.cpp, que puede descargar de la página de descargas de SQL Server en MSDN. Este ejemplo se ha desarrollado utilizando Microsoft Visual C++ 2005 y se ha desarrollado para ODBC versión 3.0 o posterior.

Nota de seguridadNota de seguridad

Siempre que sea posible, utilice la autenticación de Windows. Si la autenticación de Windows no está disponible, solicite a los usuarios que escriban sus credenciales en tiempo de ejecución. No guarde las credenciales en un archivo. Si tiene que conservar las credenciales, debería cifrarlas con la API de criptografía de Win32.

Para registrar los datos de rendimiento del controlador mediante el Administrador ODBC

  1. En Panel de control, haga doble clic en Herramientas administrativas y, a continuación, en Orígenes de datos (ODBC). De modo alternativo, puede invocar odbcad32.exe.

  2. Haga clic en la ficha DSN de usuario, DSN de sistema o DSN de archivo.

  3. Haga clic en el origen de datos para el que desea registrar el rendimiento.

  4. Haga clic en Configurar.

  5. En el Asistente para configuración DSN de Microsoft SQL Server, navegue a la página con Registrar estadísticas del controlador ODBC en el archivo de registro.

  6. Seleccione Registrar estadísticas del controlador ODBC en el archivo de registro. En el cuadro, incluya el nombre del archivo donde se deben registrar las estadísticas. De manera opcional, haga clic en Examinar para buscar en el sistema de archivos el registro de estadísticas.

Para registrar mediante programación los datos de rendimiento del controlador

  1. Llame a SQLSetConnectAttr con SQL_COPT_SS_PERF_DATA_LOG y la ruta de acceso completa y el nombre de archivo del archivo de registro de los datos de rendimiento. Por ejemplo:

    "C:\\Odbcperf.log"

  2. Llame a SQLSetConnectAttr con SQL_COPT_SS_PERF_DATA y SQL_PERF_START para iniciar el registro de los datos de rendimiento.

  3. De manera opcional, llame a SQLSetConnectAttr con SQL_COPT_SS_LOG_NOW y NULL para escribir un registro delimitado por tabulaciones de los datos de rendimiento en el archivo de registro de los datos de rendimiento. Esto se puede hacer varias veces cuando se ejecuta la aplicación.

  4. Llame a SQLSetConnectAttr con SQL_COPT_SS_PERF_DATA y SQL_PERF_STOP para detener el registro de los datos de rendimiento.

Para extraer los datos de rendimiento del controlador en una aplicación

  1. Llame a SQLSetConnectAttr con SQL_COPT_SS_PERF_DATA y SQL_PERF_START para iniciar la generación de perfiles de datos de rendimiento.

  2. Llame a SQLGetConnectAttr con SQL_COPT_SS_PERF_DATA y la dirección de un puntero a una estructura SQLPERF. La primera vez dicha llamada establece el puntero en la dirección de una estructura SQLPERF válida que contiene los datos de rendimiento actuales. El controlador no actualiza continuamente los datos de la estructura de rendimiento. La aplicación debe repetir la llamada a SQLGetConnectAttr siempre que necesita actualizar la estructura con más datos de rendimiento actuales.

  3. Llame a SQLSetConnectAttr con SQL_COPT_SS_PERF_DATA y SQL_PERF_STOP para detener el registro de los datos de rendimiento.