From: | Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> |
---|---|
To: | Bruce Momjian <bruce(at)momjian(dot)us>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | pgsql-docs <pgsql-docs(at)postgresql(dot)org> |
Subject: | Re: updatable cursors and ORDER BY |
Date: | 2018-06-12 00:44:14 |
Message-ID: | b0af1f4a-b39f-5a18-fcd2-b4f2a4a0303e@2ndquadrant.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On 5/28/18 13:17, Bruce Momjian wrote:
> On Thu, May 10, 2018 at 12:55:23PM -0400, Tom Lane wrote:
>> Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> writes:
>>> I think that last part isn't actually written down anywhere. (It only
>>> states the converse.) How about a clarification like this:
>>
>>> @@ -271,7 +271,10 @@ <title id="sql-declare-notes-title">Notes</title>
>>> and not use grouping or <literal>ORDER BY</literal>). Cursors
>>> that are not simply updatable might work, or might not, depending on plan
>>> choice details; so in the worst case, an application might work in testing
>>> - and then fail in production.
>>> + and then fail in production. If <literal>FOR UPDATE</literal> is
>>> + specified, then the cursor is guaranteed to be updatable, or the
>>> + <command>DECLARE</command> command will error if an updatable cursor
>>> + cannot be created for the supplied query.
>>> </para>
>>
>> OK by me, except we don't usually use "error" as a verb. Either "fail"
>> or "throw an error" would read better IMO. Or you could just stop with
>> "guaranteed to be updatable"; I don't think the rest adds much.
>
> I have done as you suggested and just used the first part; patch
> attached and backpatched.
I think we should still add the second part, because it currently
doesn't say anything about that a cursor declaration might fail if an
updatable cursor cannot be created.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2018-06-12 02:59:28 | Re: updatable cursors and ORDER BY |
Previous Message | Michael Paquier | 2018-06-11 01:01:34 | Re: slight grammar error |