パイプラインの管理

OCI GoldenGateパイプラインの操作に不可欠なパイプライン管理タスクをご覧ください。

パイプライン詳細の表示

パイプライン・ページからパイプラインを選択して、その詳細を表示します。パイプライン詳細ページでは、パイプラインのステータスを表示できます。ステータスは、次のいずれかです。

• 作成

• アクティブ(停止)

• アクティブ(実行中)

• 更新

• 注意が必要

• 失敗

パイプラインを編集したり、「アクション」メニューを使用して、次のようなその他のアクションを実行することもできます。

• 編集

• [開始]または [停止]

• 診断の収集

• リソースの移動

• タグの追加

• 削除

他の関連するパイプライン情報を表示するには、別のタブに切り替えます。

パイプライン情報

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

マッピング・ルール

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

初期化

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

実行時

runtimeのステータスと待機時間を表示します。

モニタリング

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

作業要求

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

• 作成

• 始点

• 停止

• 更新

• 削除

• 移動

• 診断の収集

タグ

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

パイプラインを編集します

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

• 名前

• 説明

• プロセス・オプション:

  ノート:変更を有効にするには、パイプラインを再起動する必要があります。

  • 進行中のレプリケーションの前に既存のデータをコピー: データの初期ロードを実行するには、このオプションを選択します。既存の表の場合、次の操作を選択できます。

    • 切捨て: 既存の行が削除された後、ソースから行をロードします。

    • 置換: 既存の表の削除後、ソースから作成およびロードします。

    • 追加: 既存の行を変更せずに残し、ソースから行をロードします。

    • スキップ: 表はそのままにして、次のオブジェクトに移動します。

  • スキーマ変更の置換(DDL): 選択すると、プロセスでエラーが発生したときに既存のスキーマに対して実行するアクションを選択します。

    • 終了: トランザクションをロールバックして処理を停止します。

    • 破棄: 破棄ファイルにエラーを記録して処理を継続します。

    • 無視: エラーを無視して処理を続行します。

  • DMLエラー時のアクション: プロセスでDMLエラーが発生した場合に既存のデータを処理するアクションを選択します。

    • 終了

    • 破棄

    • 無視

  • 失敗後に再起動: プロセスがなんらかの理由で停止した場合に自動再起動を有効にするには、このオプションを選択します。

  • デフォルト・マッピングを使用したパイプラインの開始: デフォルトの1:1マッピング・ルールを使用して、作成直後にパイプラインを開始します。選択しない場合、作成後にルール・マッピングを構成してから、パイプラインを手動で起動できます。

パイプラインの開始

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

パイプラインの一時停止

パイプラインを一時停止して、取得および配信プロセスを一時的に停止できます。パイプラインを一時停止しても、これらのリソースの請求は一時停止されません。パイプラインの一時停止中に、パイプライン、そのマッピング・ルールを編集し、マッピング・ルールをプレビューできます。

ノート:請求を停止するには、パイプラインを停止する必要があります。

パイプラインを一時停止するには、パイプラインの「アクション」メニューから「一時停止」を選択します。

パイプラインを続行する準備ができたら、パイプラインの「アクション」メニューから「開始」を選択します。

パイプラインを完全に停止する場合は、「停止」を選択します。

パイプラインの停止

パイプラインを停止するには、その詳細ページのアクティブ・パイプラインの「アクション」メニューから「停止」を選択します。「パイプラインの停止」ダイアログで「停止」を選択して、このアクションを確認します。

パイプラインを停止すると、これらのリソースの請求も停止します。パイプラインが停止され、非アクティブ状態の場合、パイプラインとそのマッピングを編集したり、マッピングをプレビューすることはできません。

パイプラインを再起動するには、パイプラインの「アクション」メニューから「開始」を選択します。

パイプライン・クローニング

状態が「アクティブ」、「非アクティブ」または「注意が必要」のパイプラインをクローニングできます。

パイプラインをクローニングするには:

• パイプライン・ページで、パイプラインの「アクション」メニューから「クローン」を選択し、次のステップに従います。

• パイプラインの詳細ページで、「アクション」メニューから「クローン」を選択します。

  1. 「パイプラインのクローニング」パネルで、パイプライン・クローンの「名前」を入力します。

  2. (オプション)パイプライン・クローンの説明を入力します。

  3. パイプライン・クローンを作成するコンパートメントを選択します。

  4. (オプション)必要に応じて「拡張オプション」を完了します。

  5. 「クローン」を選択します。

診断の収集

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

パイプラインに関する診断を収集するには:

1. パイプラインの詳細ページで、「アクション」メニューから「診断の収集」を選択します。

2. 「診断の収集」パネルで、診断ファイルを保存するコンパートメントおよびバケットを選択します。

3. 診断ファイルの名前接頭辞を入力します。

4. 「診断の収集」を選択します。

収集プロセスが完了したら、パイプラインの詳細ページから診断ファイルをダウンロードできます。

パイプライン・メトリックのモニター

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

• パフォーマンスのモニター

• OCI GoldenGateメトリック

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

マッピング・ルールをプレビュー、追加または削除するには:

1. パイプライン情報ページで、「マッピング・ルール」を選択します。

2. 「マッピング・ルール」リストでは、現在のマッピング・ルールを確認または編集できます。

   • プレビュー: マッピング・ルールがレプリケーションに含まれるスキーマおよび表にどのように影響するかを確認します。

   • 追加: インクルードまたは除外対象の表およびスキーマを指定します。オブジェクト名の任意の部分のかわりに、完全修飾オブジェクト名またはワイルドカードを使用できます。ワイルドカードの詳細は、「データベース・オブジェクト名でのワイルドカードの使用」に関する項を参照してください。

   • 削除: マッピング・ルールを削除します。

初期化ステップの表示

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

• ソース・データベースとターゲット・データベースの確認

• 抽出のためのデータベース・オブジェクトを準備します

• ハートビート表の作成

• Extractの作成および実行(取得)

• ターゲット・スキーマおよび表が存在することを確認します。

• チェックポイント表の作成

• 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. 「パイプラインの削除」ダイアログで、このパイプラインを削除することを確認してから、「削除」を選択します。

このアクションは取り消すことができません。