Merge pull request #399 from ChenHuajun/master

翻译14 analyze.sgml等

Author: ChenHuajun

postgresql/doc/src/sgml/ref/analyze.sgml

@@ -296,13 +296,13 @@ ____________________________________________________________________________-->
    just after making major changes in the contents of a table.  Accurate
    statistics will help the planner to choose the most appropriate query
    plan, and thereby improve the speed of query processing.  A common
-   strategy for read-mostly databases is to run <xref linkend="sql-vacuum"/>
+   strategy for read-mostly databases is to run <link linkend="sql-vacuum"><command>VACUUM</command></link>
    and <command>ANALYZE</command> once a day during a low-usage time of day.
    (This will not be sufficient if there is heavy update activity.)
   </para>
 ____________________________________________________________________________-->
   <para>
-   在默认的<productname>PostgreSQL</productname>配置中，自动清理守护进程（见<xref linkend="autovacuum"/>）会在表第一次载入数据或者用常规操作改变时负责表的自动分析。当启用自动清理时，定期运行<command>ANALYZE</command>是个好主意，或者可以在表内容做了大的修改后运行<command>ANALYZE</command>。准确的统计信息将帮助规划器选择最合适的查询计划，从而提升查询处理的速度。主读数据库的一般策略是在一天中使用量最低时运行一次<xref linkend="sql-vacuum"/>和<command>ANALYZE</command>（如果有大量的更新动作则是不够的）。
+   在默认的<productname>PostgreSQL</productname>配置中，自动清理守护进程（见<xref linkend="autovacuum"/>）会在表第一次载入数据或者用常规操作改变时负责表的自动分析。当启用自动清理时，定期运行<command>ANALYZE</command>是个好主意，或者可以在表内容做了大的修改后运行<command>ANALYZE</command>。准确的统计信息将帮助规划器选择最合适的查询计划，从而提升查询处理的速度。主读数据库的一般策略是在一天中使用量最低时运行一次<link linkend="sql-vacuum"><command>VACUUM</command></link>和<command>ANALYZE</command>（如果有大量的更新动作则是不够的）。
   </para>
 
 <!--==========================orignal english content==========================
@@ -342,24 +342,24 @@ ____________________________________________________________________________-->
    will change slightly each time <command>ANALYZE</command> is run,
    even if the actual table contents did not change.  This might result
    in small changes in the planner's estimated costs shown by
-   <xref linkend="sql-explain"/>.
+   <link linkend="sql-explain"><command>EXPLAIN</command></link>.
    In rare situations, this non-determinism will cause the planner's
    choices of query plans to change after <command>ANALYZE</command> is run.
    To avoid this, raise the amount of statistics collected by
    <command>ANALYZE</command>, as described below.
   </para>
 ____________________________________________________________________________-->
   <para>
-   对于大型的表，<command>ANALYZE</command>会对表内容做随机采样而不是检查每一行。这允许在很少的时间内完成对大型表的分析。不过要注意，这些统计信息只是近似值，并且即使实际表内容没有改变，每次运行<command>ANALYZE</command>时统计信息都会有微小地改变。这可能会导致<xref linkend="sql-explain"/>显示的规划器估算代价有小的改变。在很少的情况下，这会非决定性地导致规划器的查询计划选择在<command>ANALYZE</command>运行后改变。为了避免这种情况，可以按照下文所述提高<command>ANALYZE</command>所收集的统计信息量。
+   对于大型的表，<command>ANALYZE</command>会对表内容做随机采样而不是检查每一行。这允许在很少的时间内完成对大型表的分析。不过要注意，这些统计信息只是近似值，并且即使实际表内容没有改变，每次运行<command>ANALYZE</command>时统计信息都会有微小地改变。这可能会导致<link linkend="sql-explain"><command>EXPLAIN</command></link>显示的规划器估算代价有小的改变。在很少的情况下，这会非决定性地导致规划器的查询计划选择在<command>ANALYZE</command>运行后改变。为了避免这种情况，可以按照下文所述提高<command>ANALYZE</command>所收集的统计信息量。
   </para>
 
 <!--==========================orignal english content==========================
   <para>
    The extent of analysis can be controlled by adjusting the
    <xref linkend="guc-default-statistics-target"/> configuration variable, or
    on a column-by-column basis by setting the per-column statistics
-   target with <command>ALTER TABLE ... ALTER COLUMN ... SET
-   STATISTICS</command> (see <xref linkend="sql-altertable"/>).
+   target with <link linkend="sql-altertable"><command>ALTER TABLE ... ALTER COLUMN ... SET
+   STATISTICS</command></link>.
    The target value sets the
    maximum number of entries in the most-common-value list and the
    maximum number of bins in the histogram.  The default target value
@@ -375,7 +375,7 @@ ____________________________________________________________________________-->
   </para>
 ____________________________________________________________________________-->
   <para>
-   通过调整<xref linkend="guc-default-statistics-target"/>配置变量可以控制分析量，对每个列可以用<command>ALTER TABLE ... ALTER COLUMN ... SET STATISTICS</command>设置每列的统计信息目标（见<xref linkend="sql-altertable"/>）。目标值会设置最常用值列表中的最大项数以及直方图中的最大容器数。默认目标值是 100，可以把它调大或者调小在规划器估计值精度和<command>ANALYZE</command>花费的时间以及<literal>pg_statistic</literal>所占空间之间做出平衡。特别地，将统计信息目标设置为零会禁用该列的统计信息收集。在查询的<literal>WHERE</literal>、<literal>GROUP BY</literal>或者<literal>ORDER BY</literal>子句中从不出现的列上这样做会有所帮助，因为规划器用不上这些列上的统计信息。
+   通过调整<xref linkend="guc-default-statistics-target"/>配置变量可以控制分析量，对每个列可以用<link linkend="sql-altertable"><command>ALTER TABLE ... ALTER COLUMN ... SET STATISTICS</command></link>设置每列的统计信息目标。目标值会设置最常用值列表中的最大项数以及直方图中的最大容器数。默认目标值是 100，可以把它调大或者调小在规划器估计值精度和<command>ANALYZE</command>花费的时间以及<literal>pg_statistic</literal>所占空间之间做出平衡。特别地，将统计信息目标设置为零会禁用该列的统计信息收集。在查询的<literal>WHERE</literal>、<literal>GROUP BY</literal>或者<literal>ORDER BY</literal>子句中从不出现的列上这样做会有所帮助，因为规划器用不上这些列上的统计信息。
   </para>
 
 <!--==========================orignal english content==========================
@@ -398,12 +398,11 @@ ____________________________________________________________________________-->
    with the largest possible statistics target.  If this inaccuracy leads to
    bad query plans, a more accurate value can be determined manually and then
    installed with
-   <command>ALTER TABLE ... ALTER COLUMN ... SET (n_distinct = ...)</command>
-   (see <xref linkend="sql-altertable"/>).
+   <link linkend="sql-altertable"><command>ALTER TABLE ... ALTER COLUMN ... SET (n_distinct = ...)</command></link>.
   </para>
 ____________________________________________________________________________-->
   <para>
-   <command>ANALYZE</command>所估算的值之一是出现在每个列中的可区分值。因为只会检查行的一个子集，即便使用最大的统计信息目标，这种估计有时也可能很不精确。如果这种不精确导致不好的查询计划，可以手工确定一个更精确的值并且用<command>ALTER TABLE ... ALTER COLUMN ... SET (n_distinct = ...)</command>设置该值（见<xref linkend="sql-altertable"/>）。
+   <command>ANALYZE</command>所估算的值之一是出现在每个列中的可区分值。因为只会检查行的一个子集，即便使用最大的统计信息目标，这种估计有时也可能很不精确。如果这种不精确导致不好的查询计划，可以手工确定一个更精确的值并且用<link linkend="sql-altertable"><command>ALTER TABLE ... ALTER COLUMN ... SET (n_distinct = ...)</command></link>设置该值。
   </para>
 
 <!--==========================orignal english content==========================
@@ -445,6 +444,18 @@ ____________________________________________________________________________-->
   <para>
     如果被分析的表不完全为空，<command>ANALYZE</command>将不会为该表记录新统计信息。任何现有统计信息将会被保留。
   </para>
+
+<!--==========================orignal english content==========================
+  <para>
+    Each backend running <command>ANALYZE</command> will report its progress
+    in the <structname>pg_stat_progress_analyze</structname> view. See
+    <xref linkend="analyze-progress-reporting"/> for details.
+  </para>
+____________________________________________________________________________-->
+  <para>
+    每个运行<command>ANALYZE</command>的后端将会在<structname>pg_stat_progress_analyze</structname>
+    视图中报告其进度。详细参考<xref linkend="analyze-progress-reporting"/>。
+  </para>
  </refsect1>
 
  <refsect1>
@@ -474,6 +485,7 @@ ____________________________________________________________________________-->
    <member><xref linkend="app-vacuumdb"/></member>
    <member><xref linkend="runtime-config-resource-vacuum-cost"/></member>
    <member><xref linkend="autovacuum"/></member>
+   <member><xref linkend="analyze-progress-reporting"/></member>
   </simplelist>
  </refsect1>
 </refentry>

postgresql/doc/src/sgml/ref/begin.sgml

@@ -70,9 +70,9 @@ ____________________________________________________________________________-->
   <para>
    <command>BEGIN</command> initiates a transaction block, that is,
    all statements after a <command>BEGIN</command> command will be
-   executed in a single transaction until an explicit <xref
-   linkend="sql-commit"/> or <xref
-   linkend="sql-rollback"/> is given.
+   executed in a single transaction until an explicit <link
+   linkend="sql-commit"><command>COMMIT</command></link> or <link
+   linkend="sql-rollback"><command>ROLLBACK</command></link> is given.
    By default (without <command>BEGIN</command>),
    <productname>PostgreSQL</productname> executes
    transactions in <quote>autocommit</quote> mode, that is, each
@@ -84,9 +84,9 @@ ____________________________________________________________________________-->
   <para>
    <command>BEGIN</command>开始一个事务块，也就是说所有
    <command>BEGIN</command>命令之后的所有语句将被在一个
-   事务中执行，直到给出一个显式的<xref linkend="sql-commit"/>或
-   者<xref linkend="sql-rollback"/>。默认情况下（没有
-   <command>BEGIN</command>），
+   事务中执行，直到给出一个显式的<link linkend="sql-commit"><command>COMMIT</command></link>
+   或者<link linkend="sql-rollback"><command>ROLLBACK</command></link>。
+   默认情况下（没有<command>BEGIN</command>），
    <productname>PostgreSQL</productname>在
    <quote>自动提交</quote>模式中执行事务，也就是说每个语句都
    在自己的事务中执行并且在语句结束时隐式地执行一次提交（如果执
@@ -114,13 +114,13 @@ ____________________________________________________________________________-->
   <para>
    If the isolation level, read/write mode, or deferrable mode is specified, the new
    transaction has those characteristics, as if
-   <xref linkend="sql-set-transaction"/>
+   <link linkend="sql-set-transaction"><command>SET TRANSACTION</command></link>
    was executed.
   </para>
 ____________________________________________________________________________-->
   <para>
    如果指定了隔离级别、读/写模式或者延迟模式，新事务也会有那些特性，
-   就像执行了<xref linkend="sql-set-transaction"/>一样。
+   就像执行了<link linkend="sql-set-transaction"><command>SET TRANSACTION</command></link>一样。
   </para>
  </refsect1>
 
@@ -173,25 +173,25 @@ ____________________________________________________________________________-->
 
 <!--==========================orignal english content==========================
   <para>
-   <xref linkend="sql-start-transaction"/> has the same functionality
+   <link linkend="sql-start-transaction"><command>START TRANSACTION</command></link> has the same functionality
    as <command>BEGIN</command>.
   </para>
 ____________________________________________________________________________-->
   <para>
-   <xref linkend="sql-start-transaction"/>具有和<command>BEGIN</command>
+   <link linkend="sql-start-transaction"><command>START TRANSACTION</command></link>具有和<command>BEGIN</command>
    相同的功能。
   </para>
 
 <!--==========================orignal english content==========================
   <para>
-   Use <xref linkend="sql-commit"/> or
-   <xref linkend="sql-rollback"/>
+   Use <link linkend="sql-commit"><command>COMMIT</command></link> or
+   <link linkend="sql-rollback"><command>ROLLBACK</command></link>
    to terminate a transaction block.
   </para>
 ____________________________________________________________________________-->
   <para>
-   使用<xref linkend="sql-commit"/>或者
-   <xref linkend="sql-rollback"/>来终止一个事务块。
+   使用<link linkend="sql-commit"><command>COMMIT</command></link>或者
+   <link linkend="sql-rollback"><command>ROLLBACK</command></link>来终止一个事务块。
   </para>
 
 <!--==========================orignal english content==========================
@@ -254,14 +254,14 @@ ____________________________________________________________________________-->
   <para>
    <command>BEGIN</command> is a <productname>PostgreSQL</productname>
    language extension.  It is equivalent to the SQL-standard command
-   <xref linkend="sql-start-transaction"/>, whose reference page
+   <link linkend="sql-start-transaction"><command>START TRANSACTION</command></link>, whose reference page
    contains additional compatibility information.
   </para>
 ____________________________________________________________________________-->
   <para>
    <command>BEGIN</command>是一种
    <productname>PostgreSQL</productname>语言扩展。它等效于
-   SQL 标准的命令<xref linkend="sql-start-transaction"/>，它的参考页
+   SQL 标准的命令<link linkend="sql-start-transaction"><command>START TRANSACTION</command></link>，它的参考页
    包含额外的兼容性信息。
   </para>
 

postgresql/doc/src/sgml/ref/call.sgml

@@ -106,13 +106,44 @@ ____________________________________________________________________________-->
     <listitem>
 <!--==========================orignal english content==========================
      <para>
-      An input argument for the procedure call.
-      See <xref linkend="sql-syntax-calling-funcs"/> for the full details on
-      function and procedure call syntax, including use of named parameters.
+      An argument expression for the procedure call.
      </para>
 ____________________________________________________________________________-->
      <para>
-      过程调用的一个输入参数。函数和过程调用语法的完整细节（包括参数的使用）请参考<xref linkend="sql-syntax-calling-funcs"/>。
+      过程调用的一个参数表达式。
+     </para>
+
+<!--==========================orignal english content==========================
+     <para>
+      Arguments can include parameter names, using the syntax
+      <literal><replaceable class="parameter">name</replaceable> =&gt; <replaceable class="parameter">value</replaceable></literal>.
+      This works the same as in ordinary function calls; see
+      <xref linkend="sql-syntax-calling-funcs"/> for details.
+     </para>
+____________________________________________________________________________-->
+     <para>
+      参数可以包括参数名称，使用语法为
+      <literal><replaceable class="parameter">name</replaceable> =&gt; <replaceable class="parameter">value</replaceable></literal>。
+      这与普通函数调用的工作方式相同。
+      详细参考<xref linkend="sql-syntax-calling-funcs"/>。
+     </para>
+
+<!--==========================orignal english content==========================
+     <para>
+      Arguments must be supplied for all procedure parameters that lack
+      defaults, including <literal>OUT</literal> parameters.  However,
+      arguments matching <literal>OUT</literal> parameters are not evaluated,
+      so it's customary to just write <literal>NULL</literal> for them.
+      (Writing something else for an <literal>OUT</literal> parameter
+      might cause compatibility problems with
+      future <productname>PostgreSQL</productname> versions.)
+     </para>
+____________________________________________________________________________-->
+     <para>
+      必须为所有缺少默认值的过程参数提供参数值，包括<literal>OUT</literal>参数。
+      然而，匹配<literal>OUT</literal>参数的参数不会被求值，因此通常为它们代入<literal>NULL</literal>。
+     （为<literal>OUT</literal>参数代入其他内容可能会导致与未来的
+     <productname>PostgreSQL</productname>版本的兼容问题。）
      </para>
     </listitem>
    </varlistentry>
@@ -191,11 +222,15 @@ ____________________________________________________________________________-->
 
 <!--==========================orignal english content==========================
   <para>
-   <command>CALL</command> conforms to the SQL standard.
+   <command>CALL</command> conforms to the SQL standard,
+   except for the handling of output parameters.  The standard
+   says that users should write variables to receive the values
+   of output parameters.
   </para>
 ____________________________________________________________________________-->
   <para>
-   <command>CALL</command>符合SQL标准。
+   <command>CALL</command>符合SQL标准，除了输出参数的处理。
+   该标准规定，用户应该编写变量来接收输出参数的值。
   </para>
  </refsect1>