Oracleオブジェクト・ストレージのReplicatの追加

Oracleオブジェクト・ストレージ・ターゲット用のReplicatプロセスの追加および構成について学習します。

開始する前に

Replicatを追加する前に、次があることを確認してください:

• Oracle Object Storageの構成に関する考慮事項とベスト・プラクティスを確認

• コンパートメントのOCID

  ヒント:コンパートメントOCIDは、「コンパートメントの詳細」ページで確認できます。

  1. Oracle Cloudコンソール・ナビゲーション・メニューを開き、「アイデンティティ」、「コンパートメント」の順に選択します。

  2. リストからコンパートメントを選択して、「コンパートメントの詳細」ページにアクセスします。

  3. 「コンパートメント情報」セクションからコンパートメントOCIDをコピーします。

  詳細は、コンパートメントのOCIDの検索を参照してください。

• Oracle Object Storageバケット名

  ヒント: Oracleでは、独自のOracle Object Storageバケットを作成することをお薦めします。

  1. Oracle Cloudコンソール・ナビゲーション・メニューを開き、「ストレージ」、「バケット」の順に選択します。

  2. 「Create Bucket」を選択します。

  3. 「バケットの作成」パネルに名前を入力し、「作成」を選択します。

  詳細は、コンソールを使用したバケットの作成を参照してください。

Replicatの追加(26ai)

このターゲット・タイプに固有の前提条件を確認してください。

1. OCI GoldenGateデプロイメント・コンソール・ナビゲーション・メニューで、「Replicat」を選択します。

2. Replicatページで、「Replicatの追加」を選択します。

3. 「Replicatの追加」パネルの「Replicat情報」ページで、必要に応じてフィールドに入力し、「次」を選択します。

   • Replicatタイプを選択します:

     • クラシックReplicat

     • 調整Replicat

   • 「プロセス名」に5文字以内で入力します。

   • このプロセスを他のプロセスと区別できるように、「摘要」を入力します。

4. Replicatオプション・ページで、必要に応じてフィールドに入力し、「次へ」を選択します。

   • Replicatトレイル:

     • 「名前」を入力します。

     • トレイル・ファイルがデフォルト以外の場所にある場合は、サブディレクトリを入力します。

     • 暗号化プロファイルを選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレットが選択されます。

     • 「開始」で、データ処理の開始点を選択します:

       • ログでの位置(デフォルト)

       • Now

       • カスタム時間

   • トレイルの位置:

     • 「シーケンス番号」を入力します。

     • 「RBAオフセット」を入力します。

     • ドロップダウンから「ターゲット」を選択します。

       ノート:ターゲットの選択によっては、ストリーミング、ステージとマージ、ステージングの場所などの追加オプションがある場合があります。

   • ターゲットの資格証明:

     • 「ドメイン」を選択します。

     • 指定したドメイン内の別名を選択します。

     • 「チェックポイント表」を選択します。デフォルトの選択を残すか、ターゲット・デプロイメント用に作成したチェックポイント表を選択します。

     • 「最大スレッド数」を選択します(調整Replicatのみ)。

5. 「管理対象オプション」ページで、必要に応じてオプション・フィールドに入力し、「次へ」を選択します。

   • プロファイル名がある場合は、そのプロファイル名を選択します。

   • デプロイメントのヘルスに不可欠を有効にします。

   • 自動開始設定を有効にして構成します。

6. 「パラメータ・ファイル」ページで、パラメータを追加してReplicatをさらに構成できます。たとえば:

   table source.table1;

   ノート:

   GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。Replicatのデフォルト設定をオーバーライドするには、SETENVを使用します。この変更はデプロイメントには適用されません。たとえば:

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

7. 「プロパティ・ファイル」ページで、必要に応じてファイル・ハンドラおよびOCIイベント・ハンドラはプロパティを構成し、「次」を選択します。変更を検討する必要があるプロパティには次が含まれます:

   1. gg.handler.name.format: 出力データのフォーマット方法を選択します。使用可能なオプションには次が含まれます:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      parquetには、追加のプロパティを適用する必要があります。詳細は、Oracle Object StorageのParquetを参照してください。

   2. gg.handler.name.fileNameMappingTemplate: テンプレート・キーワードを使用してファイル名が動的に生成されます。

   3. gg.handler.name.inactivityRollInterval: GoldenGateはファイルを作成し、書込み用に開いたままにします。このプロパティは、指定された非アクティブ期間(受信トランザクションなし)の後にファイルを閉じ、Oracleオブジェクト・ストレージにロードします。

   4. gg.eventhandler.name.compartmentID: コンパートメントOCIDを入力します。

   5. gg.eventhandler.name.bucketMappingTemplate: オブジェクト・ストレージ・バケット名を入力します。

   ファイル・ライター・ハンドラおよびOCIイベント・ハンドラ構成のプロパティについてさらに学習します。

   ノート:必要に応じて、プラガブル・フォーマッタを追加することもできます。詳細は、Pluggable Formattersを参照してください。

8. 「作成および実行」を選択します。「作成」を選択した場合は、「Replicat」ページからReplicatを後で手動で起動できます。

Replicatの追加(21c)

1. OCI GoldenGateデプロイメント・コンソールの管理サービスの「概要」ページで、「Replicatの追加」(プラス・アイコン)を選択します。

2. 「Replicatの追加」ページで、Replicatタイプを選択し、「次」を選択します。

   Replicatのタイプは:

   • クラシックReplicat

   • 調整Replicat

3. 「Replicatオプション」ページで、次のフィールドに値を入力し、「次」を選択します。

   1. 「プロセス名」に、Replicatプロセスの名前を入力します。

   2. (オプション)「説明」に、このプロセスを他のプロセスから区別するための短い説明を入力します。

   3. 「トレイル名」に、2文字のトレイル名を入力します。

   4. 「ターゲット」で、ドロップダウンから「Oracle Object Storage」を選択します。

   5. OCIの使用可能な別名で、ドロップダウンから別名を選択します。

4. 「パラメータ・ファイル」ページで、必要に応じてReplicatパラメータを追加して構成し、「次」を選択します。

   table source.table1;

   ノート:

   GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。Extractのデフォルト設定をオーバーライドするには、SETENVを使用します。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

5. 「プロパティ・ファイル」ページで、必要に応じてファイル・ハンドラおよびOCIイベント・ハンドラはプロパティを構成し、「次」を選択します。変更を検討する必要があるプロパティには次が含まれます:

   1. gg.handler.name.format: 出力データのフォーマット方法を選択します。使用可能なオプションには次が含まれます:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      parquetには、追加のプロパティを適用する必要があります。詳細は、Oracle Object StorageのParquetを参照してください。

   2. gg.handler.name.fileNameMappingTemplate: テンプレート・キーワードを使用してファイル名が動的に生成されます。

   3. gg.handler.name.inactivityRollInterval: GoldenGateはファイルを作成し、書込み用に開いたままにします。このプロパティは、指定された非アクティブ期間(受信トランザクションなし)の後にファイルを閉じ、Oracleオブジェクト・ストレージにロードします。

   4. gg.eventhandler.name.compartmentID: コンパートメントOCIDを入力します。

   5. gg.eventhandler.name.bucketMappingTemplate: オブジェクト・ストレージ・バケット名を入力します。

   ファイル・ライター・ハンドラおよびOCIイベント・ハンドラのプロパティについてさらに学習します。

   ノート:必要に応じて、プラガブル・フォーマッタを追加することもできます。詳細は、プラガブル・フォーマッタの使用を参照してください。

6. 「追加および実行」を選択します。

管理サービスの「概要」ページに戻り、Replicatプロセスのステータスをモニターできます。プロセス名を選択してその詳細を表示し、レポートにアクセスします。

関連内容

• Oracle Object Storageターゲットの詳細

Oracle Object Storage接続に関する既知の問題

リソース・プリンシパル使用時のOracle Object Storageレプリケーション・エラー

Oracle Object Storage接続でリソース・プリンシパル認証が使用されている場合、Replicatは次のエラーで失敗します。

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

回避方法:この問題を回避するには、接続を編集してから、別の認証方法を選択します。

Oracleオブジェクト・ストレージ接続のユーザーOCIDが一致しない(フェデレーテッド・ユーザーのみ)

フェデレーテッド・ユーザーがOracleオブジェクト・ストレージ接続の作成時に「現在のユーザーを使用」を選択した場合、そのOCIDがシステムによって取得されたOC IDと一致しません。

回避策: Oracleオブジェクト・ストレージ接続を作成する場合は、必ず「別のユーザーの指定」を選択し、フェデレーテッド・ユーザーのOCIDを入力してください。

ユーザーOCIDを検索するには、Oracle Cloudコンソールのグローバル・ヘッダーで「プロファイル」を選択し、ユーザー名を選択します。「ユーザーの詳細」ページの「ユーザー情報」で、OCIDの「表示」を選択します。