When to use USING on DELETE could use more clarity

agora inbox for pgsql-docs@postgresql.org  
help / color / mirror / Atom feed

From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: eric+postgresql.org@tinnaeus.com
Subject: When to use USING on DELETE could use more clarity
Date: Fri, 07 Feb 2025 17:23:12 +0000
Message-ID: <173894899293.1067.15761499536160191279@wrigleys.postgresql.org> (raw)

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/sql-delete.html
Description:

Referring to this page of the docs:
   https://www.postgresql.org/docs/current/sql-delete.html

This comment is at the bottom of the Notes section:
   "In some cases the join style is easier to write or faster to execute
than the sub-select style."

Feedback:
1. Nitpicky: Given the flow of this section, I'd suggest replacing the words
"the join style" with "the USING style" to help with clarity for newbies.
2. Far more importantly: I'm sure this comment is true and accurate, but "In
some cases" doesn't tell me much.  I've actually come to this page
specifically in search of that information, and it isn't here.  In which
cases would my code operate better with USING than with a sub-select?  I
assume there must be a reason USING was created as a non-standard extension
feature just for Postgres, but what is that reason?

Thanks!
Eric

Message-ID: <173894899293.1067.15761499536160191279@wrigleys.postgresql.org>
Permalink:  ../173894899293.1067.15761499536160191279@wrigleys.postgresql.org/
Also on:    postgresql.org/message-id/173894899293.1067.15761499536160191279@wrigleys.postgresql.org

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, eric+postgresql.org@tinnaeus.com
  Subject: Re: When to use USING on DELETE could use more clarity
  In-Reply-To: <173894899293.1067.15761499536160191279@wrigleys.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox