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

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

開始する前に

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

• コンパートメントのOCID

  ヒント :

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

  1. Oracle Cloudコンソールのナビゲーション・メニューを開き、「アイデンティティ」、「コンパートメント」の順に選択します。
  2. リストからコンパートメントを選択して、「コンパートメントの詳細」ページにアクセスします。
  3. 「コンパートメント情報」セクションからコンパートメントOCIDをコピーします。

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

• OCIオブジェクト・ストレージ・バケット名

  ヒント :

  Oracleでは、独自のOCIオブジェクト・ストレージ・バケットを作成することをお薦めします。

  1. Oracle Cloudコンソールのナビゲーション・メニューを開き、「ストレージ」、「バケット」の順に選択します。
  2. 「バケットの作成」をクリックします。
  3. 「バケットの作成」パネルで、名前を入力し、「作成」をクリックします。

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

Replicatの追加(23ai)

始める前に

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

GoldenGate 23aiにReplicatを追加するには:

1. OCI GoldenGateデプロイメント・コンソールの管理サービスのホームページで、「Replicatの追加」(プラス・アイコン)をクリックします。
2. 「Replicatの追加」パネルのReplicat情報ページで、必要に応じてフィールドに入力し、「次」をクリックします:
   • Replicatタイプを選択します:
     • クラシックReplicat
     • 調整Replicat
   • 「プロセス名」に5文字以下の長さで入力します。
   • 「説明」を入力して、このプロセスを他のプロセスと区別できるようにします。
3. 「Replicatオプション」ページで、必要に応じてフィールドに入力し、「次」をクリックします:
   • Replicatトレイル:
     • 「名前」を入力します
     • 証跡ファイルがデフォルト以外の場所にあることが想定される場合は、「サブディレクトリ」を入力します。
     • 暗号化プロファイルを選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレットが選択されます。
     • 「開始」で、データ処理の開始点を選択します:
       • ログでの位置(デフォルト)
       • Now
       • カスタム時間
   • トレイルの位置:
     • 「連番」を入力します。
     • RBAオフセットを入力します。
     • ドロップダウンから「ターゲット」を選択します。

       ノート:

       ターゲットの選択に応じて、ストリーミング、ステージとマージ、ステージングの場所などの追加オプションがある場合があります。
   • ターゲットの資格証明:
     • 「ドメイン」を選択します
     • 指定したドメイン内の別名を選択します。
     • 「チェックポイント表」を選択します。デフォルトの選択のままにするか、ターゲット・デプロイメント用に作成したチェックポイント表を選択します。
     • 「最大スレッド数」を選択します(調整「レプリカ」のみ)。
4. 「管理対象オプション」ページで、必要に応じてオプションのフィールドに入力し、「次」をクリックします:
   • プロファイル名がある場合は選択します。
   • デプロイメントのヘルスに不可欠を有効にします。
   • 自動開始設定を有効にして構成します。
5. 「パラメータ・ファイル」ページで、パラメータを追加してReplicatを構成できます。次に例を示します。

   table source.table1;

   調整されたReplicatを使用する場合は、パラメータ・ファイルにTARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.propertiesを追加します。

   ノート:

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

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

6. 「プロパティ・ファイル」ページで、必要に応じてファイル・ハンドラおよびOCIイベント・ハンドラ・プロパティを構成し、「次」をクリックします。変更を検討する必要があるプロパティには次が含まれます:
   1. gg.handler.name.format: 出力データのフォーマット方法を選択します。使用可能なオプションには次が含まれます:
      • delimitedtext
      • json
      • json_row
      • xml
      • avro_row
      • avro_op
      • avro_row_ocf
      • avro_op_ocf

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

   2. gg.handler.name.fileNameMappingTemplate: テンプレート・キーワードを使用してファイル名を動的に生成します。
   3. gg.handler.name.inactivityRollInterval: GoldenGateはファイルを作成し、書込み用に開いたままにします。このプロパティは、指定された非アクティブ期間(受信トランザクションなし)の後にファイルを閉じ、OCIオブジェクト・ストレージにロードします。
   4. gg.eventhandler.name.compartmentID: コンパートメントOCIDを入力します。
   5. gg.eventhandler.name.bucketMappingTemplate: オブジェクト・ストレージ・バケット名を入力します。

   ファイル・ライター・ハンドラおよびOCIイベント・ハンドラ構成プロパティの詳細を参照してください。

   ノート:

   必要に応じて、プラガブル・フォーマッタを追加することもできます。詳細は、プラガブル・フォーマッタを参照してください。
7. 「作成および実行」をクリックします。「作成」をクリックすると、後で管理サービスのホーム・ページからReplicatを手動で起動できます。

Replicatの追加(21c)

OCIオブジェクト・ストレージ・ターゲット用のReplicatを追加するには:

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パラメータを追加して構成し、「次」をクリックします。

   ノート:

   • 調整Replicatを使用する場合は、パラメータ・ファイルの2行目に次のパラメータを追加します。

     TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
           name>.properties

     調整Replicatを使用すると、複数のファイルが作成されます。

     省略すると、次のエラーが発生します。

     OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
           "/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
           directory).

   • GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。デフォルト設定をオーバーライドするには、SETENVを使用します。たとえば次のようにします。

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

     SETENVについてさらに学習します。

5. 「プロパティ・ファイル」ページで、必要に応じてファイル・ハンドラおよびOCIイベント・ハンドラ・プロパティを構成し、「次」をクリックします。変更を検討する必要があるプロパティには次が含まれます:
   1. gg.handler.name.format: 出力データのフォーマット方法を選択します。使用可能なオプションには次が含まれます:
      • delimitedtext
      • json
      • json_row
      • xml
      • avro_row
      • avro_op
      • avro_row_ocf
      • avro_op_ocf

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

   2. gg.handler.name.fileNameMappingTemplate: テンプレート・キーワードを使用してファイル名を動的に生成します。
   3. gg.handler.name.inactivityRollInterval: GoldenGateはファイルを作成し、書込み用に開いたままにします。このプロパティは、指定された非アクティブ期間(受信トランザクションなし)の後にファイルを閉じ、OCIオブジェクト・ストレージにロードします。
   4. gg.eventhandler.name.compartmentID: コンパートメントOCIDを入力します。
   5. gg.eventhandler.name.bucketMappingTemplate: オブジェクト・ストレージ・バケット名を入力します。

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

   ノート:

   必要に応じて、プラガブル・フォーマッタを追加することもできます。詳細は、プラガブル・フォーマッタの使用を参照してください。
6. 「追加および実行」をクリックします。

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

既知の問題

リソース・プリンシパル使用時のOCIオブジェクト・ストレージ・レプリケーション・エラー

認証にリソース・プリンシパルが使用されている場合、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

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

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

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

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

---

タイトルおよび著作権情報

Copyright ©2022,

Oracle and/or its affiliates.