説明
TRACE
およびTRACE2
パラメータでは、処理のボトルネックの把握に役立つ、ExtractまたはReplicatの処理情報を取得します。両パラメータとも、DMLおよびDDLのトレースをサポートしています。
またトレースは、GGSCIのSEND EXTRACT
またはSEND REPLICAT
コマンドを使用して、有効化と無効化を切り替えることもできます。「SEND EXTRACT」または「SEND REPLICAT」を参照してください。
トレースによって重大な処理のボトルネックが明らかになった場合は、Oracleサポートに連絡してください。
構文
TRACE | TRACE2 [, DDL[INCLUDE] | DDLONLY] [, [FILE] file_name] [, THREADS (threadID
[,threadID
][, ...][,thread_range
[,thread_range
][, ...])]
TRACE
ステップバイステップの処理情報を提供します。
TRACE2
ExtractまたはReplicatがほとんどの時間を費やしているコード・セグメントを特定します。
DDL[INCLUDE] | DDLONLY
(Replicatのみ) DDLトレースを有効化し、トレース・レポートにDDLトレースを取得する方法を指定します。
DDL[INCLUDE]
DDLのトレースに加え、トランザクション・データ処理もトレースします。これはデフォルトです。DDL
またはDDLINCLUDE
のいずれかが有効です。
DDLONLY
DDLをトレースし、トランザクション・データはトレースしません。
[FILE]
file_name
Oracle GoldenGateのトレース情報の記録先ファイルの相対名または完全修飾名。FILE
キーワードはオプションですが、次の例のように、ファイル名の後に他のパラメータ・オプションを指定する場合は使用する必要があります。
TRACE FILE file_name DDLINCLUDE
次の例のように、ファイル名の後に他のオプションを指定しない場合は、FILE
キーワードを省略できます。
TRACE DDLINCLUDE file_name
THREADS (
threadID
[,
threadID
][, ...][,
thread_range
[,
thread_range
][, ...]
)
調整Replicatの指定した1つまたは複数のスレッドに対してのみトレースを有効にします。トレースは、実行時にアクティブなスレッドに対してのみ実行されます。
threadID
[,
threadID
][, ...]
スレッドIDを指定するか、スレッドのカンマ区切りリストをthreadID, threadID, threadID
の形式で指定します。
[,
thread_range
[,
thread_range
][, ...]
スレッドの範囲をthreadIDlow-threadIDhigh
の形式で指定するか、範囲のカンマ区切りリストをthreadIDlow-threadIDhigh
, threadIDlow-threadIDhigh
の形式で指定します。
threadID, threadID, threadIDlow-threadIDhigh
のように、これらの形式を組み合せることができます。
Replicatが調整モードで、TRACE
がTHREADS
リストまたは範囲とともに使用されている場合は、現在アクティブな各スレッドのトレース・ファイルが作成されます。各ファイル名には、関連付けられているスレッドIDが追加されます。このスレッドIDによるトレース・ファイル識別方法は、SEND REPLICAT
が(SEND REPLICAT fin003
TRACE
...のように) groupname
とthreadID
によって発行される場合、または1つのスレッドのみがTHREADS
で指定されている場合には適用されません。
トレースによって重大な処理のボトルネックが明らかになった場合は、Oracleサポートに連絡してください。
例
次の例は、trace.trc
というファイルをトレースします。これが調整Replicatグループの場合、トレースはすべてのアクティブなスレッドに適用されます。
TRACE /home/ggs/dirrpt/trace.trc
次の例は、スレッド1に対してのみトレースを有効にします。この場合、1つのスレッドのみトレースされるため、トレース・ファイルにはthreadID
拡張子はありません。ファイル名はtrace.trc
です。
TRACE THREADS(1) FILE ./dirrpt/trace.trc
次の例は、スレッド1、2および3のトレースを有効にします。すべてのスレッドがアクティブであると想定した場合、トレースはファイルtrace001
、trace002
およびtrace003
を生成します。
TRACE THREADS(1-3) FILE ./dirrpt/trace.trc