1. Oracle GoldenGateコマンドライン・インタフェース・リファレンス
  2. GGSCIコマンドライン・インタフェースのコマンド
  3. DBLOGIN

4.4 DBLOGIN

DBLOGINでは、データベースを操作する他のOracle GoldenGateコマンドの発行準備として、データベースへのGGSCI経由の接続を確立します。DBLOGINを発行するユーザーは、これらのコマンドによって成立する機能を実行するための適切なデータベース権限を持っている必要があります。

GGSCIコマンドに必要なその他の特別な権限は、そのコマンドのリファレンス・ドキュメントでリストされています。

統合モードでExtractまたはReplicatを構成する場合の要件(Oracle)

DBLOGINを使用してADD EXTRACT、ALTER EXTRACTまたはREGISTER EXTRACTを発行し、統合Extractを開始する、またはADD REPLICAT、ALTER REPLICATまたはREGISTER REPLICATを発行し、Oracleデータベースに対して統合Replicatを開始する場合、DBLOGINを発行するユーザーは、次を満たす必要があります。

  • Oracle dbms_goldengate_auth.grant_admin_privilegeプロシージャを使用して付与された権限がある。

  • ExtractまたはReplicatが統合モードである間は変更されない。

クラシック・キャプチャ・モードでログ保持を使用するための特別なデータベース権限

Oracleデータベースのクラシック・キャプチャ・モードの場合、Extractはログ保持機能をサポートし、それによりデータベースはExtractが必要とするログを保持します。ログ保持機能を有効にするには、REGISTER EXTRACTをLOGRETENTIONオプションで使用する前に、DBLOGINを特別な権限で発行する必要があります。Oracle GoldenGateのインストール時に適切な権限がユーザーに付与されている場合、簡単にするために、Extractデータベース・ユーザーとしてログインできます。それ以外の場合は、権限を持つユーザーとしてログインします。

表4-18 ログ保持のためのOracleの権限

Oracle EEのバージョン 権限の付与方法

11.1および11.2.0.1

  1. パッケージを実行してOracle GoldenGateの管理権限を付与します。

    exec dbms_streams_auth.grant_admin_privilege('user')

  2. become user権限を付与します。 

    grant become user to user;

11.2.0.2以降

パッケージを実行してOracle GoldenGateの管理権限を付与します。

exec dbms_goldengate_auth.grant_admin_privilege('user')

構文

DBLOGIN {
[SOURCEDB data_source] |
[, database@host:port] |
USERID {/ | userid}[, PASSWORD password]
   [algorithm ENCRYPTKEY {keyname | DEFAULT}] |
USERIDALIAS alias [DOMAIN domain] |
[SYSDBA | SQLID sqlid]
[SESSIONCHARSET character_set]
}
SOURCEDB data_source

SOURCEDBは、データ・ソース名を指定します。このオプションは、次のいずれかを識別するために必要です。

  • SQL Server、MySQLおよびODBCを使用するデータベース用のソースまたはターゲットのログイン・データベース

database@host:port

(MySQL) データベース名、ホスト名およびデータベース・ポート番号を含む接続文字列を指定します。データベース構成で指定されているデフォルト以外のポートを指定するのに使用できます。

USERID

必要に応じてデータベース・ログイン資格証明を指定します。Oracle GoldenGateの資格証明ストアが使用されない場合に使用できます。次のように、データベースによって入力は異なります。

userid

データベース構成に応じて、データベース・ユーザーまたはスキーマの名前を指定します。Oracleの場合は、SQL*Net接続文字列を使用できます。Oracleマルチテナント・コンテナ・データベースのプラガブル・データベースにログインするには、useridを接続文字列として指定します(OGGUSER@FINANCEなど)。ルート・コンテナにログインするには、C##接頭辞を含む、useridを共通ユーザーとして指定します(C##GGADMIN@FINANCEなど)。

/

(Oracle)データベース・ユーザー・ログインではなく、Oracle用のオペレーティングシステム・ログインを使用するようにOracle GoldenGateに指示します。この引数は、データベースによってオペレーティングシステム・レベルでの認証が許可されている場合にのみ使用します。このオプションを使用するには、Oracle OS_AUTHENT_PREFIX初期化パラメータの値との関連で、正しいユーザー名がデータベースに存在している必要があります。詳細は、USERID | NOUSERIDパラメータを参照してください。

NOPASSWORD | PASSWORD password

Kerberos認証を使用するなどの外部認証ではパスワードは必要ないため、外部認証を使用する場合は、NOPASSWORDオプションがPASSWORDオプションのかわりになります。

データベース・ユーザーのパスワードを指定するために認証が必要な場合に使用します。パスワードがENCRYPT PASSWORDコマンドによって暗号化されている場合は、暗号化されたパスワードを指定します。それ以外の場合は、クリアテキストのパスワードを指定します。パスワードに大/小文字の区別がある場合は、そのように入力してください。

PASSWORD句を省略すると、パスワードの入力が求められ、パスワードはエコーされません。

algorithm

ENCRYPT PASSWORDコマンドを使用してパスワードが暗号化された場合、使用した暗号化アルゴリズムを次の中から指定します。

AES128

AES192

AES256

BLOWFISH

ENCRYPTKEY {keyname | DEFAULT}

ENCRYPT PASSWORDコマンドで指定した暗号化キーを指定します。次のいずれかを使用します。

ENCRYPTKEY keyname

ENCKEYS参照ファイル内のユーザー作成の暗号化キーの論理名を指定します。ENCRYPT PASSWORDをKEYNAME keynameオプションとともに使用した場合に使用します。

ENCRYPTKEY DEFAULT

Blowfishキーを生成するようにOracle GoldenGateに指示します。ENCRYPT PASSWORDコマンドがKEYNAME DEFAULTオプションとともに使用された場合に使用します。

USERIDALIAS alias [DOMAIN domain]

必要に応じてデータベース・ログイン別名を指定します。必要な権限を持つ資格証明を含むローカルOracle GoldenGate資格証明ストアがある場合に、USERIDオプションのかわりに使用できます。

alias

Oracle GoldenGateの資格証明ストアに格納されているデータベース・ユーザー資格証明の別名を指定します。Oracleマルチテナント・コンテナ・データベースのプラガブル・データベースにログインするには、ユーザーは接続文字列として格納されている必要があります(OGGUSER@FINANCEなど)。ルート・コンテナにログインするには、ユーザーはC##接頭辞を含む共通ユーザーとして格納されている必要があります(C##GGADMIN@FINANCEなど)。

DOMAIN domain

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

SYSDBA

(Oracle)ユーザーがsysdbaとしてログインするように指定します。このオプションは、USERIDおよびUSERIDALIASに使用できます。

SQLID sqlid

(z/OS上のDB2)USERIDのログインが(該当する場合はPASSWORDを使用して)完了した後に、SQLコマンドSET CURRENT SQLID = 'sqlid'を発行します。SETコマンドが失敗すると、DBLOGINコマンド全体がユニットとして失敗します。

SESSIONCHARSET character_set

(TeradataおよびMySQL) GGSCIをデータベースに接続するために、データベース・セッションの文字セットを設定します。後続のすべてのコマンドは、指定したセッションの文字セットを使用します。このコマンド・オプションは、GLOBALSファイルで指定されるすべてのSESSIONCHARSETより優先されます。

例

(Oracle) 
DBLOGIN USERIDALIAS alias1
(Oracle、デフォルト以外のドメインを使用した場合) 
DBLOGIN USERIDALIAS alias1 DOMAIN domain1
(Oracle、SYSDBAを使用した場合) 
DBLOGIN USERID ogguser@pdb1 SYSDBA password AACAAAAAAAAAAAJAUEUGODSCVGJEEIUGKJDJTFNDKEJFFFTC AES128, ENCRYPTKEY securekey1
(MySQL) 
DBLOGIN SOURCEDB mysqldb@host1:3305, USERIDALIAS alias1
(MySQL) 
DBLOGIN SOURCEDB database USERIDALIAS alias1
(SQL Server、統合Windows認証を使用) 
DBLOGIN SOURCEDB systemdsn
(SQL Server認証を使用したSQL Server) 
DBLOGIN SOURCEDB systemdsn USERIDALIAS alias1

親トピック: GGSCIコマンドライン・インタフェースのコマンド