USERIDALIAS

有効な対象

Extract、Replicat、DEFGEN、管理クライアント。

サポート対象

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

摘要

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 AI Databaseのオペレーティング・システム・ログインの使用をサポートします。

データベース・タイプ別の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 (LUW)

USERIDALIASパラメータは、データベース認証を使用してDb2 LUWデータベースに接続するすべてのOracle GoldenGateプロセスに使用します。

MySQL

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

Oracle

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

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

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

• USERIDALIASを統合キャプチャ用に構成するExtractグループに使用するには、ユーザーに権限が必要です。Oracle AI Database 26ai以上を使用している場合は、OGG_CAPTUREおよびOGG_APPLYユーザー・ロールでユーザー権限を付与できます。Oracleデータベース21c以下を使用している場合、ユーザーはdbms_goldengate_auth.grant_admin_privilegeプロシージャの権限を持っている必要があります。ユーザーは、このUSERIDALIASに関連付けられているExtractグループに対してDBLOGINおよびREGISTER EXTRACTまたはUNREGISTER EXTRACTを発行するユーザーと同じである必要があります。

  Oracle AI Database 26aiユーザー権限の付与の詳細は、Oracle AI Database 26ai以上のユーザー権限の付与を参照してください。

  Oracle Database 21c以前の権限の付与の詳細は、「Oracle Database 21c以前のユーザー権限の付与」を参照してください。

Kerberos認証を使用するUSERIDALIAS

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

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

SQLサーバー

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

Teradata

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

デフォルト

なし

構文

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

<alias>

Oracle GoldenGate資格証明ストアに格納されたデータベース・ユーザー資格証明の別名を指定します。

DOMAIN <domain>

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

SYSDBA

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

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

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

<threadID>[, <threadID>][, ...]

threadID, threadID, threadIDというフォーマットでスレッドIDまたはスレッドのカンマ区切りリストを指定します。

[, <thread_range>[, <thread_range>][, ...]

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

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

TimesTen

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

デフォルト

なし

構文

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

<alias>

Oracle GoldenGate資格証明ストアに格納されたデータベース・ユーザー資格証明の別名を指定します。

DOMAIN <domain>

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

SYSDBA

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

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

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

<threadID>[, <threadID>][, ...]

threadID, threadID, threadIDというフォーマットでスレッドIDまたはスレッドのカンマ区切りリストを指定します。

[, <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認証の使用方法を示します:

OGG (http://localhost:9005 demo)4> dblogin useridalias ggma
Successfully logged into database CDB1_PDB1

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