データベース接続の準備

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 for Yugabyteデプロイメント用の環境変数を追加してから、接続属性を格納するodbc.iniファイルを作成する必要があります。

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

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

  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: データベースのリスニング・ポート。

  • Yugabyte用のOracle GoldenGateでは、Yugabyte接続で複数のホストおよびポートがサポートされます。この機能は、Oracle GoldenGate High Availability (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
    		 すべてのホスト(host1、host2、host3)で同じポート番号(1234)を使用します。接続は、すべてのホスト(host1、host2、host3)にポート1234を使用して試みられます。 
    db-user@host1,host2,host3:1234/db-name
    		 すべてのホスト(host1、host2、host3)で同じポート番号(1234)を使用します。接続は、すべてのホストにポート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です。

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

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