sp_replmonitorsubscriptionpendingcmds (Transact-SQL)

トランザクション パブリケーションへのサブスクリプションで保留になっているコマンド数に関する情報と、コマンドの処理に要する予想時間の概算を返します。 このストアド プロシージャは、返されたサブスクリプションごとに 1 行のデータを返します。 このストアド プロシージャはレプリケーションの監視に使用し、ディストリビューター側でディストリビューション データベースについて実行されます。

Transact-SQL 構文表記規則

構文

sp_replmonitorsubscriptionpendingcmds [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication' 
        , [ @subscriber = ] 'subscriber' 
        , [ @subscriber_db = ] 'subscriber_db' 
        , [ @subscription_type = ] subscription_type

引数

• [ @publisher = ] 'publisher'
  パブリッシャーの名前を指定します。 publisher のデータ型は sysname で、既定値はありません。

• [ @publisher_db = ] 'publisher_db'
  パブリッシャー データベースの名前を指定します。 publisher_db のデータ型は sysname で、既定値はありません。

• [ @publication = ] 'publication'
  パブリケーションの名前です。 publication のデータ型は sysname で、既定値はありません。

• [ @subscriber = ] 'subscriber'
  サブスクライバーの名前を指定します。 subscriber のデータ型は sysname で、既定値はありません。

• [ @subscriber_db = ] 'subscriber_db'
  サブスクリプション データベースの名前です。 subscriber_db のデータ型は sysname で、既定値はありません。

• [ @subscription_type = ] subscription_type
  サブスクリプションの種類を指定します。 publication_type のデータ型は int で、既定値はありません。次のいずれかの値を指定します。

  値	説明
  0	プッシュ サブスクリプション
  1	プル サブスクリプション

結果セット

列名	データ型	説明
pendingcmdcount	int	サブスクリプションで保留中のコマンドの数。
estimatedprocesstime	int	保留中のコマンドをサブスクライバーに配信するのに必要な予想時間 (秒単位)。

戻り値

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

説明

sp_replmonitorsubscriptionpendingcmds は、トランザクション レプリケーションで使用します。

権限

sp_replmonitorsubscriptionpendingcmds を実行できるのは、ディストリビューターの sysadmin 固定サーバー ロールのメンバー、またはディストリビューション データベースの db_owner 固定データベース ロールのメンバーだけです。 sp_replmonitorsubscriptionpendingcmds を実行してパブリケーションで保留になっているコマンドを返すには、ディストリビューション データベースを使用するパブリケーションのパブリケーション アクセス リストのメンバーであることが必要です。

関連項目

概念

プログラムによるレプリケーションの監視