クエリ通知 - sys.dm_qn_subscriptions

適用対象:SQL Server

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

列名	データ型	説明
id	int	サブスクリプションの ID。
database_id	int	通知クエリが実行されたデータベースの ID。 このデータベースには、このサブスクリプションに関連する情報が格納されます。
Sid	varbinary(85)	このサブスクリプションを作成して所有しているサーバー プリンシパルのセキュリティ ID。
object_id	int	サブスクリプション パラメーターに関する情報を格納する内部テーブルの ID。
created	datetime	サブスクリプションが作成された日時。
timeout	int	サブスクリプションのタイムアウト (秒単位)。 この時間が経過すると、通知に起動のフラグが設定されます。 注: 実際の起動時間は、指定されたタイムアウトを超える可能性があります。ただし、サブスクリプションを無効にする変更が、指定されたタイムアウト後にサブスクリプションが発生する前に発生した場合は、SQL Server変更が行われた時点で発生することが保証されます。
status	int	サブスクリプションの状態を示します。 コードの一覧については、「解説」の表を参照してください。

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

ソース	終了	オン	Type
sys.dm_qn_subscriptions	sys.databases	database_id	多対一
sys.dm_qn_subscriptions	sys.internal_tables	object_id	多対一

注釈

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

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

コード	マイナー状態	Info
65798	データが変更されたために発生したサブスクリプション	挿入によってトリガーされるサブスクリプション
65799	データが変更されたために発生したサブスクリプション	削除
65800	データが変更されたために発生したサブスクリプション	更新
65801	データが変更されたために発生したサブスクリプション	Merge
65802	データが変更されたために発生したサブスクリプション	テーブルを切り捨てる
66048	タイムアウトが発生したため、サブスクリプションが起動しました	未定義の情報モード
66315	オブジェクトが変更されたために発生したサブスクリプション	オブジェクトまたはユーザーが削除されました
66316	オブジェクトが変更されたために発生したサブスクリプション	オブジェクトが変更されました
66565	データベースがデタッチまたは削除されたため、サブスクリプションが起動しました	サーバーまたはデータベースが再起動されました
66571	データベースがデタッチまたは削除されたため、サブスクリプションが起動しました	オブジェクトまたはユーザーが削除されました
66572	データベースがデタッチまたは削除されたため、サブスクリプションが起動しました	オブジェクトが変更されました
67341	サーバーのリソースが不足しているため、サブスクリプションがトリガーされました	サーバーのリソースが不足しているため、サブスクリプションがトリガーされました

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

コード	マイナー状態	Info
132609	ステートメントがサポートされていないため、サブスクリプションを作成できませんでした	クエリが複雑すぎる
132610	ステートメントがサポートされていないため、サブスクリプションを作成できませんでした	サブスクリプションのステートメントが無効です
132611	ステートメントがサポートされていないため、サブスクリプションを作成できませんでした	サブスクリプションの設定オプションが無効です
132612	ステートメントがサポートされていないため、サブスクリプションを作成できませんでした	無効な分離レベル
132622	ステートメントがサポートされていないため、サブスクリプションを作成できませんでした	内部的に使用される
132623	ステートメントがサポートされていないため、サブスクリプションを作成できませんでした	テーブルあたりのテンプレート制限を超える

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

コード	マイナー ステータス	Info
198656	内部使用: check kill モードおよび init モード	未定義の情報モード
198928	サブスクリプションが破棄されました	db がアタッチされたために発生したサブスクリプション
198929	サブスクリプションが破棄されました	ユーザーが削除されたため、サブスクリプションが起動しました
198930	サブスクリプションが破棄されました	サブスクリプションが再サブスクリプションのために削除されました
198931	サブスクリプションが破棄されました	サブスクリプションが強制終了されました
199168	サブスクリプションがアクティブです	未定義の情報モード
199424	サブスクリプションが初期化されていますが、まだアクティブではありません	未定義の情報モード

アクセス許可

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

注意

ユーザーに 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)