4
4
<!-- pgdoc-cn_start sig_en=c31a4813c55a857834e1889b9a459272 sig_cn_org=94f9057b59523685216da13b84afcd1f source=15.7
5
5
<title>Archive Modules</title>
6
6
________________________________________________________-->
7
- <title>pgdoc_cn_new_tag存档模块 </title>
7
+ <title>存档模块 </title>
8
8
<!-- pgdoc-cn_end sig_en=c31a4813c55a857834e1889b9a459272 -->
9
9
<!-- pgdoc-cn_start sig_en=6e76ff6d219383b744714351a0b5d731 sig_cn_org=76da3f14eced0fd8f829746c41219a70 source=15.7
10
10
<indexterm zone="archive-modules">
@@ -25,7 +25,7 @@ ________________________________________________________-->
25
25
performant.
26
26
</para>
27
27
________________________________________________________-->
28
- <para>pgdoc_cn_new_tag
28
+ <para>
29
29
PostgreSQL提供了为连续归档创建自定义模块的基础设施(参见<xref linkend="continuous-archiving"/>)。
30
30
虽然通过shell命令进行归档(即<xref linkend="guc-archive-command"/>)更简单,
31
31
但自定义归档模块通常会更加健壮和高效。
@@ -42,7 +42,7 @@ ________________________________________________________-->
42
42
<xref linkend="backup-archiving-wal"/>.
43
43
</para>
44
44
________________________________________________________-->
45
- <para>pgdoc_cn_new_tag
45
+ <para>
46
46
当配置了自定义<xref linkend="guc-archive-library"/>时,PostgreSQL将完成的WAL文件提交给模块,
47
47
服务器将避免回收或删除这些WAL文件,直到模块指示文件已成功归档为止。最终由模块决定如何处理每个WAL文件,
48
48
但在<xref linkend="backup-archiving-wal"/>中列出了许多建议。
@@ -58,7 +58,7 @@ ________________________________________________________-->
58
58
workers).
59
59
</para>
60
60
________________________________________________________-->
61
- <para>pgdoc_cn_new_tag
61
+ <para>
62
62
存档模块必须至少包括一个初始化函数(参见<xref linkend="archive-module-init"/>)和所需的回调函数(参见<xref linkend="archive-module-callbacks"/>)。
63
63
但是,存档模块也被允许做更多的事情(例如,声明GUC和注册后台工作者)。
64
64
</para>
@@ -70,7 +70,7 @@ ________________________________________________________-->
70
70
example, which demonstrates some useful techniques.
71
71
</para>
72
72
________________________________________________________-->
73
- <para>pgdoc_cn_new_tag
73
+ <para>
74
74
<filename>contrib/basic_archive</filename>模块包含一个可工作的示例,演示了一些有用的技术。
75
75
</para>
76
76
<!-- pgdoc-cn_end sig_en=0c02c216629aadc88d419980235b8ef7 -->
@@ -79,7 +79,7 @@ ________________________________________________________-->
79
79
<!-- pgdoc-cn_start sig_en=a25c81a0e87f417d2071924d57c3cc77 sig_cn_org=b77a38a8c4f8d14aca4318ff44e2b040 source=15.7
80
80
<title>Initialization Functions</title>
81
81
________________________________________________________-->
82
- <title>pgdoc_cn_new_tag初始化函数 </title>
82
+ <title>初始化函数 </title>
83
83
<!-- pgdoc-cn_end sig_en=a25c81a0e87f417d2071924d57c3cc77 -->
84
84
<!-- pgdoc-cn_start sig_en=71c388e73a3fbab2fbe0ed0a29389d47 sig_cn_org=e4923f244b4797ea6f7144107852c9a5 source=15.7
85
85
<indexterm zone="archive-module-init">
@@ -115,7 +115,7 @@ typedef void (*ArchiveModuleInit) (struct ArchiveModuleCallbacks *cb);
115
115
others are optional.
116
116
</para>
117
117
________________________________________________________-->
118
- <para>pgdoc_cn_new_tag
118
+ <para>
119
119
通过动态加载一个共享库来加载存档库,共享库的名称为<xref linkend="guc-archive-library"/>的基本名称。
120
120
使用正常的库搜索路径来定位库。为了提供所需的存档模块回调并指示该库实际上是一个存档模块,
121
121
它需要提供一个名为<function>_PG_archive_module_init</function>的函数。该函数接收一个结构体,
@@ -140,15 +140,15 @@ typedef void (*ArchiveModuleInit) (struct ArchiveModuleCallbacks *cb);
140
140
<!-- pgdoc-cn_start sig_en=bdb232273ea8ca4908fed922d376aaf6 sig_cn_org=166126b110517b3f8c2e0bfbc5f45221 source=15.7
141
141
<title>Archive Module Callbacks</title>
142
142
________________________________________________________-->
143
- <title>pgdoc_cn_new_tag存档模块回调函数 </title>
143
+ <title>存档模块回调函数 </title>
144
144
<!-- pgdoc-cn_end sig_en=bdb232273ea8ca4908fed922d376aaf6 -->
145
145
<!-- pgdoc-cn_start sig_en=37dd2aaea2a91b668ef427acb0065f43 sig_cn_org=2b747e33a89b6b9fc94ed1755e43fedf source=15.7
146
146
<para>
147
147
The archive callbacks define the actual archiving behavior of the module.
148
148
The server will call them as required to process each individual WAL file.
149
149
</para>
150
150
________________________________________________________-->
151
- <para>pgdoc_cn_new_tag
151
+ <para>
152
152
存档回调函数定义模块的实际存档行为。
153
153
服务器将根据需要调用它们来处理每个单独的WAL文件。
154
154
</para>
@@ -158,7 +158,7 @@ ________________________________________________________-->
158
158
<!-- pgdoc-cn_start sig_en=43b1b1b0fbfa01d807a29779f0ced29d sig_cn_org=5a1bc64532a5c95a86d77f032e7ab5d9 source=15.7
159
159
<title>Check Callback</title>
160
160
________________________________________________________-->
161
- <title>pgdoc_cn_new_tag检查回调 </title>
161
+ <title>检查回调 </title>
162
162
<!-- pgdoc-cn_end sig_en=43b1b1b0fbfa01d807a29779f0ced29d -->
163
163
<!-- pgdoc-cn_start sig_en=cb6e227d063b24175058dfb9dd41c019 sig_cn_org=6055ca5aacedb113204d20ded387dba7 source=15.7
164
164
<para>
@@ -183,7 +183,7 @@ WARNING: archive_mode enabled, yet archiving is not configured
183
183
archiving will proceed only when it returns <literal>true</literal>.
184
184
</para>
185
185
________________________________________________________-->
186
- <para>pgdoc_cn_new_tag
186
+ <para>
187
187
回调<function>check_configured_cb</function>被调用以确定模块是否完全配置并准备接受WAL文件(例如,其配置参数设置为有效值)。
188
188
如果未定义<function>check_configured_cb</function>,服务器始终假定模块已配置。
189
189
@@ -205,7 +205,7 @@ WARNING: archive_mode enabled, yet archiving is not configured
205
205
<!-- pgdoc-cn_start sig_en=f3558b7d128924558f3ea314c1419639 sig_cn_org=6574c8e1efa8bfa9e113e96082c36aeb source=15.7
206
206
<title>Archive Callback</title>
207
207
________________________________________________________-->
208
- <title>pgdoc_cn_new_tag存档回调 </title>
208
+ <title>存档回调 </title>
209
209
<!-- pgdoc-cn_end sig_en=f3558b7d128924558f3ea314c1419639 -->
210
210
<!-- pgdoc-cn_start sig_en=90d338c9b5f67b3025aa9a64c18f4f72 sig_cn_org=794bc92bc4c112608ba5830a7501f584 source=15.7
211
211
<para>
@@ -225,7 +225,7 @@ typedef bool (*ArchiveFileCB) (const char *file, const char *path);
225
225
path of the WAL file (including the file name).
226
226
</para>
227
227
________________________________________________________-->
228
- <para>pgdoc_cn_new_tag
228
+ <para>
229
229
<function>archive_file_cb</function>回调函数被调用以归档单个WAL文件。
230
230
231
231
<programlisting>
@@ -242,7 +242,7 @@ ________________________________________________________-->
242
242
<!-- pgdoc-cn_start sig_en=68b3ee2e7b46796aed869d754422c63d sig_cn_org=e76d0196a15baed4533a8fc3b8255fec source=15.7
243
243
<title>Shutdown Callback</title>
244
244
________________________________________________________-->
245
- <title>pgdoc_cn_new_tag关闭回调 </title>
245
+ <title>关闭回调 </title>
246
246
<!-- pgdoc-cn_end sig_en=68b3ee2e7b46796aed869d754422c63d -->
247
247
<!-- pgdoc-cn_start sig_en=7988a41cd3f5cf75cb098f4be182e5a4 sig_cn_org=c3211755578c576087a76c3c0f468c63 source=15.7
248
248
<para>
@@ -257,7 +257,7 @@ typedef void (*ArchiveShutdownCB) (void);
257
257
</programlisting>
258
258
</para>
259
259
________________________________________________________-->
260
- <para>pgdoc_cn_new_tag
260
+ <para>
261
261
当归档器进程退出(例如,发生错误后)或者<xref linkend="guc-archive-library"/>的值发生变化时,会调用<function>shutdown_cb</function>回调函数。如果没有定义<function>shutdown_cb</function>,在这些情况下不会采取任何特殊操作。
262
262
263
263
<programlisting>
0 commit comments