Skip to content

Commit 138d628

Browse files
committed
翻译术语调整
中文文档->中文手册 臭虫->Bug 逃逸->转义 盘簇化表记录(cluster)->聚簇 校勘(collations)->排序规则 节点管理员(site administrator)->站点管理员 字串类型(token type)->标记类型
1 parent d3682cb commit 138d628

39 files changed

+276
-276
lines changed

postgresql/doc/src/sgml/array.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -887,7 +887,7 @@ SELECT * FROM sal_emp WHERE pay_by_quarter && ARRAY[10000];
887887
<para>
888888
如果数组元素值是空字符串或者包含花括弧、分隔符、双引号、反斜杠、空白,
889889
或者匹配关键字<literal>NULL</>,那么数组输出过程将在这些值周围包围双引号。
890-
在元素值里包含的双引号和反斜杠将被反斜杠逃逸。对于数值数据类型,
890+
在元素值里包含的双引号和反斜杠将被反斜杠转义。对于数值数据类型,
891891
你可以安全地假设数值没有双引号包围,但是对于文本类型,
892892
我们就需要准备好面对有双引号包围和没有双引号包围两种情况了。
893893
</para>
@@ -965,7 +965,7 @@ SELECT f1[1][-2][3] AS e1, f1[1][-1][5] AS e2
965965
当元素值可能让数组值解析器产生歧义时,你<emphasis>必须</>这么做。
966966
例如:元素值包含花括号、逗号(或者数据类型分割符)、双引号、反斜杠、
967967
在开头/结尾处有空白符、匹配 NULL 的字符串。要在元素值中包含双引号或反斜杠,
968-
可以加一个前导反斜杠。当然,你也可以避免引用和使用反斜杠逃逸来保护任何可能引起语法混淆的字符
968+
可以加一个前导反斜杠。当然,你也可以避免引用和使用反斜杠转义来保护任何可能引起语法混淆的字符
969969
</para>
970970

971971
<!--

postgresql/doc/src/sgml/config.sgml

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5340,9 +5340,9 @@ local0.* /var/log/postgresql
53405340
-->
53415341
<para>
53425342
在打开了<varname>logging_collector</varname>的时候,这个选项设置所创建的日志文件的文件名。
5343-
这个数值将被当作<function>strftime</function>模式看待。因此可以用<literal>%</literal>逃逸声明随时间而变的文件名
5344-
(注意,如果有任何时区相关<literal>%</literal>逃逸,由<xref linkend="guc-log-timezone">声明的时区进行计算。)
5345-
支持的<literal>%</literal>逃逸类似于Open Group上的<ulink url="http://pubs.opengroup.org/onlinepubs/009695399/functions/strftime.html">strftime</ulink>规范列表中的。
5343+
这个数值将被当作<function>strftime</function>模式看待。因此可以用<literal>%</literal>转义声明随时间而变的文件名
5344+
(注意,如果有任何时区相关<literal>%</literal>转义,由<xref linkend="guc-log-timezone">声明的时区进行计算。)
5345+
支持的<literal>%</literal>转义类似于Open Group上的<ulink url="http://pubs.opengroup.org/onlinepubs/009695399/functions/strftime.html">strftime</ulink>规范列表中的。
53465346
注意,不直接使用这个系统的<systemitem>strftime</systemitem>,所以特定平台的(非标准)扩展不起作用。
53475347
</para>
53485348
<!--
@@ -5357,7 +5357,7 @@ local0.* /var/log/postgresql
53575357
</para>
53585358
-->
53595359
<para>
5360-
如果您没有逃逸指定文件名,你应该计划使用日志旋转程序以避免最终填充
5360+
如果您没有转义指定文件名,你应该计划使用日志旋转程序以避免最终填充
53615361
整个磁盘。在8.4之前的版本中,如果没有<literal>%</literal>的转义符出现,
53625362
<productname>PostgreSQL</productname>将追加新日志文件创建时间的时间戳,
53635363
但是不再是这种情况了。
@@ -6275,7 +6275,7 @@ local0.* /var/log/postgresql
62756275
这是一个<function>printf</>风格的字符串,在日志的每行开头输出。
62766276
<literal>%</>字符开始<quote>转义序列</>被如下所述状态信息替换。
62776277
无法识别的转义被忽略。其它字符都直接拷贝到日志行中。
6278-
有些逃逸只被会话进程识别,被后端进程忽略,比如主服务器进程。
6278+
有些转义只被会话进程识别,被后端进程忽略,比如主服务器进程。
62796279
这个选项只能在<filename>postgresql.conf</>文件里或者服务器命令行设置。
62806280
缺省是空字符串。
62816281

@@ -6288,7 +6288,7 @@ local0.* /var/log/postgresql
62886288
<entry>Effect</entry>
62896289
<entry>Session only</entry>
62906290
-->
6291-
<entry>逃逸</entry>
6291+
<entry>转义</entry>
62926292
<entry>效果</entry>
62936293
<entry>仅用于会话</entry>
62946294
</row>
@@ -6392,7 +6392,7 @@ local0.* /var/log/postgresql
63926392
of printing those items. For example, to generate the session
63936393
identifier from <literal>pg_stat_activity</>, use this query:
63946394
-->
6395-
<literal>%c</>逃逸打印唯一会话标识符
6395+
<literal>%c</>转义打印唯一会话标识符
63966396
由两个点号分隔的4字节的十六进制数字(没有前导零)组成。
63976397
数字是该过程的开始时间和进程ID,
63986398
所以<literal>%c</>也可以用做一种打印这些项目的节约空间的方法。
@@ -9012,8 +9012,8 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
90129012
在历史上也可以用<literal>\'</>来表示。
90139013
不过使用<literal>\'</>容易导致安全漏洞,
90149014
因为在某些多字节字符集中存在最后一个字节等于<literal>\</>的 ASCII 值的字符。
9015-
如果客户端代码没有做到正确逃逸,那么将会导致SQL注入攻击。
9016-
如果服务器拒绝使用反斜杠逃逸来表示单引号的查询,那么就可以避免这种风险。
9015+
如果客户端代码没有做到正确转义,那么将会导致SQL注入攻击。
9016+
如果服务器拒绝使用反斜杠转义来表示单引号的查询,那么就可以避免这种风险。
90179017
<varname>backslash_quote</>的可用值是<literal>on</>(总是允许<literal>\'</>),
90189018
<literal>off</>(总是拒绝), <literal>safe_encoding</>
90199019
(仅在客户端字符集编码不会在多字节字符末尾包含<literal>\</>的ASCII值时允许)。
@@ -9031,7 +9031,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
90319031
<para>
90329032
需要注意的是,在字符串文本符合SQL标准的情况下,<literal>\</>没有任何其它含义。
90339033
这个参数影响的只是如何处理不符合标准的字符串文本,
9034-
包括明确的字符串逃逸语法(<literal>E'...'</>)。
9034+
包括明确的字符串转义语法(<literal>E'...'</>)。
90359035
</para>
90369036
</listitem>
90379037
</varlistentry>
@@ -9109,8 +9109,8 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
91099109
</para>
91109110
-->
91119111
<para>
9112-
想要使用反斜杠作为逃逸的应用程序
9113-
应该使用逃逸字符串语法(<literal>E'...'</>)进行修改,
9112+
想要使用反斜杠作为转义的应用程序
9113+
应该使用转义字符串语法(<literal>E'...'</>)进行修改,
91149114
因为通的字符串缺省行为作为普通字符的反斜扛对待。
91159115
启动这个变量帮助找到需要修改的代码。
91169116
</para>
@@ -9253,8 +9253,8 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
92539253
<productname>PostgreSQL</productname> 9.1开始,缺省是<literal>on</>(
92549254
之前缺省是<literal>off</>)。
92559255
应用可以检查这个参数来判断字符串文本如何被处理。
9256-
这个参数的出现也建议明确使用逃逸字符串语法(<literal>E'...'</>)来逃逸字符
9257-
如果应用希望反斜杠作为逃逸字符对待,则使用逃逸字符串语法(<xref linkend="sql-syntax-strings-escape">)。
9256+
这个参数的出现也建议明确使用转义字符串语法(<literal>E'...'</>)来转义字符
9257+
如果应用希望反斜杠作为转义字符对待,则使用转义字符串语法(<xref linkend="sql-syntax-strings-escape">)。
92589258

92599259
</para>
92609260
</listitem>

postgresql/doc/src/sgml/datatype.sgml

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -2077,11 +2077,11 @@ SELECT b, char_length(b) FROM test2;
20772077
<para>
20782078
<quote>hex</>格式将二进制数据编码为每字节2位十六进制数字,
20792079
最重要的四位(半字节)放在开始。整条字符串以<literal>\x</literal>开始
2080-
与逃逸格式相区别)。在某些情况下,最初的反斜杠需要再写一次,以逃逸
2081-
同样,在逃逸格式中,反斜杠需要写两个,下面会详细介绍。
2080+
与转义格式相区别)。在某些情况下,最初的反斜杠需要再写一次,以转义
2081+
同样,在转义格式中,反斜杠需要写两个,下面会详细介绍。
20822082
十六进制数字可以大写也可以小写,并且数字对之间允许有空格(但不能是在一个数对,
20832083
也不能是在<literal>\x</literal>起始序列)。
2084-
十六进制格式能够与许多的外部应用程序和协议兼容,并且转换往往比逃逸快
2084+
十六进制格式能够与许多的外部应用程序和协议兼容,并且转换往往比转义快
20852085
因此更倾向于这种用法。
20862086
</para>
20872087

@@ -2101,7 +2101,7 @@ SELECT E'\\xDEADBEEF';
21012101
<!--
21022102
<title><type>bytea</> Escape Format</title>
21032103
-->
2104-
<title><type>bytea</>逃逸格式</title>
2104+
<title><type>bytea</>转义格式</title>
21052105

21062106
<!--
21072107
<para>
@@ -2123,10 +2123,10 @@ SELECT E'\\xDEADBEEF';
21232123
<para>
21242124
对于<type>bytea</type>格式来说,<quote>escape</quote>格式是一种传统的
21252125
<productname>PostgreSQL</productname>格式。它采用以ASCII字符序列来表示二进制串的方法,
2126-
同时将那些无法表示成ASCII字符的二进制串转换成特殊的逃逸序列。从应用的角度看,
2126+
同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。从应用的角度看,
21272127
如果代表字节的字符有意义,那么这种表示方法会很方便。但实际上,
21282128
这样做会模糊二进制字符串和字符字符串之间的区别,从而造成困扰,
2129-
同时筛选出的逃逸机制会显得很臃肿。因此对一些新应用应该恰当的避免这种格式。
2129+
同时筛选出的转义机制会显得很臃肿。因此对一些新应用应该恰当的避免这种格式。
21302130
</para>
21312131

21322132
<!--
@@ -2147,18 +2147,18 @@ SELECT E'\\xDEADBEEF';
21472147
</para>
21482148
-->
21492149
<para>
2150-
当以逃逸格式录入<type>bytea</type>值时,你<emphasis>必须</emphasis>逃逸某些字节值
2151-
同时<emphasis>可以</emphasis>逃逸所有字节值。通常,要逃逸一个字节值
2152-
将它转换成反斜杠+三位八进制值的形式(或两个反斜杠,如果用逃逸字符串语法将值写成文本形式)。
2150+
当以转义格式录入<type>bytea</type>值时,你<emphasis>必须</emphasis>转义某些字节值
2151+
同时<emphasis>可以</emphasis>转义所有字节值。通常,要转义一个字节值
2152+
将它转换成反斜杠+三位八进制值的形式(或两个反斜杠,如果用转义字符串语法将值写成文本形式)。
21532153
另外,反斜杠本身(字节值92)可以用双反斜杠表示。<xref linkend="datatype-binary-sqlesc">
2154-
给出了必须逃逸的字符串,和替代的逃逸序列(如适用)。
2154+
给出了必须转义的字符串,和替代的转义序列(如适用)。
21552155
</para>
21562156

21572157
<table id="datatype-binary-sqlesc">
21582158
<!--
21592159
<title><type>bytea</> Literal Escaped Octets</title>
21602160
-->
2161-
<title><type>bytea</>文本逃逸八进制</title>
2161+
<title><type>bytea</>文本转义八进制</title>
21622162
<tgroup cols="5">
21632163
<thead>
21642164
<row>
@@ -2171,7 +2171,7 @@ SELECT E'\\xDEADBEEF';
21712171
-->
21722172
<entry>十进制数值</entry>
21732173
<entry>描述</entry>
2174-
<entry>输入逃逸形式</entry>
2174+
<entry>输入转义形式</entry>
21752175
<entry>例子</entry>
21762176
<entry>输出形式</entry>
21772177
</row>
@@ -2240,8 +2240,8 @@ SELECT E'\\xDEADBEEF';
22402240
</para>
22412241
-->
22422242
<para>
2243-
逃逸<emphasis>不可打印</emphasis>字节的要求因区域设置而异。在某些场合下,
2244-
你可以不逃逸它们。请注意<xref linkend="datatype-binary-sqlesc">
2243+
转义<emphasis>不可打印</emphasis>字节的要求因区域设置而异。在某些场合下,
2244+
你可以不转义它们。请注意<xref linkend="datatype-binary-sqlesc">
22452245
里的每个例子都是刚好一个字节长,虽然输出形式比一个字符要长。
22462246
</para>
22472247

@@ -2271,8 +2271,8 @@ SELECT E'\\xDEADBEEF';
22712271
<para>
22722272
你必须写这么多反斜杠的原因,如<xref linkend="datatype-binary-sqlesc">所示,
22732273
是因为一个写成字符串文本的输入字符串必须通过<productname>PostgreSQL</productname>
2274-
服务器里的两个分析阶段。每一对反斜杠中的第一个会被字符串文本分析器理解成一个逃逸字符而消耗掉
2275-
于是剩下的第二个反斜杠被<type>bytea</type>输入函数当作一个三位八进制值或者是逃逸另外一个反斜杠的开始
2274+
服务器里的两个分析阶段。每一对反斜杠中的第一个会被字符串文本分析器理解成一个转义字符而消耗掉
2275+
于是剩下的第二个反斜杠被<type>bytea</type>输入函数当作一个三位八进制值或者是转义另外一个反斜杠的开始
22762276
比如,一个传递给服务器的字符串文本<literal>E'\\001'</literal>在通过字符串分析器之后会当作<literal>\001</literal>
22772277
发送给<type>bytea</type>输入函数,在这里它被转换成一个十进制值为 1 的单个字节。请注意,
22782278
单引号字符(')不会被<type>bytea</type>特殊对待,它遵循字符串文本的普通规则。又见<xref linkend="sql-syntax-strings">。
@@ -2290,7 +2290,7 @@ SELECT E'\\xDEADBEEF';
22902290
</para>
22912291
-->
22922292
<para>
2293-
<type>Bytea</type>字节也在输出中逃逸。通常,每个<quote>不可打印</quote>
2293+
<type>Bytea</type>字节也在输出中转义。通常,每个<quote>不可打印</quote>
22942294
的字节值都转化成对应的前导反斜杠的三位八进制数值。大多数<quote>可打印的</quote>
22952295
字节值是以客户端字符集的标准表现形式出现的。十进制值为 92(反斜杠)的字节在输出中双写。
22962296
细节在<xref linkend="datatype-binary-resesc">里描述。
@@ -2300,7 +2300,7 @@ SELECT E'\\xDEADBEEF';
23002300
<!--
23012301
<title><type>bytea</> Output Escaped Octets</title>
23022302
-->
2303-
<title><type>bytea</>输出逃逸序列</title>
2303+
<title><type>bytea</>输出转义序列</title>
23042304
<tgroup cols="5">
23052305
<thead>
23062306
<row>
@@ -2313,7 +2313,7 @@ SELECT E'\\xDEADBEEF';
23132313
-->
23142314
<entry>字节的十进制值</entry>
23152315
<entry>描述</entry>
2316-
<entry>逃逸的输出形式</entry>
2316+
<entry>转义的输出形式</entry>
23172317
<entry>例子</entry>
23182318
<entry>输出结果</entry>
23192319
</row>
@@ -2370,8 +2370,8 @@ SELECT E'\\xDEADBEEF';
23702370
</para>
23712371
-->
23722372
<para>
2373-
根据你使用的前端不同,在是否逃逸<type>bytea</type>字符串的问题上你可能有一些额外的工作要做。
2374-
比如,如果你的接口自动转换换行和回车,那你可能还要逃逸它们
2373+
根据你使用的前端不同,在是否转义<type>bytea</type>字符串的问题上你可能有一些额外的工作要做。
2374+
比如,如果你的接口自动转换换行和回车,那你可能还要转义它们
23752375
</para>
23762376
</sect2>
23772377
</sect1>
@@ -6716,7 +6716,7 @@ PostgreSQL中的文本检索功能也可用于加快XML数据的全文搜索。
67166716
使JSON严格符合规范是不可能的,除非服务器编码是UTF-8。
67176717
试图直接包含不能在服务器编码中表示的字符将会失败;相反的,
67186718
能在服务器编码中表示但是不在UTF-8中的字符是被允许的。<literal>\uXXXX</literal>
6719-
逃逸是被允许的,无视服务器编码,并且只检查语法的正确性。
6719+
转义是被允许的,无视服务器编码,并且只检查语法的正确性。
67206720
</para>
67216721
</sect1>
67226722

postgresql/doc/src/sgml/docguide.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2047,7 +2047,7 @@ Norm Walsh 提供一个用于 DocBook 的
20472047
</para>
20482048
-->
20492049
<para>
2050-
任何在其它地方放都不合适的东西,尤其是臭虫、实现缺陷、安全考量、兼容性问题等。
2050+
任何在其它地方放都不合适的东西,尤其是Bug、实现缺陷、安全考量、兼容性问题等。
20512051
</para>
20522052
</listitem>
20532053
</varlistentry>

postgresql/doc/src/sgml/file-fdw.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@
124124
</para>
125125
-->
126126
<para>
127-
指定文件的逃逸字符,与<command>COPY</>的<literal>ESCAPE</literal>选项相同。
127+
指定文件的转义字符,与<command>COPY</>的<literal>ESCAPE</literal>选项相同。
128128
</para>
129129
</listitem>
130130
</varlistentry>

0 commit comments

Comments
 (0)