Oracle Cloud Infrastructureドキュメント

MongoDB用のExtractの追加

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

Extractの追加(23ai)

このソース接続タイプに固有の詳細を確認してください。

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

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

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

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

Extractの追加(21c)

OCI GoldenGateでMongoDBソースのExtractプロセスを追加する方法について学習します

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

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

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

既知の問題

Replicatsは、MongoDB ExtractのTrail fileをBINARY_JSON_FORMATとともに使用すると失敗します

ReplicatがMongoDB Extractから生成されたTrail fileをExtractパラメータ・ファイルでBINARY_JSON_FORMATとともに使用すると、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形式で表されます。