PostgreSQL用のExtractの追加

Extractは、ソース・データ・ソース接続に対して実行され、データを抽出(取得)するプロセスです。Extract for PostgreSQL Database、OCI Database with PostgreSQL、Amazon Aurora PostgreSQL、Amazon RDS for PostgreSQL、Azure Database for PostgreSQL、Azure Cosmos DB for PostgreSQL、EDB Postgres Advanced Server、Google Cloud SQL for PostgreSQLテクノロジ、およびYugabyteDBをOCI GoldenGateに追加する方法を学習します。

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

Oracle GoldenGate 26aiでのExtractの追加

開始する前に

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

Oracle GoldenGateのデータベースを準備します。
PostgreSQL接続を作成して、その接続をPostgreSQLデプロイメントに関連付けます
サプリメンタル・ロギングを有効にします:

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

ノート:「発行」を選択する必要があるのは1回のみです。検索フィールドを使用して表名を検索し、表が追加されたことを確認します。

Extractの追加

デプロイメント・コンソールのナビゲーション・メニューで、「抽出」を選択します。
「Extract」ページで、「Extractの追加」(プラス・アイコン)を選択します。
「抽出の追加」フォームは、次のページで構成されています。必要に応じて、「抽出の追加」フォームに入力します。
1. 「Extract Information」ページで、次の手順を実行します。
  1. 抽出タイプを選択します:
    - 変更データ取得Extract
    - 初期ロードExtract
  2. プロセス名を入力します。
  3. (オプション)「説明」を入力します。
  4. 「次へ」を選択します。
2. 「抽出の登録」ページで、次の手順を実行します。
  1. 「ソース資格証明」として「ドメイン」および「別名」を選択します。
  2. 「プラグイン・タイプ」(論理デコード・プラグイン)として、TEST_DECODINGまたはPGOUTPUTを選択します。
    ノート:詳細は、次を参照してください。
    - PGOUTPUTのガイドラインおよび制限事項
    - PostgreSQL用のExtractの登録の追加
3. 「抽出オプション」ページで、次の手順を実行します。
  1. 開始するタイミングを選択します。
    - Now
    - カスタム時間
    - ログでの位置
    - ログの終わり
  2. 抽出証跡の詳細を入力します。
    - 名前(2文字のみ可能)
    - サブディレクトリ
    - トレイル・サイズ
    - トレイル・シーケンス
    - 証跡オフセット
  3. ドロップダウンからソース資格証明の「ドメイン」および「別名」を選択します。
  4. 「次へ」を選択します。
4. 「管理対象オプション」ページで、必要に応じてオプションのフィールドに入力し、「次へ」を選択します。
- プロファイル名
- デプロイメントのヘルスに不可欠
- 自動開始
- 自動再起動
  
  ノート:プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、管理対象プロセスの構成を参照してください。
1. 「パラメータ・ファイル」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。たとえば:
```
table source.table1;
```
  ノート:
  
  GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。Extractのデフォルト設定をオーバーライドするには、SETENVを使用します。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
Extractを起動するには、「作成および実行」を選択します。「作成」を選択した場合は、後で「抽出」ページからExtractを手動で起動できます。

「Extract」ページに戻り、Extractプロセスを選択してその詳細を表示できます。

GoldenGate 21cでのPostgreSQL用のExtractの追加

開始する前に

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. 「送信」を選択します。
ノート:「発行」を選択する必要があるのは1回のみです。検索フィールドを使用して表名を検索し、表が追加されたことを確認します。

Extractの追加

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

ノート:「登録のみ」では、Extractを追加せずに登録します。登録では、Extractの登録時または「登録のみ」オプションの使用時にレプリケーション・スロットが作成されます。
「Extractオプション」ページの「基本情報」で、必要に応じてフィールドに入力します:
1. 「プロセス名」に、最大8文字のExtractプロセスの名前を入力します。
2. 「目的」で、このExtractの目的を最もよく説明するオプションを選択します:
  - Now
  - カスタム時間
  - ログでの位置
  - ログの終わり
3. 「トレイル名」に、トレイル・ファイルの2文字の名前を入力します。
4. (オプション)「トレイルのサブディレクトリ」で、生成されるトレイル・ファイルのカスタムの場所を設定します。
5. (オプション)「トレイル・サイズ」で、生成されるトレイル・ファイルの最大サイズを設定します。
6. (オプション)「管理対象オプション」で、次を構成できます。
  - プロファイル名
  - 自動開始
  - 自動再起動
  ノート:プロファイルを追加し、「自動起動」および「自動再起動」オプションを構成すると、ネットワークの中断後にデプロイメントを自動的に再起動できます。詳細は、管理対象プロセスの構成を参照してください。
「Extractパラメータ」ページで、テキスト領域のパラメータ・ファイルを編集して、取得する表の詳細をリストできます。たとえば:
```
table source.table1;
```
ノート:

GoldenGateでは、デフォルトでグリニッジ標準時(GMT)が使用されます。Extractのデフォルト設定をオーバーライドするには、SETENVを使用します。この変更はExtractプロセスにのみ適用され、デプロイメントには適用されません。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
SETENVについてさらに学習します。
「Create and Run」を選択すると、Extractが作成されて起動されます。「作成」を選択すると、後で管理サービスの「概要」ページからExtractを手動で起動できます。

管理サービスの「概要」ページに戻り、Extractプロセスのステータスを確認できます。Select Details from the Extract Action menu to view process information, checkpoint, statistics, parameters, and reports.