Notifications de requête - sys.dm_qn_subscriptions

S'applique à : SQL Server

Retourne des informations sur les abonnements aux notifications de requêtes actifs dans le serveur. Vous pouvez utiliser cette vue pour vérifier les abonnements actifs dans le serveur ou une base de données spécifiée, ou pour vérifier un principal de serveur.

Nom de la colonne	Type de données	Description
id	int	ID d'un abonnement.
database_id	int	ID de la base de données dans laquelle la requête de notification a été exécutée. Cette base de données stocke les informations relatives à cet abonnement.
sid	varbinary(85)	ID de sécurité du principal du serveur qui a créé cet abonnement et qui en est propriétaire.
object_id	int	ID de la table interne qui stocke les informations sur les paramètres de l'abonnement.
created	datetime	Date et heure de création de l’abonnement.
timeout	int	Délai d'expiration de l'abonnement, en secondes. La notification est marquée pour se déclencher après ce délai. Remarque : Le délai de déclenchement réel peut être supérieur au délai d’attente spécifié. Toutefois, si une modification qui invalide l’abonnement se produit après le délai d’expiration spécifié, mais avant le déclenchement de l’abonnement, SQL Server garantit que le déclenchement se produit au moment où la modification a été effectuée.
statut	int	Indique l'état de l'abonnement. Consultez le tableau sous la section Remarques pour obtenir la liste de codes.

Cardinalités de la relation

Du	À	Activé	Type
sys.dm_qn_subscriptions	sys.databases	database_id	Plusieurs-à-une
sys.dm_qn_subscriptions	sys.internal_tables	object_id	Plusieurs-à-une

Notes

Le code d'état 0 indique un état indéfini.

Les codes d'état suivants indiquent qu'un abonnement a été déclenché à cause d'une modification :

Code	État secondaire	Info
65798	L'abonnement a été déclenché parce que les données ont été modifiées	Abonnement déclenché par insertion
65799	L'abonnement a été déclenché parce que les données ont été modifiées	Supprimer
65800	L'abonnement a été déclenché parce que les données ont été modifiées	Update
65801	L'abonnement a été déclenché parce que les données ont été modifiées	Fusionner (Merge)
65802	L'abonnement a été déclenché parce que les données ont été modifiées	Troncation de la table
66048	L'abonnement a été déclenché parce que le délai d'attente a expiré	Mode d'information indéfini
66315	L'abonnement a été déclenché parce que l'objet a été modifié	L'objet ou l'utilisateur a été supprimé
66316	L'abonnement a été déclenché parce que l'objet a été modifié	L'objet a été modifié
66565	L'abonnement a été déclenché parce que la base de données a été détachée ou supprimée	Serveur ou db redémarré
66571	L'abonnement a été déclenché parce que la base de données a été détachée ou supprimée	L'objet ou l'utilisateur a été supprimé
66572	L'abonnement a été déclenché parce que la base de données a été détachée ou supprimée	L'objet a été modifié
67341	L'abonnement a été déclenché en raison d'un manque de ressources sur le serveur	L'abonnement a été déclenché en raison d'un manque de ressources sur le serveur

Les codes d'état suivants indiquent que la création d'un abonnement a échoué :

Code	État secondaire	Info
132609	La création d'un abonnement a échoué parce que l'instruction n'est pas prise en charge	La requête est trop complexe
132610	La création d'un abonnement a échoué parce que l'instruction n'est pas prise en charge	Instruction non valide pour l'abonnement
132611	La création d'un abonnement a échoué parce que l'instruction n'est pas prise en charge	Options définies non valides pour l'abonnement
132612	La création d'un abonnement a échoué parce que l'instruction n'est pas prise en charge	Niveau d'isolation non valide
132622	La création d'un abonnement a échoué parce que l'instruction n'est pas prise en charge	Utilisation en interne
132623	La création d'un abonnement a échoué parce que l'instruction n'est pas prise en charge	Au-delà de la limite de modèle par table

Les codes d'état suivants sont utilisés en interne et classés comme fin de contrôle et modes d'initialisation :

Code	État secondaire	Info
198656	Utilisation en interne : fin de contrôle et modes d'initialisation	Mode d'information indéfini
198928	L'abonnement a été détruit	L'abonnement a été déclenché parce que db a été attaché
198929	L'abonnement a été détruit	L'abonnement a été déclenché parce que l'utilisateur a été supprimé
198930	L'abonnement a été détruit	L'abonnement a été supprimé à cause d'un nouvel abonnement
198931	L'abonnement a été détruit	L'abonnement a été arrêté
199168	L'abonnement est actif	Mode d'information indéfini
199424	L'abonnement a été initialisé, mais n'est pas encore actif	Mode d'information indéfini

autorisations

Nécessite l'autorisation VIEW SERVER STATE sur le serveur.

Remarque

Si l'utilisateur n'a pas l'autorisation VIEW SERVER STATE, cette vue retourne des informations sur les abonnements qui appartiennent à l'utilisateur actuel.

Autorisations pour SQL Server 2022 (et versions plus récentes)

Nécessite l’autorisation VIEW SERVER PERFORMANCE STATE sur le serveur.

Exemples

R. Retour des abonnements aux notifications de requêtes actives pour l'utilisateur actif

L'exemple suivant retourne les abonnements aux notifications de requêtes actives de l'utilisateur actif. Si l'utilisateur possède les autorisations VIEW SERVER STATE, tous les abonnements actifs du serveur sont retournés.

SELECT id, database_id, sid, object_id, created, timeout, status  
FROM sys.dm_qn_subscriptions;  
GO  

B. Retour des abonnements aux notifications de requêtes actives pour un utilisateur spécifié

L'exemple suivant retourne les abonnements aux notifications de requêtes actives auxquelles souscrit la connexion Ruth0.

SELECT id, database_id, sid, object_id, created, timeout, status  
FROM sys.dm_qn_subscriptions  
WHERE sid = SUSER_SID('Ruth0');  
GO  

C. Retour des métadonnées des tables internes pour les abonnements aux notifications de requêtes

L'exemple suivant retourne les métadonnées des tables internes pour les abonnements aux notifications de requêtes.

SELECT qn.id AS query_subscription_id  
    ,it.name AS internal_table_name  
    ,it.object_id AS internal_table_id  
FROM sys.internal_tables AS it  
JOIN sys.dm_qn_subscriptions AS qn ON it.object_id = qn.object_id  
WHERE it.internal_type_desc = 'QUERY_NOTIFICATION';  
GO  

Voir aussi

Fonctions et vues de gestion dynamique (Transact-SQL)
Vues de gestion dynamique associées aux notifications de requête (Transact-SQL)
KILL QUERY NOTIFICATION SUBSCRIPTION (Transact-SQL)