Generar perfiles del rendimiento del controlador ODBC

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Importante

SQL Server Native Client (a menudo abreviado SNAC) se ha quitado de SQL Server 2022 (16.x) y SQL Server Management Studio 19 (SSMS). No se recomienda SQL Server Native Client (SQLNCLI o SQLNCLI11) ni el proveedor OLE DB de Microsoft heredado para SQL Server (SQLOLEDB) para el desarrollo de nuevas aplicaciones. Cambie al nuevo controlador OLE DB de Microsoft (MSOLEDBSQL) para SQL Server o al controlador ODBC de Microsoft ODBC Driver for SQL Server más reciente de ahora en adelante. Para SQLNCLI que se incluye como componente de SQL Server motor de base de datos (versiones 2012 a 2019), consulte esta excepción de ciclo de vida de soporte técnico.

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

• Consultas de ejecución prolongada.

  El controlador puede escribir en un archivo de registro cualquier consulta que no reciba una respuesta del servidor dentro de un período especificado de tiempo. A continuación, los programadores de la aplicación o los administradores de la base de datos pueden examinar cada instrucción SQL registrada para determinar cómo mejorar su rendimiento.

• Datos del rendimiento del controlador.

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

Cualquiera de los tipos de generación de perfiles se puede activar del siguiente modo:

• Conectándose a un origen de datos que especifique 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 para la combinación de una copia de controlador y un proceso de aplicación. Cuando algo en la aplicación activa la generación de perfiles, el proceso de generación de perfiles registra información de todas las conexiones activas en el controlador de esa aplicación. Se incluyen incluso las conexiones que no llamaron específicamente para la generación de perfiles.

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

Si una aplicación empieza a generar perfiles en un archivo de registro y una segunda aplicación intenta empezar a generar 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 empieza a generar perfiles después de que la primera haya descargado su controlador, la segunda aplicación sobrescribirá 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 registrar en un archivo delimitado por tabuladores. Los datos incluyen las siguientes categorías de estadísticas:

• Perfil de aplicación

• Conexión

• Red

• Time

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

Estadísticas de perfil de aplicación

Campo SQLPERF	Descripción
TimerResolution	Resolución mínima de la hora del reloj del servidor en milisegundos. Normalmente se indica como 0 (cero) y solo debe considerarse si el número notificado es grande. Si la resolución mínima del reloj del servidor es mayor que el intervalo probable para algunas de las estadísticas basadas en temporizador, esas estadísticas se podrían exagerar.
SQLidu	Número de instrucciones INSERT, DELETE o UPDATE después de SQL_PERF_START.
SQLiduRows	Número de instrucciones INSERT, DELETE o UPDATE después de SQL_PERF_START.
SQLSelects	Número de instrucciones SELECT procesadas después de SQL_PERF_START.
SQLSelectRows	Número de filas seleccionadas después de SQL_PERF_START.
Transacciones	Número de transacciones de usuario después de SQL_PERF_START, incluidas las reversiones. Cuando una aplicación ODBC se ejecuta con SQL_AUTOCOMMIT_ON, cada comando se considera una transacción.
SQLPrepares	Número de llamadas a la función SQLPrepare después de SQL_PERF_START.
ExecDirects	Número de llamadas a SQLExecDirect después de SQL_PERF_START.
SQLExecutes	Número de llamadas SQLExecute después de SQL_PERF_START.
CursorOpens	Número de veces que el controlador ha abierto un cursor del servidor después de SQL_PERF_START.
CursorSize	Número de filas en los conjuntos de resultados abiertos por los cursores después de SQL_PERF_START.
CursorUsed	Número de filas recuperadas realmente mediante el controlador de los cursores después de SQL_PERF_START.
PercentCursorUsed	Igual que CursorUsed/CursorSize. Por ejemplo, si una aplicación hace que el controlador abra un cursor de servidor para realizar "SELECT COUNT (*) FROM Authors", habrá 23 filas en el conjunto de resultados de la instrucción SELECT. Si la aplicación captura solo tres de estas filas, CursorUsed/CursorSize será 3/23, por lo que PercentCursorUsed será 13,043478.
AvgFetchTime	Igual que SQLFetchTime/SQLFetchCount.
AvgCursorSize	Igual que CursorSize/CursorOpens.
AvgCursorUsed	Igual que CursorUsed/CursorOpens.
SQLFetchTime	Cantidad acumulada de tiempo que tardaron en completarse las capturas de los cursores de servidor.
SQLFetchCount	Número de capturas realizadas de los cursores del servidor después de SQL_PERF_START.
CurrentStmtCount	Número de identificadores de instrucciones abiertos actualmente en todas las conexiones abiertas del controlador.
MaxOpenStmt	Número máximo de identificadores de instrucciones abiertos simultáneamente después de SQL_PERF_START.
SumOpenStmt	Número de identificadores de instrucciones que se han abierto después de SQL_PERF_START.
Estadísticas de conexión
CurrentConnectionCount	Número actual de controladores de conexiones activas que la aplicación ha abierto en el servidor.
MaxConnectionsOpened	Número máximo de controladores de conexiones simultáneas abiertos después de SQL_PERF_START.
SumConnectionsOpened	Suma del número de controladores de conexión abiertos después de SQL_PERF_START.
SumConnectionTime	Suma de la cantidad de tiempo que han estado abiertas todas las conexiones después de SQL_PERF_START. Por ejemplo, si una aplicación abrió 10 conexiones y mantuvo cada conexión durante 5 segundos, el valor de SumConnectionTime sería 50 segundos.
AvgTimeOpened	Igual que SumConnectionsOpened/SumConnectionTime.
Estadísticas de red
ServerRndTrips	Número de veces que el controlador envió comandos al servidor y obtuvo una respuesta.
BuffersSent	Número de paquetes de flujo de datos tabulares (TDS) enviados a SQL Server por el controlador después de SQL_PERF_START. Los comandos grandes pueden tomar varios búferes, de modo que si se envía un comando grande al servidor y llena seis paquetes, ServerRndTrips en uno y BuffersSent se incrementa en seis.
BuffersRec	Número de paquetes de TDS recibidos por el controlador de SQL Server después de que la aplicación empezara a usar el controlador.
BytesSent	Número de bytes de datos enviados a SQL Server en paquetes TDS después de que la aplicación empezara a usar el controlador.
BytesRec	Número de bytes de datos en paquetes de TDS recibidos por el controlador de SQL Server después de que la aplicación empezara a usar el controlador.

Estadísticas de tiempo

Campo SQLPERF	Descripción
msExecutionTime	Cantidad acumulada de tiempo que ha dedicado el controlador al procesamiento después de SQL_PERF_START, incluido el tiempo que ha pasado esperando respuestas del servidor.
msNetworkServerTime	Cantidad acumulada de tiempo que el controlador ha pasado esperando respuestas del servidor.

Consulte también

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