↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

百科 / 函数百科 / 12 变更

PostgreSQL 12 函数变更

相对 PostgreSQL 11 的差异：12 共有 556 个函数、684 条签名。

换一个对比基准

汇总

  1. 24新增函数
  2. 0移除函数
  3. 4签名变化
  4. 0换了分组

「签名变化」指函数还在，但它的签名有增有删；只改说明文字不计入。「换了分组」指手册把这个函数挪到了另一页。

新增函数24

  • acosh数学函数和操作符

    反双曲余弦

    acosh ( x )

    1 条签名

  • asinh数学函数和操作符

    反双曲正弦

    asinh ( x )

    1 条签名

  • atanh数学函数和操作符

    反双曲正切

    atanh ( x )

    1 条签名

  • cosh数学函数和操作符

    双曲余弦

    cosh ( x )

    1 条签名

  • log10数学函数和操作符

    以 10 为底的对数（与 log 相同）

    log10 ( dp or numeric ) → (same as input)

    1 条签名

  • sinh数学函数和操作符

    双曲正弦

    sinh ( x )

    1 条签名

  • tanh数学函数和操作符

    双曲正切

    tanh ( x )

    1 条签名

  • jsonb_path_existsJSON 函数和操作符

    检查 JSON 路径是否为指定的 JSON 值返回任何项。（这只对 SQL 标准 JSON 路径表达式有用，而不适用于谓词检查表达式，因为后者总是返回一个值。）如果指定了 vars 参数，则它必须是一个 JSON 对象，并且它的字段提供要替换到 jsonpath 表达式中的具名值。如果指定了 silent 参数并为 true，函数会抑制与@? 和 @@操作符相同的错误。

    jsonb_path_exists ( target jsonb, path jsonpath [, vars jsonb [, silent bool]] ) → boolean

    1 条签名

  • jsonb_path_matchJSON 函数和操作符

    返回指定 JSON 值的 JSON 路径谓词检查的 SQL 布尔结果。（这只对谓词检查表达式有用，而不适用于 SQL 标准 JSON 路径表达式，因为如果路径结果不是单个布尔值，它将失败或返回 NULL。）可选的 vars 和 silent 参数的作用与 jsonb_path_exists 相同。

    jsonb_path_match ( target jsonb, path jsonpath [, vars jsonb [, silent bool]] ) → boolean

    1 条签名

  • jsonb_path_queryJSON 函数和操作符

    为指定的 JSON 值返回由 JSON 路径返回的所有 JSON 项。对于 SQL 标准 JSON 路径表达式，它返回从 target 中选出的 JSON 值。对于谓词检查表达式，它返回谓词检查的结果：true、false 或 null。可选的 vars 和 silent 参数的作用与 jsonb_path_exists 相同。

    jsonb_path_query ( target jsonb, path jsonpath [, vars jsonb [, silent bool]] ) → setof jsonb

    1 条签名

  • jsonb_path_query_arrayJSON 函数和操作符

    以 JSON 数组的形式返回由 JSON 路径为指定的 JSON 值返回的所有 JSON 项。参数与 jsonb_path_query 相同。

    jsonb_path_query_array ( target jsonb, path jsonpath [, vars jsonb [, silent bool]] ) → jsonb

    1 条签名

  • jsonb_path_query_firstJSON 函数和操作符

    为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 NULL。参数与 jsonb_path_query 相同。

    jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent bool]] ) → jsonb

    1 条签名

  • acldefault系统信息函数和操作符

    构造一个 aclitem 数组，保存类型为 type、属于 OID 为 ownerId 的角色的对象的默认访问权限。当对象的 ACL 条目为空值时，会采用这些访问权限。（默认访问权限见第 5.9 节。）type 参数必须为以下值之一：'c' 表示 COLUMN，'r' 表示 TABLE 和类似表的对象，'s' 表示 SEQUENCE，'d' 表示 DATABASE，'f' 表示 FUNCTION 或 PROCEDURE，'l' 表示 LANGUAGE，'L' 表示 LARGE OBJECT，'n' 表示 SCHEMA，'p' 表示 PARAMETER，'t' 表示 TABLESPACE，'F' 表示 FOREIGN DATA WRAPPER，'S' 表示 FOREIGN SERVER，'T' 表示 TYPE 或 DOMAIN。

    acldefault ( type, ownerId ) → aclitem[]

    1 条签名

  • aclexplode系统信息函数和操作符

    以行集的形式返回 aclitem 数组。如果被授权者是伪角色 PUBLIC，则在 grantee 列中用零表示。每项授予的权限表示为 SELECT、INSERT 等（完整列表见表 5.1）。注意，每项权限都会拆成单独的一行，因此 privilege_type 列中只会出现一个关键字。

    aclexplode ( aclitem[] ) → setof record

    1 条签名

  • makeaclitem系统信息函数和操作符

    使用给定的属性构造 aclitem。privileges 是以逗号分隔的权限名列表，例如 SELECT、INSERT 等，列出的所有权限都会设置在结果中。（权限字符串不区分大小写，权限名之间允许有额外的空白，但权限名内部不允许。）

    makeaclitem ( grantee, grantor, privilege, grantable ) → aclitem

    1 条签名

  • pg_copy_logical_replication_slot系统管理函数

    复制一个名为 src_slot_name 的现有逻辑复制槽到一个名为 dst_slot_name 的逻辑复制槽，可选地更改输出插件和持久性。新槽名称不能是 pg_conflict_detection，因为该名称保留用于冲突检测。被复制的逻辑槽从与源逻辑槽相同的 LSN 开始。temporary 和 plugin 都是可选的。如果它们被省略了，使用与源逻辑槽相同的值。源逻辑槽的 failover 选项不会被复制，而是默认设为 false。这是为了避免故障切换到正在同步该槽的备库后无法继续逻辑复制的风险。不能复制已失效的槽。

    pg_copy_logical_replication_slot ( src_slot_name name, dst_slot_name name [, temporary boolean [, plugin name]] ) → (slot_name name, lsn pg_lsn)

    1 条签名

  • pg_copy_physical_replication_slot系统管理函数

    将一个名为 src_slot_name 的现有物理复制槽复制到一个名为 dst_slot_name 的物理复制槽。新槽名称不能是 pg_conflict_detection，因为它保留给冲突检测。复制后的物理槽从与源槽相同的 LSN 开始保留 WAL。temporary 是可选的。如果省略了 temporary，则使用与源槽相同的值。不能复制已失效的槽。

    pg_copy_physical_replication_slot ( src_slot_name name, dst_slot_name name [, temporary boolean] ) → (slot_name name, lsn pg_lsn)

    1 条签名

  • pg_ls_archive_statusdir系统管理函数

    返回服务器 WAL 归档状态目录（pg_wal/archive_status）中每个普通文件的名称、大小和最后修改时间（mtime）。以点号开头的文件名、目录以及其他特殊文件都不会包含在结果中。

    pg_ls_archive_statusdir ( ) → setof record

    1 条签名

  • pg_ls_tmpdir系统管理函数

    返回针对指定 tablespace 的临时文件目录中每个普通文件的名称、大小和最后修改时间（mtime）。如果未提供 tablespace，则检查 pg_default 表空间。以点号开头的文件名、目录以及其他特殊文件都不会包含在结果中。

    pg_ls_tmpdir ( [tablespace oid] ) → setof record

    1 条签名

  • pg_partition_ancestors系统管理函数

    列出给定分区的祖先关系，包括关系本身。如果关系不存在，或者不是分区或分区表，则不返回行。

    pg_partition_ancestors ( regclass ) → setof regclass

    1 条签名

  • pg_partition_root系统管理函数

    返回给定关系所属的分区树的最顶级父节点。如果关系不存在，或者不是分区或分区表，则返回 NULL。

    pg_partition_root ( regclass ) → regclass

    1 条签名

  • pg_partition_tree系统管理函数

    列出给定分区表或分区索引的分区树中的表或索引，每行对应一个分区。提供的信息包括分区的 OID、其直接父的 OID、一个布尔值以告知分区是否是叶子，以及一个整数用来告诉分区在层次结构中的级别。对于输入表或索引，级别值为 0，其直接子分区的为 1，它们的分区为 2，以此类推。如果关系不存在，或者不是分区或分区表，则不返回行。

    pg_partition_tree ( regclass ) → setof record

    1 条签名

  • pg_promote系统管理函数

    将备库提升为主库状态。当 wait 设置为 true（默认值）时，函数将等待直到提升完成或 wait_seconds 秒数已过，如果提升成功则返回 true，否则返回 false。如果 wait 设置为 false，则该函数在向 postmaster 发送 SIGUSR1 信号以触发提升后立即返回 true。

    pg_promote ( wait boolean DEFAULT true, wait_seconds integer DEFAULT 60 ) → boolean

    1 条签名

  • pg_mcv_list_items统计信息函数

    pg_mcv_list_items 返回一组记录，描述存储在多列 MCV 列表中的所有项目。它返回以下列：

    仅正文提及

移除函数0

这一版没有移除函数。

签名变化4

函数 分组 增删 第一条新增签名
substring 字符串函数和操作符 +2 substring(string from pattern for escape-character)
date_trunc 日期/时间函数和操作符 +2−1 date_trunc ( text, timestamp with time zone, text ) → timestamp with time zone
XMLEXISTS XML 函数 +1−1 XMLEXISTS(text PASSING [BY { REF | VALUE }] xml [BY { REF | VALUE }])
XMLTABLE XML 函数 +1−1 xmltable( [XMLNAMESPACES(namespace uri AS namespace name[, ...]), ] row_expression PASSING [BY { REF | VALUE }] document_expression [BY { REF | VALUE }] COLUMNS name { type [PATH column_expression] [DEFAULT default_expression] [NOT NULL | NULL] | FOR ORDINALITY } [, ...] )

换了分组0

这一版没有函数换分组。