traceLevel=value 属性

機能

トレースが有効になっているとき、Derbyのネットワーククライアントに適用されるトレースのレベルを指定します。valueは数値です。トレースのレベルを指定しない場合、規定はTRACE_ALLです。

トレースのより詳細な情報は、Derby サーバと管理ガイドの「ネットワーククライアントのトレース」を参照してください。また、トレースに関連した他の属性である、 traceFile=path、 traceFileAppend=trueおよび traceDirectory=pathを参照してください。

トレースのレベル

以下の表で設定できるトレースのレベルと、その値を示します。

表 1. Available tracing levels and values
トレースのレベル	16進数	10進数
org.apache.derby.jdbc.ClientDataSource.TRACE_NONE	0x0	0
org.apache.derby.jdbc.ClientDataSource.TRACE_CONNECTION_CALLS	0x1	1
org.apache.derby.jdbc.ClientDataSource.TRACE_STATEMENT_CALLS	0x2	2
org.apache.derby.jdbc.ClientDataSource.TRACE_RESULT_SET_CALLS	0x4	4
org.apache.derby.jdbc.ClientDataSource.TRACE_DRIVER_CONFIGURATION	0x10	16
org.apache.derby.jdbc.ClientDataSource.TRACE_CONNECTS	0x20	32
org.apache.derby.jdbc.ClientDataSource.TRACE_PROTOCOL_FLOWS	0x40	64
org.apache.derby.jdbc.ClientDataSource.TRACE_RESULT_SET_META_DATA	0x80	128
org.apache.derby.jdbc.ClientDataSource.TRACE_PARAMETER_META_DATA	0x100	256
org.apache.derby.jdbc.ClientDataSource.TRACE_DIAGNOSTICS	0x200	512
org.apache.derby.jdbc.ClientDataSource.TRACE_XA_CALLS	0x800	2048
org.apache.derby.jdbc.ClientDataSource.TRACE_ALL	0xFFFFFFFF	-1

トレースのレベルを複数指定する場合、以下の方法を使ってください。

ijを使っている場合、10進数を加算した合計値を指定してください。たとえば、プロトコルのフローと接続の呼び出しをトレースする場合、TRACE_PROTOCOL_FLOWS (64)とTRACE_CONNECTION_CALLS (1)の値を加算して、合計値の65を指定します。
JDBCによるプログラムを実行する場合、以下の方法を使ってください。
- ビット演算のOR演算子( | )を二つ以上のトレース値に使います。たとえばプロトコルのフローと接続の呼び出しをトレースする場合、次の値をトレースレベルに指定します。
```
TRACE_PROTOCOL_FLOWS | TRACE_CONNECTION_CALLS
```
- ビット演算の否定演算子( ~ )を特定のトレースを除外する場合に使います。たとえばプロトコルのフロー以外のすべてをトレースする場合、次の値をトレースレベルに指定します。
```
~TRACE_PROTOCOL_FLOWS
```

他の属性との組み合わせ

この属性を指定する場合、traceFile=path属性あるいはtraceDirectory=path属性を指定しなければなりません。

例

-- 新規データベースでのトレースを有効にする。
jdbc:derby://localhost:1527/mydb;create=true;traceFile=trace.out;traceLevel=65