Oracle Autonomous AI DatabaseのExtractの構成

次に、Autonomous AI DatabaseからキャプチャするExtractを構成するステップについて説明します:

  1. Autonomous AI Databaseインスタンス用のOracle GoldenGateをインストールします。

  2. Oracle GoldenGate環境のデプロイメントを作成します。これは、Autonomous AI DatabaseインスタンスからデータをキャプチャするExtractの作成先デプロイメントです。「デプロイメントの追加」を参照してください。

  3. Autonomous AI Databaseクライアント資格証明を取得します。

    Autonomous AI Databaseインスタンスへの接続を確立するには、クライアント資格証明ファイルをダウンロードします。クライアント資格証明をダウンロードするには、Oracle Cloud Infrastructure ConsoleまたはDatabase Actions Launchpadを使用できます。クライアント資格証明のダウンロード(ウォレット)に関する項を参照してください。

ノート: Autonomous AI Databaseへの管理者アクセス権がない場合は、資格証明ファイルをダウンロードして提供するようにサービス管理者に依頼してください。

次のステップでは、データベース・アクション起動パッドを使用してクライアント資格証明をダウンロードします。

  1. Autonomous AI Databaseアカウントにログインします。

    a. 「データベース・インスタンス」ページで、「データベース・アクション」をクリックします。これにより、Database Actions Launchpadが起動します。起動パッドは、ADMINとしてデータベースにログインしようとします。これが成功しない場合は、データベースのADMINのユーザー名とパスワードの入力を求められます。

    b. データベース・アクションLaunchpadの「管理」で、「クライアント資格証明(ウォレット)のダウンロード」をクリックします。

    c. クライアント資格証明Zipファイルを保護するためのパスワードを入力して、「ダウンロード」をクリックします。

    ノート:ウォレットのダウンロード時に指定するパスワードにより、ダウンロードしたクライアント資格証明ウォレットを保護されます。

    d. 資格証明zipファイルをローカル・システムに保存します。

    The credentials `zip` file contains the following files:

- `cwallet.sso`

- `ewallet.p12`

- `keystore.jks`

- `ojdbc.properties`

- `sqlnet.ora`

- `tnsnames.ora`

- `truststore.jks`

- `ewallet.pem`

- `README.txt`

    Autonomous AI Databaseインスタンスと連携するようにOracle GoldenGateを構成する際には、sqlnet.oraおよびtnsnames.oraファイルを参照および更新します(必要な場合)。

  2. Autonomous AI Databaseインスタンスに接続するように、Oracle GoldenGateが稼働しているサーバーを構成します。

    a. Oracle GoldenGateがインストールされているサーバーにログインします。

    b. Autonomous AI Databaseインスタンスからダウンロードした資格証明zipファイルをOracle GoldenGateサーバーに転送します。

    c. Oracle GoldenGateサーバーで、資格証明ファイルを新しいディレクトリ(たとえば、/u02/data/adwc_credentials)に解凍します。これがキー・ディレクトリになります。

    d. 接続の詳細を構成するには、Oracle GoldenGateインスタンスのOracleクライアントの場所からtnsnames.oraファイルを開きます。

    e. LOWコンシューマ・グループdbname_low (たとえばgraphdb1_low)を持つ接続文字列を使用し、それをローカルのtnsnames.oraファイルに移動します。

     The connections for the default `ggadmin` user happens only with `low`, although `high` is used in the connection string, for example `graphdb1_high`.

 See *Local Naming Parameters in the tnsnames.ora File* chapter in the *Oracle AI Database Net Services Reference* guide.

    注意:

    資格証明ファイルで提供されるファイルには、次のように識別できる3つのデータベース・サービス名が含まれています。

    *ADWC_Database_Name*_low

*ADWC_Database_Name*_medium

*ADWC_Database_Name*_high

    Oracleでは、Oracle GoldenGateでADWC_Database_Name_lowを使用することをお薦めします。Oracle Autonomous AI Database Serverlessの使用ガイドのAutonomous AIデータベースの事前定義済データベース・サービス名または専用Exadataインフラストラクチャ上のAutonomous AI Databaseドキュメントの事前定義済データベース・サービスを参照してください。

    f. Oracle GoldenGateインスタンスのtnsnames.oraファイルを編集して、tnsnames.oraファイルで使用可能な接続詳細がキー・ディレクトリ(Autonomous AI Databaseからダウンロードした資格証明zipファイルを解凍するディレクトリ)に含まれるようにします。

    <div class="infoboxnote" markdown="1">

**Note:**
Allows connections on ports 1521 and 1522. However, the Oracle GoldenGate connection only works with the port 1522. This is mandatory. If you use 1521, you get the following error:

   <pre class="copy"><code>Login failed. OCI Error ORA (status = 24459-ORA-24459: OCISessionGet() timed out waiting for pool to create new connections\n)&quot;, &quot;code&quot;: &quot;OGG-08110&quot;</code></pre>

    </div>

     <pre class="copy"><code> Sample Connection String   adw1_low. = (description=                  (retry_count=20)(retry_delay=3)                  (address=(protocol=tcps)(port=1522)(host=adb-preprod.us-phoenix-1.oraclecloud.com))                  (connect_data=(service_name=okd2ybgcz4mjx94_graphdb1_low.adb.oraclecloud.com))                  (security=(ssl_server_cert_dn=&quot;CN=adwc-preprod.uscom-east-1.oraclecloud.com,OU=Oracle BMCS US,O=Oracle Corporation,L=Redwood City,ST=California,C=US&quot;))                )</code></pre>

 If the database is within a firewall protected environment, you might not have direct access to the database. With an existing HTTP Proxy, you can pass the firewall with the following modifications to the `sqlnet.ora` and `tnsnames.ora`:

 - `sqlnet parameters`

 - `address modification of tns_alias`

 If Extract becomes unresponsive due to a network timeout or connection loss, then you can add the following into the connection profile in the `tnsnames.ora` file:

    (DESCRIPTION) = (RECV_TIMEOUT=30) (ADDRESS_LIST =

      (LOAD_BALANCE=off)(FAILOVER=on)(CONNECT_TIMEOUT=3)(RETRY_COUNT=3) (ADDRESS = (PROTOCOL = TCP)(HOST = adb-preprod.us-phoenix-1.oraclecloud.com)(PORT = 1522))

    g ウォレットを構成するには、Oracle GoldenGateインスタンスのOracleクライアントの場所にsqlnet.oraファイルを作成します。

    cd /u02/data/oci/network/admin
ls
sqlnet.ora tnsnames.ora
     See [Autonomous AI Database Client Credentials](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=OGGMP-GUID-565DF23A-2E9D-4B57-B181-DC1165B31C97) in *Using Oracle GoldenGate on Oracle Cloud Marketplace*.

    こんにちは。このsqlnet.oraファイルを編集して、キー・ディレクトリが含まれるようにします。

     <pre class="copy"><code>WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=&quot;/u02/data/adwc_credentials&quot;))) SSL_SERVER_DN_MATCH=yes</code></pre>

  3. Microservicesを使用しているかどうかに応じて、管理クライアントを使用してOracle GoldenGateデプロイメントにログインします。

  4. GGADMINユーザーとパスワードを格納するための資格証明を作成します。このユーザーは、コマンドラインからAutonomous AI Databaseに接続して、データベース接続が必要になるコマンドを実行するために使用します。また、Extractデータベース接続のためのUSERIDALIASパラメータでも使用されます。

     ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_low PASSWORD complex_password alias adb_alias

    接続文字列でhighを指定して次のコマンドを使用することもできますが、引き続きlowで接続されます。

     ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_high PASSWORD complex_password alias adb_alias

  5. DBLOGINを使用してデータベースに接続します。DBLOGINユーザーは、adb_aliasアカウント・ユーザーであることが必要です。

     DBLOGIN USERIDALIAS adb_alias

  6. ADD TRANDATAまたはADD SCHEMATRANDATAを使用して、キャプチャする表のサプリメンタル・ロギングを構成します。データベース・インスタンスに直接接続しているため、これらのコマンドにデータベース名を含める必要はありません。以下はexmapleです。

     ADD TRANDATA HR.EMP

    または

     ADD SCHEMATRANDATA HR

Oracle GoldenGate Extract用のOracle Autonomous AI Databaseでの最小サプリメンタル・ロギングの有効化を参照してください。

  1. ハートビートテーブルを追加します。

     ADD HEARTBEATTABLE

  2. Extractを追加してAutonomous AI Databaseインスタンスからキャプチャするように構成します。Extractの作成ステップは、「Extractの追加」を参照してください。

Oracle GoldenGate Extractは、Autonomous AI Databaseインスタンスと連携して、特定のデータベース・インスタンスからのみ取得するように設計されています。つまり、データベース・インスタンス名は、TABLE文またはMAP文に必要ではありません。

次の例では、exteというExtract (Autonomous AI Databaseからのキャプチャに必要)を作成し、これをすぐに開始するように指示しています。

<pre class="copy"><code>ADD EXTRACT exte, INTEGRATED TRANLOG, BEGIN NOW</code></pre>

特定のテーブルをキャプチャするには、2つのパーツ・オブジェクト名を使用します。たとえば、Autonomous AI Databaseインスタンスの表HR.EMPからキャプチャするには、Extractパラメータ・ファイルでこのエントリを使用します。

<pre class="copy"><code> TABLE HR.EMP;</code></pre>

HR.EMPをCOUNTRY.EMPLOYEEにレプリケートする場合、map文は次のようになります。

<pre class="copy"><code> MAP HR.EMP, TARGET COUNTRY.EMPLOYEE;</code></pre>

  1. Autonomous AI DatabaseインスタンスにExtractを登録します。たとえば、exteというExtractを登録するには、次のコマンドを使用します。

     REGISTER EXTRACT exte DATABASE

  2. これで、Extractを起動して、Autonomous AI Databaseインスタンスへのデータ・レプリケーションを実行できます。次に例を示します:

     START EXTRACT exte

    これで、Autonomous AI DatabaseのためのExtractの構成プロセスが完了し、他のExtractプロセスと同様に使用できます。