Skip to content

Commit 597389d

Browse files
authored
Merge pull request #440 from 1030504258/master
校验文件完成
2 parents 7ff06f8 + f84aa6b commit 597389d

28 files changed

+312
-341
lines changed

postgresql/doc/src/sgml/adminpack.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ ________________________________________________________-->
4848
<para>
4949
<xref linkend="functions-adminpack-table"/> 中显示的函数提供了对托管服务器上文件的写入访问权限。
5050
(另请参阅 <xref linkend="functions-admin-genfile-table"/> 中的函数,这些函数提供只读访问权限。)
51-
只有数据库集群目录中的文件才能被访问,除非用户是超级用户或具有
51+
只有集簇目录中的文件才能被访问,除非用户是超级用户或具有
5252
<literal>pg_read_server_files</literal> 或
5353
<literal>pg_write_server_files</literal> 角色之一的权限,适用于该函数,但相对路径或绝对路径均可。
5454
</para>

postgresql/doc/src/sgml/advanced.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -846,7 +846,7 @@ ________________________________________________________-->
846846
4800 | 47100
847847
6000 | 47100
848848
5200 | 47100
849-
(10 )
849+
(10 rows)
850850
</screen>
851851
<!-- pgdoc-cn_end sig_en=7d69d86aed19838af3477eb62d6268c6 -->
852852

@@ -905,7 +905,7 @@ ________________________________________________________-->
905905
5200 | 41100
906906
5200 | 41100
907907
6000 | 47100
908-
(10 )
908+
(10 rows)
909909
</screen>
910910
<!-- pgdoc-cn_end sig_en=b442190722aef4e54a74082045fc03f6 -->
911911

postgresql/doc/src/sgml/amcheck.sgml

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -307,15 +307,10 @@ ________________________________________________________-->
307307
</para>
308308
________________________________________________________-->
309309
<para>
310-
<function>bt_index_parent_check</function>'s additional
311-
verification is more likely to detect various pathological
312-
cases. These cases may involve an incorrectly implemented
313-
B-Tree operator class used by the index that is checked, or,
314-
hypothetically, undiscovered bugs in the underlying B-Tree index
315-
access method code. Note that
316-
<function>bt_index_parent_check</function> cannot be used when
317-
hot standby mode is enabled (i.e., on read-only physical
318-
replicas), unlike <function>bt_index_check</function>.
310+
<function>bt_index_parent_check</function>的额外验证更有可能检测到各种病理情况。
311+
这些情况可能涉及到被检查的索引使用的 B-Tree 操作类的错误实现,或者假设性地底层 B-Tree 索引访问方法代码中未发现的bug。
312+
请注意,与<function>bt_index_parent_check</function>不同,
313+
当启用热备模式(即在只读物理副本上)时,不能使用<function>bt_index_check</function>。
319314
</para>
320315
<!-- pgdoc-cn_end sig_en=fd165459cf02c9eaff49bfcb9b16ce9e -->
321316
</listitem>
@@ -382,7 +377,7 @@ SET client_min_messages = DEBUG1;
382377
________________________________________________________-->
383378
<para>
384379
检查表、序列或物化视图的结构损坏,其中关系中的页面包含格式无效的数据,
385-
以及逻辑损坏,其中页面在结构上有效但与数据库集群的其余部分不一致
380+
以及逻辑损坏,其中页面在结构上有效但与集簇的其余部分不一致
386381
</para>
387382
<!-- pgdoc-cn_end sig_en=e61d42d351c3b596c688dc4ad56379c9 -->
388383
<!-- pgdoc-cn_start sig_en=5182bd18378f894f8d63b68c7e82018c sig_cn_org=None source=14.1

postgresql/doc/src/sgml/arch-dev.sgml

Lines changed: 5 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -913,23 +913,11 @@ ________________________________________________________-->
913913
</para>
914914
________________________________________________________-->
915915
<para>
916-
<command>INSERT ... SELECT</command> feeds the rows up
917-
to <literal>ModifyTable</literal> for insertion. For
918-
<command>UPDATE</command>, the planner arranges that each
919-
computed row includes all the updated column values, plus the
920-
<firstterm>TID</firstterm> (tuple ID, or row ID) of the original
921-
target row; this data is fed up to the <literal>ModifyTable</literal>
922-
node, which uses the information to create a new updated row and
923-
mark the old row deleted. For <command>DELETE</command>, the only
924-
column that is actually returned by the plan is the TID, and the
925-
<literal>ModifyTable</literal> node simply uses the TID to visit each
926-
target row and mark it deleted. For <command>MERGE</command>, the
927-
planner joins the source and target relations, and includes all
928-
column values required by any of the <literal>WHEN</literal> clauses,
929-
plus the TID of the target row; this data is fed up to the
930-
<literal>ModifyTable</literal> node, which uses the information to
931-
work out which <literal>WHEN</literal> clause to execute, and then
932-
inserts, updates or deletes the target row, as required.
916+
<command>INSERT ... SELECT</command> 将行提供给 <literal>ModifyTable</literal> 进行插入。
917+
对于 <command>UPDATE</command>,规划器安排每个计算出的行包含所有更新列的值, 加上原始目标行的 <firstterm>TID</firstterm> (元组ID或行ID);这些数据被提供给 <literal>ModifyTable</literal> 节点,该节点使用这些信息创建一个新的更新行并标记旧行已删除。
918+
对于 <command>DELETE</command>,计划实际返回的唯一列是TID, <literal>ModifyTable</literal> 节点只需使用TID访问每个目标行并将其标记为已删除。
919+
对于 <command>MERGE</command>, 规划器连接源和目标关系,并包含所有 <literal>WHEN</literal> 子句所需的列值,加上目标行的TID;
920+
这些数据被提供给 <literal>ModifyTable</literal> 节点,该节点使用这些信息来决定执行哪个 <literal>WHEN</literal> 子句,然后根据需要插入、更新或删除目标行。
933921
</para>
934922
<!-- pgdoc-cn_end sig_en=627b5ab30568e060ff977ec2532922fe -->
935923

postgresql/doc/src/sgml/archive-modules.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -226,7 +226,7 @@ typedef bool (*ArchiveFileCB) (const char *file, const char *path);
226226
</para>
227227
________________________________________________________-->
228228
<para>
229-
<function>archive_file_cb</function>回调函数被调用以归档单个WAL文件
229+
<function>archive_file_cb</function>回调函数被调用,用于归档单个WAL文件
230230

231231
<programlisting>
232232
typedef bool (*ArchiveFileCB) (const char *file, const char *path);

postgresql/doc/src/sgml/backup.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1068,7 +1068,7 @@ ________________________________________________________-->
10681068
<para>
10691069
在<varname>archive_command</varname>中,
10701070
<literal>%p</literal>会被替换为要归档的文件路径名,而<literal>%f</literal>会被替换为文件名。
1071-
(文件路径名是相对于当前工作目录,即集群的数据目录的。)
1071+
(文件路径名是相对于当前工作目录,即集簇的数据目录的。)
10721072
如果需要在命令中嵌入实际的<literal>%</literal>字符,请使用<literal>%%</literal>。
10731073
最简单有用的命令可能是这样的:
10741074
<programlisting>
@@ -1283,7 +1283,7 @@ ________________________________________________________-->
12831283
<para>
12841284
存档命令或函数仅在完成的WAL段上调用。因此,如果您的服务器生成的WAL流量很少(或者有间歇
12851285
期),在事务完成和安全记录到存档存储之间可能会有很长的延迟。为了限制未存档数据的
1286-
年龄,您可以设置<xref linkend="guc-archive-timeout"/>,强制服务器至少在那么长时间内切换
1286+
最旧时间,您可以设置<xref linkend="guc-archive-timeout"/>,强制服务器至少在指定长的时间内切换
12871287
到新的WAL段文件。请注意,由于强制切换而提前存档的文件仍然与完全满文件相同长度。因此,
12881288
设置非常短的<varname>archive_timeout</varname>是不明智的——它会使您的存档存储膨胀。
12891289
大约一分钟左右的<varname>archive_timeout</varname>设置通常是合理的。
@@ -1513,7 +1513,7 @@ SELECT pg_backup_start(label => 'label', fast => false);
15131513
</para>
15141514
________________________________________________________-->
15151515
<para>
1516-
在线备份始终从检查点的开始开始。默认情况下,<function>pg_backup_start</function>将等待下一个定期计划的检查点完成,这可能需要很长时间(请参阅配置参数<xref linkend="guc-checkpoint-timeout"/>和<xref linkend="guc-checkpoint-completion-target"/>)。通常这是最好的,因为它最大程度地减少了对运行系统的影响。如果您想尽快开始备份,请将<literal>true</literal>作为第二个参数传递给<function>pg_backup_start</function>,它将请求立即检查点,尽可能快地完成,尽可能多地使用I/O。
1516+
在线备份始终从检查点的开始启动。默认情况下,<function>pg_backup_start</function>将等待下一个定期计划的检查点完成,这可能需要很长时间(请参阅配置参数<xref linkend="guc-checkpoint-timeout"/>和<xref linkend="guc-checkpoint-completion-target"/>)。通常这是最好的,因为它最大程度地减少了对运行系统的影响。如果您想尽快开始备份,请将<literal>true</literal>作为第二个参数传递给<function>pg_backup_start</function>,它将请求立即检查点,尽可能快地完成,尽可能多地使用I/O。
15171517
</para>
15181518
<!-- pgdoc-cn_end sig_en=619155c4a25a25e0a48ce647f2fac73b -->
15191519

postgresql/doc/src/sgml/basebackup-to-shell.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ________________________________________________________-->
1313
</indexterm>
1414
________________________________________________________-->
1515
<indexterm zone="basebackup-to-shell">
16-
<primary>将basebackup转换为shell</primary>
16+
<primary>basebackup_to_shell</primary>
1717
</indexterm>
1818
<!-- pgdoc-cn_end sig_en=89d816950f5abdec096f0bb9046816d3 -->
1919

postgresql/doc/src/sgml/basic-archive.sgml

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,10 @@ ________________________________________________________-->
2727
</para>
2828
________________________________________________________-->
2929
<para>
30-
<filename>basic_archive</filename> is an example of an archive module. This
31-
module copies completed WAL segment files to the specified directory. This
32-
may not be especially useful, but it can serve as a starting point for
33-
developing your own archive module. For more information about archive
34-
modules, see <xref linkend="archive-modules"/>.
30+
<filename>basic_archive</filename> 是归档模块的一个例子。
31+
此模块将已完成的WAL段文件复制到指定的目录中。
32+
这可能不是特别有用,但它可以作为开发自己的归档模块的起点。
33+
有关归档模块的更多信息,请参见 <xref linkend="archive-modules"/>。
3534
</para>
3635
<!-- pgdoc-cn_end sig_en=088927850ae74f1b37c5e26c511bbdcc -->
3736

postgresql/doc/src/sgml/bgworker.sgml

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -179,16 +179,15 @@ ________________________________________________________-->
179179
</para>
180180
________________________________________________________-->
181181
<para>
182-
<structfield>bgw_flags</structfield> is a bitwise-or'd bit mask indicating the
183-
capabilities that the module wants. Possible values are:
182+
<structfield>bgw_flags</structfield> 是一个按位或位掩码,表示模块所需的功能。可能的值有:
184183
<variablelist>
185184

186185
<varlistentry>
187186
<term><literal>BGWORKER_SHMEM_ACCESS</literal></term>
188187
<listitem>
189188
<para>
190189
<indexterm><primary>BGWORKER_SHMEM_ACCESS</primary></indexterm>
191-
Requests shared memory access. This flag is required.
190+
请求共享内存访问。 此标志是必需的。
192191
</para>
193192
</listitem>
194193
</varlistentry>
@@ -198,11 +197,9 @@ ________________________________________________________-->
198197
<listitem>
199198
<para>
200199
<indexterm><primary>BGWORKER_BACKEND_&zwsp;DATABASE_CONNECTION</primary></indexterm>
201-
Requests the ability to establish a database connection through which it
202-
can later run transactions and queries. A background worker using
203-
<literal>BGWORKER_BACKEND_DATABASE_CONNECTION</literal> to connect to a
204-
database must also attach shared memory using
205-
<literal>BGWORKER_SHMEM_ACCESS</literal>, or worker start-up will fail.
200+
请求建立数据库连接的能力,以便稍后运行事务和查询。
201+
使用<literal>BGWORKER_BACKEND_DATABASE_CONNECTION</literal>连接到数据库的后台工作进程,还必须使用
202+
<literal>BGWORKER_SHMEM_ACCESS</literal>附加共享内存,否则工作进程启动将失败。
206203
</para>
207204
</listitem>
208205
</varlistentry>

postgresql/doc/src/sgml/brin.sgml

Lines changed: 14 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -35,10 +35,8 @@ ________________________________________________________-->
3535
</para>
3636
________________________________________________________-->
3737
<para>
38-
<acronym>BRIN</acronym> stands for Block Range Index.
39-
<acronym>BRIN</acronym> is designed for handling very large tables
40-
in which certain columns have some natural correlation with their
41-
physical location within the table.
38+
<acronym>BRIN</acronym> 代表块范围索引。
39+
<acronym>BRIN</acronym> 旨在处理非常大的表,其中某些列与它们在表中的物理位置具有某种自然相关性。
4240
</para>
4341
<!-- pgdoc-cn_end sig_en=70b70b4a6c7a9120fc7bfb74340bd5a9 -->
4442

@@ -57,16 +55,11 @@ ________________________________________________________-->
5755
</para>
5856
________________________________________________________-->
5957
<para>
60-
<acronym>BRIN</acronym> works in terms of <firstterm>block ranges</firstterm>
61-
(or <quote>page ranges</quote>).
62-
A block range is a group of pages that are physically
63-
adjacent in the table; for each block range, some summary info is stored
64-
by the index.
65-
For example, a table storing a store's sale orders might have
66-
a date column on which each order was placed, and most of the time
67-
the entries for earlier orders will appear earlier in the table as well;
68-
a table storing a ZIP code column might have all codes for a city
69-
grouped together naturally.
58+
<acronym>BRIN</acronym> 以 <firstterm>block ranges</firstterm>
59+
(或 <quote>page ranges</quote>)为单位工作。
60+
块范围是表中物理上相邻的一组页面;对于每个块范围,索引会存储一些摘要信息。
61+
例如,一个存储商店销售订单的表可能有一个日期列,表示每个订单的下单日期,大多数情况下较早的订单条目也会在表格中较早出现;
62+
一个存储邮政编码列的表可能会自然地将同一城市的所有邮政编码分组在一起。
7063
</para>
7164
<!-- pgdoc-cn_end sig_en=e3b2c04d5d86f4054583c592f20f5a2c -->
7265

@@ -182,10 +175,9 @@ ________________________________________________________-->
182175
<link linkend="autovacuum">autovacuum</link>进行了清理,所有现有的未摘要的
183176
页面范围都会被摘要。
184177
另外,如果索引的
185-
<xref linkend="index-reloption-autosummarize"/>参数被启用,
186-
默认情况下不启用,
187-
每当数据库中运行autovacuum时,将对所有已填充的未摘要的页面范围进行摘要,
188-
无论表本身是否由autovacuum处理;请参见下文。
178+
<xref linkend="index-reloption-autosummarize"/>参数被启用(默认情况下未启用),
179+
那么每当数据库中运行自动清理(autovacuum)时,将对所有已填充的未摘要的页面范围进行摘要处理,
180+
无论表本身是否由自动清理(autovacuum)处理;请参见下文。
189181
</para>
190182
<!-- pgdoc-cn_end sig_en=1373ff19c58ab48118a39c4fb8eeb2db -->
191183

@@ -210,12 +202,11 @@ ________________________________________________________-->
210202
<simplelist>
211203
<member>
212204
<function>brin_summarize_new_values(regclass)</function>
213-
which summarizes all unsummarized ranges;
205+
它总结了所有未总结的范围;
214206
</member>
215207
<member>
216208
<function>brin_summarize_range(regclass, bigint)</function>
217-
which summarizes only the range containing the given page,
218-
if it is unsummarized.
209+
如果未汇总,则仅汇总包含给定页面的范围。
219210
</member>
220211
</simplelist>
221212
</para>
@@ -241,11 +232,11 @@ LOG: request for BRIN range summarization for index "brin_wi_idx" page 128 was
241232
________________________________________________________-->
242233
<para>
243234
当启用自动摘要时,会向<literal>autovacuum</literal>发送请求,以在检测到下一个块范围的第一页的第一项插入时执行有针对性的摘要,
244-
在同一数据库中的下一个autovacuum工作完成后执行。如果请求队列已满,则不记录请求,并向服务器日志发送消息:
235+
在同一数据库中的下一个自动清理(autovacuum)工作完成后执行。如果请求队列已满,则不记录请求,并向服务器日志发送消息:
245236
<screen>
246237
LOG: request for BRIN range summarization for index "brin_wi_idx" page 128 was not recorded
247238
</screen>
248-
当发生这种情况时,范围将保持未摘要状态,直到表上的下一个常规vacuum运行,或者调用上述函数之一。
239+
当发生这种情况时,范围将保持未摘要状态,直到表上的下一个常规清理运行,或者调用上述函数之一。
249240
</para>
250241
<!-- pgdoc-cn_end sig_en=7b170653c5c2c90bf03a0d6bae3922e0 -->
251242

0 commit comments

Comments
 (0)