sp_replqueuemonitor (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

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

引数

[ @publisher = ] 'publisher' パブリッシャーの名前を指定します。 publisher は sysname で、既定値は NULL です。 サーバーはパブリッシング用に構成されている必要があります。 NULL はすべてのパブリッシャーを表します。

[ @publisherdb = ] 'publisher_db' ] パブリケーション データベースの名前を指定します。 publisher_dbは sysname で、既定値は NULL です。 すべてのパブリケーション データベースの場合は NULL。

[ @publication = ] 'publication' ] パブリケーションの名前を指定します。 publicationは sysname で、既定値は NULL です。 NULL はすべてのパブリケーションを表します。

[ @tranid = ] 'tranid' ] トランザクション ID です。 tranidは sysname で、既定値は NULL です。 すべてのトランザクションに対して NULL。

[ @queuetype = ] 'queuetype' ] トランザクションを格納するキューの種類です。 queuetype は tinyint で、既定値は 0 で、次のいずれかの値を指定できます。

Value 内容
0 すべての種類のキュー
1 メッセージ キューイング (Message Queuing)
2 SQL Server キュー

リターン コードの値

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

解説

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

アクセス許可

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

参照

Updatable Subscriptions for Transactional Replication
システム ストアド プロシージャ (Transact-SQL)