Google BigQueryのReplicatの追加

Google Cloud StorageターゲットのReplicatプロセスの作成について学習します。

開始する前に

Google BigQueryReplicatを作成する前に、次のことを確認してください:

  • Google Cloud Storage接続とGoogle BigQuery接続の両方を作成して、ビッグ・データ・デプロイメントに割り当てます。デプロイメントでは、Google BigQueryのステージング場所としてGoogle Cloud Storageを使用します。

    ノート:

    Google Cloud StorageバケットとBigQueryデータセットが同じ場所またはリージョンにあることを確認します。
  • Google Cloud Serviceアカウント・キーを設定します。
  • 適切なGoogle BigQuery権限を割り当てます

Replicatの追加(23ai)

始める前に

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

GoldenGate 23aiにReplicatを追加するには:
  1. OCI GoldenGateデプロイメント・コンソール管理サービスのホームページで、Replicatの追加」(プラス・アイコン)をクリックします。
  2. 「Replicatの追加」パネルのReplicat情報ページで、必要に応じてフィールドに入力し、「次」をクリックします:
    • Replicatタイプを選択します:
      • クラシックReplicat
      • 調整Replicat
    • 「プロセス名」に5文字以下の長さで入力します。
    • 「説明」を入力して、このプロセスを他のプロセスと区別できるようにします。
  3. 「Replicatオプション」ページで、必要に応じてフィールドに入力し、「次」をクリックします:
    • Replicatトレイル:
      • 「名前」を入力します
      • 証跡ファイルがデフォルト以外の場所にあることが想定される場合は、「サブディレクトリ」を入力します。
      • 暗号化プロファイルを選択します。暗号化プロファイルが作成されていない場合は、デフォルトでローカル・ウォレットが選択されます。
      • 「開始」で、データ処理の開始点を選択します:
        • ログでの位置(デフォルト)
        • Now
        • カスタム時間
    • トレイルの位置:
      • 「連番」を入力します。
      • RBAオフセットを入力します。
      • ドロップダウンから「ターゲット」を選択します。

        ノート:

        ターゲットの選択に応じて、ストリーミング、ステージとマージ、ステージングの場所などの追加オプションがある場合があります。
    • ターゲットの資格証明:
      • 「ドメイン」を選択します
      • 指定したドメイン内の別名を選択します。
      • 「チェックポイント表」を選択します。デフォルトの選択のままにするか、ターゲット・デプロイメント用に作成した「チェックポイント」表を選択します。
      • 「最大スレッド数」を選択します(調整「レプリカ」のみ)。
  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. 「プロパティ・ファイル」ページで、gg.eventhandler.gcs.bucketMappingTemplate=<gcs bucket>を見つけ、<gcs bucket>Google Cloud Storageバケット名に置き換えます。

    このターゲットのプロパティの詳細は、Oracle GoldenGate for Distributed Applications and AnalyticsガイドのGoogle BigQueryのステージおよびマージを参照してください。

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

Replicatの追加(21c)

Oracle GoldenGate 21cGoogle BigQueryターゲットのReplicatを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールの管理サービスの「概要」ページで、「Replicatの追加」(プラス・アイコン)をクリックします。
  2. On the Add Replicat page, select a Replicat type, and then click Next.
    Replicatのタイプは:
    • クラシックReplicat
    • 調整Replicat
  3. 「Replicatオプション」ページで、次のフィールドに入力し、「次」をクリックします:
    1. 「プロセス名」に、Replicatプロセスの名前を入力します。
    2. (オプション)「説明」に、このReplicatを他のReplicatから区別するための簡単な説明を入力します。
    3. 「トレイル名」に、2文字のトレイル名を入力します。
    4. 「ターゲット」で、ドロップダウンから「Google BigQuery」を選択します。
    5. 「使用可能な別名」で、ドロップダウンから別名を選択します。
    6. 「使用可能なステージングの場所」では、「Google Cloud Storage」がすでに選択されている必要があります。
    7. 「ステージング別名を使用」で、「Google Cloud Storage」接続を選択します。
  4. 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を使用して、Replicatのデフォルト設定をオーバーライドします。この変更はデプロイメントには適用されません。たとえば次のようにします。
      setenv (TZ="US/Eastern")
      setenv (TZ="GMT+5")

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

  5. 「プロパティ・ファイル」ページで、gg.eventhandler.gcs.bucketMappingTemplate=<gcs bucket>を見つけ、<gcs bucket>Google Cloud Storageバケット名に置き換えます。
  6. 「作成および実行」をクリックします。「作成」をクリックすると、後で管理サービスの「概要」ページからReplicatを手動で起動できます。
管理サービスの概要ページに戻り、Replicatプロセスの表示、およびReplicatアクションにアクセスできます。