From 8fbf5cf89030dc486f1a47e90a74ff1857020503 Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Mon, 18 Aug 2014 17:29:51 +0200
Subject: [PATCH] [#3519] Document the PostgreSQL JDBC's limitations with
 respect to large cursors when using Connection.autoCommit = true

---
 jOOQ/src/main/java/org/jooq/ResultQuery.java | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/jOOQ/src/main/java/org/jooq/ResultQuery.java b/jOOQ/src/main/java/org/jooq/ResultQuery.java
index d924ab9381..c0a23319c7 100644
--- a/jOOQ/src/main/java/org/jooq/ResultQuery.java
+++ b/jOOQ/src/main/java/org/jooq/ResultQuery.java
@@ -41,6 +41,7 @@
 
 package org.jooq;
 
+import java.sql.Connection;
 import java.sql.PreparedStatement;
 import java.sql.ResultSet;
 import java.sql.Statement;
@@ -1402,6 +1403,13 @@ public interface ResultQuery<R extends Record> extends Query {
      * Regardless of this setting, {@link #fetchLazy()} is the only way in jOOQ
      * not to fetch all data in memory. However, you may influence how your JDBC
      * driver interacts with your database through specifying a fetch size.
+     * <p>
+     * Note that some databases (in particular PostgreSQL) do not like fetch
+     * sizes being combined with
+     * <code>{@link Connection#getAutoCommit()} == true</code>. For more
+     * information, see <a href=
+     * "http://jdbc.postgresql.org/documentation/head/query.html#query-with-cursor"
+     * >this page here</a>
      *
      * @see Statement#setFetchSize(int)
      */