Thread: Documenting MERGE INTO ONLY ...

Documenting MERGE INTO ONLY ...

From
Dean Rasheed
Date:
While testing MERGE, I noticed that it supports inheritance
hierarchies and the ONLY keyword, but that isn't documented. Attached
is a patch to merge.sgml, borrowing text from update.sgml and
delete.sgml.

I note that there are also a couple of places early in the manual
(advanced.sgml and ddl.sgml) that also discuss inheritance, citing
SELECT, UPDATE and DELETE as examples of (already-discussed) commands
that support ONLY. However, since MERGE isn't mentioned until much
later in the manual, it's probably best to leave those as-is. They
don't claim to be complete lists of commands supporting ONLY, and it
would be a pain to make them that.

Regards,
Dean

Attachment

Re: Documenting MERGE INTO ONLY ...

From
Nathan Bossart
Date:
On Thu, Dec 08, 2022 at 03:26:52PM +0000, Dean Rasheed wrote:
> While testing MERGE, I noticed that it supports inheritance
> hierarchies and the ONLY keyword, but that isn't documented. Attached
> is a patch to merge.sgml, borrowing text from update.sgml and
> delete.sgml.

LGTM.  I didn't see any tests for this in merge.sql or inherit.sql.  Do you
think we should add some?

-- 
Nathan Bossart
Amazon Web Services: https://aws.amazon.com



Re: Documenting MERGE INTO ONLY ...

From
Alvaro Herrera
Date:
On 2022-Dec-08, Nathan Bossart wrote:

> On Thu, Dec 08, 2022 at 03:26:52PM +0000, Dean Rasheed wrote:
> > While testing MERGE, I noticed that it supports inheritance
> > hierarchies and the ONLY keyword, but that isn't documented. Attached
> > is a patch to merge.sgml, borrowing text from update.sgml and
> > delete.sgml.
> 
> LGTM.

LGTM2.

> I didn't see any tests for this in merge.sql or inherit.sql.  Do you
> think we should add some?

Ouch!  We should definitely have some.

-- 
Álvaro Herrera               48°01'N 7°57'E  —  https://www.EnterpriseDB.com/



Re: Documenting MERGE INTO ONLY ...

From
Dean Rasheed
Date:
On Fri, 9 Dec 2022 at 10:02, Alvaro Herrera <alvherre@alvh.no-ip.org> wrote:
>
> On 2022-Dec-08, Nathan Bossart wrote:
>
> > On Thu, Dec 08, 2022 at 03:26:52PM +0000, Dean Rasheed wrote:
> > > While testing MERGE, I noticed that it supports inheritance
> > > hierarchies and the ONLY keyword, but that isn't documented. Attached
> > > is a patch to merge.sgml, borrowing text from update.sgml and
> > > delete.sgml.
> >
> > LGTM.
>
> LGTM2.
>
> > I didn't see any tests for this in merge.sql or inherit.sql.  Do you
> > think we should add some?
>
> Ouch!  We should definitely have some.
>

Agreed. I just pushed this, with some additional tests.

Regards,
Dean