PostgreSQL 文档检索

从 PL/Tcl 访问数据库章节正文PG1842.5. 从 PL/Tcl 访问数据库在本节中，我们遵循 Tcl 的通常约定，用问号而不是方括号来表示语法摘要中的可选元素。下列命令可用于从 PL/Tcl 函数体中访问数据库：spi_exec ?-count n? ?-array name? command ?loop-body? # 执行以字符串形式给出的 SQL 命令。命令出错时会引发错误。否则，spi_exec 的返回…从 PL/Tcl 访问数据库 从函数返回章节正文PG1841.6.1. 从函数返回有两个命令让我们能够从函数中返回数据：RETURN 和 RETURN NEXT。从函数返回 从大对象读取数据章节正文PG1833.3.6. 从大对象读取数据函数 int lo_read(PGconn *conn, int fd, char *buf, size_t len); 从大对象描述符 fd 中读取最多 len 字节到 buf 中（其大小必须为 len）。fd 参数必须是先前由 lo_open 返回的大对象描述符。返回值是实际读取的字节数；如果先到达大对象末尾，该值就会小于 len。发生错误时…从大对象读取数据 从被修改的行中返回数据章节正文PG186.4. 从被修改的行中返回数据有时候，在修改行的同时取得这些行中的数据会很有用。INSERT、UPDATE、DELETE 和 MERGE 命令都支持可选的 RETURNING 子句。使用 RETURNING 可以避免额外执行一次数据库查询来收集这些数据；当原本难以可靠地识别被修改的行时，这一点尤其有价值。RETURNING 子句允许的内容与 SELECT 命令的输出列表相同（…从被修改的行中返回数据 从过程返回章节正文PG1841.6.2. 从过程返回过程没有返回值。因此，过程的结束可以不用 RETURN 语句。如果想用一个 RETURN 语句提前退出代码，只需写一个没有表达式的 RETURN。如果过程有输出参数，那么输出参数最终的值会被返回给调用者。从过程返回 代价估算选项章节正文PG18F.38.1.3. 代价估算选项 postgres_fdw 通过在远程服务器上执行查询来获取远程数据，因此，理想情况下，扫描外部表的估计代价应当等于在远程服务器上完成该操作的代价，再加上一些通信开销。获得这种估算最可靠的方法，是向远程服务器询问，再把开销加上去；但对于简单查询，为了取得代价估算而额外发送一次远程查询，可能并不划算。因此 postgres_fdw 提供以下选项来控…代价估算选项 代码构建目标章节正文PG1817.4.4.1. 代码构建目标 all # 构建文档以外的所有内容 backend # 构建后端及相关模块 bin # 构建前端二进制程序 contrib # 构建 contrib 模块 pl # 构建过程语言代码构建目标 以前的 PostgreSQL 版本章节正文PG1819.13.1. 以前的 PostgreSQL 版本 array_nulls (boolean) # 这个参数控制数组输入解析器是否把未用引号的 NULL 识别为一个值为空值的数组元素。默认为 on，允许输入包含空值的数组值。但是 PostgreSQL 8.2 之前的版本不支持数组中的空值，并且因此将把 NULL 当作指定一个值为字符串“NULL”的正常数组元素。为了向后兼容那…以前的 PostgreSQL 版本 任意精度数值章节正文PG188.1.2. 任意精度数值类型 numeric 可以存储非常多位的数字。我们特别建议将它用于货币金额和其他要求计算准确的数量。numeric 值的计算在可能的情况下会得到准确的结果，例如加法、减法、乘法。不过，numeric 类型上的算术运算比整数类型或者下一节描述的浮点数类型要慢很多。我们在下文中使用以下术语：精度（precision）是一个 numeric 值中有效数字的总…任意精度数值 优化章节正文PG1830.1.3. 优化 LLVM 支持对生成的代码进行优化。有些优化的代价很低，因此每次使用 JIT 时都可以执行；另一些优化则只有在运行时间较长的查询中才有益处。更多有关优化的细节请参见 https://llvm.org/docs/Passes.html#transform-passes。优化 优化 PL/pgSQL 函数章节正文PG1841.13.2.3. 优化 PL/pgSQL 函数 PostgreSQL 提供了两种函数创建修饰符来优化执行：“volatility”（对于给定的相同参数，函数是否总是返回相同的结果）以及“strictness”（如果任何参数为空值，函数是否返回空值）。详见 CREATE FUNCTION 参考页。在利用这些优化属性时，你的 CREATE FUNCTION 语句可能像这样：CR…优化 PL/pgSQL 函数 优化器章节正文PG18E.6.3.1.1. 优化器自动删除一些不必要的表自连接（Andrey Lepikhov, Alexander Kuzmenkov, Alexander Korotkov, Alena Rybakina）§ 可以使用服务器变量 enable_self_join_elimination 禁用此优化。 将一些 IN (VALUES ...) 转换为 x = ANY ... 以获得更…优化器 会话信息函数章节正文PG189.27.1. 会话信息函数表 9.71 列出了多个用于提取会话和系统信息的函数。除了本节列出的函数外，还有许多与统计系统相关的函数，这些函数也提供系统信息。有关更多信息，请参见第 27.2.26 节。表 9.71. 会话信息函数 函数 描述 current_catalog → name current_database () → name 返回当前数据库的名称。（SQL 标准…会话信息函数 伪类型章节正文PG188.21. 伪类型 PostgreSQL 的类型系统中包含一些特殊用途的条目，统称为伪类型。伪类型不能作为列数据类型使用，但可以用于声明函数的参数类型或结果类型。每一种伪类型都适用于这样的场景：函数的行为并不对应于简单地接受或返回某个特定 SQL 数据类型的值。表 8.27 列出了现有的伪类型。表 8.27. 伪类型 名字 描述 any 表示一个函数可以接受任意输入数据类型。 …伪类型 伪类型章节正文PG1836.2.4. 伪类型有少数几种“伪类型”用于特殊目的。伪类型不能作为表的列或容器类型的组成部分出现，但它们可以用来声明函数的参数类型和结果类型。这为在类型系统内部识别特殊类别的函数提供了一种机制。表 8.27 列出了现有的伪类型。伪类型 伯克利 POSTGRES 项目章节正文PG182.1. 伯克利 POSTGRES 项目由 Michael Stonebraker 教授领导的 POSTGRES 项目，得到了国防高级研究计划局（DARPA）、陆军研究办公室（ARO）、国家科学基金会（NSF）以及 ESL, Inc. 的资助。POSTGRES 的实现始于 1986 年。该系统的最初概念见于[ston86]，而最初数据模型的定义见于[rowe87]。当时规则系统…伯克利 POSTGRES 项目 位串函数和操作符章节正文PG189.6. 位串函数和操作符本节描述用于检查和操作位串的函数和操作符，也就是操作类型为 bit 和 bit varying 的值的函数和操作符。（虽然这些表中只提到了 bit 类型，但 bit varying 类型的值可以互换使用。）位串支持表 9.1 中显示的常用比较操作符，以及表 9.14 中显示的操作符。表 9.14. 位串操作符 操作符 描述 示例 bit || bit …位串函数和操作符 位串常量章节正文PG184.1.2.5. 位串常量位串常量看起来像常规字符串常量在开引号之前（中间无空白）加了一个 B（大写或小写形式），例如 B'1001'。位串常量中允许的字符只有 0 和 1。或者，也可以用十六进制记法指定位串常量，即在开头写一个 X（大写或小写形式），例如 X'1FF'。这种记法等价于把每个十六进制位替换成四个二进制位得到的位串常量。两种形式的位串常量可以以与常规字符串常量相同…位串常量 位串类型章节正文PG188.10. 位串类型位串是由 1 和 0 组成的字符串。它们可用于存储或展示位掩码。SQL 中有两种位类型：bit(n) 和 bit varying(n)，其中 n 是正整数。bit 类型的数据长度必须与 n 完全一致；试图存储更短或更长的位串都会报错。bit varying 数据则是长度上限为 n 的变长类型，更长的串会被拒绝。不带长度的 bit 等效于 bit(1)，而不带…位串类型 位置参数章节正文PG184.2.2. 位置参数位置参数引用用来表示一个由 SQL 语句外部提供的值。参数可用于 SQL 函数定义和预备语句中。某些客户端库还支持把数据值与 SQL 命令字符串分开指定，在这种情况下，参数就用来引用这些命令字符串之外的数据值。参数引用的形式是：$number 例如，考虑一个函数 dept 的定义：CREATE FUNCTION dept(text) RETURNS dep…位置参数 何时使用 JIT？章节正文PG1830.2. 何时使用 JIT？JIT 编译主要对长时间运行且受 CPU 限制的查询有益。这类查询通常是分析型查询。对于短查询，执行 JIT 编译所增加的额外开销往往会高于它能节省的时间。为了确定是否应使用 JIT 编译，会使用查询的总估计代价（见第 69 章和第 19.7.2 节）。查询的估计代价会与 jit_above_cost 的设置值进行比较。如果代价更高，就会执行 JI…何时使用 JIT？ 何时使用管道模式章节正文PG1832.5.3. 何时使用管道模式与异步查询模式类似，使用管道模式不会带来明显的性能开销。它增加了客户端应用程序的复杂性，需要格外注意防止客户端与服务器之间的死锁，但也能显著提升性能，代价是状态保留更久，因而占用更多内存。当服务器距离较远，即网络延迟（“ping 时间”）较高，或者需要快速连续执行许多小操作时，管道模式最有用。如果每个查询的执行时间是客户端与服务器往返时间的许多倍…何时使用管道模式 何时使用颜色章节正文PG18N.1. 何时使用颜色要使用彩色输出，请按如下方式设置环境变量 PG_COLOR：如果其值为 always，则总是使用颜色。 如果其值为 auto，并且标准错误流与终端设备相关联，则使用颜色。 否则，不使用颜色。何时使用颜色 何时可以使用并行查询？章节正文PG1815.2. 何时可以使用并行查询？有几种设置会导致查询规划器在任何情况下都不生成并行查询计划。要让系统能够生成任何并行查询计划，下列设置必须按要求配置。max_parallel_workers_per_gather 必须设置为大于零的值。这只是更一般原则的一个特例，即所使用的工作进程数量不应超过通过 max_parallel_workers_per_gather 配置的数量。此…何时可以使用并行查询？ 作者章节正文PG18F.25.9. 作者 Mark Kirkwood <markir@paradise.net.nz> 设计建议：Neil Conway <neilc@samurai.com> 调试建议：Tom Lane <tgl@sss.pgh.pa.us>作者 作者章节正文PG18F.31.3. 作者 Tatsuo Ishii作者 作者章节正文PG18F.33.2. 作者 Tatsuo Ishii、Satoshi Nagayasu 和 Abhijit Menon-Sen作者 作者章节正文PG18F.2.2. 作者 KaiGai Kohei <kaigai@ak.jp.nec.com>作者 作者章节正文PG18F.3.3. 作者 Takahiro Itagaki <itagaki.takahiro@oss.ntt.co.jp>作者 作者章节正文PG18F.4.2. 作者 Robert Haas <rhaas@postgresql.org>作者 作者章节正文PG18F.5.3. 作者 Nathan Bossart作者 作者章节正文PG18F.6.5. 作者 Teodor Sigaev <teodor@postgrespro.ru>，Postgres Professional，俄罗斯莫斯科 Alexander Korotkov <a.korotkov@postgrespro.ru>，Postgres Professional，俄罗斯莫斯科 Oleg Bartunov <obartunov@postgrespro.…作者 作者章节正文PG18F.7.2. 作者 Teodor Sigaev（<teodor@stack.net>）和 Oleg Bartunov（<oleg@sai.msu.su>）。参阅 http://www.sai.msu.su/~megera/oddmuse/index.cgi/Gin。作者 作者章节正文PG18F.8.2. 作者 Teodor Sigaev（<teodor@stack.net>）、Oleg Bartunov（<oleg@sai.msu.su>）、Janko Richter（<jankorichter@yahoo.de>）和 Paul Jungwirth（<pj@illuminatedcomputing.com>）。更多信息见 http://www.sai.msu.su…作者 作者章节正文PG18F.9.5. 作者 David E. Wheeler <david@kineticode.com> 灵感来自 Donald Fraser 最初编写的 citext 模块。作者 作者章节正文PG18F.17.8. 作者 Oleg Bartunov <oleg@sai.msu.su>，俄罗斯莫斯科，莫斯科大学 Teodor Sigaev <teodor@sigaev.ru>，俄罗斯莫斯科，Delta-Soft Ltd. Andrew Gierth <andrew@tao11.riddles.org.uk>，英国，对本模块作了额外增强作者 作者章节正文PG18F.19.5. 作者所有工作都由 Teodor Sigaev（<teodor@sigaev.ru>）和 Oleg Bartunov（<oleg@sai.msu.su>）完成。更多信息请见 http://www.sai.msu.su/~megera/postgres/gist/。Andrey Oktyabrski 在添加新函数和操作方面也做出了很大贡献。作者 作者章节正文PG18F.20.7. 作者 Germán Méndez Bravo (Kronuz), 2004–2006 该模块受到了 Garrett A. Wollman 的 isbn_issn 代码的启发。作者 作者章节正文PG18F.21.4. 作者 Peter Mount <peter@retep.org.uk>作者 作者章节正文PG18F.22.6. 作者全部工作均由 Teodor Sigaev（<teodor@stack.net>）和 Oleg Bartunov（<oleg@sai.msu.su>）完成。更多信息见 http://www.sai.msu.su/~megera/postgres/gist/。作者谨感谢 Eugeny Rodichev 的有益讨论。欢迎提出意见和缺陷报告。作者