pgsql: Improve the documentation about commit_delay.

Поиск
Список
Период
Сортировка
От Tom Lane
Тема pgsql: Improve the documentation about commit_delay.
Дата
Msg-id E1UGcO6-0000XG-Hc@gemulon.postgresql.org
обсуждение исходный текст
Список pgsql-committers
Improve the documentation about commit_delay.

Clarify the docs explaining what commit_delay does, and add a
recommendation about a useful value for it, namely half of the single-page
fsync time reported by pg_test_fsync.  This is informed by testing of
the new-in-9.3 implementation of commit_delay; in prior versions it
was far harder to arrive at a useful setting.

In passing, do some wordsmithing and markup-fixing in the same general
area.

Also, change pg_test_fsync's default time-per-test from 2 seconds to 5.
The old value was about the minimum at which the results could be taken
seriously at all, and so seems a tad optimistic as a default.

Peter Geoghegan, reviewed by Noah Misch; some additional editing by me

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/70ec2f8f4392f4e3d379c2c759789d631ffeec10

Modified Files
--------------
contrib/pg_test_fsync/pg_test_fsync.c |    2 +-
doc/src/sgml/config.sgml              |    9 +-
doc/src/sgml/pgtestfsync.sgml         |    8 +-
doc/src/sgml/wal.sgml                 |  169 +++++++++++++++++++++------------
4 files changed, 118 insertions(+), 70 deletions(-)


В списке pgsql-committers по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: pgsql: Improve error reporting in code that checks for buffer refcount
Следующее
От: Peter Eisentraut
Дата:
Сообщение: Re: pgsql: Correct tense in log message