DDLOPTIONS

適用対象

ExtractおよびReplicat

説明

DDLOPTIONSパラメータでは、フィルタリングおよび文字列置換以外のDDL処理を構成します。DDLOPTIONS文は複数使用可能ですが、1つの文のみを使用することをお薦めします。複数のDDLOPTIONS文を使用する場合は、相互に上書きしないように、それぞれを一意の文にする必要があります。複数のDDLOPTIONS文は、パラメータ・ファイルに指定された順に実行されます。

デフォルト

引数の説明を参照してください。

構文

DDLOPTIONS
[, DEFAULTUSERPASSWORD password [algorithm [ENCRYPTKEY DEFAULT | ENCRYPTKEY key_name]
[, CAPTUREGLOBALTEMPTABLE ]
[, DEFAULTUSERPASSWORDALIAS alias [DOMAIN domain] ]
[, GETAPPLOPS | IGNOREAPPLOPS]
[, GETREPLICATES | IGNOREREPLICATES]
[, IGNOREMAPPING]
[, MAPDERIVED | NOMAPDERIVED]
[, MAPSCHEMAS]
[, MAPSESSIONSCHEMA source_schema TARGET target_schema]
[, NOTAG]
[, PASSWORD algorithm ENCRYPTKEY {key_name | DEFAULT}]
[, REMOVECOMMENTS {BEFORE | AFTER}]
[, REPLICATEPASSWORD | NOREPLICATEPASSWORD]
[, REPORT | NOREPORT]
[, UPDATEMETADATA]
[, USEPASSWORDVERIFIERLEVEL {10|11}]
[, _USEOWNERFORSESSION]

DEFAULTUSERPASSWORD password [algorithm ENCRYPTKEY {key_name | DEFAULT}]

Replicatに有効です。(Oracleのみ)

Oracle GoldenGate資格証明ストアが使用されていない場合に、DEFAULTUSERPASSWORDALIASオプションのかわりに使用できます。レプリケートされる{CREATE | ALTER} USER name IDENTIFIED BY password文に、ソース文で使用されているパスワードとは異なるパスワードを指定します。Replicatは、Extractがトレイルに書き込むプレースホルダを、指定されたパスワードに置き換えます。DEFAULTUSERPASSWORDを使用する場合、ExtractにはDDLOPTIONSのNOREPLICATEPASSWORDオプションを使用します。

オプションなしのDEFAULTUSERPASSWORD passwordでは、クリアテキストのパスワードを指定します。パスワードに大/小文字の区別がある場合は、そのように入力してください。

ノート:

プロファイル/パスワードの検証ファンクションはSYSスキーマに存在する必要があるため、CREATE | ALTER PROFILEのレプリケーションは失敗します。これらのDDLを正常にレプリケートするには、SYSスキーマへのDDLは除外されるため、ソース/ターゲットの両方でパスワード検証ファンクションを手動で作成する必要があります。

GGSCIのENCRYPT PASSWORDコマンドでパスワードが暗号化されている場合、次のオプションを使用します。

algorithm

ENCRYPT PASSWORDコマンドでパスワードの暗号化に使用した暗号化アルゴリズムを、AES128、AES192、AES256またはBLOWFISHの中から指定します。下位互換性のためにBlowfishが必要でないかぎり、AESを使用してください。AESはBlowfishよりもセキュアです。

ENCRYPTKEY key_name

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

ENCRYPTKEY DEFAULT

指定すると、Oracle GoldenGateでランダムなキーが使用されます。ENCRYPT PASSWORDがKEYNAME DEFAULTオプションとともに使用された場合に使用します。

CAPTUREGLOBALTEMPTABLE

Oracleに有効

グローバル一時表(GTT) DDLをExtractに表示できるようになり、レプリケートできます。デフォルトでは、GTT DDLはExtractに表示できないため、CAPTUREGLOBALTEMPTABLEを使用することで、GTT DDLを含むようにExtractを設定できます(GTT DDLはDDL文によってフィルタ可能で、渡されるとトレイルに書き込まれます)。GTT DDLは、トレイルに存在する場合はReplicatに含まれ、DDL文によってフィルタされ、渡されると実行されます。

トリガーバージョンのExtractの場合、表がGTTかどうかに関係なく、このオプションはfalseに設定されます。

DEFAULTUSERPASSWORDALIAS alias [DOMAIN domain]

Replicatに有効です。(Oracleのみ)

Oracle GoldenGate資格証明ストアが使用されていない場合に、DEFAULTUSERPASSWORDオプションのかわりに使用できます。レプリケートされたCREATE USERまたはALTER USER文のIDENTIFIED BY句のパスワードを置き換える、資格証明の別名を指定します。別名は、Oracle GoldenGate資格証明ストアの暗号化パスワードに解決されます。Replicatは、Extractがトレイルに書き込むプレースホルダを、解決されたパスワードに置き換えてからDDLをターゲットに適用します。

DEFAULTUSERPASSWORDALIASを使用する場合、ExtractにはDDLOPTIONSのNOREPLICATEPASSWORDオプションを使用します。

alias

置換パスワードとして使用されるパスワードの資格証明の別名を指定します。この資格証明は、Oracle GoldenGate資格証明ストアに存在する必要があります。使用する別名が不明な場合は、INFO CREDENTIALSTOREコマンドを発行して資格証明ストアの内容を調べることができます。

DOMAIN domain

資格証明ストアの指定されたユーザーに割り当てられるドメインを指定します。

GETAPPLOPS | IGNOREAPPLOPS

Extractに有効です。(Oracleのみ)

Replicat以外のビジネス・アプリケーションが生成したDDL操作を、Extractがトレイルまたはファイルに書き込むコンテンツに含めるかどうかを制御します。GETAPPLOPSおよびIGNOREAPPLOPSは、GETREPLICATESおよびIGNOREREPLICATESオプションとともに使用して、双方向またはカスケード構成で伝播するDDLを制御できます。

• 双方向構成では、GETAPPLOPSとIGNOREREPLICATESを使用します。UPDATEMETADATAオプションも使用する必要があります。

• カスケード構成では、DDL操作をターゲットにカスケードするシステム上で、IGNOREAPPLOPSとGETREPLICATES使用します。

デフォルトはGETAPPLOPSです。

GETREPLICATES | IGNOREREPLICATES

Extractに有効です(Oracleのみ)。Replicatが生成したDDL操作をExtractがトレイルまたはファイルに書き込むコンテンツに含めるかどうかを制御します。デフォルトはIGNOREREPLICATESです。詳細は、DDLOPTIONSのGETAPPLOPS | IGNOREAPPLOPSオプションを参照してください。

IGNOREMAPPING

Replicatに有効です。DDLがMAPPED範囲かUNMAPPED範囲かを決定する名前マッピングの評価を無効化します。このオプションにより、ソースとターゲットのスキーマ名およびオブジェクト名が一致するためマッピング機能が不要な場合に、like-to-like DDLレプリケーション構成のパフォーマンスが向上します。IGNOREMAPPINGを有効にすると、MAPPEDまたはUNMAPPED範囲を決定できず、すべてのDDL文はOTHER範囲として処理されます。ソースのスキーマおよびオブジェクト名がターゲット上で異なるスキーマおよびオブジェクト名にマッピングされている場合、このパラメータを使用しないでください。

MAPDERIVED | NOMAPDERIVED

Replicatに有効です(Oracle)。導出オブジェクト名のマッピング方法を制御します。

MAPDERIVED

導出オブジェクトのMAP文が存在する場合、名前はその文のTARGET句に指定されている名前にマッピングされます。それ以外の場合、名前はベース・オブジェクトを含むMAP文のTARGET句に指定されている名前にマッピングされます。MAPDERIVEDはデフォルトです。

NOMAPDERIVED

名前のマッピングを行わないようにします。NOMAPDERIVEDは、導出オブジェクトの名前を含むすべての明示的なMAP文より優先されます。

導出されたオブジェクトのDDLレプリケーションでの処理方法の詳細は、『Oracle DatabaseのためのOracle GoldenGateの使用』のDDLレプリケーション環境の管理に関する項を参照してください。

MAPSCHEMAS

Replicat(OracleおよびTeradata)に有効です。MAPSESSIONSCHEMAを使用している場合のみ使用します。

• MAPSESSIONSCHEMAは、セッション・スキーマのソース・ターゲット間のマッピングを確立し、スキーマがDDLで修飾されていないオブジェクトに使用されます。

• MAPSCHEMASは、修飾されたスキーマがソースDDLに存在するが、MAPを使用したマッピングは修飾しないオブジェクトを、MAPSESSIONSCHEMAと同じセッション・スキーマ間のマッピングにマップします。そのようなオブジェクトの例には、AS SELECT句内の導出オブジェクトが含まれているOracleのCREATE TABLE AS SELECT文や、TeradataのCREATE REPLICATION RULESET文があります。

このマッピングは、MAP文で指定されたマッピング後に行われます。

例として、次のDDL文がソースOracleデータベースで発行されるとします。

create table a.t as select from b.t;

ターゲット上でのMAP文は次のようになるとします。

MAP a.*, TARGET c.*;
DDLOPTIONS MAPSESSIONSCHEMA b, TARGET b1, MAPSCHEMAS

このマッピングの結果、Replicatはターゲット上に次のDDL文を発行します。

create table c.t as select from b1.t;

• ベース表は、TARGET句(スキーマc)に従ってマップされます。

• 修飾された導出オブジェクト(SELECT FROM内の表t)は、MAPSCHEMASが存在するため、MAPSESSIONSCHEMA (スキーマb1)に従ってマップされます。

MAPSCHEMASを指定しない場合、MAPSESSIONSCHEMAのみが未修飾のオブジェクトをマップするため、導出オブジェクトは、(TARGET句で指定した)スキーマcにマップされます。

MAPSESSIONSCHEMA source_schema TARGET target_schema

Replicatに有効です(Oracleのみ)。ソースのセッション・スキーマを、ターゲット上の異なるセッション・スキーマにマッピング(変換)します。

• source_schemaは、ソース上でALTER SESSION set CURRENT_SCHEMAで設定されているセッション・スキーマです。

• target_schemaは、ターゲット上でALTER SESSION set CURRENT_SCHEMAで設定されているセッション・スキーマです。

ワイルドカードはサポートされていません。複数のMAPSESSIONSCHEMAパラメータを使用して、異なるスキーマをマップできます。

MAPSESSIONSCHEMAは、マスターまたは導出オブジェクト名に基づくすべてのスキーマ名マッピングより優先されます。

このセクション最後の使用例を参照してください。

MAPSCHEMASも参照してください。

NOTAG

Replicatに有効

ReplicatがREDOタグ(デフォルト・タグ'00'またはDBOPTIONSパラメータのSETTAGオプションによって設定されるタグ)を使用して適用するDDLのタグ付けを禁止します。このオプションは双方向構成で使用します。双方向構成では、GETREPLICATESが使用され、Replicatが適用したDDLをメタデータのリフレッシュのためExtractがキャプチャする必要があります。

PASSWORD algorithm ENCRYPTKEY {key_name | DEFAULT}

Extractに有効です(Oracleのみ)。

DDLをトレイルに書き込む前に、ExtractにソースDDLのすべてのパスワードを暗号化させます。

algorithm

パスワードの暗号化に使用する暗号アルゴリズムを指定します。有効な値は、AES128、AES192、AES256またはBLOWFISHです。下位互換性のためにBlowfishが必要でないかぎり、AESを使用してください。AESはBlowfishよりもセキュアです。

ENCRYPTKEY key_name

ENCKEYS参照ファイル内のユーザー作成の暗号化キーの論理名を指定します。

ENCRYPTKEY DEFAULT

指定すると、Oracle GoldenGateでランダムなキーが使用されます。

REMOVECOMMENTS {BEFORE | AFTER}

(オプション) ExtractおよびReplicatに有効です(Oracleのみ)。DDL操作からコメントを削除するかどうかを制御します。デフォルトでは、DDLSUBSTパラメータを使用して文字列の置換で使用できるように、コメントは削除されません。詳細は、DDLSUBSTを参照してください。

REMOVECOMMENTS BEFORE

ExtractまたはReplicatによってDDL操作が処理される前にコメントを削除します。コメントは、文字列置換で使用できません。

REMOVECOMMENTS AFTER

文字列置換で使用された後にコメントを削除します。これは、REMOVECOMMENTSが指定されていない場合のデフォルト動作です。

REPLICATEPASSWORD | NOREPLICATEPASSWORD

Extractに有効です(Oracleのみ)。{CREATE | ALTER} USER user IDENTIFIED BY passwordコマンドのパスワードに適用します。

• デフォルト(REPLICATEPASSWORD)では、Oracle GoldenGateはターゲットのCREATEまたはALTER文でソース・パスワードを使用します。

• ソース・パスワードのターゲットへの送信を防ぐには、NOREPLICATEPASSWORDを使用します。

NOREPLICATEPASSWORDを使用する場合は、DDLOPTIONS文とDEFAULTUSERPASSWORDまたはReplicatパラメータ・ファイルのDEFAULTUSERPASSWORDALIASオプションを使用して、ターゲットDDL文用のパスワードを指定します。

REPORT | NOREPORT

ExtractおよびReplicat(OracleおよびTeradata)に有効です。レポート・ファイルに詳しいDDL処理情報を書き込むかどうかを制御します。デフォルトのNOREPORTでは、基本的なDDL統計をレポートします。REPORTでは、使用しているパラメータ、および処理された操作のステップバイステップの履歴をレポートに追加します。

UPDATEMETADATA

Replicatに有効です(Oracleのみ)。アクティブアクティブの双方向構成で使用します。このパラメータは、DDLが開始されたシステム上のReplicatに、もう一方のシステムにこのDDLが伝播されたため、新しいメタデータにあわせてすぐにオブジェクト・メタデータ・キャッシュを更新するように通知します。これにより、Replicatのメタデータ・キャッシュと、ローカル・データベースの現在のメタデータの同期性を維持します。

USEPASSWORDVERIFIERLEVEL {10|11}

OracleからOracleの構成でのみ有効です。DDL CREATE USER文で送信されるパスワード・ベリファイアに変更が必要かどうかを確認します。この確認を行う理由は、Oracleにはデータベース・バージョンに応じて異なるパスワード・ベリファイアがあるためです。

• 10g: user$.passwordに保持されている弱いベリファイア。

• 11g: SHA-1ベリファイア。

• 12c: SHA-2およびHTTPダイジェスト・ベリファイア。

SHA-1、SHA-2およびHTTPベリファイアは、'S:<SHA-1-verifier>;H:<http-verifier>;T:<SHA-2-verifier>'という形式でuser$.spare4に取得されます。Integrated Extractは、12cではcreate user DDL文に対して次のDDLを返します。

• 12.0.1.0では、CREATE USER username IDENTIFIED BY VALUES 'S:SHA-1;H:http;weak'を返します。

• 12.0.2.0以降では、CREATE USER username IDENTIFIED BY VALUES 'S:SHA-1;H:http;T:SHA-2;weak'を返します。

ReplicatをOracle 12cに対して実行する場合、これらのCREATE USERフォームはRDBMSレベルで処理されますが、ReplicatをOracle 10gまたは11に対して実行する場合、これらのフォームはRDBMSによって処理されません。Oracle 10gは弱いベリファイアのみを受け入れ、Oracle 11gはS:SHA-1および弱いベリファイアのみを受け入れます。

Oracle 12cに接続されたExtractに対して生成されたCREATE USER DDLを、Oracle 10gまたは11gに接続されたReplicatで使用できるようにするには、次のように、このパラメータを使用して不要なベリファイアをフィルタリングで除外できます。

• USEPASSWORDVERIFIERLEVELを10に設定した場合、弱いベリファイア以外はすべてCREATE USER DDL検証文字列からフィルタリングで除外されます。

• USEPASSWORDVERIFIERLEVELを11に設定した場合、S:SHA-1および弱いベリファイア以外はすべてCREATE USER DDL検証文字列からフィルタリングで除外されます。

例

例1   

次に、MAPSESSIONSCHEMAを使用して、ソース・セッション・スキーマをターゲット上の別のスキーマにマッピングする方法を示します。

ExtractおよびReplicatで、次のようにDDL取得およびマッピングが構成されているとします。

Extract:

DDL INCLUDE OBJNAME SRC.* INCLUDE OBJNAME SRC1.*
TABLE SRC.*;
TABLE SRC1.*;
DDL INCLUDE OBJNAME SRC.* INCLUDE OBJNAME SRC1.*
TABLE SRC.*;
TABLE SRC1.*;

Replicat:

DDLOPTIONS MAPSESSIONSCHEMA SRC TARGET DST
DDLOPTIONS MAPSESSIONSCHEMA SRC1 TARGET DST1
MAP SRC.*, TARGET DST.*;
MAP SRC1.*, TARGET DST1.*;
DDL INCLUDE OBJNAME DST.* INCLUDE OBJNAME DST1.*

ソースのログイン・ユーザーによって、次のDDL文が発行されるとします。

ALTER SESION SET CURRENT_SCHEMA=SRC;
CREATE TABLE tab (X NUMBER);
CREATE TABLE SRC1.tab (X NUMBER) AS SELECT * FROM tab;

Replicatは、次のようなDDLを実行します(各コード・セグメントの前に説明を記載しています)。

-- Set session to DST, because SRC.* is mapped to DST.* in MAP statement.
ALTER SESION SET CURRENT_SCHEMA=DST;
-- Create the first TAB table in the DST schema, using the DST session schema.
CREATE TABLE DST.tab (X NUMBER);
-- Restore Replicat schema.
ALTER SESSION SET CURRENT_SCHEMA=REPUSER
-- Set session schema to DST, per MAPSESSIONSCHEMA, so that AS SELECT succeeds.
ALTER SESION SET CURRENT_SCHEMA=DST;
-- Create the DST1.TAB table AS SELECT * FROM the first table (DST.TAB).
CREATE TABLE DST1.tab (X NUMBER) AS SELECT * FROM tab;
-- Restore Replicat schema.
ALTER SESSION SET CURRENT_SCHEMA=REPUSER

MAPSESSIONSCHEMAを指定しない場合、SELECT * FROM TABは存在しないSRC.TAB表からの選択を試み、失敗します。デフォルトでは、ソース・スキーマを、ターゲットDDL文の未修飾のオブジェクトに適用します。その場合、DDL文は次のようになり、失敗します。

-- Set session to DST, because SRC.* is mapped to DST.* in MAP statement.
ALTER SESION SET CURRENT_SCHEMA=DST;
-- Create the first TAB table in the DST schema, using the DST session schema.
CREATE TABLE DST.tab (X NUMBER);
-- Restore Replicat schema.
ALTER SESSION SET CURRENT_SCHEMA=REPUSER
-- Set session schema to SRC, because TAB in the AS SELECT is unqualified-- and SRC is the source session schema.
ALTER SESION SET CURRENT_SCHEMA=SRC;
-- Create DST1.TAB AS SELECT * from SRC.TAB (SRC=current session schema).
CREATE TABLE DST1.tab (X NUMBER) AS SELECT * FROM tab;
-- SRC.TAB does not exist.
-- Abend with an error unless the error is handled by a DDLERROR statement.

例2   

次に、DEFAULTUSERPASSWORDALIASを使用して、レプリケートされる{CREATE | ALTER} USER name IDENTIFIED BY password文にソース文で使用されたものとは異なるパスワードを指定する方法を示します。この例では、別名ddlaliasが資格証明ストアのtargetドメインにあります。

DDLOPTIONS DEFAULTUSERPASSWORDALIAS ddlalias DOMAIN target