ランタイム・パラメータの操作

ランタイム・パラメータによって、次のようなOracle GoldenGateの同期の様々な機能を制御します。

  • データの選択、マッピング、変換およびレプリケーション

  • DDLおよび順序の選択、マッピングおよびレプリケーション(サポートされる場合)

  • エラーの解決

  • ロギング

  • ステータスおよびエラーのレポート

  • システム・リソースの使用方法

  • 起動時および実行時の動作

Oracle GoldenGateのインストールごとにマネージャ・プロセスを1つだけ含めることができます。これはmgr.prmパラメータ・ファイルを使用して構成します。単一のインストールに複数のExtractおよびReplicatを実行できますが、それぞれを1つのパラメータ・ファイルのみと関連付けることができます。ExtractおよびReplicatの場合、これらは大/小文字を区別しない名前で識別されます。たとえば、EXT_DEMOという名前のExtractには、EXT_DEMO.prmという関連パラメータ・ファイルが1つあります。パラメータ・ファイルの使用を簡略化する方法の詳細は、「パラメータ・ファイルの作成の簡略化」を参照してください。

パラメータには、次のようにグローバル・パラメータ(GLOBALSパラメータとは異なります)とオブジェクト固有パラメータの2種類があります。

  • グローバル・パラメータは、パラメータ・ファイルに指定されているすべてのデータベース・オブジェクトに適用されます。たとえば、プロセスの動作に影響するパラメータや、メモリー使用率などの機能に影響するパラメータがあります。例 -1および例 -3USERIDALIASは、グローバル・パラメータの例です。ほとんどの場合、グローバル・パラメータは、ファイル内でデータベース・オブジェクトを指定するパラメータ(たとえば、例 -1および例 -3TABLE文やMAP文)より前の任意の場所に指定できます。グローバル・パラメータは、ファイル内で1回のみリストされる必要があります。複数回リストされると、最後のインスタンスのみがアクティブになり、他のすべてのインスタンスは無視されます。

  • オブジェクト固有パラメータでは、データベース・オブジェクトの異なるセットに対して異なる処理ルールを適用できます。例 -3GETINSERTSおよびIGNOREINSERTSは、オブジェクト固有パラメータの例です。どちらのパラメータも、影響を受けるオブジェクトを指定するMAP文の前にあります。オブジェクト固有パラメータは、ファイルにリストされている順序で有効になります。

例 -1例 -3に、ExtractおよびReplicatの基本パラメータ・ファイルの例を示します。コメントの先頭にはハイフンが2つ付いています。

前述の例は、大/小文字が区別されないOracleデータベースを反映したもので、オブジェクト名がTABLE文に大文字で指定されています。大/小文字が区別されないOracleデータベースの場合、パラメータ・ファイルに名前をどのように入力しても(大文字でも、小文字でも、大文字と小文字が混在していても)違いは生じません。他のデータベースの場合は、オブジェクト名の大/小文字が問題になることがあります。オブジェクト名の指定の詳細は、「Oracle GoldenGateの入力におけるオブジェクト名の指定」を参照してください。

例 -1に示したReplicatのサンプルでの一重引用符と二重引用符の使用方法に注意してください。オブジェクト名の大/小文字を区別するには引用符が必要になるデータベース(Oracleなど)の場合、大/小文字が区別されるオブジェクト名はパラメータ・ファイルでも二重引用符で囲む必要があります。大/小文字が区別されるその他のデータベースでは、データベースに保存されているとおりに名前を指定します。名前およびリテラルの指定方法の詳細は、「Oracle GoldenGateの入力におけるオブジェクト名の指定」を参照してください。

例 -1 Extractのサンプル・パラメータ・ファイル

-- Extract group name
EXTRACT capt
-- Extract database user login, with alias to credentials in the credential store.
USERIDALIAS ogg1
-- Remote host to where captured data is sent in encrypted format:
RMTHOSTOPTIONS sysb, MGRPORT 7809, ENCRYPT AES192 KEYNAME mykey
-- Encryption specification for trail data
ENCRYPTTRAIL AES192
-- Remote trail on the remote host
RMTTRAIL /ggs/dirdat/aa

With these lines:
-- Encryption specification for trail data
ENCRYPTTRAIL AES192
-- Local trail on the remote host
EXTTRAIL ./dirdat/aa


例 -2 Extractのサンプル・ポンプ・パラメータ・ファイル

-- Extract Pump group name
EXTRACT pmp
-- Remote host to where captured data is sent in encrypted format:
RMTHOSTOPTIONS sysb, MGRPORT 7809, ENCRYPT AES192 KEYNAME mykey
-- Encryption specification for trail data
ENCRYPTTRAIL AES192
-- Remote trail on the remote host
RMTTRAIL /ggs/dirdat/bb
-- TABLE statements that identify data to capture.
TABLE FIN.*;
TABLE SALES.*;

例 -3 Replicatのサンプル・パラメータ・ファイル

-- Replicat group name
REPLICAT deliv
-- Replicat database user login, with alias to credentials in the credential store
USERIDALIAS ogg2
-- Error handling rules
REPERROR DEFAULT, ABEND
-- Ignore INSERT operations
IGNOREINSERTS
-- MAP statement to map source objects to target objects and
-- specify column mapping
MAP "fin"."accTAB", TARGET "fin"."accTAB",
COLMAP ("Account" = "Acct",
"Balance" = "Bal",
"Branch" = "Branch");
-- Get INSERT operations
GETINSERTS
-- MAP statement to map source objects to target objects and
-- filter to apply only the 'NY' branch data.
MAP "fin"."teller", TARGET "fin"."tellTAB",
WHERE ("Branch" = 'NY');