Oracle® Fusion Middleware Oracle WebLogic Server タイプ4 JDBCドライバ 11g リリース1(10.3.3) B61001-01 |
|
前 |
WebLogic JDBC SpyはWebLogic タイプ4 JDBCドライバをラップするラッパーです。アプリケーションによって発行されたJDBC呼出しに関する詳細情報をログに記録して、その呼出しをラップされたWebLogic タイプ4 JDBCドライバに渡します。このログの情報は、アプリケーションの問題を解決するために使用できます。WebLogic JDBC Spyを使用する利点は以下のとおりです。
ロギングはJDBC 4.0に準拠しています。
ロギングはすべてのWebLogic タイプ4 JDBCドライバで動作します。
ロギングはどのWebLogic タイプ4 JDBCドライバを使用する場合でも一貫性があります。
JDBC呼出しのすべてのパラメータと関数の結果をログに記録できます。
WebLogic Server構成のJDBCデータ・ソースを変更することで、アプリケーションを変更せずにロギングを有効にできます。
注意: WebLogic JDBC Spyは標準のJDBC APIのみを実装します。他のWebLogic タイプ4 JDBCドライバで実装されるJDBC拡張機能は実装していません。アプリケーションでJDBC拡張機能を使用する場合、WebLogic JDBC Spyを使用するとエラーが発生するおそれがあります。 |
WebLogic ServerでWebLogic JDBC Spyを使用するには、JDBCデータ・ソース構成のURLの末尾にJDBC Spy属性を追加します。
注意: wlspy.jar は非推奨です。現在、この機能はドライバjarファイルに組み込まれていて、SpyAttributes接続パラメータを設定して有効化できます。 |
データ・ソースの構成を修正するには、次の手順に従います。
WebLogicドメインのWebLogic Server管理コンソールまたは構成ファイルで、データ・ソースのURLにWebLogic JDBC Spyのオプションを付加します。JDBC Spyオプションをセミコロンで区切って、1組のカッコ内にすべてのオプションを含めます。
管理コンソールの「ドメイン構成」>「データ・ソース」で、spyを有効にする特定のデータ・ソースを選択します。「接続プール」タブを開き、既存のURLの最後にspyAttributes
を追加します。例:
jdbc:weblogic:DB2://db2host:50000;spyAttributes=(log=(file)d:\spy.log;timestamp=yes)
または、datasource_name
-jdbc.xml
ファイルで、JDBCデータ・ソースのエントリのURLを更新します。例:
<jdbc-driver-params>
<url>jdbc:weblogic:db2://bangpcdb2:50000;spyAttributes=(log=(file)db2-spy.out;load=weblogic.jdbc.db2.DB2Driver;timestamp=yes)
</url>
<driver-name>weblogic.jdbc.db2.DB2Driver</driver-name>
<properties>
<property>
<name>user</name>
<value>john</value>
</property>
<property>
<name>portNumber</name>
<value>50000</value>
</property>
<property>
<name>databaseName</name>
<value>wls</value>
</property>
<property>
<name>serverName</name>
<value>db2host</value>
</property>
<property>
<name>batchPerformanceWorkaround</name>
<value>true</value>
</property>
</properties>
<password-encrypted>{3DES}hqKps8ozo98=</password-encrypted>
</jdbc-driver-params>
WebLogic Serverを停止して再起動します。
表D-1に、WebLogic JDBC Spy構成で使用できるオプションを示します。これらのオプションを、XAドライバの場合はspyAttributesプロパティの属性として、非XAドライバの場合はURL内の属性として使用します。
表D-1 WebLogic JDBC SpyのURL属性
キーと値の組み合わせ | 説明 |
---|---|
log=System.out |
ロギングをJava標準出力にリダイレクトします。 |
log=(file)filename |
ロギングをfilenameで指定されるファイルにリダイレクトします。デフォルトでは、WebLogic JDBC Spyは |
load=classname |
classnameで指定されるドライバをロードします。 |
linelimit=numberofchars |
WebLogic JDBC Spyが1行に記録する最大文字数をnumberofcharsで指定します。デフォルトは0(最大値の制限なし)です。 |
logIS={ |
WebLogic JDBC Spyが
デフォルトは |
logTName={ |
WebLogic JDBC Spyが現在のスレッドの名前をログに記録するかどうかを指定します。デフォルトは |
timestamp={ |
WebLogic JDBC Spyのログの各行にタイムスタンプを含めるかどうかを指定します。 |
例の下にある「注意」で該当するテキストを参照してください。
例D-1 WebLogic JDBC Spyのログの例
All rights reserved.Foot 1 registerDriver:driver[className=weblogic.jdbcspy.SpyDriver, context=null,weblogic.jdbcspy.SpyDriver@1ec49f]Foot 2 *Driver.connect(jdbc:spy:{jdbc:weblogic:sqlserver://QANT:4003; databaseName=Test;}) trying driver[className=weblogic.jdbcspy.SpyDriver, context=null,weblogic.jdbcspy.SpyDriver@1ec49f]Foot 3 spy>> Driver.connect(String url, Properties info) spy>> url = jdbc:spy:{jdbc:weblogic:sqlserver://QANT:4003;databaseName=Test; OSUser=qauser;OSPassword=null12} spy>> info = {password=tiger, user=scott} spy>> OK (Connection[1])Foot 4 getConnection returning driver[className=weblogic.jdbcspy.SpyDriver, context=null,weblogic.jdbcspy.SpyDriver@1ec49f]Foot 5 spy>> Connection[1].getWarnings() spy>> OKFoot 6 spy>> Connection[1].createStatement spy>> OK (Statement[1])Foot 7 spy>> Statement[1].executeQuery(String sql) spy>> sql = select empno,ename,job from emp where empno=7369 spy>> OK (ResultSet[1])Foot 8 spy>> ResultSet[1].getMetaData() spy>> OK (ResultSetMetaData[1])Foot 9 spy>> ResultSetMetaData[1].getColumnCount() spy>> OK (3)Foot 10 spy>> ResultSetMetaData[1].getColumnLabel(int column) spy>> column = 1 spy>> OK (EMPNO)Foot 11 spy>> ResultSetMetaData[1].getColumnLabel(int column) spy>> column = 2 spy>> OK (ENAME)Foot 12 spy>> ResultSetMetaData[1].getColumnLabel(int column) spy>> column = 3 spy>> OK (JOB)Foot 13 spy>> ResultSet[1].next() spy>> OK (true)Foot 14 spy>> ResultSet[1].getString(int columnIndex) spy>> columnIndex = 1 spy>> OK (7369)Foot 15 spy>> ResultSet[1].getString(int columnIndex) spy>> columnIndex = 2 spy>> OK (SMITH)Foot 16 spy>> ResultSet[1].getString(int columnIndex) spy>> columnIndex = 3 spy>> OK (CLERK)Foot 17 spy>> ResultSet[1].next() spy>> OK (false)Foot 18 spy>> ResultSet[1].close() spy>> OKFoot 19 spy>> Connection[1].close() spy>> OKFoot 20
脚注
脚注1 : WebLogic JDBC Spyは登録されています。spy>>接頭辞は、この行がBEA WebLogic JDBC Spyによってログに記録されたことを表します。