PostgreSQL用のExtractの追加

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。PostgreSQLデータベース、OCI PostgreSQLAmazon Aurora PostgreSQLAmazon RDS for PostgreSQLAzure Database for PostgreSQLAzure Cosmos DB for PostgreSQLおよびGoogle Cloud SQL for PostgreSQLテクノロジのExtractを追加する方法について学習します。

デプロイメント・バージョンに適した手順に従ってください。

Extractの追加(23ai)

始める前に

Extractを追加および実行してソースからデータを取得する前に、次を確認してください

  • Oracle GoldenGateのデータベースを準備します。
  • PostgreSQL接続を作成してその接続をPostgreSQLデプロイメントに関連付けます
  • サプリメンタル・ロギングを有効にします:
    1. PostgreSQL GoldenGateデプロイメント・コンソールを起動します:
      1. 「デプロイメント」ページから、PostgreSQLデプロイメントを選択してその詳細を表示します。
      2. PostgreSQLデプロイメントの詳細ページで、「コンソールの起動」をクリックします。
      3. デプロイメント・コンソールのサインイン・ページで、PostgreSQLデプロイメントの作成時に指定したGoldenGate管理資格証明を入力します。
    2. サインイン後、ナビゲーション・メニューで「DB接続」をクリックします。
    3. PostgreSQLデータベース接続で、「接続」をクリックします。接続が成功すると、チェックポイント表およびTRANDATAのフィールドが表示されます。
    4. 「TRANDATA情報」の横にある「TRANDATAの追加」(プラス・アイコン)をクリックします。
    5. 表名、スキーマ名またはワイルドカードを入力します。たとえば、src_ociggll.*です。
    6. 「Submit」をクリックします。

      ノート:

      「送信」をクリックする必要があるのは1回のみです。検索フィールドを使用して表名を検索し、表が追加されたことを確認します。
Oracle GoldenGate 23aiにExtractを追加するには:
  1. Administration Serviceナビゲーション・メニューで、Extractsをクリックします。
  2. Extractsページで、Extractの追加」(プラス・アイコン)をクリックします。
  3. Extractの追加」フォームは、4つのページで構成されます。必要に応じて、「Extractの追加」フォームに入力します。
    1. Extractの「情報」ページで:
      1. Extractタイプを選択します:
        • Change Data Capture Extract
        • Initial Load Extract
      2. プロセス名を入力します。
      3. 「説明」を入力します(オプション)。
      4. 「次へ」をクリックします。
    2. Extractオプション・ページ:
      1. 開始するタイミングを選択します。
        • Now
        • カスタム時間
        • ログでの位置
        • ログの終わり
      2. Extract Trailの詳細を入力します。
        • 名前(2文字のみ使用できます。)
        • サブディレクトリ
        • トレイル・サイズ
        • トレイル・シーケンス
        • トレイル・オフセット
      3. ドロップダウンから「ソース資格証明」「ドメイン」および「別名」を選択します。
      4. 「次へ」をクリックします。
    3. 「管理対象オプション」ページで、必要に応じてオプションのフィールドに入力します。
      1. 「プロファイル名」を選択します。
      2. 「デプロイメントのヘルスに不可欠」を有効にします。
      3. 「自動開始」を有効にします。
      4. 「自動再起動」を有効にします。
      5. 「次へ」をクリックします。
    4. 「パラメータ・ファイル」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。次に例を示します。
      table source.table1;

      ノート:

      GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。SETENVを使用して、Extractのデフォルト設定をオーバーライドします。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
      setenv (TZ="US/Eastern")
      setenv (TZ="GMT+5")
  4. 「Create and Run」をクリックしてExtractを起動します。「作成」をクリックすると、後でExtractsページからExtractを手動で起動できます。
Extractsページに戻り、Extractプロセスを選択してその詳細を表示できます。

Extractの追加(21c)

始める前に

Extractを追加および実行してソースからデータを取得する前に、次を確認してください

  • Oracle GoldenGateのデータベースを準備します
  • PostgreSQL接続を作成してその接続をPostgreSQLデプロイメントに関連付けます
  • サプリメンタル・ロギングを有効にします:
    1. PostgreSQL GoldenGateデプロイメント・コンソールを起動します:
      1. 「デプロイメント」ページから、PostgreSQLデプロイメントを選択してその詳細を表示します。
      2. PostgreSQLデプロイメントの詳細ページで、「コンソールの起動」をクリックします。
      3. デプロイメント・コンソールのサインイン・ページで、PostgreSQLデプロイメントの作成時に指定したGoldenGate管理資格証明を入力します。
    2. ログインしたら、ナビゲーション・メニューを開き、「構成」をクリックします。
    3. PostgreSQLデータベース接続で、「接続」をクリックします。接続が成功すると、チェックポイント表およびTRANDATAのフィールドが表示されます。
    4. 「TRANDATA情報」の横にある「TRANDATAの追加」(プラス・アイコン)をクリックします。
    5. 表名、スキーマ名またはワイルドカードを入力します。たとえば、src_ociggll.*です。
    6. 「Submit」をクリックします。

      ノート:

      「送信」をクリックする必要があるのは1回のみです。検索フィールドを使用して表名を検索し、表が追加されたことを確認します。
GoldenGate 21cでPostgreSQL用のExtractを追加するには:
  1. OCI GoldenGateデプロイメント・コンソールで、管理サービスの「概要」ページにあることを確認し、「Extractの追加」(プラス・アイコン)をクリックします。
  2. 「Extractタイプ」で、次のいずれかを選択します:
    • 初期ロードExtract
    • 変更データ取得Extract
  3. プロセス名を入力し、資格証明ドメインおよび別名を選択して、トレイル名の2文字の名前を入力します。
  4. 初期ロードExtractを選択した場合、「次」をクリックして「ステップ7 - 抽出パラメータ」にスキップします。変更データ取得Extractを選択した場合、「登録のみ」をクリックしてExtractを登録し、「概要」ページに戻るか、「次」をクリックして追加のExtractオプションを構成できます。

    ノート:

    「登録のみ」では、追加せずにExtractを登録します。登録では、Extractの登録時または「登録のみ」オプションの使用時にレプリケーション・スロットが作成されます。
  5. 「Extractオプション」ページの「基本情報」で、必要に応じてフィールドに入力します:
    1. 「プロセス名」に、最大8文字のExtractプロセスの名前を入力します。
    2. 「目的」で、このExtractの目的を最適に説明するオプションを選択します:
      • Now
      • カスタム時間
      • ログでの位置
      • ログの終わり
    3. For Trail Name, enter a two character name for the Trail file.
    4. (Optional) For Trail Subdirectory, set a custom location for the generated Trail file.
    5. 「トレイル・サイズ」で、生成されるトレイル・ファイルの最大数を設定します。
    6. (オプション)「管理対象オプション」では、次を構成できます。
      • プロファイル名
      • 自動開始
      • 自動再起動

      ノート:

      プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、「管理対象プロセスの構成」を参照してください。
  6. 「Extractパラメータ」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。次に例を示します。
    table source.table1;

    ノート:

    GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。SETENVを使用して、Extractのデフォルト設定をオーバーライドします。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
    setenv (TZ="US/Eastern")
    setenv (TZ="GMT+5")

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

  7. 「作成および実行」をクリックして、Extractを作成します。「作成」をクリックすると、後で管理サービスの「概要」ページからExtractを手動で起動できます。
管理サービスの「概要」ページに戻り、Extractプロセスのステータスを確認できます。Extractの「アクション」メニューから「詳細」を選択して、プロセス情報、チェックポイント、統計、パラメータおよびレポートを表示します。