MongoDB用のExtractの追加

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。MongoDB用のExtractを追加する方法について学習します。

Extractの追加(23ai)

MongoDBのExtractを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールの「管理サービスのホーム」ページで、「Extractの追加」をクリックします。
  2. 「抽出の追加」パネルの「抽出情報」ページで、必要に応じて次のフィールドに入力し、「次へ」をクリックします。
    • 「プロセス名」に8文字以内で入力します。
    • 「説明」(オプション)を入力して、このプロセスを他のプロセスと区別できるようにします。
    • ドロップダウンから「ソース」を選択します。
  3. 「抽出オプション」ページで、必要に応じて次のフィールドに入力し、「次へ」をクリックします。
    1. 「Extract Trail」の場合:
      1. Extractプロセスの「名前」を入力します。
      2. 「サブディレクトリ名」を入力して、生成された証跡ファイルのカスタムの場所を設定します。
      3. 「証跡順序」と入力して、証跡ファイルの開始番号を設定します。
      4. 「トレイル・サイズ」を入力して、生成されるトレイル・ファイルの最大サイズを設定します。
      5. 「暗号化プロファイル」を選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレット・プロファイルが選択されます。
      6. 「暗号化のアルゴリズム」を選択します。
        • なし
        • AES256
        • AES192
        • AES128
    2. 「ソース資格証明」で、次を選択します:
      1. ドメイン
      2. エイリアス
      3. 最初の作業作業
  4. 「管理対象オプション」ページで、必要に応じて次のオプション・フィールドに入力し、「次へ」をクリックします。
    • プロファイル名
    • デプロイメントのヘルスに不可欠
    • 自動開始
    • 自動再起動

    ノート:

    プロファイルを追加して「自動開始」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、「管理対象プロセスの構成」を参照してください。

  5. パラメータ・ファイル・ページで、TABLE source.*;を使用してソース・マッピングを更新します。

    ノート:

    これはソース・データベース/コレクション・マッピングです。TABLE *.*;を実行すると、すべてのデータベース/コレクションからプロセスが抽出されます。
  6. 「作成および実行」をクリックして、Extractを作成および起動します。「作成」をクリックすると、後で「抽出」ページからExtractを手動で起動できます。

Extractの追加(21c)

OCI GoldenGateMongoDBソースのExtractプロセスを追加する方法を学習します

MongoDB用のExtractを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールで、管理サービスの「概要」ページが表示されていることを確認し、「Extractの追加」(プラス・アイコン)をクリックします。
  2. 「Extractの追加」ページの「Extract」タイプで、次のいずれかを選択し、「次」をクリックします。
    • 初期ロード
    • 変更データ取得
  3. 「Extractオプション」ページで、次のようにフィールドに入力した後、「次」をクリックします:
    1. 「プロセス名」に、Extractの名前を入力します。
    2. 「接続別名」で、ドロップダウンから接続別名を選択します。
    3. 「ソース」で、「ファイル」を選択します。
    4. 「ファイル名」に、ファイル名に3文字以上入力します。
    5. (オプション)「管理対象オプション」で、次を構成できます。
      • プロファイル名
      • 自動開始
      • 自動再起動

      ノート:

      プロファイルを追加して「自動開始」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、管理対象プロセスの構成を参照してください。
  4. パラメータ・ファイル・ページで、TABLE source.*;を使用してソース・マッピングを更新します。

    ノート:

    これはソース・データベース/コレクション・マッピングです。TABLE *.*;を実行すると、すべてのデータベース/コレクションからプロセスが抽出されます。
  5. 「作成および実行」をクリックします。
管理サービスの「概要」ページに戻ります。Extract名をクリックして、Extractの詳細およびレポートを表示します。

既知の事象

BINARY_JSON_FORMATでMongoDB Extractの証跡ファイルを使用すると、レプリケートが失敗します

ReplicatがExtractパラメータ・ファイルでBINARY_JSON_FORMATを使用してMongoDB Extractから生成されたトレイル・ファイルを使用する場合、Replicatは次のエラーで失敗します。

ERROR 2023-08-04 17:13:13.000421 [main] - Unable to decode column 0 : Input length = 1
      java.nio.charset.MalformedInputException: Input length = 1 at
      java.nio.charset.CoderResult.throwException(CoderResult.java:281) ~[?:1.8.0_311]at java.nio.charset.CharsetDecoder.decode(CharsetDecoder.java:816) ~[?:1.8.0_311] at
      oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1106)
      [ggdbutil-21.9.0.0.3.001.jar:21.9.0.0.3.001] Exception in thread “main”
      oracle.goldengate.util.GGException: Unable to decode column 0 : Input length = 1 at
      oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1203)

回避策: BINARY_JSON_FORMATがExtractパラメータから削除されると、Replicatは正常に実行され、ドキュメントは拡張JSON形式で表されます。