Autonomous AI Transaction ProcessingからAmazon S3へのデータのレプリケート

OCI GoldenGateを使用して、Autonomous AI Transaction Processing (ATP)からAmazon S3 (Amazon Simple Storage Service)にデータをレプリケートする方法について学習します。

開始する前に

このクイックスタートを正常に完了するには、次が必要です:

ソースのAutonomous AI Transaction Processing (ATP)インスタンス
Amazon S3サービス
Amazon S3のアクセス・キーおよびシークレット

環境設定: Autonomous AI Transaction Processing

レプリケーション用のソース・データベースがまだ設定されていない場合は、次のステップに従って、このクイックスタートに使用するサンプル・スキーマをロードできます。このクイックスタートでは、ソース・データベースにAutonomous AI Transaction Processingを使用します。

ソースAutonomous AI Transaction Processingを設定するには:

サンプル・データベース・スキーマをダウンロードして解凍します。
Oracle Cloudコンソールで、「Autonomous AI Databases」ページからAutonomous AI Transaction Processing (ATP)インスタンスを選択して、その詳細を表示し、データベース・アクションにアクセスします。
GGADMINユーザーをロック解除します。
1. 「データベース・アクション」を選択し、「データベース・ユーザー」を選択します。
2. GGADMINを見つけて、その省略記号メニュー(3つのドット)を選択し、「編集」を選択します。
3. 「ユーザーの編集」パネルで、GGADMINパスワードを入力し、パスワードを確認して、「アカウントがロックされています」の選択を解除します。
4. 「変更の適用」を選択します。
ソース・サンプル・スキーマおよびデータをロード:
1. 「データベース・アクション」メニューの「開発」で、「SQL」を選択します。
2. OCIGGLL_OCIGGS_SETUP_USERS_ATP.sqlからスクリプトをコピーしてSQLワークシートに貼り付けます。
3. 「スクリプトの実行」を選択します。「スクリプト出力」タブに確認メッセージが表示されます。
4. SQLワークシートをクリアして、OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql.からSQLスクリプトをコピーして貼り付けます。
  
  ヒント: SQLツールがスクリプトを正常に実行するために、各文を個別に実行する必要がある場合があります。
5. 表が正常に作成されたことを確認するには、SQLウィンドウを閉じて再度開きます。「ナビゲータ」タブで、SRC_OCIGGLLスキーマを検索し、それぞれのドロップダウンから表を選択します。
サプリメンタル・ロギングを有効にします:
1. SQLワークシートをクリアします。
2. 次の文を入力し、「文の実行」を選択します。
```
ALTER PLUGGABLE DATABASE ADD SUPPLEMENTAL LOG DATA;
```

タスク1: OCI GoldenGateリソースの作成

このクイックスタートの例では、ソースとターゲットの両方のデプロイメントおよび接続が必要です。

ソースAutonomous AI Transaction ProcessingインスタンスのOracleデプロイメントを作成します。
ターゲットAmazon S3のビッグ・データ・デプロイメントを作成します。
ソースAutonomous AI Transaction Processingインスタンスの接続を作成します。
ターゲットAmazon S3への接続を作成します。
ビッグ・データ・デプロイメントのプライベート・エンドポイントを指すGoldenGateへの接続を作成してから、この接続をソースOracleデプロイメントに割り当てます。
ソースOracleデプロイメントにAutonomous AI Transaction Processing接続を割り当てる。
Amazon S3接続をターゲット・ビッグ・データ・デプロイメントに割り当てます。

タスク2: Extractの追加

「デプロイメント」ページで、ソースAutonomous AI Transaction Processingデプロイメントを選択します。
デプロイメントの詳細ページで、「コンソールの起動」を選択します。
ソース・デプロイメントの管理者のユーザー名とパスワードでログインします。
Extractを追加します

タスク3: 分散パスの追加および実行

GoldenGate資格証明ストアを使用する場合は、ターゲット・ビッグ・データ・デプロイメントで分散パスのユーザーを作成し、それ以外の場合はステップ3にスキップします。
ソースGoldenGateデプロイメント・コンソールで、ステップ1で作成したユーザーのパス接続を追加します。
1. ソースGoldenGateデプロイメント・コンソールで、左側のナビゲーションで「パス接続」を選択します。
2. 「パス接続の追加」(プラス・アイコン)を選択し、次を完了します:
  1. 「資格証明別名」に、GGSNetworkと入力します。
  2. 「ユーザーID」に、ステップ1で作成したユーザー名を入力します。
  3. 確認のためにユーザーのパスワードを2回入力します。
3. 「送信」を選択します。
  
  「パス接続」リストにパス接続が表示されます。
ソース・デプロイメント・コンソールで、次の値を含む分散パスを追加します:
1. 「ソース・オプション」ページで、次の手順を実行します。
  - 「ソースExtract」で、タスク2で作成したExtractを選択します。
  - 「トレイル名」に、2文字の名前(E1など)を入力します。
2. 「ターゲット・オプション」ページで、次の手順を実行します。
  - 「ターゲット・ホスト」に、ターゲット・デプロイメントのホスト・ドメインを入力します。
  - 「ポート番号」に、443と入力します。
  - 「トレイル名」に、2文字の名前(E1など)を入力します。
  - 「別名」に、ステップ2で作成した資格証明別名を入力します。
ターゲット・ビッグ・データ・デプロイメント・コンソールで、分散パスの結果として作成された受信パスの確認を行います。
1. ターゲットのビッグ・データ・デプロイメント・コンソールで、「受信サービス」を選択します。
2. パスの詳細を確認します。このパスは、前のステップで作成した分散パスの結果として作成されました。

タスク4: Replicatの追加

Amazon S3のReplicatを追加するには:

ターゲットのビッグ・データ・デプロイメント・コンソールのナビゲーション・メニューで、「Replicat」、「Replicatの追加」(プラス・アイコン)の順に選択します。
次の値を使用してReplicatを追加します:
1. 「Replicat情報」ページの「Replicatタイプ」で、「クラシックReplicat」を選択し、プロセス名を入力して「次へ」を選択します。
2. 「レプリケーション・オプション」ページで、次の手順を実行します。
  - 「名前」に、タスク2からトレイルの名前を入力します。
  - 「ドメイン」で、ドメインを選択します。
  - 「別名」で、タスク1で作成したAmazon S3接続を選択します。
  - 「チェックポイント表」で、ターゲット・デプロイメント用に作成したチェック・ポイント表を選択します。
3. 「管理対象オプション」ページで、フィールドをそのままにして、「次へ」を選択します。
4. 「Replicatパラメータ」ページで、MAP *.*, TARGET *.*;を次のように置き換えます:
```
MAP SRC_OCIGGLL.*, TARGET *.*;
```
5. 「プロパティ・ファイル」ページで、必要に応じてS3イベント・ハンドラのプロパティを構成します。変更を検討する必要があるプロパティには次が含まれます:
  - gg.eventhandler.s3.region: ターゲットS3バケットのAWSリージョンを指定します
  - gg.eventhandler.s3.bucketMappingTemplate: ターゲットS3バケット名を指定します。バケットが存在しない場合は、OCI GoldenGateによって自動作成できます。静的バケット名を指定することも、「テンプレート・キーワード」を使用してバケット名を動的に割り当てることもできます。
  - (オプション) gg.eventhandler.s3.format: 出力のフォーマット方法を選択します。デフォルト設定はJSONです。使用可能なオプションには次が含まれます:
    - delimitedtext
    - json
    - json_row
    - xml
    - avro_row_ocf
    - avro_op_ocf
「作成および実行」を選択します。

「概要」ページに戻り、Replicatの詳細を確認できます。

タスク5: レプリケーションの確認

Oracle Cloudコンソールで、ナビゲーション・メニューを開き、「Oracle AI Database」を選択し、「Autonomous AI Transaction Processing」を選択します。
Autonomous AI Transaction Processingインスタンスのリストで、ソース・インスタンスを選択してその詳細を表示します。
データベースの詳細ページで、「データベース・アクション」を選択します。

ノート:通常は自動的にログインします。そうでない場合は、データベース資格証明を使用してログインします。
データベース・アクション・ホームページで、「SQL」を選択します。
ワークシートに次を入力し、「スクリプトの実行」を選択します。

ソースGoldenGateのOCI GoldenGateデプロイメント・コンソールで、Extract名を選択し、「統計」を選択します。SRC_OCIGGLL.SRC_CUSTOMERに7つの挿入があることを確認します。

Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1001,0,'Brendt','Paul','10 Jasper Blvd.',107,'(212) 555 2146',19,10);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1002,0,'McCarthy','Robin','27 Pasadena Drive',11,'(214) 555 3075',29,11);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1003,0,'Travis','Peter','7835 Hartford Drive',12,'(510) 555 4448',34,12);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1004,0,'Larson','Joe','87 Carmel Blvd.',13,'(213) 555 5095',45,13);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1005,0,'Goldschmidt','Tony','91 Torre drive',14,'(619) 555 6529',55,20);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1006,0,'Baker','William','2890 Grant Avenue',15,'(312) 555 7040',64,21);
Insert into SRC_OCIGGLL.SRC_CUSTOMER (CUSTID,DEAR,LAST_NAME,FIRST_NAME,ADDRESS,CITY_ID,PHONE,AGE,SALES_PERS_ID) values (1007,0,'Swenson','Jack','64 Imagination Drive',19,'(202) 555 8125',74,22)

ターゲット・ビッグ・データOCI GoldenGateデプロイメント・コンソールで、Replicat名を選択し、「統計」を選択します。SRC_OCIGGLL.SRC_CUSTOMERに7つの挿入があることを確認します。