sp_refresh_log_shipping_monitor (Transact-SQL)

リモートの監視テーブルを、指定したログ配布エージェントの特定のプライマリまたはセカンダリ サーバーにある最新の情報に更新します。このプロシージャはプライマリまたはセカンダリ サーバーで呼び出されます。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_refresh_log_shipping_monitor
[ @agent_id = ] 'agent_id',
[ @agent_type = ] 'agent_type'
[ @database = ] 'database'
[ @mode ] n

引数

  • [ @agent_id = ] 'agent_id'
    バックアップ用のプライマリ ID、またはコピーや復元用のセカンダリ ID を指定します。agent_id のデータ型は uniqueidentifier で、NULL 値は許可されません。

  • [ @agent_type = ] 'agent_type'
    ログ配布ジョブの種類を指定します。

    0 = バックアップ。

    1 = コピー。

    2 = 復元。

    agent_type のデータ型は tinyint で、NULL 値は許可されません。

  • [ @database = ] 'database'
    バックアップや復元エージェントのログ記録で使用されるプライマリまたはセカンダリ データベースを指定します。

  • [ @mode ] n
    監視データを更新するか削除するかを指定します。m のデータ型は tinyint で、次の値を指定できます。

    1 = 更新 (既定値)。

    2 = 削除。

戻り値

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

結果セット

なし

説明

sp_refresh_log_shipping_monitor では、log_shipping_monitor_primarylog_shipping_monitor_secondarylog_shipping_monitor_history_detaillog_shipping_monitor_error_detail テーブルに、まだ転送されていないセッション情報が反映されます。これにより、しばらくの間監視サーバーを同期していなかった場合に、監視サーバーとプライマリまたはセカンダリ サーバーを同期できます。また、必要に応じて監視サーバーにある監視情報をクリーンアップできます。

sp_refresh_log_shipping_monitor は、プライマリまたはセカンダリ サーバーの master データベースから実行する必要があります。

権限

このプロシージャを実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。