Azure Data Lake StorageのReplicatの追加

Azure Data Lake StorageターゲットにReplicatを追加する方法について学習します。

関連項目

Azure Blob Storageターゲットの詳細

Replicatの追加(23ai)

始める前に

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

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

OCI GoldenGateデプロイメント・コンソールの管理サービスのホームページで、「Replicatの追加」(プラス・アイコン)をクリックします。
「Replicatの追加」パネルのReplicat情報ページで、必要に応じてフィールドに入力し、「次」をクリックします:
- Replicatタイプを選択します:
  - クラシックReplicat
  - 調整Replicat
- 「プロセス名」に5文字以下の長さで入力します。
- 「説明」を入力して、このプロセスを他のプロセスと区別できるようにします。
「Replicatオプション」ページで、必要に応じてフィールドに入力し、「次」をクリックします:
- Replicatトレイル:
  - 「名前」を入力します
  - 証跡ファイルがデフォルト以外の場所にあることが想定される場合は、「サブディレクトリ」を入力します。
  - 暗号化プロファイルを選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレットが選択されます。
  - 「開始」で、データ処理の開始点を選択します:
    - ログでの位置(デフォルト)
    - Now
    - カスタム時間
- トレイルの位置:
  - 「連番」を入力します。
  - RBAオフセットを入力します。
  - ドロップダウンから「ターゲット」を選択します。
    
    ノート:
    ターゲットの選択に応じて、ストリーミング、ステージとマージ、ステージングの場所などの追加オプションがある場合があります。
- ターゲットの資格証明:
  - 「ドメイン」を選択します
  - 指定したドメイン内の別名を選択します。
  - 「チェックポイント表」を選択します。デフォルトの選択のままにするか、ターゲット・デプロイメント用に作成した「チェックポイント」表を選択します。
  - 「最大スレッド数」を選択します(調整「レプリカ」のみ)。
「管理対象オプション」ページで、必要に応じてオプションのフィールドに入力し、「次」をクリックします:
- プロファイル名がある場合は選択します。
- デプロイメントのヘルスに不可欠を有効にします。
- 自動開始設定を有効にして構成します。
「パラメータ・ファイル」ページで、パラメータを追加して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")
```
「プロパティ・ファイル」ページで、次のAzure Data Lake Storageプロパティを構成します:
必須プロパティ:
- gg.eventhandler.abs.bucketMappingTemplate: Azure Data Lake Storageコンテナ名を指定します。コンテナが事前構成されている場合、静的コンテナ名を指定できます。Azure認証方法の権限が指定されている場合、OCI GoldenGateはテンプレート・キーワードを使用してコンテナを自動作成できます。
(オプション)追加を検討できる追加プロパティ:
- (オプション) gg.handler.abs.format: 出力のフォーマット方法を選択します。デフォルト設定はJSONです。使用可能なオプションには次が含まれます:
  - delimitedtext
  - json
  - json_row
  - xml
  - avro_row_ocf
  - avro_op_ocf
  parquetの場合は、追加のプロパティを適用する必要があります。詳細は、Azure Data Lake StorageのParquetを参照してください。
このターゲットのプロパティの詳細は、Oracle GoldenGate for Distributed Applications and AnalyticsガイドのAzure Blob Storageを参照してください。
「作成および実行」をクリックします。「作成」をクリックすると、後で管理サービスのホーム・ページからReplicatを手動で起動できます。

Replicatの追加(21c)

Oracle GoldenGate 21cでAzure Data Lake StorageターゲットのReplicatを追加するには:

OCI GoldenGateデプロイメント・コンソールの管理サービスの「概要」ページで、「Replicatの追加」(プラス・アイコン)をクリックします。
On the Add Replicat page, select a Replicat type, and then click Next.
Replicatのタイプは:
- クラシックReplicat
- 調整Replicat
「Replicatオプション」ページで、次のフィールドに入力し、「次」をクリックします:
1. 「プロセス名」に、Replicatプロセスの名前を入力します。
2. (オプション)「説明」に、このReplicatを他のReplicatから区別するための簡単な説明を入力します。
3. 「トレイル名」に、2文字のトレイル名を入力します。
4. 「ターゲット」で、ドロップダウンから「Azure Data Lake Storage」を選択します。
5. 「別名」で、「Azure Data Lake Storage」接続を選択します。
On the Parameter File page, add and configure Replicat parameters as needed, and then click Next.
ノート:
- 調整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についてさらに学習します。
「プロパティ・ファイル」ページで、次のAzure Data Lake Storageプロパティを構成します:
必須プロパティ:
- gg.eventhandler.abs.bucketMappingTemplate: Azure Data Lake Storageコンテナ名を指定します。コンテナが事前構成されている場合、静的コンテナ名を指定できます。Azure認証方法の権限が指定されている場合、OCI GoldenGateはテンプレート・キーワードを使用してコンテナを自動作成できます。
(オプション)追加を検討できる追加プロパティ:
- gg.handler.abs.format: 出力のフォーマット方法を選択します。デフォルト設定はJSONです。使用可能なオプションには次が含まれます:
  - delimitedtext
  - json
  - json_row
  - xml
  - avro_row_ocf
  - avro_op_ocf
  parquetの場合は、追加のプロパティを適用する必要があります。詳細は、Azure Data Lake StorageのParquetを参照してください。
「作成および実行」をクリックします。「作成」をクリックすると、後で管理サービスの「概要」ページからReplicatを手動で起動できます。

管理サービスの概要ページに戻り、Replicatプロセスの表示、およびReplicatアクションにアクセスできます。

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

Oracle and/or its affiliates.