sp_replqueuemonitor (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

指定されたパブリケーションに対するキュー更新サブスクリプションの SQL Server キューまたは Microsoft メッセージ キューからのキュー メッセージを一覧表示します。 SQL Server キューが使用されている場合、このストアド プロシージャはサブスクリプション データベースのサブスクライバーで実行されます。 メッセージ キューイングを使用している場合、このストアド プロシージャはディストリビューター側のディストリビューション データベース上で実行されます。

Transact-SQL 構文表記規則

構文

sp_replqueuemonitor
    [ [ @publisher = ] N'publisher' ]
    [ , [ @publisherdb = ] N'publisherdb' ]
    [ , [ @publication = ] N'publication' ]
    [ , [ @tranid = ] N'tranid' ]
    [ , [ @queuetype = ] queuetype ]
[ ; ]

引数

[ @publisher = ] N'publisher'

パブリッシャーの名前。 @publishersysname で、既定値は NULL です。 サーバーはパブリッシング用に構成されている必要があります。 NULL は、すべてのパブリッシャーを取得するために使用されます。

[ @publisherdb = ] N'publisherdb'

パブリケーション データベースの名前。 @publisherdbsysname で、既定値は NULL です。 NULL は、すべてのパブリケーション データベースを取得するために使用されます。

[ @publication = ] N'publication'

出版物の名前。 @publicationsysname で、既定値は NULL です。 NULL は、すべてのパブリケーションを取得するために使用されます。

[ @tranid = ] N'tranid'

トランザクション ID。 @tranidsysname で、既定値は NULL です。 NULL は、すべてのトランザクションを取得するために使用されます。

[ @queuetype = ] queuetype

トランザクションを格納するキューの種類。 @queuetypetinyint であり、これらの値のいずれかを指定できます。

Value 説明
0 (既定値) すべての種類のキュー
1 メッセージ キューイング (Message Queuing)
2 SQL Server キュー

リターン コードの値

0 (成功) または 1 (失敗)。

解説

sp_replqueuemonitor は、キュー更新サブスクリプションを使用するスナップショット レプリケーションまたはトランザクション レプリケーションで使用されます。 SQL コマンドが含まれていないキュー メッセージ、またはスパン SQL コマンドの一部であるキュー メッセージは表示されません。

アクセス許可

sysadmin固定サーバー ロールまたは固定データベース ロールdb_ownerのメンバーのみがsp_replqueuemonitorを実行できます。