アップグレード後のステップ

様々なアップグレード・シナリオのアップグレード後のタスクについて学習します。

Oracle GoldenGateデータ・レプリケーションの設定を開始する前に完了する必要があるアップグレード後のステップが複数あります。次のタスクがあります。

ハートビート表のアップグレード
(Oracle GoldenGate for PostgreSQLのみ) PostgreSQL Extractのアップグレード。

ハートビート表のアップグレード

アップグレードが完了したら、UPGRADE HEARTBEATTABLEコマンドを実行して、以前に作成されたソース・データベースとターゲット・データベースに対して、表とラグのビューに列を追加します。これらの特別な列は、Extractの再開位置をトラッキングするために使用されます。詳細は、UPGRADE HEARTBEATTABLE`を参照してください。

PostgreSQLのOracle GoldenGateのためのExtractのアップグレード

PostgreSQLからのOracle GoldenGate CDCキャプチャのサポートは、PostgreSQLデータベースのレプリケーション・スロットを使用してWALから変更レコードを読み取ることに依存します。各CDC Extractで使用されるレプリケーション・スロット名は、Oracle GoldenGateのインストール・パスによって異なります。

Extractはアップグレード時まで変更レコードの取得を完了していませんが、アップグレード後も、既存のOracle GoldenGate環境から同じExtractを使用して、新しいOracle GoldenGate環境での変更レコードの取得を続行できます。ただし、新しいOracle GoldenGateインストール・ディレクトリがアップグレードに使用されている場合、これは不可能です。これを行うには、既存のOracle GoldenGateインストール・ディレクトリを使用する必要があります。

古いOracle GoldenGateバージョンをアップグレードするか、Oracle GoldenGate Classic ArchitectureからMicroservices Architectureに移行するには、次のステップを使用します。

ノート:次のステップでは、Extract名extnを例として使用します。

古い環境でOracle GoldenGate CDC Extractによって使用されていたレプリケーション・スロット名を取得します。古いレプリケーション・スロット名は、Extractレポート・ファイルから、またはINFO EXTRACTコマンドを実行して取得できます。

古いOracle GoldenGate環境のExtractレポート・ファイルから。Extractレポート・ファイルのスニペットの例を次に示します。
```
2024-01-09 11:49:38  INFO    OGG-25376  Oracle GoldenGate capture 'EXTN' running with replication slot 'ext1_5d87a7db5e810943', slot type 'logical', plugin name
as 'test_decoding' attached with database 'postgres' with slot restart LSN as '6/3CBFE2B8', flush LSN as '6/3CBFE2F0' and its current TXID as '7899713'.
```
Extractレポート・ファイルのレプリケーション・スロット名を書き留めます。この例では、extn_5d87a7db5e810943です。

次の例に示すように、古いOracle GoldenGate環境でGGSCIまたは管理クライアントからINFO EXTRACTコマンドを実行することもできます。
```
GGSCI (phoenix96567 as postgres@pg12) 10> info extract extn
```
出力:
```
Extract    EXT1      Last Started 2024-01-09 11:49   Status RUNNING
Checkpoint Lag       00:00:45 (updated 00:00:01 ago)
Process ID           3640439
VAM Read Checkpoint  2024-01-09 11:48:52.575833
Replication Slot     extn_5d87a7db5e810943 is active with PID 3640450 in database postgres
Slot Restart LSN     6/3CBFE2B8
Slot Flush LSN       6/3CBFE2F0
Current Log Position 6/3CBFE2F0
```
新しいOracle GoldenGate環境でOracle GoldenGate CDC Extractに関連するレプリケーション・スロット名を取得します。UNREGISTER EXTRACTコマンドを実行して、新しいレプリケーション・スロット名を取得します。
```
unregister extract extn
```
出力:
```
2024-01-09 11:43:37  INFO    OGG-25354  The replication slot 'extn_6ec0db7cc27c812' for group 'EXTN' does not exist in database 'postgres'.
```
エラー・メッセージからレプリケーション・スロット名を書き留めます。この例では、extn_6ec0db7cc27c812です。

対応するソースPostgreSQLデータベースで次のSQL問合せを実行します(PSQLを使用できます)。

SELECT * FROM pg_copy_logical_replication_slot('*old-replication-slot*', '*new-replication-slot*');

たとえば:

SELECT * FROM pg_copy_logical_replication_slot('extn_5d87a7db5e810943', 'extn_6ec0db7cc27c812');

Extractチェックポイント・ファイル、証跡ファイルおよびその他の構成ファイルを、古いOracle GoldenGate環境から新しい環境に必ずコピーしてください。
new-replication-slotのLSNポストがold-replication-slotと同じであることを確認します。
UNREGISTER EXTRACT extract_nameコマンドは、古いOracle GoldenGate環境で実行します。たとえば:
```
UNREGISTER EXTRACT extn
```
新しいOracle GoldenGate環境でExtractを起動して、変更レコードのキャプチャを再開します。