Objet SQL Server User Settable

L'objet User Settable de Microsoft SQL Server vous permet de créer des instances de compteurs personnalisées. La création de vos propres instances de compteurs est utile pour surveiller les aspects du serveur qui ne le sont pas par les compteurs existants, comme les composants propres à votre base de données SQL Server (par exemple, la détermination du nombre de commandes clients enregistrées ou l'inventaire des produits).

L'objet User Settable contient 10 instances du compteur de requêtes : du compteur utilisateur 1 au compteur utilisateur 10. Ces compteurs correspondent aux procédures stockées SQL Server sp_user_counter1 à sp_user_counter10. Comme ces procédures stockées sont exécutées par les applications de l'utilisateur, les valeurs définies par les procédures stockées sont affichées dans le Moniteur système. Un compteur peut surveiller toute valeur entière (par exemple une procédure stockée qui compte combien de fois un produit en particulier a été commandé en un jour).

Remarque :

Les procédures stockées des compteurs utilisateur ne sont pas automatiquement interrogées par le Moniteur système. Pour que les valeurs d'un compteur soient mises à jour, les procédures doivent être explicitement exécutées par une application de l'utilisateur. Utilisez un déclencheur pour mettre automatiquement à jour 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. Dès que le déclencheur est activé à la suite de l'exécution d'une opération INSERT ou DELETE sur la table, le compteur du Moniteur système est automatiquement mis à jour.

Le tableau suivant décrit l'objet SQL Server User Settable.

Compteurs SQL Server User Settable	Description
Requête	L'objet User Settable contient le compteur de requêtes. Les utilisateurs configurent les compteurs utilisateur dans l'objet de requête.

Le tableau suivant décrit les instances du compteur de requêtes.

Instances du compteur de requêtes	Description
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 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 seul paramètre entier qui représente la nouvelle valeur prise par le compteur. Par exemple, pour faire passer le compteur utilisateur 1 à 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 tout endroit où les autres procédures stockées peuvent être appelées, par exemple 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 de tentatives de connexions qui ont eu lieu depuis qu'une instance de SQL Server a été lancée :

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

La fonction @@CONNECTIONS renvoie le nombre de connexions ou de tentatives de connexion depuis qu'une instance de SQL Server a été lancée. Cette valeur est transférée comme paramètre à la procédure stockée sp_user_counter1.

Important :
Les requêtes définies dans les procédures stockées du compteur utilisateur doivent être aussi simples que possible. Les requêtes sollicitant beaucoup de mémoire, comme les requêtes de tri ou de hachage, ou celles qui impliquent des volumes importants d'E/S sont d'une exécution coûteuse en ressources et peuvent affecter les performances.

Autorisations

sp_user_counter est disponible pour tous les utilisateurs, mais son utilisation peut être limitée pour chacun des compteurs de requête.

Voir aussi

Autres ressources

Surveillance de l'utilisation des ressources (Moniteur système)

Aide et Informations

Assistance sur SQL Server 2005