translate start.sgml, storage.sgxml, textsearch.sgml

Author: messon

postgresql/doc/src/sgml/start.sgml

@@ -174,14 +174,14 @@ ____________________________________________________________________________-->
     From that point on, the client and the new server process
     communicate without intervention by the original
     <filename>postgres</filename> process.  Thus, the
-    master server process is always running, waiting for
+    supervisor server process is always running, waiting for
     client connections, whereas client and associated server processes
     come and go.  (All of this is of course invisible to the user.  We
     only mention it here for completeness.)
    </para>
 ____________________________________________________________________________-->
    <para>
-    <productname>PostgreSQL</productname>服务器可以处理来自客户端的多个并发请求。 因此，它为每个连接启动（<quote>forks</quote>）一个新的进程。 从这个时候开始，客户端和新服务器进程就不再经过最初的 <filename>postgres</filename>进程的干涉进行通讯。 因此，主服务器进程总是在运行并等待着客户端联接， 而客户端和相关联的服务器进程则是起起停停（当然，这些对用户是透明的。我们介绍这些主要是为了内容的完整性）。
+    <productname>PostgreSQL</productname>服务器可以处理来自客户端的多个并发请求。 因此，它为每个连接启动（<quote>forks</quote>）一个新的进程。 从这个时候开始，客户端和新服务器进程就不再经过最初的 <filename>postgres</filename>进程的干涉进行通讯。 因此，守护者服务器进程总是在运行并等待着客户端联接， 而客户端和相关联的服务器进程则是起起停停（当然，这些对用户是透明的。我们介绍这些主要是为了内容的完整性）。
    </para>
   </sect1>
 
@@ -289,30 +289,28 @@ createdb: command not found
    <para>
     Another response could be this:
 <screen>
-createdb: could not connect to database postgres: could not connect to server: No such file or directory
-        Is the server running locally and accepting
-        connections on Unix domain socket "/tmp/.s.PGSQL.5432"?
+createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such file or directory
+        Is the server running locally and accepting connections on that socket?
 </screen>
-    This means that the server was not started, or it was not started
-    where <command>createdb</command> expected it.  Again, check the
+    This means that the server was not started, or it is not listening
+    where <command>createdb</command> expects to contact it.  Again, check the
     installation instructions or consult the administrator.
    </para>
 ____________________________________________________________________________-->
    <para>
     另外一种响应可能是这样：
 <screen>
-createdb: could not connect to database postgres: could not connect to server: No such file or directory
-        Is the server running locally and accepting
-        connections on Unix domain socket "/tmp/.s.PGSQL.5432"?
+createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such file or directory
+        Is the server running locally and accepting connections on that socket?
 </screen>
-    这意味着该服务器没有启动，或者没有按照<command>createdb</command>预期地启动。同样， 你也要查看安装指导或者咨询管理员。
+    这意味着该服务器没有启动，或者在<command>createdb</command>期望去连接它的时候没有在监听。同样， 你也要查看安装指导或者咨询管理员。
    </para>
 
 <!--==========================orignal english content==========================
    <para>
     Another response could be this:
 <screen>
-createdb: could not connect to database postgres: FATAL:  role "joe" does not exist
+createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: FATAL:  role "joe" does not exist
 </screen>
     where your own login name is mentioned.  This will happen if the
     administrator has not created a <productname>PostgreSQL</productname> user account
@@ -331,7 +329,7 @@ ____________________________________________________________________________-->
    <para>
     另外一个响应可能是这样：
 <screen>
-createdb: could not connect to database postgres: FATAL:  role "joe" does not exist
+createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: FATAL:  role "joe" does not exist
 </screen>
     在这里提到了你自己的登录名。如果管理员没有为你创建<productname>PostgreSQL</productname>用户帐号， 就会发生这些现象。（<productname>PostgreSQL</productname>用户帐号和操作系统用户帐号是不同的。） 如果你是管理员，参阅<xref linkend="user-manag"/>获取创建用户帐号的帮助。 你需要变成安装<productname>PostgreSQL</productname>的操作系统用户的身份（通常是 <literal>postgres</literal>）才能创建第一个用户帐号。 也有可能是赋予你的<productname>PostgreSQL</productname>用户名和你的操作系统用户名不同； 这种情况下，你需要使用<option>-U</option>选项或者使用<envar>PGUSER</envar>环境变量指定你的<productname>PostgreSQL</productname>用户名。
    </para>
@@ -341,7 +339,7 @@ createdb: could not connect to database postgres: FATAL:  role "joe" does not ex
     If you have a user account but it does not have the privileges required to
     create a database, you will see the following:
 <screen>
-createdb: database creation failed: ERROR:  permission denied to create database
+createdb: error: database creation failed: ERROR:  permission denied to create database
 </screen>
     Not every user has authorization to create new databases.  If
     <productname>PostgreSQL</productname> refuses to create databases
@@ -373,7 +371,7 @@ ____________________________________________________________________________-->
    <para>
     如果你有个数据库用户帐号，但是没有创建数据库所需要的权限，那么你会看到下面的信息：
 <screen>
-createdb: database creation failed: ERROR:  permission denied to create database
+createdb: error: database creation failed: ERROR:  permission denied to create database
 </screen>
     并非所有用户都被许可创建新数据库。 如果<productname>PostgreSQL</productname>拒绝为你创建数据库， 那么你需要让站点管理员赋予你创建数据库的权限。出现这种情况时请咨询你的站点管理员。 如果你自己安装了<productname>PostgreSQL</productname>， 那么你应该以你启动数据库服务器的用户身份登录然后参考手册完成权限的赋予工作。
 

postgresql/doc/src/sgml/storage.sgml

@@ -647,6 +647,22 @@ ____________________________________________________________________________-->
 的内容将说明这个问题。
 </para>
 
+<!--==========================orignal english content==========================
+<para>
+The compression technique used for either in-line or out-of-line compressed
+data can be selected for each column by setting
+the <literal>COMPRESSION</literal> column option in <command>CREATE
+TABLE</command> or <command>ALTER TABLE</command>.  The default for columns
+with no explicit setting is to consult the
+<xref linkend="guc-default-toast-compression"/> parameter at the time data is
+inserted.
+</para>
+____________________________________________________________________________-->
+<para>
+线内或者线外压缩数据所使用的压缩技术可以在<command>CREATE TABLE</command>或<command>ALTER TABLE</command>时设置<literal>COMPRESSION</literal>列选项来为每一列选择。
+未显式设置的列的缺省值参照插入数据时的参数<xref linkend="guc-default-toast-compression"/>。
+</para>
+
 <!--==========================orignal english content==========================
 <para>
 As mentioned, there are multiple types of <acronym>TOAST</acronym> pointer datums.
@@ -678,20 +694,6 @@ ____________________________________________________________________________-->
 <xref linkend="storage-toast-inmemory"/>。
 </para>
 
-<!--==========================orignal english content==========================
-<para>
-The compression technique used for either in-line or out-of-line compressed
-data is a fairly simple and very fast member
-of the LZ family of compression techniques.  See
-<filename>src/common/pg_lzcompress.c</filename> for the details.
-</para>
-____________________________________________________________________________-->
-<para>
-线内或者线外压缩数据所使用的压缩技术是 LZ 压缩技术家族中一种
-相对简单且非常快速的成员。详见
-<filename>src/common/pg_lzcompress.c</filename>。
-</para>
-
 <sect2 id="storage-toast-ondisk">
 <!--==========================orignal english content==========================
  <title>Out-of-Line, On-Disk TOAST Storage</title>
@@ -727,14 +729,15 @@ retrieval of the values.  A pointer datum representing an out-of-line on-disk
 <acronym>TOAST</acronym>ed value therefore needs to store the OID of the
 <acronym>TOAST</acronym> table in which to look and the OID of the specific value
 (its <structfield>chunk_id</structfield>).  For convenience, pointer datums also store the
-logical datum size (original uncompressed data length) and physical stored size
-(different if compression was applied).  Allowing for the varlena header bytes,
+logical datum size (original uncompressed data length), physical stored size
+(different if compression was applied), and the compression method used, if
+any.  Allowing for the varlena header bytes,
 the total size of an on-disk <acronym>TOAST</acronym> pointer datum is therefore 18
 bytes regardless of the actual size of the represented value.
 </para>
 ____________________________________________________________________________-->
 <para>
-线外值被分裂成（如果压缩过，在压缩之后分裂）最大为<symbol>TOAST_MAX_CHUNK_SIZE</symbol>（默认情况下该值应选为使得四个块（chunk）行能放在一个页面中，这个数值大约为2000 字节）字节的块。每个块都作为独立的行存储在从属于所属表的<acronym>TOAST</acronym>表中。每个<acronym>TOAST</acronym>表都有列<structfield>chunk_id</structfield>（一个表示特定的被<acronym>TOAST</acronym>过的数据的OID）、<structfield>chunk_seq</structfield>（一个序列号，存储该块在值中的位置）和一个<structfield>chunk_data</structfield>（该块的实际数据）。在<structfield>chunk_id</structfield>和<structfield>chunk_seq</structfield>上有一个唯一索引， 提供对值的快速检索。因此，一个表示线外磁盘上<acronym>TOAST</acronym>过的值的指针数据应存储要查看的<acronym>TOAST</acronym>表的OID以及 指定值的OID（它的<structfield>chunk_id</structfield>）。为了方便， 指针数据还存储逻辑数据的尺寸（原始的未压缩的数据长度）以及物理存储的尺寸（如果应用了压缩，则两者不同）。 加上变长数据头部的字节，一个磁盘上<acronym>TOAST</acronym>指针数据的总尺寸是18字节，不管它代表的值的实际长度是多大。
+线外值被分裂成（如果压缩过，在压缩之后分裂）最大为<symbol>TOAST_MAX_CHUNK_SIZE</symbol>（默认情况下该值应选为使得四个块（chunk）行能放在一个页面中，这个数值大约为2000 字节）字节的块。每个块都作为独立的行存储在从属于所属表的<acronym>TOAST</acronym>表中。每个<acronym>TOAST</acronym>表都有列<structfield>chunk_id</structfield>（一个表示特定的被<acronym>TOAST</acronym>过的数据的OID）、<structfield>chunk_seq</structfield>（一个序列号，存储该块在值中的位置）和一个<structfield>chunk_data</structfield>（该块的实际数据）。在<structfield>chunk_id</structfield>和<structfield>chunk_seq</structfield>上有一个唯一索引， 提供对值的快速检索。因此，一个表示线外磁盘上<acronym>TOAST</acronym>过的值的指针数据应存储要查看的<acronym>TOAST</acronym>表的OID以及 指定值的OID（它的<structfield>chunk_id</structfield>）。为了方便， 指针数据还存储逻辑数据的尺寸（原始的未压缩的数据长度），物理存储的尺寸（如果应用了压缩，则两者不同）以及采用的压缩方法(如果有的话)。 加上变长数据头部的字节，一个磁盘上<acronym>TOAST</acronym>指针数据的总尺寸是18字节，不管它代表的值的实际长度是多大。
 </para>
 
 <!--==========================orignal english content==========================

postgresql/doc/src/sgml/textsearch.sgml

@@ -3024,7 +3024,7 @@ ____________________________________________________________________________-->
 <!--==========================orignal english content==========================
        <para>
         This form of <function>ts_rewrite</function> accepts a starting
-        <replaceable>query</replaceable> and a SQL <replaceable>select</replaceable> command, which
+        <replaceable>query</replaceable> and an SQL <replaceable>select</replaceable> command, which
         is given as a text string.  The <replaceable>select</replaceable> must yield two
         columns of <type>tsquery</type> type.  For each row of the
         <replaceable>select</replaceable> result, occurrences of the first column value
@@ -3853,13 +3853,13 @@ ____________________________________________________________________________-->
 <!--==========================orignal english content==========================
    <para>
     <literal>email</literal> does not support all valid email characters as
-    defined by RFC 5322.  Specifically, the only non-alphanumeric
-    characters supported for email user names are period, dash, and
-    underscore.
+    defined by <ulink url="https://tools.ietf.org/html/rfc5322">RFC 5322</ulink>.
+    Specifically, the only non-alphanumeric characters supported for
+    email user names are period, dash, and underscore.
    </para>
 ____________________________________________________________________________-->
    <para>
-    <literal>email</literal>不支持 RFC 5322 定义的所有合法 email 字符。具体来说，对 email 用户名被支持的非字母数字字符只有句点、破折号和下划线。
+    <literal>email</literal>不支持<ulink url="https://tools.ietf.org/html/rfc5322">RFC 5322</ulink>定义的所有合法 email 字符。具体来说，对 email 用户名被支持的非字母数字字符只有句点、破折号和下划线。
    </para>
   </note>
 
@@ -6762,13 +6762,17 @@ ____________________________________________________________________________-->
    Schema   |      Name       |                        Description
 -&minus;-&minus;-&minus;-&minus;-&minus;-&minus;+-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-+-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-&minus;-
  pg_catalog | arabic_stem     | snowball stemmer for arabic language
+ pg_catalog | armenian_stem   | snowball stemmer for armenian language
+ pg_catalog | basque_stem     | snowball stemmer for basque language
+ pg_catalog | catalan_stem    | snowball stemmer for catalan language
  pg_catalog | danish_stem     | snowball stemmer for danish language
  pg_catalog | dutch_stem      | snowball stemmer for dutch language
  pg_catalog | english_stem    | snowball stemmer for english language
  pg_catalog | finnish_stem    | snowball stemmer for finnish language
  pg_catalog | french_stem     | snowball stemmer for french language
  pg_catalog | german_stem     | snowball stemmer for german language
  pg_catalog | greek_stem      | snowball stemmer for greek language
+ pg_catalog | hindi_stem      | snowball stemmer for hindi language
  pg_catalog | hungarian_stem  | snowball stemmer for hungarian language
  pg_catalog | indonesian_stem | snowball stemmer for indonesian language
  pg_catalog | irish_stem      | snowball stemmer for irish language
@@ -6779,11 +6783,13 @@ ____________________________________________________________________________-->
  pg_catalog | portuguese_stem | snowball stemmer for portuguese language
  pg_catalog | romanian_stem   | snowball stemmer for romanian language
  pg_catalog | russian_stem    | snowball stemmer for russian language
+ pg_catalog | serbian_stem    | snowball stemmer for serbian language
  pg_catalog | simple          | simple dictionary: just lower case and check for stopword
  pg_catalog | spanish_stem    | snowball stemmer for spanish language
  pg_catalog | swedish_stem    | snowball stemmer for swedish language
  pg_catalog | tamil_stem      | snowball stemmer for tamil language
  pg_catalog | turkish_stem    | snowball stemmer for turkish language
+ pg_catalog | yiddish_stem    | snowball stemmer for yiddish language
 </screen>
      </para>
 ____________________________________________________________________________-->
@@ -6795,13 +6801,17 @@ ____________________________________________________________________________-->
    Schema   |      Name       |                        Description
 ------------+-----------------+-----------------------------------------------------------
  pg_catalog | arabic_stem     | snowball stemmer for arabic language
+ pg_catalog | armenian_stem   | snowball stemmer for armenian language
+ pg_catalog | basque_stem     | snowball stemmer for basque language
+ pg_catalog | catalan_stem    | snowball stemmer for catalan language
  pg_catalog | danish_stem     | snowball stemmer for danish language
  pg_catalog | dutch_stem      | snowball stemmer for dutch language
  pg_catalog | english_stem    | snowball stemmer for english language
  pg_catalog | finnish_stem    | snowball stemmer for finnish language
  pg_catalog | french_stem     | snowball stemmer for french language
  pg_catalog | german_stem     | snowball stemmer for german language
  pg_catalog | greek_stem      | snowball stemmer for greek language
+ pg_catalog | hindi_stem      | snowball stemmer for hindi language
  pg_catalog | hungarian_stem  | snowball stemmer for hungarian language
  pg_catalog | indonesian_stem | snowball stemmer for indonesian language
  pg_catalog | irish_stem      | snowball stemmer for irish language
@@ -6812,11 +6822,13 @@ ____________________________________________________________________________-->
  pg_catalog | portuguese_stem | snowball stemmer for portuguese language
  pg_catalog | romanian_stem   | snowball stemmer for romanian language
  pg_catalog | russian_stem    | snowball stemmer for russian language
+ pg_catalog | serbian_stem    | snowball stemmer for serbian language
  pg_catalog | simple          | simple dictionary: just lower case and check for stopword
  pg_catalog | spanish_stem    | snowball stemmer for spanish language
  pg_catalog | swedish_stem    | snowball stemmer for swedish language
  pg_catalog | tamil_stem      | snowball stemmer for tamil language
  pg_catalog | turkish_stem    | snowball stemmer for turkish language
+ pg_catalog | yiddish_stem    | snowball stemmer for yiddish language
 </screen>
      </para>
     </listitem>