pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
相对 PostgreSQL 9.6 的差异：10 共有 523 个函数、649 条签名。
「签名变化」指函数还在，但它的签名有增有删；只改说明文字不计入。「换了分组」指手册把这个函数挪到了另一页。
regexp_match字符串函数和操作符
返回 POSIX 正则表达式 pattern 与 string 的第一次匹配中的子字符串；参见第 9.7.3.1.5 节。
regexp_match ( string text, pattern text [, flags text] ) → text[]
macaddr8_set7bit网络地址函数和操作符
将地址的第 7 位设置为 1，生成所谓的修订 EUI-64 格式，以便用于 IPv6 地址。
macaddr8_set7bit ( macaddr8 ) → macaddr8
XMLTABLEXML 函数
xmltable 表达式根据给定的 XML 值、用于提取行的 XPath 过滤器和一组列定义生成一个表。虽然它在语法上类似于函数，但它只能作为一个表出现在查询的 FROM 子句中。
xmltable( [XMLNAMESPACES(namespace uri AS namespace name[, ...]), ] row_expression PASSING [BY REF] document_expression [BY REF] COLUMNS name { type [PATH column_expression] [DEFAULT default_expression] [NOT NULL | NULL] | FOR ORDINALITY } [, ...] )
pg_current_logfile系统信息函数和操作符
返回当前由日志收集器使用的日志文件的路径名。路径包括 log_directory 目录和单独的日志文件名。如果日志收集器已禁用，则结果为 NULL。当存在多个日志文件，每个以不同格式存在时，不带参数的 pg_current_logfile 返回有序列表中找到的第一个格式的文件路径：stderr，csvlog，jsonlog。如果没有任何日志文件具有这些格式，则返回 NULL。要请求有关特定日志文件格式的信息，请将 csvlog，jsonlog 或 stderr 作为可选参数的值。如果请求的日志格式未在 log_destination 中配置，则结果为 NULL。结果反映 current_logfiles 文件的内容。
pg_current_logfile ( [text] ) → text
pg_get_statisticsobjdef系统信息函数和操作符
重建扩展统计对象的创建命令。（这是反编译重建的结果，并非命令的原始文本。）
pg_get_statisticsobjdef ( statobj_oid ) → text
pg_safe_snapshot_blocking_pids系统信息函数和操作符
返回一个数组，包含阻止指定进程 ID 对应的服务器进程获取安全快照的会话进程 ID；如果不存在这样的服务器进程，或该进程未被阻塞，则返回空数组。
pg_safe_snapshot_blocking_pids ( int ) → int[]
pg_statistics_obj_is_visible系统信息函数和操作符
统计对象在搜索路径中可见吗？
pg_statistics_obj_is_visible ( stat_oid ) → boolean
txid_current_if_assigned系统信息函数和操作符
参见 pg_current_xact_id_if_assigned()。
txid_current_if_assigned ( ) → bigint
txid_status系统信息函数和操作符
参见 pg_xact_status()。
txid_status ( bigint ) → text
brin_desummarize_range系统管理函数
如果存在涵盖指定表块的页面范围摘要，则删除对应的 BRIN 索引元组。
brin_desummarize_range ( index regclass, blockNumber bigint ) → integer
brin_summarize_range系统管理函数
对覆盖给定块的页面范围执行摘要（如果尚未摘要）。这类似于 brin_summarize_new_values，区别在于它只处理包含给定表块编号的页面范围。
brin_summarize_range ( index regclass, blockNumber bigint ) → integer
pg_collation_actual_version系统管理函数
返回当前安装在操作系统中的该排序规则对象的实际版本。如果这个版本与 pg_collation.collversion 中的值不同，则依赖于该排序规则的对象可能需要被重建。还可以参考 ALTER COLLATION。
pg_collation_actual_version ( oid ) → text
pg_current_wal_flush_lsn系统管理函数
返回当前预写式日志刷盘位置（参见下文说明）。
pg_current_wal_flush_lsn ( ) → pg_lsn
pg_current_wal_insert_lsn系统管理函数
返回当前预写式日志插入位置（参见下文说明）。
pg_current_wal_insert_lsn ( ) → pg_lsn
pg_current_wal_lsn系统管理函数
返回当前预写式日志写入位置（参见下文说明）。
pg_current_wal_lsn ( ) → pg_lsn
pg_import_system_collations系统管理函数
根据操作系统中找到的所有区域设置，向系统目录 pg_collation 添加排序规则。initdb 使用的就是此函数；更多信息见第 23.2.2 节。如果以后在操作系统中安装了其他区域设置，可以再次运行此函数，为新区域设置添加排序规则。与 pg_collation 中现有条目匹配的区域设置会被跳过。（但此函数不会删除基于操作系统中已不存在的区域设置的排序规则对象。）schema 参数通常为 pg_catalog，但并非必须如此；也可以将排序规则安装到其他模式中。函数返回新建的排序规则对象数量。此函数仅限超级用户使用。
pg_import_system_collations ( schema regnamespace ) → integer
pg_is_wal_replay_paused系统管理函数
如果已请求暂停恢复，则返回真。
pg_is_wal_replay_paused ( ) → bool
pg_last_wal_receive_lsn系统管理函数
返回流复制最近接收并同步到磁盘的预写式日志位置。在流复制进行期间，该值单调增加。如果恢复已完成，该值将保持为恢复期间最后接收并同步到磁盘的 WAL 记录的位置。如果禁用了流复制，或者流复制尚未开始，此函数返回 NULL。
pg_last_wal_receive_lsn ( ) → pg_lsn
pg_last_wal_replay_lsn系统管理函数
返回恢复期间最近重放的预写式日志位置。如果恢复仍在进行，该值单调增加。如果恢复已完成，该值将保持为该次恢复期间最后应用的 WAL 记录的位置。如果服务器未经恢复而正常启动，此函数返回 NULL。
pg_last_wal_replay_lsn ( ) → pg_lsn
pg_ls_logdir系统管理函数
返回服务器日志目录中每个普通文件的名称、大小和最后修改时间（mtime）。以点开头的文件名、目录和其他特殊文件将被排除。
pg_ls_logdir ( ) → setof record
pg_ls_waldir系统管理函数
返回服务器的预写式日志（WAL）目录中每个普通文件的名称、大小和最后修改时间（mtime）。以点开头的文件名、目录和其他特殊文件将被排除。
pg_ls_waldir ( ) → setof record
pg_switch_wal系统管理函数
强制服务器切换到新的预写式日志文件，使当前文件可以归档（假设正在使用连续归档）。返回值是刚完成的预写式日志文件中的结束预写式日志位置加 1。如果自上次切换预写式日志以来没有发生任何预写式日志活动，pg_switch_wal 不执行任何操作，并返回当前使用的预写式日志文件的起始位置。
pg_switch_wal ( ) → pg_lsn
pg_wal_lsn_diff系统管理函数
计算两个预写式日志位置之间的字节差（lsn1 - lsn2）。可以将它与 pg_stat_replication 或表 9.99 中的某些函数配合使用，以获取复制延迟。
pg_wal_lsn_diff ( lsn pg_lsn, lsn pg_lsn ) → numeric
pg_wal_replay_pause系统管理函数
请求暂停恢复。请求不意味着恢复马上停止。如果你想要保证恢复实际上是暂停的，你需要检查 pg_get_wal_replay_pause_state() 返回的恢复暂停状态。注意，pg_is_wal_replay_paused() 返回是否作出请求。在恢复暂停时，不会应用进一步的数据库更改。如果热备是激活的，所有新查询将看到相同的一致的数据库快照，并且在恢复继续之前不会生成进一步的查询冲突。
pg_wal_replay_pause ( ) → void
pg_wal_replay_resume系统管理函数
如果暂停了，则重新启动恢复。
pg_wal_replay_resume ( ) → void
pg_walfile_name系统管理函数
将预写式日志位置转换为包含该位置的 WAL 文件的名称。
pg_walfile_name ( lsn pg_lsn ) → text
pg_walfile_name_offset系统管理函数
将预写式日志位置转换为 WAL 文件名和该文件中的字节偏移量。
pg_walfile_name_offset ( lsn pg_lsn ) → text, integer
pg_current_xlog_flush_location系统管理函数
获取当前预写式日志刷盘位置
pg_current_xlog_flush_location ( ) → pg_lsn
pg_current_xlog_insert_location系统管理函数
获取当前预写式日志插入位置
pg_current_xlog_insert_location ( ) → pg_lsn
pg_current_xlog_location系统管理函数
获取当前预写式日志写入位置
pg_current_xlog_location ( ) → pg_lsn
pg_is_xlog_replay_paused系统管理函数
如果恢复已暂停，则为真。
pg_is_xlog_replay_paused ( ) → bool
pg_last_xlog_receive_location系统管理函数
获取流复制最近接收并同步到磁盘的预写式日志位置。在流复制进行期间，该值单调增加。如果恢复已完成，该值将保持为恢复期间最后接收并同步到磁盘的 WAL 记录的位置。如果禁用了流复制，或者流复制尚未开始，此函数返回 NULL。
pg_last_xlog_receive_location ( ) → pg_lsn
pg_last_xlog_replay_location系统管理函数
获取恢复期间最近重放的预写式日志位置。如果恢复仍在进行，该值单调增加。如果恢复已完成，该值将保持为该次恢复期间最后应用的 WAL 记录的位置。如果服务器未经恢复而正常启动，此函数返回 NULL。
pg_last_xlog_replay_location ( ) → pg_lsn
pg_switch_xlog系统管理函数
强制切换到新的预写式日志文件（默认仅限超级用户，但可以向其他用户授予EXECUTE权限以运行此函数）
pg_switch_xlog ( ) → pg_lsn
pg_xlog_location_diff系统管理函数
计算两个事务日志位置之差
pg_xlog_location_diff ( location pg_lsn, location pg_lsn ) → numeric
pg_xlog_replay_pause系统管理函数
立即暂停恢复（默认仅限超级用户，但可以向其他用户授予EXECUTE权限以运行此函数）。
pg_xlog_replay_pause ( ) → void
pg_xlog_replay_resume系统管理函数
如果恢复已暂停，则重新开始恢复（默认仅限超级用户，但可以向其他用户授予EXECUTE权限以运行此函数）。
pg_xlog_replay_resume ( ) → void
pg_xlogfile_name系统管理函数
将事务日志位置字符串转换为文件名
pg_xlogfile_name ( location pg_lsn ) → text
pg_xlogfile_name_offset系统管理函数
将事务日志位置字符串转换为文件名和文件内的十进制字节偏移量
pg_xlogfile_name_offset ( location pg_lsn ) → text, integer
| 函数 | 分组 | 增删 | 第一条新增签名 |
|---|---|---|---|
trunc |
数学函数和操作符 | +1 | trunc ( macaddr8 ) → macaddr8 |
to_tsvector |
文本检索函数和操作符 | +1 | to_tsvector ( [ config regconfig , ] document json(b) ) → tsvector |
ts_headline |
文本检索函数和操作符 | +1 | ts_headline ( [ config regconfig, ] document json(b), query tsquery [, options text ] ) → text |
pg_create_logical_replication_slot |
系统管理函数 | +1−1 | pg_create_logical_replication_slot ( slot_name name, plugin name [, temporary boolean] ) → (slot_name name, lsn pg_lsn) |
pg_create_physical_replication_slot |
系统管理函数 | +1−1 | pg_create_physical_replication_slot ( slot_name name [, immediately_reserve boolean, temporary boolean] ) → (slot_name name, lsn pg_lsn) |
pg_logical_slot_get_binary_changes |
系统管理函数 | +1−1 | pg_logical_slot_get_binary_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges int, VARIADIC options text[] ) → (lsn pg_lsn, xid xid, data bytea) |
pg_logical_slot_get_changes |
系统管理函数 | +1−1 | pg_logical_slot_get_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges int, VARIADIC options text[] ) → (lsn pg_lsn, xid xid, data text) |
pg_logical_slot_peek_binary_changes |
系统管理函数 | +1−1 | pg_logical_slot_peek_binary_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges int, VARIADIC options text[] ) → (lsn pg_lsn, xid xid, data bytea) |
pg_logical_slot_peek_changes |
系统管理函数 | +1−1 | pg_logical_slot_peek_changes ( slot_name name, upto_lsn pg_lsn, upto_nchanges int, VARIADIC options text[] ) → (lsn pg_lsn, xid xid, data text) |
pg_replication_origin_advance |
系统管理函数 | +1−1 | pg_replication_origin_advance ( node_name text, lsn pg_lsn ) → void |
pg_stop_backup |
系统管理函数 | +1−1 | pg_stop_backup ( exclusive boolean [, wait_for_archive boolean ] ) → setof record |
这一版没有函数换分组。