database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-27 12:41:57 +03:00
Code Activity

initdb: Add --no-sync-data-files.

Browse Source 
This new option instructs initdb to skip synchronizing any files
in database directories, the database directories themselves, and
the tablespace directories, i.e., everything in the base/
subdirectory and any other tablespace directories.  Other files,
such as those in pg_wal/ and pg_xact/, will still be synchronized
unless --no-sync is also specified.  --no-sync-data-files is
primarily intended for internal use by tools that separately ensure
the skipped files are synchronized to disk.  A follow-up commit
will use this to help optimize pg_upgrade's file transfer step.

The --sync-method=fsync implementation of this option makes use of
a new exclude_dir parameter for walkdir().  When not NULL,
exclude_dir specifies a directory to skip processing.  The
--sync-method=syncfs implementation of this option just skips
synchronizing the non-default tablespace directories.  This means
that initdb will still synchronize some or all of the database
files, but there's not much we can do about that.

Discussion: https://postgr.es/m/Zyvop-LxLXBLrZil%40nathan
This commit is contained in:
Nathan Bossart
2025-03-25 16:02:35 -05:00
parent 650ab8aaf1
commit cf131fa942
9 changed files with 99 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
doc/src/sgml/ref/initdb.sgml
View File

@ -527,6 +527,33 @@ PostgreSQL documentation
</listitem>
</varlistentry>
<varlistentry id="app-initdb-option-no-sync-data-files">
<term><option>--no-sync-data-files</option></term>
<listitem>
<para>
By default, <command>initdb</command> safely writes all database files
to disk. This option instructs <command>initdb</command> to skip
synchronizing all files in the individual database directories, the
database directories themselves, and the tablespace directories, i.e.,
everything in the <filename>base</filename> subdirectory and any other
tablespace directories. Other files, such as those in
<literal>pg_wal</literal> and <literal>pg_xact</literal>, will still be
synchronized unless the <option>--no-sync</option> option is also
specified.
</para>
<para>
Note that if <option>--no-sync-data-files</option> is used in
conjuction with <option>--sync-method=syncfs</option>, some or all of
the aforementioned files and directories will be synchronized because
<literal>syncfs</literal> processes entire file systems.
</para>
<para>
This option is primarily intended for internal use by tools that
separately ensure the skipped files are synchronized to disk.
</para>
</listitem>
</varlistentry>
<varlistentry id="app-initdb-option-no-instructions">
<term><option>--no-instructions</option></term>
<listitem>