diff --git a/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml b/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml index cc6c071d1..6c557adfa 100644 --- a/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml +++ b/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml @@ -180,6 +180,22 @@ logged SQL statements. each pretty-printed SQL line. + + + + + SQL + + + PrintParameters + + +PrintParameters: A boolean indicating whether SQL parameter +values will be included in exception text and when logging is enabled. Since +the parameter values may contain sensitive information the default value is +false. + + @@ -193,7 +209,7 @@ each pretty-printed SQL line. <property name="openjpa.ConnectionURL" value="jdbc:hsqldb:db-hypersonic"/> <property name="openjpa.ConnectionDriverName" value="org.hsqldb.jdbcDriver"/> <property name="openjpa.ConnectionFactoryProperties" - value="PrettyPrint=true, PrettyPrintLineLength=80"/> + value="PrettyPrint=true, PrettyPrintLineLength=80, PrintParameters=true"/> diff --git a/openjpa-project/src/doc/manual/ref_guide_logging.xml b/openjpa-project/src/doc/manual/ref_guide_logging.xml index fd476c2df..bf48346c2 100644 --- a/openjpa-project/src/doc/manual/ref_guide_logging.xml +++ b/openjpa-project/src/doc/manual/ref_guide_logging.xml @@ -177,6 +177,16 @@ about possible performance concerns will be logged to the INFO use. Detailed information about the execution of SQL statements will be sent to the TRACE level. It is useful to enable this channel if you are curious about the exact SQL that OpenJPA issues to the datastore. + +The SQL issued to the database may contain sensitive information. By default the +parameter values used in the prepared statements generated by OpenJPA will not +be printed in the SQL log - instead you will see a ? for each value. The actual +values may be printed by adding PrintParameters=True to the + +openjpa.ConnectionFactoryProperties property. Also +see Using the OpenJPA +DataSource + When using the built-in OpenJPA logging facilities, you can enable SQL logging