mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-08-24 01:17:19 +02:00
Doc: improve documentation about postgresql.auto.conf.
Clarify what external tools can do to this file, and add a bit of detail about what ALTER SYSTEM itself does. Discussion: https://postgr.es/m/aed6cc9f-98f3-2693-ac81-52bb0052307e@2ndquadrant.com
This commit is contained in:
parent
32d38f54a3
commit
7f77f2aec3
@ -137,6 +137,8 @@ shared_buffers = 128MB
|
|||||||
identifiers or numbers must be single-quoted. To embed a single
|
identifiers or numbers must be single-quoted. To embed a single
|
||||||
quote in a parameter value, write either two quotes (preferred)
|
quote in a parameter value, write either two quotes (preferred)
|
||||||
or backslash-quote.
|
or backslash-quote.
|
||||||
|
If the file contains multiple entries for the same parameter,
|
||||||
|
all but the last one are ignored.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
@ -169,18 +171,29 @@ shared_buffers = 128MB
|
|||||||
In addition to <filename>postgresql.conf</filename>,
|
In addition to <filename>postgresql.conf</filename>,
|
||||||
a <productname>PostgreSQL</productname> data directory contains a file
|
a <productname>PostgreSQL</productname> data directory contains a file
|
||||||
<filename>postgresql.auto.conf</filename><indexterm><primary>postgresql.auto.conf</primary></indexterm>,
|
<filename>postgresql.auto.conf</filename><indexterm><primary>postgresql.auto.conf</primary></indexterm>,
|
||||||
which has the same format as <filename>postgresql.conf</filename> but should
|
which has the same format as <filename>postgresql.conf</filename> but
|
||||||
never be edited manually. This file holds settings provided through
|
is intended to be edited automatically not manually. This file holds
|
||||||
the <xref linkend="sql-altersystem"/> command. This file is automatically
|
settings provided through the <xref linkend="sql-altersystem"/> command.
|
||||||
read whenever <filename>postgresql.conf</filename> is, and its settings take
|
This file is read whenever <filename>postgresql.conf</filename> is,
|
||||||
effect in the same way. Settings in <filename>postgresql.auto.conf</filename>
|
and its settings take effect in the same way. Settings
|
||||||
override those in <filename>postgresql.conf</filename>.
|
in <filename>postgresql.auto.conf</filename> override those
|
||||||
|
in <filename>postgresql.conf</filename>.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
External tools may also
|
||||||
|
modify <filename>postgresql.auto.conf</filename>. It is not
|
||||||
|
recommended to do this while the server is running, since a
|
||||||
|
concurrent <command>ALTER SYSTEM</command> command could overwrite
|
||||||
|
such changes. Such tools might simply append new settings to the end,
|
||||||
|
or they might choose to remove duplicate settings and/or comments
|
||||||
|
(as <command>ALTER SYSTEM</command> will).
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The system view
|
The system view
|
||||||
<link linkend="view-pg-file-settings"><structname>pg_file_settings</structname></link>
|
<link linkend="view-pg-file-settings"><structname>pg_file_settings</structname></link>
|
||||||
can be helpful for pre-testing changes to the configuration file, or for
|
can be helpful for pre-testing changes to the configuration files, or for
|
||||||
diagnosing problems if a <systemitem>SIGHUP</systemitem> signal did not have the
|
diagnosing problems if a <systemitem>SIGHUP</systemitem> signal did not have the
|
||||||
desired effects.
|
desired effects.
|
||||||
</para>
|
</para>
|
||||||
|
Loading…
Reference in New Issue
Block a user