1. Oracle GoldenGateリファレンス
  2. Oracle GoldenGateの共通コンポーネント
  3. Oracle GoldenGateパラメータ
  4. USERIDALIAS

USERIDALIAS

適用対象

Extract、Replicat、DEFGEN、GGSCI、Admin Client。

サポート

リリースでサポートされているすべてのデータベース。

説明

USERIDALIASパラメータでは、データベースへのログイン時に使用するOracle GoldenGateプロセスの認証を指定します。USERIDALIASを使用するには、Oracle GoldenGate資格証明ストアを使用する必要があります。パラメータ・ファイルで、TABLEまたはMAPエントリの前にUSERIDALIASを指定します。USERIDALIASユーザーに必要な権限は、データベースによって異なります。

aliasの値には、次の規則が適用されます:

  • 長さは最大30文字です

  • 英文字で開始する必要があります

  • 英文字、数字、および次の特殊文字の任意の組合せを含めることができます:

    • $ (ドル)記号

    • _ (アンダースコア)

    • # (ハッシュ)記号

USERIDと比較したUSERIDALIAS

USERIDALIASでは、ユーザーIDおよびパスワードではなく、エイリアスをパラメータ・ファイルで指定できます。ユーザーIDと暗号化されたパスワードが資格証明ストアに格納されます。USERIDALIASは、Linux、UNIXおよびWindowsプラットフォームで稼働するデータベースをサポートします。

USERIDでは、パラメータ・ファイルにクリアテキスト・パスワードを指定するか、ENCRYPT PASSWORDコマンドで暗号化し、オプションで暗号化キーをENCKEYSファイルに格納する必要があります。USERIDでは、Oracle GoldenGateでサポートされる幅広いデータベースがサポートされます。また、Oracleデータベースのオペレーティング・システム・ログインの使用をサポートします。

データベース・タイプ別のUSERIDALIASの要件

USERIDALIASの使用方法は、データベース・タイプに応じて異なります。

ノート:

データベース・ユーザーとパスワードが必要になるログインは、Oracle GoldenGate資格証明ストアに格納されている必要があります。

MySQL MAを使用したOracle GoldenGateのUSERIDALIASでサポートされている指定済USERIDは、次のとおりです。

  • user/db

  • user@host/db

  • user@host:port/db

Oracle GoldenGateユーザーが前述のパターンに従わないUSERIDALIASを変更または追加することを許可されている場合、MA Webインタフェース・クライアントやAdmin Clientなどのクライアントでのパターン一致でエラーが表示されます。

DB2 for LUW

USERIDALIASとSOURCEDBまたはTARGETDBは、データベース認証を使用してDB2 LUWデータベースに接続するすべてのOracle GoldenGateプロセスで使用します。データベースがオペレーティングシステム・レベルでの認証を許可するように構成されている場合は、USERIDALIASを省略し、SOURCEDBまたはTARGETDBのみを使用できます。詳細は、「SOURCEDB」および「TARGETDB」を参照してください。

MySQL

MySQLデータベースに接続するすべてのOracle GoldenGateプロセスにUSERIDALIASを使用します。

Oracle

USERIDALIASは、Oracle Databaseに接続するOracle GoldenGateプロセスに使用します。

  • SOURCEDBまたはTARGETDBパラメータは不要です。

  • Oracle GoldenGate資格証明ストアに格納されているデータベース資格証明の別名を指定します。

  • LOGRETENTIONを使用するようにExtractが構成されている場合は、USERIDALIASユーザーに特別なデータベース権限が必要になります。これらの権限は、Oracle GoldenGateのインストール時に付与されている可能性があります。LOGRETENTIONの詳細は、Oracle DatabaseのためのOracle GoldenGateの使用のロギング・プロパティの構成を参照してください。

  • 統合キャプチャ用に構成されているExtractグループにUSERIDALIASを使用するには、ユーザーにdbms_goldengate_auth.grant_admin_privilegeプロシージャで付与される権限が必要であり、そのユーザーは、このUSERIDALIASに関連付けられているExtractグループに対してDBLOGINおよびREGISTER EXTRACTまたはUNREGISTER EXTRACTを発行するユーザーと同じである必要があります。

  • Oracleコンテナ・データベースからのキャプチャをサポートするには、USERIDで指定されたユーザーがルート・コンテナにログインする必要があり、共通データベース・ユーザーである必要があります。接続文字列がこのユーザーに指定されている必要があります。たとえば: C##GGADM@FINANCE。詳細は、『異種データベースのためのOracle GoldenGateの使用』のプライマリExtractの構成に関する項を参照してください。

Kerberos認証を使用するUSERIDALIAS

Oracle Databaseのみでサポートされます。

認証が外部であるため、NOPASSWORDキーワードを使用するようにALTER CREDENTIALSTOREを設定する必要があります。詳細は、ALTER CREDENTIALSTOREに関する項を参照してください。

SQL Server

USERIDALIASは、Oracle GoldenGateプロセスで使用されるODBCデータ・ソース接続が、SQL Server認証を使用して接続するように構成されている場合に使用します。

  • ソースSQL Serverシステムでは、SOURCEDBパラメータも使用してソースODBCデータ・ソースを指定します。

  • ターゲットSQL Serverシステムでは、TARGETDBパラメータも使用してターゲットODBCデータ・ソースを指定します。

Teradata

USERIDALIASは、Teradataデータベースに接続するOracle GoldenGateプロセスで使用します。

ターゲットTeradataシステムでは、TARGETDBパラメータを使用してターゲットODBCデータ・ソースを指定します。

デフォルト

なし

構文

USERIDALIAS alias [DOMAIN domain] [SYSDBA]
[, THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])]
alias

Oracle GoldenGate資格証明ストアに格納されているデータベース・ユーザー資格証明の別名を指定します。その他のガイドラインは、「データベース・タイプ別のUSERIDの要件」を参照してください。

DOMAIN domain

指定した別名の資格証明ストアのドメインを指定します。有効なドメイン・エントリが指定した別名に対する資格証明ストアに存在する必要があります。

SYSDBA

(Oracle)ユーザーがsysdbaとしてログインするように指定します。

THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])

Replicatに有効です。指定された資格証明を調整Replicatの1つ以上のスレッドにリンクします。異なるスレッドに異なるログインを指定できます。

threadID[, threadID][, ...]

スレッドIDを指定するか、スレッドのカンマ区切りリストをthreadID, threadID, threadIDの形式で指定します。

[, thread_range[, thread_range][, ...]

スレッドの範囲をthreadIDlow-threadIDhighの形式で指定するか、範囲のカンマ区切りリストをthreadIDlow-threadIDhigh, threadIDlow-threadIDhighの形式で指定します。

threadID, threadID, threadIDlow-threadIDhighのように、これらの形式を組み合せて指定することもできます。

TimesTen

USERIDALIASは、TimesTenデータベースに接続するOracle GoldenGateプロセスに使用します。

ターゲットTimesTenシステムでは、TARGETDBパラメータを使用してターゲットODBCデータ・ソースを指定します。

デフォルト

なし

構文

USERIDALIAS alias [DOMAIN domain] [SYSDBA]
[, THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])]
alias

Oracle GoldenGate資格証明ストアに格納されているデータベース・ユーザー資格証明の別名を指定します。その他のガイドラインは、「データベース・タイプ別のUSERIDの要件」を参照してください。

DOMAIN domain

指定した別名の資格証明ストアのドメインを指定します。有効なドメイン・エントリが指定した別名に対する資格証明ストアに存在する必要があります。

SYSDBA

(Oracle)ユーザーがsysdbaとしてログインするように指定します。

THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])

Replicatに有効です。指定された資格証明を調整Replicatの1つ以上のスレッドにリンクします。異なるスレッドに異なるログインを指定できます。

threadID[, threadID][, ...]

スレッドIDを指定するか、スレッドのカンマ区切りリストをthreadID, threadID, threadIDの形式で指定します。

[, thread_range[, thread_range][, ...]

スレッドの範囲をthreadIDlow-threadIDhighの形式で指定するか、範囲のカンマ区切りリストをthreadIDlow-threadIDhigh, threadIDlow-threadIDhighの形式で指定します。

threadID, threadID, threadIDlow-threadIDhighのように、これらの形式を組み合せて指定することもできます。

例

例1   

次の例は、eastのドメインにtiger1の別名を持つ資格証明ストア内のユーザーの資格証明を指定します。

USERIDALIAS tiger1 DOMAIN east

例2   
次の例は、調整Replicatのスレッド3の資格証明を指定します。
USERIDALIAS tiger1 DOMAIN east THREADS (3)
例3   
次の例では、このパラメータをPostgreSQLで使用しています。
USERIDALIAS pgdsn

次の例では、Oracle GoldenGateでのKerberos認証の使用方法を示します。

GGSCIの場合:
GGSCI (abc2)> dblogin useridalias ora1 
Successfully logged into database CDB1_PDB1
Admin Clientの場合:
OGG (http://localhost:9005 demo)4> dblogin useridalias ora1 
Successfully logged into database CDB1_PDB1

この例では、資格証明ストアはALTER CREDENTIALSTOREコマンドを使用して事前に設定されています。