Re: Document atthasmissing default optimization avoids verification table scan - Mailing list pgsql-hackers

From James Coleman
Subject Re: Document atthasmissing default optimization avoids verification table scan
Date
Msg-id CAAaqYe-t0Xns=QMsoDWJWnX0g1Wv07ESL5i1u0-91xS9snXbvQ@mail.gmail.com
Whole thread Raw
In response to Re: Document atthasmissing default optimization avoids verification table scan  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Document atthasmissing default optimization avoids verification table scan
List pgsql-hackers
On Fri, Jan 21, 2022 at 5:38 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
>
> "David G. Johnston" <david.g.johnston@gmail.com> writes:
> > You've removed the "constraint verification scan" portion of this.
>
> Indeed, because that's got nothing to do with adding a new column
> (per se; adding a constraint along with the column is a different
> can of worms).

Yeah. Initially I'd thought I'd wanted it there, but by explicitly
linking people to the ALTER TABLE docs for more details (I've made
that a link now too) I'm now inclined to agree that tightly focusing
the tip is better form.

> > Re-reading this, the recommendation:
>
> > -     However, if the default value is volatile (e.g.,
> > -     <function>clock_timestamp()</function>)
> > -     each row will need to be updated with the value calculated at the time
> > -     <command>ALTER TABLE</command> is executed. To avoid a potentially
> > -     lengthy update operation, particularly if you intend to fill the
> > column
> > -     with mostly nondefault values anyway, it may be preferable to add the
> > -     column with no default, insert the correct values using
> > -     <command>UPDATE</command>, and then add any desired default as
> > described
> > -     below.
>
> > has now been completely removed from the documentation.
>
> Really?  That's horrid, because that's directly useful advice.

Remedied, but rewritten a bit to better fit with the new style/goal of
that tip).

Version 3 is attached.

James Coleman

Attachment

pgsql-hackers by date:

Previous
From: "Bossart, Nathan"
Date:
Subject: Re: do only critical work during single-user vacuum?
Next
From: vrund shah
Date:
Subject: Re: How to get started with contribution