Re: [DOCS] Confused about a statement in WAL configs - Mailing list pgsql-docs

From David G. Johnston
Subject Re: [DOCS] Confused about a statement in WAL configs
Date
Msg-id CAKFQuwZ1+1XF-JZktOShmSKmxdLBw4aCHK0Hj1GoP3BaCXKV9Q@mail.gmail.com
Whole thread Raw
In response to [DOCS] Confused about a statement in WAL configs  (finzelj@gmail.com)
Responses Re: [DOCS] Confused about a statement in WAL configs  (Jeremy Finzel <finzelj@gmail.com>)
List pgsql-docs
On Mon, Jul 31, 2017 at 6:16 AM, <finzelj@gmail.com> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.6/static/wal-configuration.html
Description:

In this section:

&quot;At checkpoint time, all dirty data pages are flushed to disk and a special
checkpoint record is written to the log file. (The change records were
previously flushed to the WAL files.)&quot;

I am confused by what the part in parenthesis means by &quot;previously&quot;.  This
may only reflect my ignorance, but I don&#39;t know if &quot;previously&quot; means &quot;in
previous versions of Postgres&quot; or &quot;before the checkpoint&quot; or something
else.

Mostly because of this, I don&#39;t understand what this statement means.  Thank
you.

​"previously" in that sentence means "earlier in time".  The "WAL files" are written to during every COMMIT.  They constitute a journal of changes that affected the in-memory "pages" and made them "dirty".  During a checkpoint a marker entry is written that says a checkpoint has occurred and that every change noted in the WAL files written before the marker entry and now known to exist in the actual data files on disk.  Until that happens some of those change may only exist in memory (in the form of dirty data pages).

David J.​

pgsql-docs by date:

Previous
From: finzelj@gmail.com
Date:
Subject: [DOCS] Confused about a statement in WAL configs
Next
From: Peter Eisentraut
Date:
Subject: Re: [DOCS] remove shmmax example in Linux section