Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: <derby-dev@db.apache.org>
Message-ID: <643740982.1240850850302.JavaMail.jira@brutus>
Date: Mon, 27 Apr 2009 09:47:30 -0700 (PDT)
From: "Tiago R. Espinha (JIRA)" <jira@apache.org>
To: derby-dev@db.apache.org
Subject: [jira] Created: (DERBY-4192) OFFSET and FETCH FIRST documentation
 improvement
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

OFFSET and FETCH FIRST documentation improvement
------------------------------------------------

                 Key: DERBY-4192
                 URL: https://issues.apache.org/jira/browse/DERBY-4192
             Project: Derby
          Issue Type: Improvement
    Affects Versions: 10.5.1.1
            Reporter: Tiago R. Espinha
            Priority: Minor


I have a suggestion regarding the documentation for the OFFSET and FETCH FIRST documentation. On these documents, we have three SQL examples on the usage of these clauses. I suggest that we add a brief description of what each clause does.

This might help the users to have a better understanding at first of how the said clauses work.

Here are the examples with a possible description:

-- This query fetches the first row from T
SELECT * FROM T FETCH FIRST ROW ONLY;

-- This query skips the first 10 rows and fetches the following 10.
-- It will fetch rows 11 through 20 (inclusive) from the table T, sorted by I
SELECT * FROM T ORDER BY I OFFSET 10 ROWS FETCH NEXT 10 ROWS ONLY;

-- This query skips the first 100 rows from T.
-- If the table has less than 101 records, then an empty result set is returned.
SELECT * FROM T OFFSET 100 ROWS;

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.