データベースの接続の追加

ExtractおよびReplicatプロセスには、作業データベース接続が必要です。次のステップに従って、レプリケーション用のソース・ホストとターゲット・ホストを接続するデータベース接続を作成します。

管理サービス・インタフェースにログインします
左側のナビゲーション・ペインで「DB接続」をクリックします。
「DB接続」の横にあるプラス記号(+)をクリックします。「資格証明」ダイアログ・ボックスが表示されます。
表示されたフィールドに次の詳細を入力します。

ノート:次に示すフィールドはすべて、すべてのデータベースに適用できるとはかぎりません。各フィールドの詳細を確認して、データベースに適用可能かどうかを確認してください。
- 資格証明ドメイン
  
  データベース資格証明を関連付けるドメイン名を指定します。たとえば、ドメイン名を指定しない場合は、OracleGoldenGateがデフォルトのドメイン名となります。
- 資格証明別名
  
  これはデータベース資格証明の別名です(ggeastなど)。
- 接続タイプ
  
  データベースへの接続に使用する接続のタイプ。オプションには、Password、Plugin、Kerberos、および OAuthがあります。
  - 「パスワード」に、データベース資格証明としてユーザー名とパスワードを指定します。
  - 「プラグイン」には、ユーザー名とクライアント・シークレットまたはプラグイン・シークレットを指定します。詳細は、「サード・パーティVaultからデータベース・パスワードを格納してアクセスするためのデータベース・パスワード・プラグインの構成」を参照してください
  - Kerberosには、kerberosユーザー名を指定します。詳細は、Authenticate with Kerberos Credentialsを参照してください。
  - OAuthには、ユーザー名とクライアント・シークレットを指定します。このオプションは、Microsoft EntraIDのDBLOGINを構成する場合に使用します。詳細は、Microsoft EntraIDによるデータベース接続認証を参照してください。
  Oracle AI Database以外の場合は、次の値も指定する必要があります。
  - データ・ソース名: データベース接続のDSNエントリ。
  - データベース・サーバーおよびポート: このオプションを選択すると「データベース・ホスト名またはIPアドレス」および「ポート番号」フィールドが表示されます。それぞれ、データベースのホスト名またはIPアドレスとポート番号を指定します。
  - データ・ソース名: データベース接続のDSNエントリ。
  - データベース・サーバー/データベース・ホスト名またはIPアドレス: データベースが実行されているサーバーの名前またはIPアドレス。
  - ポート/ポート番号: データベース・サーバーに接続するためのポート番号。
  - データベース名: 接続先のデータベースの名前。
  - ユーザーID: データベース・ユーザーのユーザーIDまたはユーザー名。
  ノート:データベース内のユーザー名にダッシュ(OGG-ADMINなど)が含まれている場合、次のエラーが発生します。
```
OGG-08221 Cannot register or unregister EXTRACT *extract_name* because of the following SQL
error: OCI Error ORA (status = 44004-ORA-44004: invalid qualified SQL name.
```
  - 「パスワード」および「パスワードの確認」: データベース・ユーザーがデータベースにログインするために使用するパスワード。
  - セキュリティ・プロトコル: データベースへの接続に使用されるセキュリティ・プロトコル。次の3つのセキュリティ・プロトコルのいずれかを使用できます。
    - プレーンテキスト: 「接続タイプ」が「データベース・サーバーおよびポート」の場合、これがデフォルトのセキュリティ・プロトコルになります。
    - TLS: SQL Serverに対してこのオプションを選択すると、デフォルトで「信頼サーバー証明書」オプションが選択されます。「サーバー証明書を信頼」オプションの選択を解除する場合は、「SSLパス」および「SSL証明書」オプションの値を指定する必要があります。
    - mTLS: 「TLS」オプションを選択すると、次の2つのサブオプションは表示されます。
  - SSLモード: 使用可能なオプションは次のとおりです。
    - MySQLの場合、PREFERRED、REQUIRED、VERIFY_CAおよびVERIFY_IDENTITY。
    - PostgreSQLの場合は、PREFER、REQUIRE、VERIFY-CA、VERIFY FULL。

該当するSSLモードを選択します。

a. MySQLにPREFERREDまたはREQUIRED、PostgreSQLにPREFERまたはREQUIREを選択する場合、「追加属性」テキスト・ボックスに適用可能な追加の属性を指定します。

b. MySQLにVERIFY_CAまたはVERIFY_IDENTITYのSSLモード、またはPostgreSQLにVERIFY_CAまたはVERIFY_IDENTITYのSSLモードを選択すると、次のフィールドに表示されます。

SSLパス: 信頼できるSSL認証局(CA)証明書ファイルが格納されるディレクトリのパス名。
SSL CA: PEM形式のCA証明書ファイルのパス。
SSL CRL: PEM形式の証明書失効リストが格納されているファイルのパス。

c. 「mTLS」モードを選択すると、次のサブオプションが表示されます。

- **SSL Mode**: The available options are:

   - **PREFERRED**, **REQUIRED**, **VERIFY_CA**, and **VERIFY_IDENTITY** for MySQL.

   - **PREFER**, **REQUIRE**, **VERIFY-CA**, **VERIFY FULL** for PostgreSQL.

d. PostgreSQLにPREFERREDまたはREQUIRED、またはMySQLにPREFERまたはREQUIREを選択すると、次のフィールドが表示されます。

- **SSL Path**: The path of the directory that contains trusted SSL Certificate Authority (CA) certificate files in PEM format.
      
 **Note:** For PostgreSQL, if the `sslpath` is specified then certificate names should not have full path however, if `sslpath` is not specified then the certificates must have complete path.
 {: .infoboxbote} 

- **SSL Certificate**: The path of the SSL public key certificate file in PEM format. On the client side, this is the client public key certificate and on the server side, this is the server public key certificate.

- **SSL Key**: The path of the SSL private key file in PEM format. On the client side, this is the client private key, and on the server side, this is the server private key.

e. PostgreSQLにVERIFY_CAまたはVERIFY_IDENTITYのSSLモード、またはMySQLにVERIFY_CAまたはVERIFY_IDENTITYのSSLモードを選択すると、前述のフィールドに加えて、次のフィールドが表示されます。

- **SSL CA**: The path of the CA certificate file in PEM format.

- **SSL CRL**: The path of the file containing certificate revocation lists in PEM format.

- **Additional Attributes**: Specify any additional information in this field.

「発行」をクリックします。
「データベースの接続」アイコンをクリックして、接続が正しく機能していることを確認します。接続に成功すると、データベースに接続アイコンが青に変わります。接続が成功すると、チェックポイントおよびハートビート表を設定するためのセクションも表示されます。
「DB接続」ページで、「アクション」列から次のタスクを実行することもできます。
- データベースに接続
- DB接続のコピー
- DB接続の変更
- DB接続の削除

データベースに正常に接続した後、ExtractとReplicatに必要なTRANDATA、SCHEMATRANDATA、チェックポイントおよびハートビート表を追加できます。