Oracle Object Storageターゲット用のReplicatの追加

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

• コンパートメントOCID

  ヒント:

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

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

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

• Oracle Object Storageバケット名

  ヒント:

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

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

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

1. OCI GoldenGateデプロイメント・コンソールの管理サービスのホームページで、「Replicatの追加」(プラス・アイコン)をクリックします。
2. 「Replicatの追加」パネルの「Replicat情報」ページで、必要に応じてフィールドに入力し、「次」をクリックします:
   • Replicatのタイプを選択します:
     • クラシックReplicat
     • 調整Replicat
   • 「プロセス名」に5文字以下の長さで入力します。
   • このプロセスを他のプロセスから区別できるように、「説明」を入力します。
3. 「Replicatオプション」ページで、必要に応じてフィールドに入力し、「次」をクリックします:
   • Replicatトレイル:
     • 「名前」を入力します
     • サブディレクトリを入力します(トレイル・ファイルがデフォルト以外の場所にあることが予想される場合)。
     • 暗号化プロファイルを選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレットが選択されます。
     • 「開始」で、データ処理の開始点を選択します:
       • ログでの位置(デフォルト)
       • 現在
       • カスタム時間
   • トレイルの位置:
     • 「シーケンス番号」を入力します。
     • RBAオフセットを入力します。
     • ドロップダウンから「ターゲット」を選択します。
       ノート
       
       ターゲットの選択によっては、ストリーミング、ステージとマージ、ステージングの場所などの追加オプションがある場合があります。
   • ターゲットの資格証明:
     • 「ドメイン」を選択します
     • 指定したドメイン内の別名を選択します。
     • チェックポイント表を選択します。デフォルトの選択のままにするか、ターゲット・デプロイメント用に作成したチェックポイント表を選択します。
     • 「最大スレッド数」を選択します(調整されたReplicatのみ)。
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の場合、追加プロパティを適用する必要があります。詳細は、「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を参照してください。
7. 「作成および実行」をクリックします。「作成」をクリックすると、後で管理サービスのホーム・ページから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の場合、追加プロパティを適用する必要があります。詳細は、「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. 「追加および実行」をクリックします。