Merge pull request #400 from sizhitu/master

翻译 14.1 sgml

Author: ChenHuajun

postgresql/doc/src/sgml/indices.sgml

@@ -118,7 +118,7 @@ CREATE INDEX test1_id_index ON test1 (id);
   </para>
 ____________________________________________________________________________-->
   <para>
-   为了移除一个索引，可以使用<command>DROP INDEX</command>命令。索引可以随时被创建或删除。
+   删除一个索引，使用<command>DROP INDEX</command>命令。索引可以随时被创建或删除。
   </para>
 
 <!--==========================orignal english content==========================
@@ -148,7 +148,7 @@ ____________________________________________________________________________-->
   </para>
 ____________________________________________________________________________-->
   <para>
-   索引也会使带有搜索条件的<command>UPDATE</command>和<command>DELETE</command>命令受益。此外索引还可以在连接搜索中使用。因此，一个定义在连接条件列上的索引可以显著地提高连接查询的速度。
+   索引也会对带有搜索条件的<command>UPDATE</command>和<command>DELETE</command>命令有帮助。此外索引还可以在连接搜索中使用。因此，一个定义在连接条件列上的索引可以显著地提高连接查询的速度。
   </para>
 
 <!--==========================orignal english content==========================
@@ -193,15 +193,24 @@ ____________________________________________________________________________-->
    B-tree, Hash, GiST, SP-GiST, GIN and BRIN.
    Each index type uses a different
    algorithm that is best suited to different types of queries.
-   By default, the <command>CREATE INDEX</command> command creates
+   By default, the <link linkend="sql-createindex"><command>CREATE
+   INDEX</command></link> command creates
    B-tree indexes, which fit the most common situations.
+   The other index types are selected by writing the keyword
+    <literal>USING</literal> followed by the index type name.
+    For example, to create a Hash index:
   </para>
 ____________________________________________________________________________-->
   <para>
    <productname>PostgreSQL</productname>提供了多种索引类型：
    B-tree、Hash、GiST、SP-GiST 、GIN 和 BRIN。每一种索引类型使用了
    一种不同的算法来适应不同类型的查询。默认情况下，
-   <command>CREATE INDEX</command>命令创建适合于大部分情况的B-tree 索引。
+    <link linkend="sql-createindex"><command>CREATE
+      INDEX</command></link> 命令创建适合于大部分情况的B-tree 索引。
+      在索引类型名后面加上关键字<literal>USING</literal> ， 可以选择其他的索引类型，例如， 创建一个HASH索引：
+      <programlisting>
+      CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable> USING HASH (<replaceable>column</replaceable>);
+      </programlisting>
   </para>
 
 <!--==========================orignal english content==========================
@@ -234,24 +243,21 @@ ____________________________________________________________________________-->
    NULL</literal> condition on an index column can be used with a B-tree index.
   </para>
 ____________________________________________________________________________-->
-  <para>
+  <sect2 id="indexes-types-btree">
+   <title>B-Tree</title>
    <indexterm>
     <primary>index</primary>
-    <secondary>B-tree</secondary>
+    <secondary>B-Tree</secondary>
    </indexterm>
    <indexterm>
-    <primary>B-tree</primary>
+    <primary>B-Tree</primary>
     <see>index</see>
    </indexterm>
    B-tree可以在可排序数据上的处理等值和范围查询。特别地，<productname>PostgreSQL</productname>的查询规划器会在任何一种涉及到以下操作符的已索引列上考虑使用B-tree索引：
 
-   <simplelist>
-    <member><literal>&lt;</literal></member>
-    <member><literal>&lt;=</literal></member>
-    <member><literal>=</literal></member>
-    <member><literal>&gt;=</literal></member>
-    <member><literal>&gt;</literal></member>
-   </simplelist>
+<synopsis>
+&lt; &nbsp; &lt;= &nbsp; = &nbsp; &gt;= &nbsp; &gt;
+</synopsis>
 
    将这些操作符组合起来，例如<literal>BETWEEN</literal>和<literal>IN</literal>，也可以用B-tree索引搜索实现。同样，在索引列上的<literal>IS NULL</literal>或<literal>IS NOT
    NULL</literal>条件也可以在B-tree索引中使用。
@@ -289,6 +295,7 @@ ____________________________________________________________________________-->
   <para>
    B-tree索引也可以用于检索排序数据。这并不会总是比简单扫描和排序更快，但是总是有用的。
   </para>
+  </sect2>
 
 <!--==========================orignal english content==========================
   <para>
@@ -310,7 +317,8 @@ CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable>
 </synopsis>
   </para>
 ____________________________________________________________________________-->
-  <para>
+   <sect2 id="indexes-types-hash">
+   <title>Hash</title>
    <indexterm>
     <primary>index</primary>
     <secondary>hash</secondary>
@@ -319,11 +327,12 @@ ____________________________________________________________________________-->
     <primary>hash</primary>
     <see>index</see>
    </indexterm>
-   Hash索引只能处理简单等值比较。不论何时当一个索引列涉及到一个使用了<literal>=</literal>操作符的比较时，查询规划器将考虑使用一个Hash索引。下面的命令将创建一个Hash索引：
+   HASH索引存储一个由索引列计算出的32位的hash code值。因此，Hash索引只能处理简单等值比较。每当索引列涉及到等值操作符的比较时，查询规划器将会使用Hash索引。
 <synopsis>
-CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable> USING HASH (<replaceable>column</replaceable>);
+=
 </synopsis>
   </para>
+  </sect2>
 
 <!--==========================orignal english content==========================
   <para>
@@ -368,7 +377,8 @@ CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable>
    projects.  For more information see <xref linkend="gist"/>.
   </para>
 ____________________________________________________________________________-->
-  <para>
+  <sect2 id="indexes-type-gist">
+  <title>GiST</title>
    <indexterm>
     <primary>index</primary>
     <secondary>GiST</secondary>
@@ -377,22 +387,12 @@ ____________________________________________________________________________-->
     <primary>GiST</primary>
     <see>index</see>
    </indexterm>
+   <para>
    GiST索引并不是一种单独的索引，而是可以用于实现很多不同索引策略的基础设施。相应地，可以使用一个GiST索引的特定操作符根据索引策略（<firstterm>操作符类</firstterm>）而变化。作为一个例子，<productname>PostgreSQL</productname>的标准捐献包中包括了用于多种二维几何数据类型的GiST操作符类，它用来支持使用下列操作符的索引化查询：
 
-   <simplelist>
-    <member><literal>&lt;&lt;</literal></member>
-    <member><literal>&amp;&lt;</literal></member>
-    <member><literal>&amp;&gt;</literal></member>
-    <member><literal>&gt;&gt;</literal></member>
-    <member><literal>&lt;&lt;|</literal></member>
-    <member><literal>&amp;&lt;|</literal></member>
-    <member><literal>|&amp;&gt;</literal></member>
-    <member><literal>|&gt;&gt;</literal></member>
-    <member><literal>@&gt;</literal></member>
-    <member><literal>&lt;@</literal></member>
-    <member><literal>~=</literal></member>
-    <member><literal>&amp;&amp;</literal></member>
-   </simplelist>
+<synopsis>
+&lt;&lt; &nbsp; &amp;&lt; &nbsp; &amp;&gt; &nbsp; &gt;&gt; &nbsp; &lt;&lt;| &nbsp; &amp;&lt;| &nbsp; |&amp;&gt; &nbsp; |&gt;&gt; &nbsp; @&gt; &nbsp; &lt;@ &nbsp; ~= &nbsp; &amp;&amp;
+</synopsis>
 
    （这些操作符的含义见<xref linkend="functions-geometry"/>）<xref linkend="gist-builtin-opclasses-table"/>中给出了标准发布中所包括的 GiST 操作符类。<literal>contrib</literal>集合中还包括了很多其他GiST操作符类，可见<xref linkend="gist"/>。
   </para>
@@ -420,6 +420,7 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10;
    它将找到离给定目标点最近的10个位置。能够支持这种查询的能力同样取决于被使用的特定操作符类。
    在<xref linkend="gist-builtin-opclasses-table"/>中，<quote>Ordering Operators</quote>列中列出了可以在这种方法中使用的操作符。
   </para>
+  </sect2>
 
 <!--==========================orignal english content==========================
   <para>
@@ -455,7 +456,8 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10;
    For more information see <xref linkend="spgist"/>.
   </para>
 ____________________________________________________________________________-->
-  <para>
+  <sect2 id="indexes-type-spgist">
+   <title>SP-GiST</title>
    <indexterm>
     <primary>index</primary>
     <secondary>SP-GiST</secondary>
@@ -464,17 +466,13 @@ ____________________________________________________________________________-->
     <primary>SP-GiST</primary>
     <see>index</see>
    </indexterm>
+   <para>
    和GiST相似，SP-GiST索引为支持多种搜索提供了一种基础结构。SP-GiST 允许实现众多不同的非平衡的基于磁盘的数据结构，例如四叉树、k-d树和radix树。作为一个例
 子，<productname>PostgreSQL</productname>的标准捐献包中包含了一个用于二维点的SP-GiST操作符类，它用于支持使用下列操作符的索引化查询：
 
-   <simplelist>
-    <member><literal>&lt;&lt;</literal></member>
-    <member><literal>&gt;&gt;</literal></member>
-    <member><literal>~=</literal></member>
-    <member><literal>&lt;@</literal></member>
-    <member><literal>&lt;^</literal></member>
-    <member><literal>&gt;^</literal></member>
-   </simplelist>
+<synopsis>
+&lt;&lt; &nbsp; &gt;&gt; &nbsp; ~= &nbsp; &lt;@ &nbsp; &lt;&lt;| &nbsp; |&gt;&gt;
+</synopsis>
 
    （其含义见<xref linkend="functions-geometry"/>）<xref linkend="spgist-builtin-opclasses-table"/>中给出了标准发布中所包括的 SP-GiST 操作符类。更多信息参见<xref linkend="spgist"/>。
   </para>
@@ -489,8 +487,9 @@ ____________________________________________________________________________-->
 ____________________________________________________________________________-->
   <para>
    就像 GiST, SP-GiST 支持 <quote>nearest-neighbor</quote> 搜索.
-   对于支持距离排序的 SP-GiST 运算符类别，相应的运算符被规定在<xref linkend="spgist-builtin-opclasses-table"/>里面的<quote>Ordering Operators</quote>列中。
+   对于支持距离排序的 SP-GiST 运算符类别，相应的运算符被列在<xref linkend="spgist-builtin-opclasses-table"/>里面的<quote>Ordering Operators</quote>中。
   </para>
+  </sect2>
 
 <!--==========================orignal english content==========================
   <para>
@@ -509,7 +508,8 @@ ____________________________________________________________________________-->
    component values.
   </para>
 ____________________________________________________________________________-->
-  <para>
+  <sect2 id="indexes-types-gin">
+   <title>GIN</title>
    <indexterm>
     <primary>index</primary>
     <secondary>GIN</secondary>
@@ -518,6 +518,7 @@ ____________________________________________________________________________-->
     <primary>GIN</primary>
     <see>index</see>
    </indexterm>
+   <para>
    GIN 索引是<quote>倒排索引</quote>，它适合于包含多个组成值的数据值，例如数组。倒排索引中为每一个组成值都包含一个单独的项，它可以高效地处理测试指定组成值是否存在的查询。
   </para>
 
@@ -550,15 +551,13 @@ ____________________________________________________________________________-->
   <para>
    与 GiST 和 SP-GiST相似， GIN 可以支持多种不同的用户定义的索引策略，并且可以与一个 GIN 索引配合使用的特定操作符取决于索引策略。作为一个例子，<productname>PostgreSQL</productname>的标准贡献包中包含了用于数组的GIN操作符类，它用于支持使用下列操作符的索引化查询：
 
-   <simplelist>
-    <member><literal>&lt;@</literal></member>
-    <member><literal>@&gt;</literal></member>
-    <member><literal>=</literal></member>
-    <member><literal>&amp;&amp;</literal></member>
-   </simplelist>
+<synopsis>
+&lt;@ &nbsp; @&gt; &nbsp; = &nbsp; &amp;&amp;
+</synopsis>
 
    （这些操作符的含义见<xref linkend="functions-array"/>）<xref linkend="gin-builtin-opclasses-table"/>中给出了标准发布中所包括的 GIN 操作符类。在<literal>contrib</literal>集合中还有更多其他GIN操作符类，更多信息参见<xref linkend="gin"/>。
   </para>
+  </sect2>
 
 <!--==========================orignal english content==========================
   <para>
@@ -594,7 +593,8 @@ ____________________________________________________________________________-->
    For more information see <xref linkend="brin"/>.
   </para>
 ____________________________________________________________________________-->
-  <para>
+  <sect2 id="indexes-types-brin">
+   <title>BRIN</title>
    <indexterm>
     <primary>index</primary>
     <secondary>BRIN</secondary>
@@ -603,18 +603,15 @@ ____________________________________________________________________________-->
     <primary>BRIN</primary>
     <see>index</see>
    </indexterm>
-   BRIN 索引（块范围索引的缩写）存储有关存放在一个表的连续物理块范围上的值摘要信息。与 GiST、SP-GiST 和 GIN 相似，BRIN 可以支持很多种不同的索引策略，并且可以与一个 BRIN 索引配合使用的特定操作符取决于索引策略。对于具有线性排序顺序的数据类型，被索引的数据对应于每个块范围的列中值的最小值和最大值，使用这些操作符来支持用到索引的查询：
+   BRIN 索引（块范围索引的缩写）存储有关存放在一个表的连续物理块范围上的值摘要信息。因此，那些值和table中物理行存放顺序相关性更好的列更高效。与 GiST、SP-GiST 和 GIN 相似，BRIN 可以支持很多种不同的索引策略，并且可以与一个 BRIN 索引配合使用的特定操作符取决于索引策略。对于具有线性排序顺序的数据类型，被索引的数据对应于每个块范围的列中值的最小值和最大值，使用这些操作符来支持用到索引的查询：
 
-   <simplelist>
-    <member><literal>&lt;</literal></member>
-    <member><literal>&lt;=</literal></member>
-    <member><literal>=</literal></member>
-    <member><literal>&gt;=</literal></member>
-    <member><literal>&gt;</literal></member>
-   </simplelist>
+<synopsis>
+&lt; &nbsp; &lt;= &nbsp; = &nbsp; &gt;= &nbsp; &gt;
+</synopsis>
 
-   包括在标准发布中的 BRIN 操作符类的文档在<xref linkend="brin-builtin-opclasses-table"/>中。更多信息请见<xref linkend="brin"/>。
+    标准发行文档中有记录BRIN 操作符类<xref linkend="brin-builtin-opclasses-table"/>。更多信息请见<xref linkend="brin"/>。
   </para>
+  </sect2>
  </sect1>
 
 
@@ -688,7 +685,7 @@ CREATE INDEX test2_mm_idx ON test2 (major, minor);
   </para>
 ____________________________________________________________________________-->
   <para>
-   目前，只有 B-tree、GiST、GIN 和 BRIN 索引类型支持多列索引，最多可以指定32个列（该限制可以在源代码文件<filename>pg_config_manual.h</filename>中修改，但是修改后需要重新编译<productname>PostgreSQL</productname>）。
+   目前，只有 B-tree、GiST、GIN 和 BRIN 索引类型支持多列索引。是否可以有多个关键列与<literal>INCLUDE</literal>列是否可以被添加到索引中无关。 索引最多可以有32列，包括<literal>INCLUDE</literal>列。（该限制可以在源代码文件<filename>pg_config_manual.h</filename>中修改，但是修改后需要重新编译<productname>PostgreSQL</productname>）。
   </para>
 
 <!--==========================orignal english content==========================
@@ -1970,7 +1967,7 @@ CREATE UNIQUE INDEX tab_x_y ON tab(x) INCLUDE (y);
   </para>
 ____________________________________________________________________________-->
   <para>
-   保守地将非键负载列添加到索引是明智的，尤其是宽列。 如果索引元组超过索引类型允许的最大大小，数据插入将失败。在任何情况下，非键列都将复制索引表中的数据并放大了索引的大小，从而有可能减慢搜索速度。请记住，除非一个表足够慢以至于仅索引扫描可能不必访问堆，否则没有什么理由在一个索引中包含负载列。无论如何，如果必须访问堆元组，从堆里获取列的值并不会带来更高的开销。其他限制是表达式不被作为包含的来支持。只有B树和GiST索引当前支持包含的列。
+   保守地将非键负载列添加到索引是明智的，尤其是宽列。 如果索引元组超过索引类型允许的最大大小，数据插入将失败。在任何情况下，非键列都将复制索引表中的数据并放大了索引的大小，从而有可能减慢搜索速度。请记住，除非一个表足够慢以至于仅索引扫描可能不必访问堆，否则没有什么理由在一个索引中包含负载列。无论如何，如果必须访问堆元组，从堆里获取列的值并不会带来更高的开销。其他限制是表达式不被作为包含的来支持。只有B树，GiST和SP-GiST 索引当前支持包含的列。
   </para>
 
 <!--==========================orignal english content==========================