Merge pull request #397 from sizhitu/master

翻译14.1 mod sgml

Author: ChenHuajun

postgresql/doc/src/sgml/gin.sgml

@@ -126,111 +126,63 @@ ____________________________________________________________________________-->
  </para>
 
   <table id="gin-builtin-opclasses-table">
-<!--==========================orignal english content==========================
-   <title>Built-in <acronym>GIN</acronym> Operator Classes</title>
-____________________________________________________________________________-->
    <title>内建<acronym>GIN</acronym>操作符类</title>
-   <tgroup cols="3">
+   <tgroup cols="2">
     <thead>
-<!--==========================orignal english content==========================
      <row>
       <entry>Name</entry>
-      <entry>Indexed Data Type</entry>
       <entry>Indexable Operators</entry>
      </row>
-____________________________________________________________________________-->
-     <row>
-      <entry>名称</entry>
-      <entry>索引数据类型</entry>
-      <entry>可索引操作符</entry>
-     </row>
     </thead>
     <tbody>
-<!--==========================orignal english content==========================
      <row>
-      <entry><literal>array_ops</literal></entry>
-      <entry><type>anyarray</type></entry>
-      <entry>
-       <literal>&amp;&amp;</literal>
-       <literal>&lt;@</literal>
-       <literal>=</literal>
-       <literal>@&gt;</literal>
-      </entry>
+      <entry morerows="3" valign="middle"><literal>array_ops</literal></entry>
+      <entry><literal>&amp;&amp; (anyarray,anyarray)</literal></entry>
      </row>
-____________________________________________________________________________-->
      <row>
-      <entry><literal>array_ops</literal></entry>
-      <entry><type>anyarray</type></entry>
-      <entry>
-       <literal>&amp;&amp;</literal>
-       <literal>&lt;@</literal>
-       <literal>=</literal>
-       <literal>@&gt;</literal>
-      </entry>
+      <entry><literal>@&gt; (anyarray,anyarray)</literal></entry>
      </row>
-<!--==========================orignal english content==========================
      <row>
-      <entry><literal>jsonb_ops</literal></entry>
-      <entry><type>jsonb</type></entry>
-      <entry>
-       <literal>?</literal>
-       <literal>?&amp;</literal>
-       <literal>?|</literal>
-       <literal>@&gt;</literal>
-       <literal>@?</literal>
-       <literal>@@</literal>
-      </entry>
+      <entry><literal>&lt;@ (anyarray,anyarray)</literal></entry>
      </row>
-____________________________________________________________________________-->
      <row>
-      <entry><literal>jsonb_ops</literal></entry>
-      <entry><type>jsonb</type></entry>
-      <entry>
-       <literal>?</literal>
-       <literal>?&amp;</literal>
-       <literal>?|</literal>
-       <literal>@&gt;</literal>
-       <literal>@?</literal>
-       <literal>@@</literal>
-      </entry>
+      <entry><literal>= (anyarray,anyarray)</literal></entry>
      </row>
-<!--==========================orignal english content==========================
      <row>
-      <entry><literal>jsonb_path_ops</literal></entry>
-      <entry><type>jsonb</type></entry>
-      <entry>
-       <literal>@&gt;</literal>
-       <literal>@?</literal>
-       <literal>@@</literal>
-      </entry>
+      <entry morerows="5" valign="middle"><literal>jsonb_ops</literal></entry>
+      <entry><literal>@&gt; (jsonb,jsonb)</literal></entry>
      </row>
-____________________________________________________________________________-->
      <row>
-      <entry><literal>jsonb_path_ops</literal></entry>
-      <entry><type>jsonb</type></entry>
-      <entry>
-       <literal>@&gt;</literal>
-       <literal>@?</literal>
-       <literal>@@</literal>
-      </entry>
+      <entry><literal>@? (jsonb,jsonpath)</literal></entry>
      </row>
-<!--==========================orignal english content==========================
      <row>
-      <entry><literal>tsvector_ops</literal></entry>
-      <entry><type>tsvector</type></entry>
-      <entry>
-       <literal>@@</literal>
-       <literal>@@@</literal>
-      </entry>
+      <entry><literal>@@ (jsonb,jsonpath)</literal></entry>
+     </row>
+     <row>
+      <entry><literal>? (jsonb,text)</literal></entry>
+     </row>
+     <row>
+      <entry><literal>?| (jsonb,text[])</literal></entry>
+     </row>
+     <row>
+      <entry><literal>?&amp; (jsonb,text[])</literal></entry>
+     </row>
+     <row>
+      <entry morerows="2" valign="middle"><literal>jsonb_path_ops</literal></entry>
+      <entry><literal>@&gt; (jsonb,jsonb)</literal></entry>
+     </row>
+     <row>
+      <entry><literal>@? (jsonb,jsonpath)</literal></entry>
+     </row>
+     <row>
+      <entry><literal>@@ (jsonb,jsonpath)</literal></entry>
+     </row>
+     <row>
+      <entry morerows="1" valign="middle"><literal>tsvector_ops</literal></entry>
+      <entry><literal>@@ (tsvector,tsquery)</literal></entry>
      </row>
-____________________________________________________________________________-->
      <row>
-      <entry><literal>tsvector_ops</literal></entry>
-      <entry><type>tsvector</type></entry>
-      <entry>
-       <literal>@@</literal>
-       <literal>@@@</literal>
-      </entry>
+      <entry><literal>@@@ (tsvector,tsquery)</literal></entry>
      </row>
     </tbody>
    </tgroup>
@@ -831,14 +783,14 @@ ____________________________________________________________________________-->
   </para>
 ____________________________________________________________________________-->
   <para>
-   更新一个<acronym>GIN</acronym>索引可能会比较慢，这是因为倒排索引的天然特性造成的：
-   对一个堆行的插入或更新可能导致对索引的很多次插入（每一次插入用于从被索引项中抽取的一个键）。
-   从<productname>PostgreSQL</productname> 8.4 开始，<acronym>GIN</acronym>可以通过将新元组插入到一个临时的未排序的待处理条目列表中来推迟很多这种工作。
-   当表被清理、自动分析、<function>gin_clean_pending_list</function>函数被调用
-   或者待处理列表变得大于<xref linkend="guc-gin-pending-list-limit"/>时，
-   这些条目被使用初始索引创建时使用的批量插入技术移动到主<acronym>GIN</acronym>数据结构中。
-   这大幅度提高了<acronym>GIN</acronym>索引的更新速度，虽然带了一些额外的清理负荷。
-   此外，这些开销可以通过用一个后台进程来取代一个前台进程执行。
+   更新<acronym>GIN</acronym> 索引往往会很慢，由于反向索引的固有特性：
+   插入或更新一个heap row 会导致许多项目插入到索引中（每个索引键从索引项目中提取一个）。
+   <acronym>GIN</acronym> 能够通过将新的tuple 插入临时的未排序的待处理条目列表来延迟大部分工作。
+   当表被清理或自动分析时，或者<function>gin_clean_pending_list</function> 函数被调用时，
+   又或者待处理列表变得大于<xref linkend="guc-gin-pending-list-limit"/>时，
+   使用在初始索引建立期间使用的相同批次插入技术将项目移动到主要的<acronym>GIN</acronym>数据结构中。
+   即使考虑到额外的清理开销，这也显着加快了<acronym>GIN</acronym>索引更新速度。
+   此外，后台进程可以执行这种开销工作，而不是前端查询处理来完成。
   </para>
 
 <!--==========================orignal english content==========================
@@ -933,7 +885,8 @@ ____________________________________________________________________________-->
     </para>
 ____________________________________________________________________________-->
     <para>
-     从<productname>PostgreSQL</productname> 8.4 开始，这个建议已经不再需要了，因为可以使用延迟索引（详见<xref linkend="gin-fast-update"/>）。但是对于非常大量的更新，还是最好先删除再重建索引。
+     当 <acronym>GIN</acronym> 启用 <literal>fastupdate</literal> 时
+     (参见 <xref linkend="gin-fast-update"/> ), 惩罚比其他情况要小。但是对于非常大的更新，删除并重新创建索引可能仍然是最好的。
     </para>
    </listitem>
   </varlistentry>

postgresql/doc/src/sgml/glossary.sgml

@@ -286,6 +286,17 @@ ____________________________________________________________________________-->
    </glossdef>
   </glossentry>
 
+  <glossentry id="glossary-basebackup">
+   <glossterm>Base Backup</glossterm>
+   <glossdef>
+    <para>
+     所有<glossterm linkend="glossary-db-cluster">database cluster</glossterm>
+     文件的二进制拷贝。 通过<xref linkend="app-pgbasebackup"/>工具生成。
+     它可以结合WAL文件作为恢复、日志传送或流式复制的起点。
+    </para>
+   </glossdef>
+  </glossentry>
+
   <glossentry id="glossary-bloat">
    <glossterm>Bloat</glossterm>
    <glossdef>