2.11.8 SQLログ機能

JPAの機能を使用しているアプリケーションの調査やチューニングでInterstage永続性プロバイダが発行しているSQL文を確認するため、SQLログ機能を使用できます。SQLログを使用すると、Interstage永続性プロバイダはSQL文を発行する時に、またはSQL文の発行時に例外が発生するときに、SQL文と動的パラメタをログに出力します。

SQLログは、以下の永続性ユニットプロパティにより設定します。

永続性ユニットプロパティ名	値(太字:省略値)	説明
toplink.logging.level.sql	FINE	SQL文をサーバーログに出力します。
	CONFIG	例外が発生する場合だけSQL文をサーバーログに出力します。
	INFO	SQL文をサーバーログに出力しません。

値は、大文字と小文字を区別しません。

永続性ユニットプロパティをdeployment descriptor (persistence.xml)、またはエンティティマネージャファクトリの取得時にjavax.persistence.PersistenceのcreateEntityManagerFactory(String, Map)メソッドに指定します。
永続性ユニットプロパティをdeployment descriptor (persistence.xml)とcreateEntityManagerFactoryメソッドの両方に指定した場合、createEntityManagerFactoryメソッドに指定した設定を優先します。

例

SQLログの設定例を以下に示します。

  <persistence xmlns="http://java.sun.com/xml/ns/persistence"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
                   http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"
               version="1.0">
    <persistence-unit name="com.company.my.pu">
      <jta-data-source>jdbc/myDatasource</jta-data-source>
      <properties>
        <property name="toplink.logging.level.sql" value="FINE"/>
      </properties>
    </persistence-unit>
  </persistence>

例

FINEを指定した場合のサーバーログへのSQLログ出力例を以下に示します。

[12/01/2011 11:20:31.296 +0800] ISJEE: INFO: ISJEE_JPA0021: SQL statement=INSERT INTO EJB_PERSON (NAME, HOBBY) VALUES (?, ?)
bind => [Henrry_EJB_JPA, football]: ThreadID=63,ThreadName=p: thread-pool-1; w: 17
[12/01/2011 11:20:31.296 +0800] ISJEE: WARNING: ISJEE_JPA0020: caught throwable: ThreadID=63,ThreadName=p: thread-pool-1; w: 17
Local Exception Stack: 
Exception [TOPLINK-4002] (Oracle TopLink Essentials - 2.1 (Build SNAPSHOT (12/31/2010))): oracle.toplink.essentials.exceptions.DatabaseException
Internal Exception: java.sql.SQLException: [SymfoWARE ODBC Driver][SymfoWARE Server] JYP7203E 表“EJB_PERSON”が存在しません．
Error Code: -7203
Call: INSERT INTO EJB_PERSON (NAME, HOBBY) VALUES (?, ?)
         bind => [Henrry_EJB_JPA, football]
Query: InsertObjectQuery(com.fnst.jpa.entity.Person@1c42452)

本機能をJava SEスタンドアローンアプリケーションで使用する場合、本プロパティを、Java VMオプションとして設定できます。Java VMオプションとcreateEntityManagerFactoryメソッドの両方に指定した場合、createEntityManagerFactoryメソッドに指定した設定を優先します。また、Java VMオプションとdeployment descriptor (persistence.xml)の両方に指定した場合、deployment descriptor (persistence.xml)に指定した設定を優先します。

例

Java SE環境のSQLログ出力例を以下に示します。

[TopLink Fine]: 2008.01.14 05:24:49.125--ClientSession(25709120)--Connection(127
74933)--JPA0021: SQL statement=SELECT ID, NAME FROM CUSTOMER WHERE (NAME = ?)
        bind => [Tarou]