OPENJPA-1699: Add documentation for fully materialized LOB issue with streaming LOBs and DB2

git-svn-id: https://svn.apache.org/repos/asf/openjpa/trunk@1058756 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Michael Dick 2011-01-13 21:52:39 +00:00
parent d48bbbe6cd
commit d916e6feb8
1 changed files with 17 additions and 0 deletions

View File

@ -712,6 +712,23 @@ of DESCSTAT, DB2 metadata tables must be recreated by running the DSNTIJMS job.
See DB2 for z/OS documentation for additional information.
</para>
</listitem>
<listitem>
<para>
When using LOBs with persistent attributes of a streaming data type (e.g.
<literal>java.io.InputStream</literal>) in the case of very large lob, DB2 JCC
driver will automatically use progressive streaming to retrieve the Lob data.
With progressiveStreaming, the inputStream retrieved (see red below) must be
fully materialized before the next iteration of call to rs.next(). By default
this will result in a LobClosedException when OpenJPA processes the InputStream.
</para>
<para>
To work around this condition you may force fullyMaterializedLobData to true in
the connection URL as shown below :
<programlisting>
openjpa.ConnectionURL: jdbc:db2://localhost:50000/demodb:fullyMaterializeLobData=true;progressiveStreaming=NO
</programlisting>
</para>
</listitem>
</itemizedlist>
</section>
</section>