次の方法で共有

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

  • [アーティクル]

レプリケーション モニターは、レプリケーション トポロジを監視するためのグラフィカル ツールです。 Transact-SQL レプリケーション ストアド プロシージャまたはレプリケーション管理オブジェクト (RMO) を使用すると、同じ監視データにプログラムからアクセスできます。 このオブジェクトにより、次のタスクをプログラムできます。

  • パブリッシャー、パブリケーション、およびサブスクリプションの状態を監視する。

  • 1 つ以上のサブスクライバーにおけるマージ エージェント セッションを監視する。

  • 1 つ以上のサブスクライバーで適用を待機しているトランザクション コマンドを監視する。

  • パブリケーションにユーザーの介入が必要となるしきい値の基準を定義する。

  • トレーサー トークンのステータスを監視する。

このトピックの内容

Transact-SQL

レプリケーション管理オブジェクト (RMO)

Transact-SQL

ディストリビューターからパブリッシャー、パブリケーション、サブスクリプションを監視するには

  1. ディストリビューターのディストリビューション データベースで、sp_replmonitorhelppublisher を実行します。 これにより、このディストリビューターを利用している全パブリッシャーの監視情報が返されます。 結果セットを 1 つのパブリッシャーに限定するには、@publisher を指定します。

  2. ディストリビューターのディストリビューション データベースで、sp_replmonitorhelppublication を実行します。 これにより、このディストリビューターを利用している全パブリケーションの監視情報が返されます。 結果セットを 1 つのパブリッシャー、パブリケーション、またはパブリッシュ済みデータベースに限定するには、それぞれ @publisher、@publication、または @publisher_db を指定します。

  3. ディストリビューターのディストリビューション データベースで、sp_replmonitorhelpsubscription を実行します。 これにより、このディストリビューターを利用しているすべてのサブスクリプションの監視情報が返されます。 結果セットを 1 つのパブリッシャー、パブリケーション、またはパブリッシュ済みデータベースに属するサブスクリプションに限定するには、それぞれ @publisher、@publication、または @publisher_db を指定します。

サブスクライバーで適用を待機しているトランザクション コマンドを監視するには

  • ディストリビューターのディストリビューション データベースで、sp_replmonitorsubscriptionpendingcmds を実行します。 これにより、このディストリビューターを利用しているすべてのサブスクリプションの、待機中の全コマンドに関する監視情報が返されます。 結果セットを 1 つのパブリッシャー、サブスクライバー、パブリケーション、またはパブリッシュ済みデータベースに属するサブスクリプションに適用される待機中コマンドに限定するには、それぞれ @publisher、@subscriber、@publication、または @publisher_db を指定します。

アップロードまたはダウンロードされるのを待機しているマージ変更を監視するには

  1. パブリッシャーのパブリケーション データベースで、sp_showpendingchanges を実行します。 返される結果セットには、サブスクライバーへのレプリケートを待機している変更に関する情報が示されます。 結果セットを 1 つのパブリケーションまたはアーティクルに属する変更に限定するには、それぞれ @publication または @article を指定します。

  2. サブスクライバーのサブスクリプション データベースで、sp_showpendingchanges を実行します。 返される結果セットには、パブリッシャーへのレプリケートを待機している変更に関する情報が示されます。 結果セットを 1 つのパブリケーションまたはアーティクルに属する変更に限定するには、それぞれ @publication または @article を指定します。

マージ エージェント セッションを監視するには

  1. ディストリビューターのディストリビューション データベースで、sp_replmonitorhelpmergesession を実行します。 これにより、このディストリビューターを利用する全サブスクリプションのすべてのマージ エージェント セッションに関する監視情報 (Session_id を含む) が返されます。 また、MSmerge_sessions システム テーブルにクエリを実行することでも、Session_id を取得できます。

  2. ディストリビューターのディストリビューション データベースで、sp_replmonitorhelpmergesessiondetail を実行します。 手順 1. で取得した Session_id の値を @session_id に指定します。 これにより、セッションに関する詳細な監視情報が表示されます。

  3. 目的の各セッションについて、手順 2. を実行します。

サブスクライバーからのプル サブスクリプションのマージ エージェント セッションを監視するには

  1. サブスクライバーのサブスクリプション データベースで、sp_replmonitorhelpmergesession を実行します。 サブスクリプションの @publisher と @publication を指定し、パブリケーション データベースの名前を @publisher_db に指定します。 これにより、このサブスクリプションの過去 5 回のマージ エージェント セッションに関する監視情報が返されます。 結果セットで、目的のセッションの Session_id の値を確認します。

  2. サブスクライバーのサブスクリプション データベースで、sp_replmonitorhelpmergesessiondetail を実行します。 手順 1. で取得した Session_id の値を @session_id に指定します。 これにより、セッションに関する詳細な監視情報が表示されます。

  3. 目的の各セッションについて、手順 2. を実行します。

パブリケーションのしきい値を表示して変更するには

  1. ディストリビューターのディストリビューション データベースで、sp_replmonitorhelppublicationthresholds を実行します。 これにより、このディストリビューターを利用している全パブリケーションの監視しきい値が返されます。 結果セットを 1 つのパブリッシャー、パブリッシュ済みデータベース、またはパブリケーションに属するパブリケーションに対する監視しきい値に限定するには、それぞれ @publisher、@publisher_db、または @publication を指定します。 変更する必要があるしきい値に対応する Metric_id の値を確認します。 詳細については、「レプリケーション モニターのしきい値と警告の設定」を参照してください。

  2. ディストリビューターのディストリビューション データベースで、sp_replmonitorchangepublicationthreshold を実行します。 必要に応じて、次の値を指定します。

    • 手順 1. で得た Metric_id の値を @metric_id に指定します。

    • 監視しきい値の新しい値を @value に指定します。

    • このしきい値に到達したときに警告をログに記録するには、@shouldalert に 1 を指定します。警告が不要な場合には、0 を指定します。

    • 監視しきい値を有効にするには @mode に 1 を指定し、無効にするには 2 を指定します。

[トップに戻る] リンクで使用される矢印アイコン[Top]

レプリケーション管理オブジェクト (RMO)

サブスクライバーでマージ パブリケーションのサブスクリプションを監視するには

  1. ServerConnection クラスを使用して、サブスクライバーへの接続を作成します。

  2. MergeSubscriberMonitor クラスのインスタンスを作成し、サブスクリプションの Publisher、Publication、PublisherDB、SubscriberDB の各プロパティを設定します。次に、ConnectionContext プロパティに対し、手順 1. で作成した ServerConnection を設定します。

  3. 次のいずれかのメソッドを呼び出して、このサブスクリプションのマージ エージェント セッションの情報を取得します。

    • GetSessionsSummary() - 過去に発生したマージ エージェント セッションの情報を保持する MergeSessionSummary オブジェクトの配列を返します (最大 5 セッション)。 監視対象のすべてのセッションについて、SessionID 値を確認してください。

    • GetSessionsSummary(Int32) - hours パラメーターに指定された期間内に発生したマージ エージェント セッションの情報を保持する MergeSessionSummary オブジェクトの配列を返します (最大 5 セッション)。 監視対象のすべてのセッションについて、SessionID 値を確認してください。

    • GetLastSessionSummary - 前回のマージ エージェント セッションの情報を保持する MergeSessionSummary オブジェクトを返します。 このセッションの SessionID 値を確認してください。

    • GetSessionsSummaryDataSet - 過去のマージ エージェント セッション (最大 5 セッション) の情報を、1 行あたり 1 セッションの形式で保持する DataSet オブジェクトを返します。 監視対象のすべてのセッションについて、Session_id 列の値を確認してください。

    • GetLastSessionSummaryDataRow - 前回のマージ エージェント セッションの情報を保持する DataRow オブジェクトを返します。 このセッションの Session_id 列の値を確認してください。

  4. (省略可) RefreshSessionSummary(MergeSessionSummary%) を呼び出して、mss, として渡された MergeSessionSummary オブジェクトのデータを更新します。または、RefreshSessionSummary(DataRow%) を呼び出して、drRefresh として渡された DataRow オブジェクトのデータを更新します。

  5. 手順 3. で取得したセッション ID を使用して次のいずれかのメソッドを呼び出し、特定のセッションの詳細情報を取得します。

ディストリビューターですべてのパブリケーションについてレプリケーション プロパティを監視するには

  1. ServerConnection クラスを使用して、ディストリビューターへの接続を作成します。

  2. ReplicationMonitor クラスのインスタンスを作成します。

  3. ConnectionContext プロパティに、手順 1. で作成した ServerConnection を設定します。

  4. LoadProperties メソッドを呼び出して、オブジェクトのプロパティを取得します。

  5. 次の 1 つまたは複数のメソッドを実行して、このディストリビューターを使用している、すべてのパブリッシャーのレプリケーション情報を取得します。

    • EnumDistributionAgents - このディストリビューターのすべてのディストリビューション エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumErrorRecords - ディストリビューターに保存されているエラー情報を保持する DataSet オブジェクトを返します。

    • EnumLogReaderAgents - ディストリビューターのすべてのログ リーダー エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumMergeAgents - ディストリビューターのすべてのマージ エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumMiscellaneousAgents - ディストリビューターのその他すべてのレプリケーション エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumPublishers - このディストリビューターのすべてのパブリッシャーに関する情報を保持する DataSet オブジェクトを返します。

    • EnumPublishers2 - このディストリビューターを使用しているパブリッシャーを返す DataSet オブジェクトを返します。

    • EnumQueueReaderAgents - ディストリビューターのすべてのキュー リーダー エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumQueueReaderAgentSessionDetails - 指定されたキュー リーダー エージェントおよびセッションの情報を保持する DataSet オブジェクトを返します。

    • EnumQueueReaderAgentSessions - 指定されたキュー リーダー エージェントのセッション情報を保持する DataSet オブジェクトを返します。

    • EnumSnapshotAgents - ディストリビューターのすべてのスナップショット エージェントに関する情報を保持する DataSet オブジェクトを返します。

ディストリビューターで特定のパブリッシャーのパブリケーション プロパティを監視するには

  1. ServerConnection クラスを使用して、ディストリビューターへの接続を作成します。

  2. 次のいずれかの方法で PublisherMonitor オブジェクトを取得します。

    • PublisherMonitor クラスのインスタンスを作成します。 パブリッシャーの Name プロパティを設定し、ConnectionContext プロパティに手順 1. で作成した ServerConnection を設定します。 LoadProperties メソッドを呼び出して、オブジェクトのプロパティを取得します。 このメソッドから false が返された場合、パブリッシャー名が正しく定義されていないか、パブリケーションが存在していません。

    • PublisherMonitorCollection から取得します。このコレクションには、既存の ReplicationMonitor オブジェクトの PublisherMonitors プロパティを使用してアクセスできます。

  3. 次の 1 つまたは複数のメソッドを実行して、このパブリッシャーに属している、すべてのパブリケーションのレプリケーション情報を取得します。

    • EnumDistributionAgentSessionDetails - 指定されたディストリビューション エージェントおよびセッションの情報を保持する DataSet オブジェクトを返します。

    • EnumDistributionAgentSessions - 指定されたディストリビューション エージェントのセッション情報を保持する DataSet オブジェクトを返します。

    • EnumErrorRecords - 指定されたエラーのエラー レコード情報を保持する DataSet オブジェクトを返します。

    • EnumLogReaderAgentSessionDetails - 指定されたログ リーダー エージェントおよびセッションの情報を保持する DataSet オブジェクトを返します。

    • EnumLogReaderAgentSessions - 指定されたログ リーダー エージェントのセッション情報を保持する DataSet オブジェクトを返します。

    • EnumMergeAgentSessionDetails - 指定されたマージ エージェントおよびセッションの情報を保持する DataSet オブジェクトを返します。

    • EnumMergeAgentSessionDetails2 - 指定されたマージ エージェントおよびセッションの追加情報を保持する DataSet オブジェクトを返します。

    • EnumMergeAgentSessions - 指定されたマージ エージェントのセッション情報を保持する DataSet オブジェクトを返します。

    • EnumMergeAgentSessions2 - 指定されたマージ エージェントの追加のセッション情報を保持する DataSet オブジェクトを返します。

    • EnumPublications - このディストリビューターのすべてのパブリケーションに関する情報を保持する DataSet オブジェクトを返します。

    • EnumPublications2 - このディストリビューターのすべてのパブリケーションに関する追加情報を保持する DataSet オブジェクトを返します。

    • EnumSnapshotAgentSessionDetails - 指定されたスナップショット エージェントおよびセッションの情報を保持する DataSet オブジェクトを返します。

    • EnumSnapshotAgentSessions - 指定されたスナップショット エージェントのセッション情報を保持する DataSet オブジェクトを返します。

    • EnumSubscriptions - このディストリビューターのパブリケーションに対するすべてのサブスクリプションに関する情報を保持する DataSet オブジェクトを返します。

ディストリビューターで特定のパブリッシャーのプロパティを監視するには

  1. ServerConnection クラスを使用して、ディストリビューターへの接続を作成します。

  2. 次のいずれかの方法で PublicationMonitor オブジェクトを取得します。

  3. 次の 1 つまたは複数のメソッドを実行して、このパブリケーションに関する情報を取得します。

    • EnumErrorRecords - 指定されたエラーのエラー レコードを保持する DataSet オブジェクトを返します。

    • EnumLogReaderAgent - このパブリケーションのログ リーダー エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumMonitorThresholds - このパブリケーションに設定されている監視警告のしきい値情報を保持する DataSet オブジェクトを返します。

    • EnumQueueReaderAgent - このパブリケーションで使用されるキュー リーダー エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumSnapshotAgent - このパブリケーションのスナップショット エージェントに関する情報を保持する DataSet オブジェクトを返します。

    • EnumSubscriptions - このパブリケーションのサブスクリプションに関する情報を保持する DataSet オブジェクトを返します。

    • EnumSubscriptions2 - このパブリケーションのサブスクリプションに関する追加情報を保持する DataSet オブジェクトを、指定された SubscriptionResultOption に基づいて返します。

    • EnumTracerTokenHistory - 指定されたトレーサー トークンの待機時間情報を保持する DataSet オブジェクトを返します。

    • EnumTracerTokens - このパブリケーションに挿入されたすべてのトレーサー トークンに関する情報を保持する DataSet オブジェクトを返します。

サブスクライバーで適用待ち状態になっているトランザクション コマンドを監視するには

  1. ServerConnection クラスを使用して、ディストリビューターへの接続を作成します。

  2. 次のいずれかの方法で PublicationMonitor オブジェクトを取得します。

  3. TransPendingCommandInfo メソッドを実行して PendingCommandInfo オブジェクトを取得します。

  4. この PendingCommandInfo オブジェクトのプロパティを使用して、保留状態の推定コマンド数と、コマンドを配信を完了するまでの時間を調べます。

パブリケーションに対して監視警告のしきい値を設定するには

  1. ServerConnection クラスを使用して、ディストリビューターへの接続を作成します。

  2. 次のいずれかの方法で PublicationMonitor オブジェクトを取得します。

  3. EnumMonitorThresholds メソッドを実行します。 返された MonitorThreshold オブジェクトの ArrayList で、現在のしきい値設定を確認します。

  4. ChangeMonitorThreshold メソッドを実行します。 次のパラメーターを指定します。

    • metricID - 監視しきい値の基準を表す Int32 値です。次の表に示す値を使用します。

      値

      説明

      1

      expiration - トランザクション パブリケーションのサブスクリプションについて有効期限切れを監視します。

      2

      latency - トランザクション パブリケーションへのサブスクリプションのパフォーマンスを監視します。

      4

      mergeexpiration - マージ パブリケーションへのサブスクリプションに期限が迫っていないかを監視します。

      5

      mergeslowrunduration - 低速回線 (ダイヤルアップ) 接続でのマージの同期時間を監視します。

      6

      mergefastrunduration - 高速回線 (LAN) 接続にでのマージの同期時間を監視します。

      7

      mergefastrunspeed - 高帯域 (LAN) 接続でのマージ同期の同期率を監視します。

      8

      mergeslowrunspeed - 低速回線 (ダイヤルアップ) 接続でのマージの同期速度を監視します。

    • enable -パブリケーションで基準が有効かどうかを示す Boolean 値です。

    • thresholdValue - しきい値を設定する整数値です。

    • shouldAlert - このしきい値に対して警告を生成するかどうかを示す整数です。

[トップに戻る] リンクで使用される矢印アイコン[Top]