Amazon KinesisのReplicatの追加

Amazon Kinesis用のReplicatを追加および実行する前に、次のものがあることを確認してください:

• Amazon Kinesis接続が作成され、ターゲット・ビッグ・データ・デプロイメントに割り当てられました
• Amazon Web Services (AWS)リージョン

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. 「プロパティ・ファイル」ページで、次のAmazon Kinesisプロパティを構成します:
   • gg.eventhandler.kinesis.region: ターゲットAmazon KinesisストリームのAWSリージョンを指定します。
   • gg.handler.kinesis.streamMappingTemplate=${tableName}。$(tableName}を既存のデータ・ストリームの名前に置き換えるか、デフォルト値をそのままにするか、「テンプレート・キーワード」を使用してストリーム名を動的に割り当てます。
   • (オプション) gg.handler.kinesis.partitionMappingTemplate=${primaryKeys}、デフォルト値をそのままにするか、${primaryKeys}をテンプレート名に置き換えてメッセージ・キーを解決します。

   このターゲットのプロパティの詳細は、Oracle GoldenGate for Distributed Applications and AnalyticsガイドのAmazon Kinesisを参照してください。

7. 「作成および実行」をクリックします。「作成」をクリックすると、後で管理サービスのホーム・ページからReplicatを手動で起動できます。

Amazon Kinesis用のReplicatプロセスの追加について学習します。

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

   • クラシックReplicat
   • 調整Replicat
3. 「Replicatオプション」ページで、次のフィールドに入力し、「次」をクリックします:
   1. 「プロセス名」に、Replicatプロセスの名前を入力します。
   2. (オプション)「説明」に、このReplicatを他のReplicatから区別するための簡単な説明を入力します。
   3. 「トレイル名」に、2文字のトレイル名を入力します。
   4. 「ターゲット」で、ドロップダウンから「Amazon Kinesis」を選択します。
   5. 「Amazon Kinesisで使用可能な別名」で、ドロップダウンから別名を選択します。
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を使用して、Replicatのデフォルト設定をオーバーライドします。この変更はデプロイメントには適用されません。例:

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

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

5. 「プロパティ・ファイル」ページで、次のAmazon Kinesisプロパティを構成します:
   • gg.eventhandler.kinesis.region:: ターゲットAmazon KinesisストリームのAWSリージョンを指定します。
   • gg.handler.kinesis.streamMappingTemplate=${tableName}。$(tableName}を既存のデータ・ストリームの名前に置き換えるか、デフォルト値をそのままにするか、「テンプレート・キーワード」を使用してストリーム名を動的に割り当てます。
   • (オプション) gg.handler.kinesis.partitionMappingTemplate=${primaryKeys}、デフォルト値をそのままにするか、${primaryKeys}をテンプレート名に置き換えてメッセージ・キーを解決します。
6. 「作成および実行」をクリックします。「作成」をクリックすると、後で管理サービスの「概要」ページからReplicatを手動で起動できます。