SQL Server, objet configurable par l'utilisateur

L’objet User Settable dans Microsoft SQL Server vous permet de créer des instances de compteur personnalisées. Utilisez des instances de compteur personnalisées pour surveiller les aspects du serveur non surveillés par les compteurs existants, tels que les composants propres à votre base de données SQL Server (par exemple, le nombre de commandes client enregistrées ou l’inventaire des produits).

L’objet User Settable contient 10 instances du compteur de requête : compteur utilisateur 1 à compteur utilisateur 10. Ces compteurs correspondent aux procédures stockées SQL Server sp_user_counter1 via sp_user_counter10. À mesure que ces procédures stockées sont exécutées par des applications utilisateur, les valeurs définies par les procédures stockées sont affichées dans Le Moniteur système. Un compteur peut surveiller n’importe quelle valeur entière unique (par exemple, une procédure stockée qui compte le nombre de commandes d’un produit particulier qui se sont produites en un jour).

Remarque

Les procédures stockées du compteur utilisateur ne sont pas interrogées automatiquement par le Moniteur système. Elles doivent être exécutées explicitement par une application utilisateur pour que les valeurs de compteur soient mises à jour. Utilisez un déclencheur pour mettre à jour automatiquement la valeur du compteur. Par exemple, pour créer un compteur qui surveille le nombre de lignes d’une table, créez un déclencheur INSERT et DELETE sur la table qui exécute l’instruction suivante : SELECT COUNT(*) FROM table Chaque fois que le déclencheur est déclenché en raison d’une opération INSERT ou DELETE sur la table, le compteur Moniteur système est automatiquement mis à jour.

Ce tableau décrit l’objet SQL Server User Settable .

Compteurs utilisateur paramétrables SQL Server	Descriptif
Requête	L’objet User Settable contient le compteur de requête. Les utilisateurs configurent les compteurs utilisateur dans l’objet de requête.

Ce tableau décrit les instances du compteur de requête .

Rechercher des instances de compteur	Descriptif
Compteur utilisateur 1	Défini à l’aide de sp_user_counter1.
Compteur utilisateur 2	Défini à l’aide de sp_user_counter2.
Compteur utilisateur 3	Défini à l’aide de sp_user_counter3.
...
Compteur d'utilisateur 10	Défini à l’aide de sp_user_counter10.

Pour utiliser les procédures stockées du compteur utilisateur, exécutez-les à partir de votre propre application avec un paramètre entier unique représentant la nouvelle valeur du compteur. Par exemple, pour définir le compteur utilisateur 1 sur la valeur 10, exécutez cette instruction Transact-SQL :

EXECUTE sp_user_counter1 10  

Les procédures stockées du compteur utilisateur peuvent être appelées à partir de n’importe où d’autres procédures stockées peuvent être appelées, telles que vos propres procédures stockées. Par exemple, vous pouvez créer la procédure stockée suivante pour compter le nombre de connexions et tentatives de connexions depuis le démarrage d’une instance de SQL Server :

DROP PROC My_Proc  
GO  
CREATE PROC My_Proc  
AS   
   EXECUTE sp_user_counter1 @@CONNECTIONS  
GO  

La fonction @@CONNECTIONS retourne le nombre de connexions ou de tentatives de connexions depuis le démarrage d’une instance de SQL Server. Cette valeur est transmise à la procédure stockée sp_user_counter1 en tant que paramètre.

Important

Définissez les requêtes dans les procédures stockées des compteurs utilisateur aussi simples que possible. Les requêtes nécessitant beaucoup de mémoire qui effectuent des opérations de tri ou de hachage substantielles ou des requêtes qui effectuent de grandes quantités d’E/S sont coûteuses à exécuter et peuvent avoir un impact sur les performances.

Autorisations

sp_user_counter est disponible pour tous les utilisateurs, mais peut être limité pour n’importe quel compteur de requête.

Voir aussi

Analyser l'utilisation des ressources (Moniteur système)