Configurable por el usuario (objeto de SQL Server)

Se aplica a:SQL Server

El objeto User Settable de Microsoft SQL Server permite crear instancias de contadores personalizadas. Utilice las instancias de contadores personalizadas para supervisar aspectos del servidor que los contadores existentes no supervisan, como los componentes únicos de la base de datos de SQL Server (por ejemplo, para determinar el número de pedidos de clientes registrados o el inventario de productos).

El objeto User Settable contiene diez instancias del contador de consultas: User counter 1 a User counter 10. Estos contadores se asignan a los sp_user_counter1 procedimientos almacenados de SQL Server mediante sp_user_counter10. A medida que las aplicaciones del usuario ejecutan estos procedimientos almacenados, los valores que establecen estos procedimientos almacenados se muestran en el Monitor de sistema. Un contador puede supervisar cualquier valor entero, por ejemplo, un procedimiento almacenado que cuente el número de pedidos de un producto específico que se han realizado en un día.

Nota:

El Monitor del sistema no realiza automáticamente el sondeo de los procedimientos almacenados de contadores del usuario. Es necesario ejecutarlos explícitamente en una aplicación de usuario para actualizar los valores de estos contadores. Utilice un desencadenador para actualizar automáticamente el valor del contador.

En esta tabla se describe el objeto User Settable de SQL Server.

Contadores de Establecidas por el usuario de SQL Server Descripción
Consultar El objeto User Settable contiene el contador de consultas. Los usuarios configuran cada contador de usuario del objeto de consulta. Cada contador es un tipo de datos entero.

En esta tabla se describen las instancias del contador Consulta .

Instancias del contador de consultas Descripción
User counter 1 Se define mediante sp_user_counter1.
User counter 2 Se define mediante sp_user_counter2.
User counter 3 Se define mediante sp_user_counter3.
...
User counter 10 Se define mediante sp_user_counter10.

Establecimiento del valor del contador de usuario

Para utilizar los procedimientos almacenados de contadores del usuario, ejecútelos desde su propia aplicación con un parámetro de número entero que represente el nuevo valor del contador. Por ejemplo, para establecer el valor 10 para User counter 1 , ejecute esta instrucción Transact-SQL:

EXECUTE dbo.sp_user_counter1 10;

Los procedimientos almacenados de contadores de usuario se pueden llamar desde los mismos lugares que otros procedimientos almacenados, por ejemplo los propios del usuario. Por ejemplo, puede crear el siguiente procedimiento almacenado para contar el número de conexiones e intentos de conexión realizados desde que se inició una instancia de SQL Server:

DROP PROC My_Proc;  
GO  
CREATE PROC My_Proc  
AS   
   EXECUTE dbo.sp_user_counter1 @@CONNECTIONS;  
GO  

La función @@CONNECTIONS devuelve el número de conexiones o intentos de conexión desde el inicio de una instancia de SQL Server. Este valor se pasa al procedimiento almacenado sp_user_counter1 como el parámetro.

Importante

Las consultas definidas en los procedimientos almacenados de contadores de usuario deben ser lo más sencillas posible. Las consultas con un gran uso de memoria que realizan un número significativo de operaciones de ordenación o de hash, o las consultas que realizan un gran número de operaciones de E/S tienen un gran costo de ejecución y pueden afectar al rendimiento.

Ejemplo de supervisión

Puede empezar a explorar los contadores en este objeto mediante esta consulta T-SQL en la vista de administración dinámica sys.dm_os_performance_counters:

SELECT * FROM sys.dm_os_performance_counters
WHERE object_name LIKE '%User Settable%';

Permisos

El procedimiento almacenado sp_user_counter está disponible para todos los usuarios, pero puede estar restringido para cualquier contador de consultas.