Merge pull request #410 from ChenHuajun/master

翻译14.1 cluster.sgml等

Author: ChenHuajun

postgresql/doc/src/sgml/ref/cluster.sgml

@@ -41,12 +41,22 @@ ____________________________________________________________________________-->
 <!--==========================orignal english content==========================
 <synopsis>
 CLUSTER [VERBOSE] <replaceable class="parameter">table_name</replaceable> [ USING <replaceable class="parameter">index_name</replaceable> ]
+CLUSTER ( <replaceable class="parameter">option</replaceable> [, ...] ) <replaceable class="parameter">table_name</replaceable> [ USING <replaceable class="parameter">index_name</replaceable> ]
 CLUSTER [VERBOSE]
+
+<phrase>where <replaceable class="parameter">option</replaceable> can be one of:</phrase>
+
+    VERBOSE [ <replaceable class="parameter">boolean</replaceable> ]
 </synopsis>
 ____________________________________________________________________________-->
 <synopsis>
 CLUSTER [VERBOSE] <replaceable class="parameter">table_name</replaceable> [ USING <replaceable class="parameter">index_name</replaceable> ]
+CLUSTER ( <replaceable class="parameter">option</replaceable> [, ...] ) <replaceable class="parameter">table_name</replaceable> [ USING <replaceable class="parameter">index_name</replaceable> ]
 CLUSTER [VERBOSE]
+
+<phrase><replaceable class="parameter">option</replaceable> 可以是以下之一:</phrase>
+
+    VERBOSE [ <replaceable class="parameter">boolean</replaceable> ]
 </synopsis>
  </refsynopsisdiv>
 
@@ -106,7 +116,7 @@ ____________________________________________________________________________-->
    <command>CLUSTER <replaceable class="parameter">table_name</replaceable></command>
    reclusters the table using the same index as before.  You can also
    use the <literal>CLUSTER</literal> or <literal>SET WITHOUT CLUSTER</literal>
-   forms of <xref linkend="sql-altertable"/> to set the index to be used for
+   forms of <link linkend="sql-altertable"><command>ALTER TABLE</command></link> to set the index to be used for
    future cluster operations, or to clear any previous setting.
   </para>
 ____________________________________________________________________________-->
@@ -115,7 +125,7 @@ ____________________________________________________________________________-->
    会记住它是按照哪个索引聚簇的。形式
    <command>CLUSTER <replaceable class="parameter">table_name</replaceable></command>
    会使用前面所用的同一个索引对表重新聚簇。你也可以使用
-   <literal>CLUSTER</literal>或者<xref linkend="sql-altertable"/>
+   <literal>CLUSTER</literal>或者<link linkend="sql-altertable"><command>ALTER TABLE</command></link>
    的<literal>SET WITHOUT CLUSTER</literal>形式把索引设置为可用于
    未来的聚簇操作，或者清除任何之前的设置。
   </para>
@@ -208,6 +218,32 @@ ____________________________________________________________________________-->
      </para>
     </listitem>
    </varlistentry>
+
+   <varlistentry>
+<!--==========================orignal english content==========================
+    <term><replaceable class="parameter">boolean</replaceable></term>
+____________________________________________________________________________-->
+    <term><replaceable class="parameter">boolean</replaceable></term>
+    <listitem>
+<!--==========================orignal english content==========================
+     <para>
+      Specifies whether the selected option should be turned on or off.
+      You can write <literal>TRUE</literal>, <literal>ON</literal>, or
+      <literal>1</literal> to enable the option, and <literal>FALSE</literal>,
+      <literal>OFF</literal>, or <literal>0</literal> to disable it.  The
+      <replaceable class="parameter">boolean</replaceable> value can also
+      be omitted, in which case <literal>TRUE</literal> is assumed.
+     </para>
+____________________________________________________________________________-->
+     <para>
+      指定打开还是关闭选定的选项。你可以输入<literal>TRUE</literal>、
+      <literal>ON</literal>或<literal>1</literal>启用该选项，
+      或者输入<literal>FALSE</literal>、<literal>OFF</literal>或<literal>0</literal>禁用它。
+      也可以省略这个<replaceable class="parameter">boolean</replaceable>值，
+      在这种情况下，假设其值为<literal>TRUE</literal>。
+     </para>
+    </listitem>
+   </varlistentry>
   </variablelist>
  </refsect1>
 
@@ -306,14 +342,14 @@ ____________________________________________________________________________-->
 <!--==========================orignal english content==========================
    <para>
     Because the planner records statistics about the ordering of
-    tables, it is advisable to run <xref linkend="sql-analyze"/>
+    tables, it is advisable to run <link linkend="sql-analyze"><command>ANALYZE</command></link>
     on the newly clustered table.
     Otherwise, the planner might make poor choices of query plans.
    </para>
 ____________________________________________________________________________-->
    <para>
     因为规划器会记录有关表顺序的统计信息，建议在新近被聚簇的表上
-    运行<xref linkend="sql-analyze"/>。否则，规划器可能会产生很差
+    运行<link linkend="sql-analyze"><command>ANALYZE</command></link>。否则，规划器可能会产生很差
     的查询计划。
    </para>
 
@@ -333,6 +369,18 @@ ____________________________________________________________________________-->
     表就会被周期性地重新聚簇。
    </para>
 
+<!--==========================orignal english content==========================
+  <para>
+    Each backend running <command>CLUSTER</command> will report its progress
+    in the <structname>pg_stat_progress_cluster</structname> view. See
+    <xref linkend="cluster-progress-reporting"/> for details.
+  </para>
+____________________________________________________________________________-->
+  <para>
+    运行<command>CLUSTER</command>的每个后端将在
+    <structname>pg_stat_progress_cluster</structname>视图中报告其进度。
+    有关详细信息，请参见<xref linkend="cluster-progress-reporting"/>。
+  </para>
  </refsect1>
 
  <refsect1>
@@ -429,6 +477,7 @@ ____________________________________________________________________________-->
 
   <simplelist type="inline">
    <member><xref linkend="app-clusterdb"/></member>
+   <member><xref linkend="cluster-progress-reporting"/></member>
   </simplelist>
  </refsect1>
 </refentry>

postgresql/doc/src/sgml/ref/comment.sgml

@@ -275,20 +275,16 @@ ____________________________________________________________________________-->
     <listitem>
 <!--==========================orignal english content==========================
      <para>
-      The name of the object to be commented.  Names of tables,
-      aggregates, collations, conversions, domains, foreign tables, functions,
-      indexes, operators, operator classes, operator families, procedures, routines, sequences,
-      statistics, text search objects, types, and views can be
+      The name of the object to be commented.  Names of objects that reside in
+      schemas (tables, functions, etc.) can be
       schema-qualified. When commenting on a column,
       <replaceable class="parameter">relation_name</replaceable> must refer
       to a table, view, composite type, or foreign table.
      </para>
 ____________________________________________________________________________-->
      <para>
-      要被注释的对象的名称。表、聚集、排序方式、转换、域、外部表、函数、
-      索引、操作符、操作符类、操作符族、存储过程、例程、序列、统计信息、文本搜索对象、类型和视图
-      的名称可以被模式限定。在注释一列时，
-      <replaceable class="parameter">relation_name</replaceable>必须
+      要被注释的对象的名称。驻留在模式（表、函数等）中的对象的名称可以是模式限定的。
+      在注释一列时，<replaceable class="parameter">relation_name</replaceable>必须
       引用一个表、视图、组合类型或者外部表。
      </para>
     </listitem>
@@ -453,11 +449,11 @@ ____________________________________________________________________________-->
      <para>
       The data type(s) of the operator's arguments (optionally
       schema-qualified).  Write <literal>NONE</literal> for the missing argument
-      of a prefix or postfix operator.
+      of a prefix operator.
      </para>
 ____________________________________________________________________________-->
      <para>
-      操作符的参数的数据类型（可以是模式限定的）。对一个前缀后后缀操作符
+      操作符的参数的数据类型（可以是模式限定的）。对一个前缀操作符
       的缺失参数可以写<literal>NONE</literal>。
      </para>
     </listitem>

postgresql/doc/src/sgml/ref/copy.sgml

@@ -160,6 +160,19 @@ ____________________________________________________________________________-->
    <literal>STDIN</literal>或者<literal>STDOUT</literal>时，数据会通过客
    户端和服务器之间的连接传输。
   </para>
+
+<!--==========================orignal english content==========================
+  <para>
+    Each backend running <command>COPY</command> will report its progress
+    in the <structname>pg_stat_progress_copy</structname> view. See
+    <xref linkend="copy-progress-reporting"/> for details.
+  </para>
+____________________________________________________________________________-->
+  <para>
+    运行<command>COPY</command>的每个后端将在
+    <structname>pg_stat_progress_copy</structname>视图中报告其进度。
+    有关详细信息，请参见<xref linkend="copy-progress-reporting"/>。
+  </para>
  </refsect1>
 
  <refsect1>
@@ -213,17 +226,21 @@ ____________________________________________________________________________-->
     <listitem>
 <!--==========================orignal english content==========================
      <para>
-      A <xref linkend="sql-select"/>, <xref linkend="sql-values"/>,
-      <xref linkend="sql-insert"/>, <xref linkend="sql-update"/> or
-      <xref linkend="sql-delete"/> command whose results are to be
+      A <link linkend="sql-select"><command>SELECT</command></link>,
+      <link linkend="sql-values"><command>VALUES</command></link>,
+      <link linkend="sql-insert"><command>INSERT</command></link>,
+      <link linkend="sql-update"><command>UPDATE</command></link>, or
+      <link linkend="sql-delete"><command>DELETE</command></link> command whose results are to be
       copied.  Note that parentheses are required around the query.
      </para>
 ____________________________________________________________________________-->
      <para>
-      其结果要被复制的<xref linkend="sql-select"/>、
-      <xref linkend="sql-values"/>、
-      <xref linkend="sql-insert"/>、<xref linkend="sql-update"/>或者
-      <xref linkend="sql-delete"/>命令。注意查询周围的圆括号是必要的。
+      其结果要被复制的<link linkend="sql-select"><command>SELECT</command></link>、
+      <link linkend="sql-values"><command>VALUES</command></link>、
+      <link linkend="sql-insert"><command>INSERT</command></link>、
+      <link linkend="sql-update"><command>UPDATE</command></link>或者
+      <link linkend="sql-delete"><command>DELETE</command></link>命令。
+      注意查询周围的圆括号是必要的。
      </para>
 <!--==========================orignal english content==========================
      <para>
@@ -759,16 +776,25 @@ ____________________________________________________________________________-->
 
 <!--==========================orignal english content==========================
    <para>
-    <command>COPY TO</command> can only be used with plain tables, not
-    with views.  However, you can write <literal>COPY (SELECT * FROM
-    <replaceable class="parameter">viewname</replaceable>) TO ...</literal>
-    to copy the current contents of a view.
+    <command>COPY TO</command> can be used only with plain
+    tables, not views, and does not copy rows from child tables
+    or child partitions.  For example, <literal>COPY <replaceable
+    class="parameter">table</replaceable> TO</literal> copies
+    the same rows as <literal>SELECT * FROM ONLY <replaceable
+    class="parameter">table</replaceable></literal>.
+    The syntax <literal>COPY (SELECT * FROM <replaceable
+    class="parameter">table</replaceable>) TO ...</literal> can be used to
+    dump all of the rows in an inheritance hierarchy, partitioned table,
+    or view.
    </para>
 ____________________________________________________________________________-->
    <para>
-    <command>COPY TO</command>只能被用于纯粹的表，不能用于视图。
-    不过你可以写<literal>COPY (SELECT * FROM
-    <replaceable class="parameter">viewname</replaceable>) TO ...</literal>来拷贝一个视图的当前内容。
+   <command>COPY TO</command>只能用于普通表，而不能用于视图，并且不能从子表或子分区复制行。
+   例如，<literal>COPY <replaceable class="parameter">table</replaceable> TO</literal>
+   复制与<literal>SELECT * FROM ONLY <replaceable class="parameter">table</replaceable></literal>
+   相同的行。
+   语法<literal>COPY (SELECT * FROM <replaceable class="parameter">table</replaceable>) TO ...</literal>
+   可用于转储一个继承层次结构、分区表或视图中的所有行。
    </para>
 
 <!--==========================orignal english content==========================
@@ -782,26 +808,6 @@ ____________________________________________________________________________-->
     <command>COPY FROM</command>可以被用于普通表、外部表、分区表或者具有<literal>INSTEAD OF INSERT</literal>触发器的视图。
    </para>
 
-<!--==========================orignal english content==========================
-   <para>
-    <command>COPY</command> only deals with the specific table named;
-    it does not copy data to or from child tables.  Thus for example
-    <literal>COPY <replaceable class="parameter">table</replaceable> TO</literal>
-    shows the same data as <literal>SELECT * FROM ONLY <replaceable
-    class="parameter">table</replaceable></literal>.  But <literal>COPY
-    (SELECT * FROM <replaceable class="parameter">table</replaceable>) TO ...</literal>
-    can be used to dump all of the data in an inheritance hierarchy.
-   </para>
-____________________________________________________________________________-->
-   <para>
-    <command>COPY</command>只处理提到的表，它不会从子表复制
-    数据或者复制数据到子表中。例如
-    <literal>COPY <replaceable class="parameter">table</replaceable> TO</literal>
-    会显示与<literal>SELECT * FROM ONLY <replaceable
-    class="parameter">table</replaceable></literal>相同的数据。而<literal>COPY
-    (SELECT * FROM <replaceable class="parameter">table</replaceable>) TO ...</literal>
-    可以被用来转储一个继承层次中的所有数据。
-   </para>
 
 <!--==========================orignal english content==========================
    <para>
@@ -845,7 +851,7 @@ ____________________________________________________________________________-->
     by the server, not by the client application, must be executable by the
     <productname>PostgreSQL</productname> user.
     <command>COPY</command> naming a file or command is only allowed to
-    database superusers or users who are granted one of the default roles
+    database superusers or users who are granted one of the roles
     <literal>pg_read_server_files</literal>,
     <literal>pg_write_server_files</literal>,
     or <literal>pg_execute_server_program</literal>, since it allows reading
@@ -861,7 +867,9 @@ ____________________________________________________________________________-->
     ID）可访问的并且是可读或者可写的。类似地，用<literal>PROGRAM</literal>
     指定的命令也会由服务器（不是客户端应用）直接执行，它也必须是
     <productname>PostgreSQL</productname>用户可以执行的。
-    只允许数据库超级用户或者授予了默认角色<literal>pg_read_server_files</literal>、<literal>pg_write_server_files</literal>及<literal>pg_execute_server_program</literal>之一的用户<command>COPY</command>一个文件或者命令，
+    只允许数据库超级用户或者授予了角色<literal>pg_read_server_files</literal>、
+    <literal>pg_write_server_files</literal>及<literal>pg_execute_server_program</literal>
+    之一的用户<command>COPY</command>一个文件或者命令，
     因为它允许读取或者写入服务器有特权访问的任何文件或者运行服务器有特权访问的程序。
    </para>
 
@@ -1149,12 +1157,12 @@ ____________________________________________________________________________-->
       <row>
        <entry><literal>\</literal><replaceable>digits</replaceable></entry>
        <entry>Backslash followed by one to three octal digits specifies
-       the character with that numeric code</entry>
+       the byte with that numeric code</entry>
       </row>
       <row>
        <entry><literal>\x</literal><replaceable>digits</replaceable></entry>
        <entry>Backslash <literal>x</literal> followed by one or two hex digits specifies
-       the character with that numeric code</entry>
+       the byte with that numeric code</entry>
       </row>
      </tbody>
     </tgroup>
@@ -1204,17 +1212,17 @@ ____________________________________________________________________________-->
       </row>
       <row>
        <entry><literal>\</literal><replaceable>digits</replaceable></entry>
-       <entry>反斜线后跟一到三个十进制位表示该数字代码对应的字符</entry>
+       <entry>反斜线后跟一到三个八进制数字表示该数字代码对应的字节</entry>
       </row>
       <row>
        <entry><literal>\x</literal><replaceable>digits</replaceable></entry>
-       <entry>反斜线加<literal>x</literal>后跟一到三个十六进制位表示该数字代码对应的字符</entry>
+       <entry>反斜线加<literal>x</literal>后跟一到三个十六进制数字表示该数字代码对应的字节</entry>
       </row>
      </tbody>
     </tgroup>
    </informaltable>
 
-    当前，<command>COPY TO</command>不会发出一个十进制或十六进制位
+    当前，<command>COPY TO</command>不会发出一个八进制或十六进制位
     反斜线序列，但是它确实把上面列出的其他序列用于那些控制字符。
    </para>
 
@@ -1256,6 +1264,17 @@ ____________________________________________________________________________-->
     传输<command>COPY</command>文件，它们也很容易受到破坏。
    </para>
 
+<!--==========================orignal english content==========================
+   <para>
+     All backslash sequences are interpreted after encoding conversion.
+     The bytes specified with the octal and hex-digit backslash sequences must
+     form valid characters in the database encoding.
+   </para>
+____________________________________________________________________________-->
+   <para>
+     所有反斜杠序列都在编码转换后进行解释。
+     用八进制和十六进制数字反斜杠序列指定的字节必须在数据库编码中形成有效字符。
+   </para>
 <!--==========================orignal english content==========================
    <para>
     <command>COPY TO</command> will terminate each row with a Unix-style
@@ -2000,4 +2019,15 @@ COPY [ BINARY ] <replaceable class="parameter">table_name</replaceable>
     [ WITH NULL AS '<replaceable class="parameter">null_string</replaceable>' ]
 </synopsis></para>
  </refsect1>
+
+ <refsect1>
+<!--==========================orignal english content==========================
+  <title>See Also</title>
+____________________________________________________________________________-->
+  <title>另见</title>
+
+  <simplelist type="inline">
+   <member><xref linkend="copy-progress-reporting"/></member>
+  </simplelist>
+ </refsect1>
 </refentry>