doc: update pgstatstatements.sgml

Author: sizhitu

postgresql/doc/src/sgml/pgstatstatements.sgml

@@ -35,7 +35,7 @@ ____________________________________________________________________________-->
  </para>
 ____________________________________________________________________________-->
  <para>
-  该模块必须通过在<filename>postgresql.conf</filename>的<xref linkend="guc-shared-preload-libraries"/>中增加<literal>pg_stat_statements</literal>来载入，因为它需要额外的共享内存。这意味着增加或移除该模块需要一次服务器重启。
+  该模块必须通过在<filename>postgresql.conf</filename>的<xref linkend="guc-shared-preload-libraries"/>中增加<literal>pg_stat_statements</literal>来载入，因为它需要额外的共享内存。这意味着增加或移除该模块需要一次服务器重启。此外，必须启用查询ID计算器才能使模块处于active状态。如果<xref linkend="guc-compute-query-id"/>参数设置为<literal>auto</literal> 或者 <literal>on</literal>，或者如果加载了计算查询 id 的第三方模块， 则会自动完成此操作。
  </para>
 
 <!--==========================orignal english content==========================
@@ -50,7 +50,7 @@ ____________________________________________________________________________-->
  </para>
 ____________________________________________________________________________-->
  <para>
-   当<filename>pg_stat_statements</filename>被载入时，它会跟踪该服务器
+   当<filename>pg_stat_statements</filename>激活时，它会跟踪该服务器
    的所有数据库的统计信息。该模块提供了一个视图
    <structname>pg_stat_statements</structname>以及函数<function>pg_stat_statements_reset</function>
    和<function>pg_stat_statements</function>用于访问和操纵这些统计信息。这些视图
@@ -76,9 +76,8 @@ ____________________________________________________________________________-->
 ____________________________________________________________________________-->
   <para>
    由该模块收集的统计信息可以通过一个名为
-   <structname>pg_stat_statements</structname>的视图使用。这个视图为每
-   一个可区分的数据库 ID、用户 ID 和查询 ID（最多到该模块可以追
-   踪的可区分语句的数量）的组合都包含一行。该视图的列如
+   <structname>pg_stat_statements</structname>的视图使用。这个视图的每一行都包含
+   一个单独的数据库 ID、用户 ID 和查询 ID 以及它是否是顶级语句（最多到该模块可以追踪的可区分语句的数量）的组合。该视图的列如
    <xref linkend="pgstatstatements-columns"/>中所示。
   </para>
 
@@ -149,7 +148,15 @@ ____________________________________________________________________________-->
       <para>
        在其中执行该语句的数据库的 OID
       </para></entry>
-     </row>
+      </row>
+          <row>
+           <entry role="catalog_table_entry"><para role="column_definition">
+            <structfield>toplevel</structfield> <type>bool</type>
+           </para>
+           <para>
+            如果查询作为顶级 SQL 语句执行则为True（<varname>pg_stat_statements.track</varname>如果设置为<literal>top</literal>则始终为真）
+           </para></entry>
+       </row>
 
 <!--==========================orignal english content==========================
      <row>
@@ -166,7 +173,7 @@ ____________________________________________________________________________-->
        <structfield>queryid</structfield> <type>bigint</type>
       </para>
       <para>
-       内部哈希码，从语句的解析树计算得来
+       用于识别相同规范化查询的哈希码。
       </para></entry>
      </row>
 
@@ -732,7 +739,7 @@ ____________________________________________________________________________-->
        <structfield>wal_bytes</structfield> <type>numeric</type>
       </para>
       <para>
-       语句生成的 WAL 字节总数
+       SQL 语句生成的 WAL 总量（以字节为单位）
       </para></entry>
      </row>
 
@@ -772,6 +779,11 @@ ____________________________________________________________________________-->
   <para>
    只要可规划的查询（即<command>SELECT</command>、<command>INSERT</command>、<command>UPDATE</command>以及<command>DELETE</command>）根据一种内部哈希计算具有相同的查询结构，它们就会被组合到一个单一的<structname>pg_stat_statements</structname>项。通常，对于这里的目的，如果两个查询除了查询中的文本常量值之外在语义上等效，它们将会被认为是相同的。不过，功能性命令（即所有其他命令）会严格地以它们的文本查询字符串为基础进行比较。
   </para>
+    <note>
+     <para>
+     以下有关常量替换和<structfield>queryid</structfield>的详细信息仅适用于<xref linkend="guc-compute-query-id"/>有效的情况。 <structfield>queryid</structfield>如果您使用外部模块来计算，您应该参考该外部模块的文档以获取详细信息。
+     </para>
+    </note>
 
 <!--==========================orignal english content==========================
   <para>
@@ -927,7 +939,53 @@ ____________________________________________________________________________-->
    如果因为使用了缓存计划而跳过计划，则只会更新其执行统计信息。
   </para>
  </sect2>
+<sect2>
+  <title>The <structname>pg_stat_statements_info</structname> View</title>
+
+  <indexterm>
+   <primary>pg_stat_statements_info</primary>
+  </indexterm>
+
+  <para>
+   通过视图<structname>pg_stat_statements_info</structname>来生成和记录<filename>pg_stat_statements</filename> 本身模块的统计信息。这个视图只有一行数据，视图列显示在 <xref linkend="pgstatstatementsinfo-columns"/>中。
+  </para>
+
+  <table id="pgstatstatementsinfo-columns">
+   <title><structname>pg_stat_statements_info</structname> Columns</title>
+   <tgroup cols="1">
+    <thead>
+     <row>
+      <entry role="catalog_table_entry"><para role="column_definition">
+       Column Type
+      </para>
+      <para>
+       Description
+      </para></entry>
+     </row>
+    </thead>
 
+    <tbody>
+     <row>
+      <entry role="catalog_table_entry"><para role="column_definition">
+       <structfield>dealloc</structfield> <type>bigint</type>
+      </para>
+      <para>
+       由于观察到比<varname>pg_stat_statements.max</varname>更多的不同语句，关于最少执行语句的<structname>pg_stat_statements</structname>条目被删除的总次数。
+      </para></entry>
+     </row>
+     <row>
+      <entry role="catalog_table_entry"><para role="column_definition">
+       <structfield>stats_reset</structfield> <type>timestamp with time zone</type>
+      </para>
+      <para>
+       <structname>pg_stat_statements</structname>上次重置视图的所有统计信息的时间。
+      </para></entry>
+     </row>
+
+    </tbody>
+   </tgroup>
+  </table>
+ </sect2>
  <sect2>
 <!--==========================orignal english content==========================
   <title>Functions</title>
@@ -970,7 +1028,7 @@ ____________________________________________________________________________-->
       <function>pg_stat_statements_reset</function>丢弃到目前为止与指定的<structfield>userid</structfield>，
       <structfield>dbid</structfield>和<structfield>queryid</structfield>相对应的<filename>pg_stat_statements</filename>收集的统计信息。 
       如果有任何参数未被指定，那么将对这些参数使用默认值<literal>0</literal>（无效），并且将重置与其他参数匹配的统计信息。
-      如果未指定任何参数，或者所有指定的参数均为<literal>0</literal>（无效），则它将丢弃所有统计信息。
+      如果未指定任何参数，或者所有指定的参数均为<literal>0</literal>（无效），则它将丢弃所有统计信息。如果<filename>pg_stat_statements</filename>视图的所有统计信息都被丢弃，则<structname>pg_stat_statements_info</structname>视图的统计信息也将被重置。
       默认情况下，此功能只能由超级用户执行。可以使用<command>GRANT</command>授予其他人访问权限。
      </para>
     </listitem>
@@ -1062,7 +1120,7 @@ ____________________________________________________________________________-->
      </para>
 ____________________________________________________________________________-->
      <para>
-      <varname>pg_stat_statements.max</varname>是由该模块跟踪的语句的最大数目（即<structname>pg_stat_statements</structname>视图中行的最大数量）。如果观测到的可区分的语句超过这个数量，最少被执行的语句的信息将会被丢弃。默认值为 5000。这个参数只能在服务器启动时设置。
+      <varname>pg_stat_statements.max</varname>是由该模块跟踪的语句的最大数目（即<structname>pg_stat_statements</structname>视图中行的最大数量）。如果观测到的可区分的语句超过这个数量，最少被执行的语句的信息将会被丢弃。可以在<structname>pg_stat_statements_info</structname>视图中看到此类信息被丢弃的次数。默认值为 5000。这个参数只能在服务器启动时设置。
      </para>
     </listitem>
    </varlistentry>
@@ -1150,7 +1208,7 @@ ____________________________________________________________________________-->
 ____________________________________________________________________________-->
      <para>
       <varname>pg_stat_statements.track_planning</varname>控制模块是否跟踪计划操作和持续时间。
-      启用此参数可能会导致明显的性能损失，尤其是在许多并发连接上执行较少种类的查询时。
+      启用此参数可能会导致明显的性能损失，尤其是当具有相同查询结构的 SQL 语句由许多竞争更新少数<structname>pg_stat_statements</structname>条目的并发连接执行时。
       默认值为<literal>off</literal>。只有超级用户才能更改此设置。
      </para>
     </listitem>
@@ -1218,6 +1276,7 @@ ____________________________________________________________________________-->
 # postgresql.conf
 shared_preload_libraries = 'pg_stat_statements'
 
+compute_query_id = on
 pg_stat_statements.max = 10000
 pg_stat_statements.track = all
 </programlisting>