パイプラインの管理

OCI GoldenGateパイプラインの操作に不可欠なパイプライン管理タスクを確認します。

パイプライン詳細の表示

パイプライン・ページからパイプラインを選択して、その詳細を表示します。パイプライン詳細ページでは、パイプラインのステータスを表示できます。次のいずれかになります。
  • 作成
  • アクティブ(停止)
  • 有効(実行中)
  • 更新
  • 注意が必要
  • 失敗
パイプラインを編集したり、「アクション」メニューを使用して、次のような他のアクションを実行することもできます。 他のタブに切り替えて、他の関連するパイプライン情報を表示します。

パイプライン情報

パイプライン情報ページには、OCID、リソースが存在するコンパートメント、作成日および最終更新日など、このリソースに関する一般情報が表示されます。

マッピング・ルール

ソース表およびスキーマのデフォルトの1対1マッピングをターゲットに変更するマッピング・ルールの追加、削除またはプレビュー

初期化

パイプライン・ステップの現在のステータスを表示する初期化ステップの表示。任意のステップを選択して、その詳細を表示できます。

実行時

実行時のステータスおよび待機時間を表示します。

モニタリング

パイプライン・メトリックの表示、クリティカル・イベント・ログの有効化または無効化、および通知の作成と表示を行います。

作業要求

パイプライン作業リクエストのステータスを表示します。作業リクエストを作成するパイプライン操作には、次のものがあります。

  • 作成
  • 始点
  • 停止
  • 更新
  • 削除
  • 移動
  • 診断の収集

タグ

タグは、テナンシ内のリソースを見つけるのに役立ちます。パイプラインのタグの追加や表示は、「パイプライン」ページと「パイプラインの詳細」ページから行うことができます。「タグの管理」を参照してください。

パイプラインの編集

パイプラインを編集するには、パイプラインの詳細ページで「編集」をクリックします。編集パネルでは、次の項目を編集できます。

  • 名前
  • 説明
  • プロセス・オプション:

    ノート:

    変更を有効にするには、パイプラインを再起動する必要があります。
    • 進行中のレプリケーションの前に既存のデータをコピー: データの初期ロードを実行するには、このオプションを選択します。既存の表について、次の操作を選択できます。
      • 切捨て: 既存の行を削除した後、ソースから行をロードします。
      • 置換: 既存の表を削除した後、ソースから表を作成およびロードします。
      • 追加: 既存の行を変更せずに残し、ソースから行をロードします。
      • スキップ: 表はそのままにして、次のオブジェクトに移動します。
    • スキーマ変更(DDL)の置換: 選択すると、プロセスでエラーが発生したときに既存のスキーマに対して実行するアクションを選択します。
      • 終了: トランザクションをロールバックして処理を停止します。
      • 破棄: 破棄ファイルにエラーを記録して処理を継続します。
      • 無視: エラーを無視して処理を継続します。
    • DMLエラー時のアクション: プロセスでDMLエラーが発生したときに既存のデータに対して実行するアクションを選択します。
      • 終了
      • 破棄
      • 無視
    • 失敗後に再起動: このオプションは、なんらかの理由でプロセスが停止した場合に自動再起動を有効にする場合に選択します。
    • デフォルト・マッピングを使用してパイプラインを開始: デフォルトの1:1マッピング・ルールを使用して、作成直後にパイプラインを開始します。選択しない場合、作成後にルール・マッピングを構成し、パイプラインを手動で開始できます。

パイプラインの開始

パイプラインを開始するには、その詳細ページの非アクティブ・パイプラインの「アクション」メニューから「開始」を選択します。「パイプラインの開始」ダイアログで「起動」をクリックして、このアクションを確認します。パイプラインは、取得および適用プロセスを開始する前に、作成時に選択したプロセス・オプション(またはパイプラインを編集した場合は更新時)に基づいて初期化ステップを実行します。

パイプラインの停止

パイプラインを停止するには、詳細ページのアクティブ・パイプラインの「アクション」メニューから「停止」を選択します。「パイプラインの停止」ダイアログで「停止」をクリックして、このアクションを確認します。パイプラインが停止して非アクティブ状態になったら、「開始」をクリックしてパイプラインを再起動できます。

ノート:

パイプラインを停止しても、デプロイメントはバックグラウンドで実行されるため、使用されているリソースに対して請求されます。繰返しコストを回避するには、パイプラインを削除する必要があります。

診断の収集

診断を収集して、OCI GoldenGateパイプラインに関する情報を分析または共有します。診断ファイルには、取得および適用プロセスの破棄されたレコード(ある場合)が含まれます。

パイプラインに関する診断を収集するには:
  1. パイプラインの詳細ページで、「アクション」メニューから「診断の収集」を選択します。
  2. 「診断の収集」パネルで、診断ファイルを保存するコンパートメントおよびバケットを選択します。
  3. 診断ファイルの名前接頭辞を入力します。
  4. 「診断の収集」をクリックします。
収集プロセスが完了したら、パイプラインの詳細ページから診断ファイルをダウンロードできます。

パイプライン・メトリックの監視

パイプラインの詳細ページで、「モニタリング」を選択して、CPU使用率、OCPU消費、メモリー使用率、全体的なパイプライン・ヘルスなどのパイプライン・メトリックを表示します。使用可能なメトリックの詳細は、次を参照してください。

マッピング・ルールの管理

マッピング・ルールをプレビュー、追加または削除するには:
  1. 「パイプライン情報」ページで、「マッピング・ルール」を選択します。
  2. 「マッピング・ルール」リストでは、現在のマッピング・ルールを確認または編集し、次の操作を実行できます。
    • プレビュー: マッピング・ルールがレプリケーションに含まれるスキーマおよび表にどのように影響するかを確認します。
    • 追加: 含める、または除外する表およびスキーマを識別します。オブジェクト名の任意の部分のかわりに、完全修飾オブジェクト名またはワイルドカードを使用できます。詳細は、「データベース・オブジェクト名でのワイルドカードの使用」を参照してください。
    • 削除: マッピング・ルールを削除します。

初期化ステップの表示

GoldenGateプロセスをよく理解している場合、パイプラインはデータ・レプリケーション・プロセスの抽象化です。パイプラインを起動すると、初期化ステップが直線的に実行され、必要なすべてのリソースが作成され、作成時に収集された情報に基づいてデータ・レプリケーション用のデータベースが準備されます。初期化ステップは次のとおりです。

  • ソースおよびターゲット・データベースのチェック
  • 抽出のためのデータベース・オブジェクトの準備
  • ハートビート表の作成
  • Extract(Capture)の作成および実行
  • ターゲット・スキーマおよび表が存在することを確認します。
  • チェックポイント表の作成
  • Replicatの作成および実行(適用)

各初期化ステップの「アクション」メニューから「詳細の表示」を選択して、各ステップに対応するステータスおよびシステム・メッセージを確認できます。

実行時

パイプラインがアクティブで実行中の場合、パイプライン詳細ページの「ランタイム」セクションに取得および適用プロセスのステータスおよびレイテンシを表示できます。この情報を使用して、これらのプロセスの状態を監視し、必要に応じてアクションを実行できます。

通知の設定

パイプライン・イベントを通知するように通知を設定できます。

パイプライン・イベント通知を設定するには:
  1. パイプラインの詳細ページで、「モニタリング」を選択します。
  2. 「モニタリング」ページで、「通知」までスクロール・ダウンし、「通知の作成」をクリックします。
  3. 通知の作成ページでは、次の項目を選択できます。
    • クイックスタート。その後、事前構成された通知設定のテンプレートから選択します。
    • 「拡張イベント通知」を選択し、様々なイベント条件のアクションをトリガーするイベント・ルールを選択します。
    • 拡張アラーム通知。次に、アラームを起動するルールを追跡およびトリガーするメトリックを選択します。
  4. 「トピックとサブスクリプション」の場合:
    1. 新しいトピックを作成するか、既存のトピックを選択します。
    2. メッセージを受信するサブスクリプションを確認します。
  5. (オプション)拡張アラーム通知の場合は、「拡張オプション」を展開し、アラーム本文(メッセージ本文)および通知のメッセージ形式を構成します。
  6. 「送信」をクリックします。

パイプライン・ログの管理

OCI GoldenGateパイプラインのクリティカル・イベント・ログを有効または無効にします。

クリティカル・イベント・ログを有効にするには:
  1. パイプラインの詳細ページで、「モニタリング」を選択します。
  2. 「モニタリング」ページで、「ログ」まで下にスクロールします。
  3. 「クリティカル・イベントのアクション」メニューで、「ログの有効化」を選択します。
  4. 「ログの有効化」パネルで、次のフィールドに入力し、「ログの有効化」をクリックします:
    1. 「ログ名」に、ログの名前を入力します。
    2. 「コンパートメント」ドロップダウンから、ログを作成するコンパートメントを選択します。
    3. ログ・グループを選択するか、「新規グループの作成」をクリックします。
    4. ログ保持時間を選択します。

パイプラインの移動

パイプラインは、あるコンパートメントから別のコンパートメントに移動できます。

パイプラインを移動するには:
  1. 「パイプライン」ページで、移動するパイプラインを選択します。
  2. パイプラインの詳細ページの「アクション」メニューから、「リソースの移動」をクリックします。
  3. 「別のコンパートメントへのリソースの移動」ダイアログで、パイプラインの移動先となるコンパートメントを選択します。
  4. 「リソースの移動」をクリックします

パイプラインのタグを管理

パイプラインのタグは、「パイプライン」ページおよびパイプラインの詳細ページから追加および表示できます。

「パイプライン」ページで、パイプラインの「アクション」メニューから、「タグの追加」または「タグの表示」を選択します。

パイプライン詳細ページでは、「アクション」メニューから「タグ」を選択するか、「タグ」タブを選択してタグを表示および管理できます。

タグ付けについてさらに学習します。

パイプラインの削除

パイプラインを削除する前に、パイプラインが停止し、非アクティブ状態であることを確認します。

パイプラインを削除するには:
  1. 「パイプライン」ページで、削除するパイプラインを選択します。
  2. パイプラインの詳細ページの「アクション」メニューから、「削除」を選択します。
  3. 「パイプラインの削除」ダイアログで、このパイプラインを削除することを確認し、「削除」をクリックします。
このアクションは取り消すことができません。