Merge pull request #445 from 1030504258/master

func.sgml 文件合并

Author: ChenHuajun

postgresql/doc/src/sgml/func.sgml

@@ -3225,8 +3225,8 @@ ________________________________________________________-->
         <returnvalue>numeric</returnvalue>
        </para>
        <para>
-        Rounds <parameter>v</parameter> to <parameter>s</parameter> decimal
-        places.  Ties are broken by rounding away from zero.
+        将 <parameter>v</parameter> 四舍五入到 <parameter>s</parameter> 位小数。
+        当出现平局时，通过远离零的方向进行四舍五入来解决。
        </para>
        <para>
         <literal>round(42.4382, 2)</literal>
@@ -5576,7 +5576,7 @@ ________________________________________________________-->
                    <secondary>前缀测试</secondary>
                </indexterm>
                <type>text</type> <literal>^@</literal> <type>text</type>
-               <returnvalue>布尔值</returnvalue>
+               <returnvalue>boolean</returnvalue>
            </para>
            <para>
                如果第一个字符串以第二个字符串开头，则返回true（等同于<function>starts_with()</function>函数）。
@@ -6536,11 +6536,8 @@ ________________________________________________________-->
         <returnvalue>setof text[]</returnvalue>
        </para>
        <para>
-        Returns substrings within the first match of the POSIX regular
-        expression <parameter>pattern</parameter> to
-        the <parameter>string</parameter>, or substrings within all
-        such matches if the <literal>g</literal> flag is used;
-        see <xref linkend="functions-posix-regexp"/>.
+        返回POSIX正则表达式 <parameter>pattern</parameter> 在 <parameter>string</parameter>中第一个匹配项内的子字符串, 或者如果使用 <literal>g</literal> 标志，则返回所有此类匹配项内的子字符串；
+        参见 <xref linkend="functions-posix-regexp"/>。
        </para>
        <para>
         <literal>regexp_matches('foobarbequebaz', 'ba.', 'g')</literal>
@@ -11476,8 +11473,8 @@ ________________________________________________________-->
      </optional></optional></optional></optional></optional>).
      在<replaceable>string</replaceable>中搜索<replaceable>pattern</replaceable>，通常从字符串的开头开始，但如果提供了<replaceable>start</replaceable>参数，则从该字符索引开始。
      如果指定了<replaceable>N</replaceable>，则定位模式的第<replaceable>N</replaceable>个匹配项，否则定位第一个匹配项。
-     如果省略了<replaceable>endoption</replaceable>参数或将其指定为零，则函数返回匹配项的第一个字符的位置。否则，<replaceable>endoption</replaceable>
-     必须为一，函数返回匹配项后面字符的位置。
+     如果省略了<replaceable>endoption</replaceable>参数或将其指定为0，则函数返回匹配项的第一个字符的位置。否则，<replaceable>endoption</replaceable>
+     必须为1，函数返回匹配项后面字符的位置。
      <replaceable>flags</replaceable>参数是一个可选的文本字符串，包含零个或多个单字母标志，可以改变函数的行为。支持的标志在<xref linkend="posix-embedded-options-table"/>中描述。
      对于包含括号子表达式的模式，<replaceable>subexpr</replaceable>是一个整数，表示感兴趣的子表达式：结果标识与该子表达式匹配的子字符串的位置。
      子表达式按其前导括号的顺序编号。
@@ -11967,13 +11964,13 @@ SELECT foo FROM regexp_split_to_table('the quick brown fox jumps over the lazy d
  the
  lazy
  dog
-(9 行)
+(9 rows)
 
 SELECT regexp_split_to_array('the quick brown fox jumps over the lazy dog', '\s+');
               regexp_split_to_array
 -----------------------------------------------
  {the,quick,brown,fox,jumps,over,the,lazy,dog}
-(1 行)
+(1 row)
 
 SELECT foo FROM regexp_split_to_table('the quick brown fox', '\s*') AS foo;
  foo
@@ -11994,7 +11991,7 @@ SELECT foo FROM regexp_split_to_table('the quick brown fox', '\s*') AS foo;
  f
  o
  x
-(16 行)
+(16 rows)
 </programlisting>
    </para>
 <!-- pgdoc-cn_end sig_en=0fbf6ff361b55e9d9bd8d64af5cf90aa -->
@@ -12180,7 +12177,7 @@ ________________________________________________________-->
    </para>
 ________________________________________________________-->
    <para>
-    一个分支是零个或多个<firstterm>量子化原子</firstterm>或<firstterm>约束</firstterm>，连接在一起。
+    一个分支是零个或多个<firstterm>quantified atoms</firstterm>或<firstterm>constraints</firstterm>，连接在一起。
     它匹配第一个的匹配项，然后是第二个的匹配项，依此类推；一个空分支匹配空字符串。
 </para>
 <!-- pgdoc-cn_end sig_en=12cd2a6352f29d02a1fdf5ef0f53f5d7 -->
@@ -17661,8 +17658,8 @@ ________________________________________________________-->
 ________________________________________________________-->
        <row>
         <entry role="func_table_entry"><para role="func_signature">
-         <type>时间戳</type> <literal>-</literal> <type>时间戳</type>
-         <returnvalue>间隔</returnvalue>
+         <type>timestamp</type> <literal>-</literal> <type>timestamp</type>
+         <returnvalue>interval</returnvalue>
         </para>
         <para>
          减去时间戳（将24小时间隔转换为天数，类似于<link
@@ -19551,8 +19548,8 @@ SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40');
 ________________________________________________________-->
        <para>
         对于<type>带有时区的时间戳</type>值，自1970-01-01 00:00:00 UTC以来的秒数（负值表示该时间戳之前的时间）；
-        对于<type>日期</type>和<type>时间戳</type>值，自1970-01-01 00:00:00以来的名义秒数，不考虑时区或夏令时规则；
-        对于<type>间隔</type>值，间隔中的总秒数
+        对于<type>date</type>和<type>timestamp</type>值，自1970-01-01 00:00:00以来的名义秒数，不考虑时区或夏令时规则；
+        对于<type>interval</type>值，间隔中的总秒数
        </para>
 <!-- pgdoc-cn_end sig_en=ddf5a7221042363051826d0869204217 -->
 
@@ -21855,15 +21852,15 @@ ________________________________________________________-->
        </para>
        <para>
         计算对象之间的距离。
-        对于所有七种几何类型，所有<type>点</type>与另一种几何类型的组合，
+        对于所有七种几何类型，所有<type>point(点)</type>与另一种几何类型的组合，
         以及以下这些额外的类型对：
-        (<type>盒</type>, <type>线段</type>),
-        (<type>线段</type>, <type>线</type>),
-        (<type>多边形</type>, <type>圆</type>)
+        (<type>box(盒)</type>, <type>lseg(线段)</type>),
+        (<type>lseg(线段)</type>, <type>line(线)</type>),
+        (<type>polygon(多边形)</type>, <type>circle(圆)</type>)
         （以及交换位置的情况）。
        </para>
        <para>
-        <literal>圆 '&lt;(0,0),1&gt;' &lt;-&gt; 圆 '&lt;(5,0),1&gt;'</literal>
+        <literal>circle '&lt;(0,0),1&gt;' &lt;-&gt; circle '&lt;(5,0),1&gt;'</literal>
         <returnvalue>3</returnvalue>
        </para></entry>
       </row>
@@ -29088,17 +29085,17 @@ xml $$
 <ROWS>
   <ROW id="1">
     <COUNTRY_ID>AU</COUNTRY_ID>
-    <COUNTRY_NAME>澳大利亚</COUNTRY_NAME>
+    <COUNTRY_NAME>Australia</COUNTRY_NAME>
   </ROW>
   <ROW id="5">
     <COUNTRY_ID>JP</COUNTRY_ID>
-    <COUNTRY_NAME>日本</COUNTRY_NAME>
-    <PREMIER_NAME>安倍晋三</PREMIER_NAME>
+    <COUNTRY_NAME>Japan</COUNTRY_NAME>
+    <PREMIER_NAME>Shinzo Abe</PREMIER_NAME>
     <SIZE unit="sq_mi">145935</SIZE>
   </ROW>
   <ROW id="6">
     <COUNTRY_ID>SG</COUNTRY_ID>
-    <COUNTRY_NAME>新加坡</COUNTRY_NAME>
+    <COUNTRY_NAME>Singapore</COUNTRY_NAME>
     <SIZE unit="sq_km">697</SIZE>
   </ROW>
 </ROWS>
@@ -29119,9 +29116,9 @@ SELECT xmltable.*
 
  id | ordinality | COUNTRY_NAME | country_id | size_sq_km |  size_other  | premier_name
 ----+------------+--------------+------------+------------+--------------+---------------
-  1 |          1 | 澳大利亚     | AU         |            |              | 未指定
-  5 |          2 | 日本         | JP         |            | 145935 sq_mi | 安倍晋三
-  6 |          3 | 新加坡       | SG         |        697 |              | 未指定
+  1 |          1 | Australia    | AU         |            |              | not specified
+  5 |          2 | Japan        | JP         |            | 145935 sq_mi | Shinzo Abe
+  6 |          3 | Singapore    | SG         |        697 |              | not specified
 ]]></screen>
 
      下面的例子展示了多个text()节点的连接，列名作为XPath过滤器的使用，以及对空格、XML注释和处理指令的处理:
@@ -29130,15 +29127,15 @@ SELECT xmltable.*
 CREATE TABLE xmlelements AS SELECT
 xml $$
   <root>
-   <element>  你好<!-- xyxxz -->2a2<?aaaaa?> <!--x-->  bbb<x>xxx</x>CC  </element>
+   <element>  Hello<!-&minus; xyxxz -&minus;>2a2<?aaaaa?> <!-&minus;x-&minus;>  bbb<x>xxx</x>CC  </element>
   </root>
 $$ AS data;
 
 SELECT xmltable.*
   FROM xmlelements, XMLTABLE('/root' PASSING data COLUMNS element text);
          element
--------------------------
-   你好2a2   bbbxxxCC
+-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-
+   Hello2a2   bbbxxxCC
 ]]></screen>
     </para>
 <!-- pgdoc-cn_end sig_en=9d65fd99234702d600fb4437237e55bb -->
@@ -32033,11 +32030,11 @@ ________________________________________________________-->
         <indexterm>
          <primary>jsonb_set_lax</primary>
         </indexterm>
-        <function>jsonb_set_lax</function> ( <parameter>目标</parameter> <type>jsonb</type>, <parameter>路径</parameter> <type>text[]</type>, <parameter>新值</parameter> <type>jsonb</type> <optional>, <parameter>如果缺失则创建</parameter> <type>boolean</type> <optional>, <parameter>空值处理方式</parameter> <type>text</type> </optional></optional> )
+        <function>jsonb_set_lax</function> ( <parameter>target</parameter> <type>jsonb</type>, <parameter>path</parameter> <type>text[]</type>, <parameter>new_value</parameter> <type>jsonb</type> <optional>, <parameter>create_if_missing</parameter> <type>boolean</type> <optional>, <parameter>null_value_treatment</parameter> <type>text</type> </optional></optional> )
         <returnvalue>jsonb</returnvalue>
        </para>
        <para>
-        如果<parameter>新值</parameter>不是<literal>NULL</literal>，则行为与<literal>jsonb_set</literal>完全相同。否则，根据<parameter>空值处理方式</parameter>的值进行处理，其值必须是<literal>'raise_exception'</literal>、<literal>'use_json_null'</literal>、<literal>'delete_key'</literal>或<literal>'return_target'</literal>之一。默认值为<literal>'use_json_null'</literal>。
+        如果<parameter>new_value</parameter>不是<literal>NULL</literal>，则行为与<literal>jsonb_set</literal>完全相同。否则，根据<parameter>null_value_treatment</parameter>的值进行处理，其值必须是<literal>'raise_exception'</literal>、<literal>'use_json_null'</literal>、<literal>'delete_key'</literal>或<literal>'return_target'</literal>之一。默认值为<literal>'use_json_null'</literal>。
        </para>
        <para>
         <literal>jsonb_set_lax('[{"f1":1,"f2":null},2,null,3]', '{0,f1}', null)</literal>
@@ -39409,7 +39406,7 @@ ________________________________________________________-->
         <indexterm>
          <primary>最大值</primary>
         </indexterm>
-        <function>最大值</function> ( <replaceable>见文本</replaceable> )
+        <function>max</function> ( <replaceable>见文本</replaceable> )
         <returnvalue><replaceable>与输入类型相同</replaceable></returnvalue>
        </para>
        <para>
@@ -39486,7 +39483,7 @@ ________________________________________________________-->
       <row>
        <entry role="func_table_entry"><para role="func_signature">
         <indexterm>
-         <primary>range_agg</primary>
+         <primary>时间范围并集</primary>
         </indexterm>
         <function>range_agg</function> ( <parameter>value</parameter>
          <type>anyrange</type> )
@@ -39528,7 +39525,7 @@ ________________________________________________________-->
       <row>
        <entry role="func_table_entry"><para role="func_signature">
         <indexterm>
-         <primary>range_intersect_agg</primary>
+         <primary>时间范围交集</primary>
         </indexterm>
         <function>range_intersect_agg</function> ( <parameter>value</parameter>
          <type>anyrange</type> )
@@ -42550,13 +42547,13 @@ OR
   </para>
 ________________________________________________________-->
   <para>
-   右侧是一个用括号括起来的表达式列表。如果左侧表达式的结果等于右侧任何一个表达式的结果，则结果为<quote>真</quote>。
+   右侧是一个用括号括起来的表达式列表。如果左侧表达式的结果等于右侧任何一个表达式的结果，则结果为<quote>true</quote>。
    这是一个简写表示法，如下所示：
 
 <synopsis>
-<replaceable>表达式</replaceable> = <replaceable>值1</replaceable>
+<replaceable>expression</replaceable> = <replaceable>value1</replaceable>
 或
-<replaceable>表达式</replaceable> = <replaceable>值2</replaceable>
+<replaceable>expression</replaceable> = <replaceable>value2</replaceable>
 或
 ...
 </synopsis>
@@ -42809,10 +42806,10 @@ ________________________________________________________-->
    每一边都是一个行构造器，
    如在<xref linkend="sql-syntax-row-constructors"/>中描述的那样。
    这两个行构造器必须具有相同数量的字段。
-   给定的<replaceable>操作符</replaceable>应用于每一对
+   给定的<replaceable>operator</replaceable>应用于每一对
    对应的字段。（由于字段可能是不同类型的，这意味着每对可能选择不同的具体操作符。）
    所有选定的操作符必须是某个B树操作符类的成员，或者是B树操作符类的<literal>=</literal>成员的否定形式，
-   这意味着只有当<replaceable>操作符</replaceable>是
+   这意味着只有当<replaceable>operator</replaceable>是
    <literal>=</literal>、
    <literal>&lt;&gt;</literal>、
    <literal>&lt;</literal>、
@@ -44161,15 +44158,15 @@ ________________________________________________________-->
          <primary>pg_current_logfile</primary>
         </indexterm>
         <indexterm>
-         <primary>日志</primary>
+         <primary>Logging</primary>
          <secondary>pg_current_logfile函数</secondary>
         </indexterm>
         <indexterm>
           <primary>current_logfiles</primary>
           <secondary>和pg_current_logfile函数</secondary>
         </indexterm>
         <indexterm>
-         <primary>日志</primary>
+         <primary>Logging</primary>
          <secondary>current_logfiles文件和pg_current_logfile函数</secondary>
         </indexterm>
         <function>pg_current_logfile</function> ( <optional> <type>text</type> </optional> )
@@ -52220,9 +52217,7 @@ ________________________________________________________-->
         <returnvalue>oid</returnvalue>
        </para>
        <para>
-        Looks up a replication origin by name and returns the internal ID. If
-        no such replication origin is found, <literal>NULL</literal> is
-        returned.
+        通过名称查找复制源并返回其内部ID。如果未找到这样的复制源，则返回 <literal>NULL</literal>。
        </para></entry>
       </row>
 <!-- pgdoc-cn_end sig_en=8f393ceff60e147ea74683117490ab0e -->

postgresql/doc/src/sgml/manage-ag.sgml

@@ -265,11 +265,11 @@ ________________________________________________________-->
   </para>
 ________________________________________________________-->
   <para>
-   在数据库集群初始化期间还会创建两个额外的数据库，
+   在集簇初始化期间还会创建两个额外的数据库，
    <literal>template1</literal><indexterm><primary>template1</primary></indexterm>
    和
    <literal>template0</literal>，<indexterm><primary>template0</primary></indexterm>
-   。每当在集群中创建新数据库时，实际上是克隆了<literal>template1</literal>。
+   。每当在集簇中创建新数据库时，实际上是克隆了<literal>template1</literal>。
    这意味着您在<literal>template1</literal>中所做的任何更改都会传播到随后创建的所有数据库中。
    因此，除非您希望这些更改传播到每个新创建的数据库中，否则应避免在<literal>template1</literal>中创建对象。
    <literal>template0</literal>旨在作为<literal>template1</literal>原始内容的原始副本。
@@ -735,7 +735,7 @@ ________________________________________________________-->
    </para>
 ________________________________________________________-->
    <para>
-     即使位于主PostgreSQL数据目录之外，表空间仍然是数据库集群的一个组成部分，
+     即使位于主PostgreSQL数据目录之外，表空间仍然是集簇的一个组成部分，
      <emphasis>不能</emphasis>被视为一个独立的数据文件集合。它们依赖于主数据目录中包含的元数据，
      因此不能附加到不同的数据库集群或单独备份。同样，如果丢失一个表空间（文件删除、磁盘故障等），
      数据库集群可能变得无法读取或无法启动。将表空间放在像RAM磁盘这样的临时文件系统上会