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 を実行してパブリケーションで保留になっているコマンドを返すには、ディストリビューション データベースを使用するパブリケーションのパブリケーション アクセス リストのメンバであることが必要です。

関連項目

タスク

レプリケーションをプログラムから監視する方法 (レプリケーション Transact-SQL プログラミング)