クエリ通知 - sys.dm_qn_subscriptions

適用対象: SQL サーバー

サーバーのアクティブ クエリ通知サブスクリプションに関する情報を返します。 このビューは、サーバーまたは指定したデータベース内のアクティブなサブスクリプションを確認したり、指定したサーバー プリンシパルを確認する際に使用できます。

リレーションシップカーディナリティ

解説

状態コードが 0 の場合は、未定義の状態であることを示します。

次の状態コードは、変更が原因でサブスクリプションが発生したことを示しています。

次の状態コードは、サブスクリプションの作成に失敗したことを示しています。

次の状態コードは内部で使用され、check kill モードおよび init モードとして分類されます。

アクセス許可

サーバーに対する VIEW SERVER STATE 権限が必要です。

SQL Server 2022 以降でのアクセス許可

サーバーに対する VIEW SERVER PERFORMANCE STATE アクセス許可が必要です。

例

A. 現在のユーザーのアクティブなクエリ通知サブスクリプションを返す

次の例では、現在のユーザーのアクティブなクエリ通知サブスクリプションを返します。 ユーザーが VIEW SERVER STATE 権限を所有している場合は、サーバー内のアクティブなサブスクリプションがすべて返されます。

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

B. 指定したユーザーのアクティブなクエリ通知サブスクリプションを返す

次の例では、ログイン Ruth0 によってサブスクライブされたアクティブなクエリ通知サブスクリプションを返します。

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

C: クエリ通知サブスクリプションの内部テーブル メタデータを返す

次の例では、クエリ通知サブスクリプションに関する内部テーブルのメタデータを返します。

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  

参照

動的管理ビューと動的管理関数 (Transact-SQL)
クエリ通知関連の動的管理ビュー (Transact-SQL)
KILL QUERY NOTIFICATION SUBSCRIPTION (Transact-SQL)