データベース接続の準備

Oracle GoldenGate for Yugabyte (PostgreSQLバリアント)は、事前にパッケージ化されたODBCドライバを使用してYugabyteデータベースに接続します。接続はデータ・ソース名(DSN)を使用するか、直接接続を使用してデータベース・サーバーのホスト、ポート、データベースおよびその他の情報を提供することによって確立できます。

DSN接続を使用するには、接続詳細をodbc.iniファイルにリストする必要がありますが、Webインタフェースまたは管理クライアントからデータベース接続を追加する場合は、直接エントリを使用して手動で入力します。

ノート: PgBouncerは、Oracle GoldenGate接続ではサポートされません。

ノート: Oracle GoldenGateでは、Pgpoolを使用するYugabyteへの接続はサポートされていません。

次に示すステップを実行してDSNエントリを作成した後、または直接接続を使用する予定がある場合は、「データベース接続の追加」トピックに進み、データベース接続の作成方法を確認します。

DSNベースの接続の設定

Oracle GoldenGateプロセス用にDSN接続を作成するには、最初にOracle GoldenGate forPostgreSQLデプロイメント用の環境変数を追加してから、接続属性を格納するodbc.iniファイルを作成する必要があります。

1. サービス・マネージャのWebインタフェースにログインします。

2. 「デプロイメント」の左側のナビゲーション・ペインで、「デプロイメント」をクリックし、デプロイメント名を選択します。これにより、デプロイメントの様々な設定が展開されます。

3. 「構成」をクリックし、「環境変数」の横にあるプラス記号(+)を選択します。

4. 使用可能な2つのフィールドに次の情報を入力します。「環境変数値」フィールドでは、odbc.iniファイルの絶対パスであることを確認します。

   環境変数名 = ODBCINI

   環境変数値 = /ogg/deployment/yugabyte/odbc.ini

5. 「発行」をクリックして新しい変数を作成し、変更を有効にします「デプロイメント」ペインからデプロイメントを再起動します。

6. Oracle GoldenGateインストールのdeploymentフォルダで、odbc.iniファイルを手動で作成し、このファイルにデータ・ソースを追加します。

DSNファイルを作成するときは、次の最小設定を使用します。

• Data Source Name - ExtractやReplicatなどのOracle GoldenGateプロセスによって参照される、ソースまたはターゲット・データベース接続のユーザー定義名。DSN名では、32文字までの英数字を使用できます。特殊文字としてはアンダースコア(_)とダッシュ(-)のみを使用できます。

• IANAAppCodePage=4 - これがデフォルト設定ですが、データベース文字セットがUnicodeでない場合は、https://docs.progress.com/bundle/datadirect-connect-odbc-71/page/IANAAppCodePage_9.html#IANAAppCodePage_9のページで示されているガイダンスに従って変更できます。

• InstallDir – Oracle GoldenGate PostgreSQLワイヤ・プロトコル・ドライバ・パスの名前。InstallDir =./datadirectのように相対パスを使用できます。

• Driver: Oracle GoldenGate PostgreSQLワイヤ・プロトコル・ドライバ・ファイルの名前で、Driver=./datadirect/lib/ggpsql25.soのように相対パスを使用できます。

• Database: ソース・データベースまたはターゲット・データベースの名前です。

• Hostname: データベース・ホストのIPアドレスまたはホスト名。

• PortNumber: データベースのリスニング・ポートです。

• Oracle GoldenGate for Yugabyteは、Yugabyte接続用の複数のホストおよびポートをサポートします。この機能は、Oracle GoldenGate高可用性(HA)設定で役立ちます。Yugabyte HAセットアップには、1つのプライマリ・サーバーと複数のスタンバイ・サーバーがあります。接続文字列形式を設定して、複数のホストを指定できます。

  接続文字列	摘要
  db-user@host1,host2,host3/db-name	接続は、すべてのホスト(host1、host2、host3)に対してデフォルトのYugabyteデータベース・ポート5433を使用して試行されます。
  db-user@host1:1234,host2:2345,host3:3456/db-name	接続は、接続文字列で指定された各ホストに関連付けられたポートを使用して試行されます。
  db-user@host1,host2,host3:1234/db-name	すべてのホストで同じポート番号(1234)を使用しているすべてのホスト(host1、host2、host3)。接続は、すべてのホスト(host1、host2、host3)のポート1234を使用して試行されます。
  db-user@host1,host2,host3:1234/db-name	すべてのホストで同じポート番号(1234)を使用しているすべてのホスト(host1、host2、host3)。接続は、すべてのホストに対してポート1234を使用して試行されます。
  db-user@host1:3456,host2,host3:1234/db-name	接続文字列が、ポート番号が一部のホストに対して指定されている他の形式で指定され、他のホストがポートなしで指定されている場合、接続文字列でポート番号が指定されていないすべてのホストのポート番号として、最後または右端のポート指定が使用されます。接続文字列に示すように、次のようになります。 db-user@host1:3456,host2,host3:1234/db-name host2のポート番号は1234で、これは接続文字列で指定されている右端のポート番号です。

• ExtractまたはReplicatユーザーのLogonIDとPasswordを指定することもできますが、これらはクリア・テキストで格納されます。これらのフィールドは、DSNに含めずに、かわりにOracle GoldenGateウォレットに資格証明別名として格納し、ExtractおよびReplicatでUSERIDALIASパラメータを使用してそれらを参照することをお薦めします。

次に、2つのDSNエントリを含むodbc.iniファイルの例を示します。次の例で使用されているデータ・ソース名は、PG_srcとPG_tgtです。

#[ODBC Data Sources] [ODBC] IANAAppCodePage=4 InstallDir=/datadirect

[PG_src] Driver= ./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=sourcedb HostName=remotehost PortNumber=5432

| — |

[PG_tgt] Driver=./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=targetdb HostName=remotehost PortNumber=5432

1. odbc.iniファイルを保存して閉じます。

2. Oracle GoldenGateからYugabyteデプロイメントへのデータベース接続を設定するには、「データベース接続の追加」を参照してください。