Skip to content

Commit 74f24a3

Browse files
author
chegong18
committed
Update ref/pg_basebackup.sgml -200605
——row303至307,调整英文内容为: Create <filename>standby.signal</filename> and append connection settings to <filename>postgresql.auto.conf</filename> in the output directory (or into the base archive file when using tar format) to ease setting up a standby server. The <filename>postgresql.auto.conf</filename> file will record the connection ——row538至539,调整翻译内容为: 在输出目录中(或者当使用 tar 格式时再基础归档文件中)建立 <filename>standby.signal</filename> 并附加连接设置到<filename>postgresql.auto.conf</filename> 来简化设置一个后备服务器。 <filename>postgresql.auto.conf</filename>文件将记录连接设置(如果有)以及<application>pg_basebackup</application>所使用的复制槽,这样流复制后面就会使用相同的设置。 ——row746,调整英文内容为: in <xref linkend="guc-primary-slot-name"/>. That way, it is ensured that ——row888,调整翻译内容为: 这个选项仅能与<literal>-X stream</literal>一起使用。它导致WAL流使用指定的复制槽。如果该基础备份的目的是被用作一台使用复制槽的流复制后备,则它应该使用与<xref linkend="guc-primary-slot-name"/>中相同的复制槽名称。通过这种方式,可以确保服务器不会移除位于该基础备份结束与流复制开始之间产生的任何所需的WAL数据。 ——row805至806,增加英文内容为: Checksum verifications failures will also be reported in the <xref linkend="pg-stat-database-view"/> view. ——row932,增加翻译内容为: 校验和验证失败也将报告在<xref linkend="pg-stat-database-view"/>视图中。 ——row1208至1218,增加英文和翻译内容为: <!--==========================orignal english content========================== <para> The environment variable <envar>PG_COLOR</envar> specifies whether to use color in diagnostics messages. Possible values are <literal>always</literal>, <literal>auto</literal>, <literal>never</literal>. </para> ____________________________________________________________________________--> <para> 环境变量<envar>PG_COLOR</envar>规定在诊断消息中是否使用颜色。可能的值为<literal>always</literal>、 <literal>auto</literal>和<literal>never</literal>。 </para>
1 parent b09bedd commit 74f24a3

File tree

1 file changed

+28
-13
lines changed

1 file changed

+28
-13
lines changed

postgresql/doc/src/sgml/ref/pg_basebackup.sgml

Lines changed: 28 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ____________________________________________________________________________-->
1212
<indexterm zone="app-pgbasebackup">
1313
<primary>pg_basebackup</primary>
1414
</indexterm>
15-
15+
1616
<!--==========================orignal english content==========================
1717
<refmeta>
1818
<refentrytitle>pg_basebackup</refentrytitle>
@@ -300,10 +300,11 @@ ____________________________________________________________________________-->
300300
<listitem>
301301

302302
<para>
303-
Write a minimal <filename>recovery.conf</filename> in the output
303+
Create <filename>standby.signal</filename> and append connection settings
304+
to <filename>postgresql.auto.conf</filename> in the output
304305
directory (or into the base archive file when using tar format) to
305306
ease setting up a standby server.
306-
The <filename>recovery.conf</filename> file will record the connection
307+
The <filename>postgresql.auto.conf</filename> file will record the connection
307308
settings and, if specified, the replication slot
308309
that <application>pg_basebackup</application> is using, so that the
309310
streaming replication will use the same settings later on.
@@ -412,7 +413,7 @@ ____________________________________________________________________________-->
412413
</para>
413414
<para>
414415
When tar format mode is used, the write-ahead log files will be
415-
written to a separate file named <filename>pg_wal.tar</filename>
416+
written to a separate file named <filename>pg_wal.tar</filename>
416417
(if the server is a version earlier than 10, the file will be named
417418
<filename>pg_xlog.tar</filename>).
418419
</para>
@@ -511,7 +512,7 @@ ____________________________________________________________________________-->
511512
</variablelist></para>
512513
</listitem>
513514
</varlistentry>
514-
515+
515516
<varlistentry>
516517
<term><option>-r <replaceable class="parameter">rate</replaceable></option></term>
517518
<term><option>--max-rate=<replaceable class="parameter">rate</replaceable></option></term>
@@ -534,12 +535,13 @@ ____________________________________________________________________________-->
534535
<listitem>
535536

536537
<para>
537-
在输出目录中(或者当使用 tar 格式时再基础归档文件中)写一个最小的<filename>recovery.conf</filename>来简化设置一个后备服务器。<filename>recovery.conf</filename>文件将记录连接设置(如果有)以及<application>pg_basebackup</application>所使用的复制槽,这样流复制后面就会使用相同的设置。
538+
在输出目录中(或者当使用 tar 格式时再基础归档文件中)建立 <filename>standby.signal</filename> 并附加连接设置到<filename>postgresql.auto.conf</filename> 来简化设置一个后备服务器。
539+
<filename>postgresql.auto.conf</filename>文件将记录连接设置(如果有)以及<application>pg_basebackup</application>所使用的复制槽,这样流复制后面就会使用相同的设置。
538540
</para>
539541

540542
</listitem>
541543
</varlistentry>
542-
544+
543545
<varlistentry>
544546
<term><option>-T <replaceable class="parameter">olddir</replaceable>=<replaceable class="parameter">newdir</replaceable></option></term>
545547
<term><option>--tablespace-mapping=<replaceable class="parameter">olddir</replaceable>=<replaceable class="parameter">newdir</replaceable></option></term>
@@ -583,6 +585,7 @@ ____________________________________________________________________________-->
583585
</para>
584586
</listitem>
585587
</varlistentry>
588+
586589
<varlistentry>
587590
<term><literal>f</literal></term>
588591
<term><literal>fetch</literal></term>
@@ -741,7 +744,7 @@ ____________________________________________________________________________-->
741744
replication slot. If the base backup is intended to be used as a
742745
streaming replication standby using replication slots, it should then
743746
use the same replication slot name
744-
in <filename>recovery.conf</filename>. That way, it is ensured that
747+
in <xref linkend="guc-primary-slot-name"/>. That way, it is ensured that
745748
the server does not remove any necessary WAL data in the time between
746749
the end of the base backup and the start of streaming replication.
747750
</para>
@@ -800,7 +803,8 @@ ____________________________________________________________________________-->
800803
By default, checksums are verified and checksum failures will result
801804
in a non-zero exit status. However, the base backup will not be
802805
removed in such a case, as if the <option>-&minus;no-clean</option> option
803-
had been used.
806+
had been used. Checksum verifications failures will also be reported
807+
in the <xref linkend="pg-stat-database-view"/> view.
804808
</para>
805809
</listitem>
806810
</varlistentry>
@@ -883,7 +887,7 @@ ____________________________________________________________________________-->
883887
<term><option>--slot=<replaceable class="parameter">slotname</replaceable></option></term>
884888
<listitem>
885889
<para>
886-
这个选项仅能与<literal>-X stream</literal>一起使用。它导致WAL流使用指定的复制槽。如果该基础备份的目的是被用作一台使用复制槽的流复制后备,则它应该使用与<filename>recovery.conf</filename>中相同的复制槽名称。通过这种方式,可以确保服务器不会移除位于该基础备份结束与流复制开始之间产生的任何所需的WAL数据。
890+
这个选项仅能与<literal>-X stream</literal>一起使用。它导致WAL流使用指定的复制槽。如果该基础备份的目的是被用作一台使用复制槽的流复制后备,则它应该使用与<xref linkend="guc-primary-slot-name"/>中相同的复制槽名称。通过这种方式,可以确保服务器不会移除位于该基础备份结束与流复制开始之间产生的任何所需的WAL数据。
887891
</para>
888892
<para>
889893
指定的复制槽必须已经存在,除非同时使用了选项<option>-C</option>。
@@ -926,7 +930,7 @@ ____________________________________________________________________________-->
926930
如果在取基础备份的服务器上启用了校验码验证,则禁用校验码验证。
927931
</para>
928932
<para>
929-
默认情况下,校验码会被验证并且校验码失败将会导致一种非零的退出状态。不过,基础备份在这种情况下将不会被移除,就好像使用了<option>--no-clean</option>选项一样。
933+
默认情况下,校验码会被验证并且校验码失败将会导致一种非零的退出状态。不过,基础备份在这种情况下将不会被移除,就好像使用了<option>--no-clean</option>选项一样。校验和验证失败也将报告在<xref linkend="pg-stat-database-view"/>视图中。
930934
</para>
931935
</listitem>
932936
</varlistentry>
@@ -1202,6 +1206,17 @@ ____________________________________________________________________________-->
12021206
和大部分其他<productname>PostgreSQL</productname>工具相似,这个工具也使用<application>libpq</application>(见<xref linkend="libpq-envars"/>)支持的环境变量。
12031207
</para>
12041208

1209+
<!--==========================orignal english content==========================
1210+
<para>
1211+
The environment variable <envar>PG_COLOR</envar> specifies whether to use
1212+
color in diagnostics messages. Possible values are
1213+
<literal>always</literal>, <literal>auto</literal>,
1214+
<literal>never</literal>.
1215+
</para>
1216+
____________________________________________________________________________-->
1217+
<para>
1218+
环境变量<envar>PG_COLOR</envar>规定在诊断消息中是否使用颜色。可能的值为<literal>always</literal>、 <literal>auto</literal>和<literal>never</literal>。
1219+
</para>
12051220
</refsect1>
12061221

12071222
<refsect1>
@@ -1253,7 +1268,7 @@ ____________________________________________________________________________-->
12531268
<para>
12541269
表空间默认将以普通格式备份到与它们在服务器上相同的路径中,除非使用了<literal>--tablespace-mapping</literal>选项。如果没有这个选项并且表空间正在使用,在同一台服务器上进行普通格式的基础备份将无法工作,因为备份必须要写入到与原始表空间相同的目录位置。
12551270
</para>
1256-
1271+
12571272
<!--==========================orignal english content==========================
12581273
<para>
12591274
When tar format mode is used, it is the user's responsibility to unpack each
@@ -1351,7 +1366,7 @@ ____________________________________________________________________________-->
13511366
</screen>
13521367
(如果在该数据库中有多个表空间,这个命令将失败)。
13531368
</para>
1354-
1369+
13551370
<!--==========================orignal english content==========================
13561371
<para>
13571372
To create a backup of a local database where the tablespace in

0 commit comments

Comments
 (0)