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

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

百科 / 函数百科 / 8.1 变更

PostgreSQL 8.1 函数变更

相对 PostgreSQL 8.0 的差异：8.1 共有 194 个函数、260 条签名。

换一个对比基准

汇总

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

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

新增函数19

  • regexp_replace字符串函数和操作符

    替换第一个与 POSIX 正则表达式 pattern 匹配的子字符串，如果使用了 g 标志，则替换所有这样的匹配；参见第 9.7.3.1.7 节。

    regexp_replace ( string text, pattern text, replacement text [,flags text] ) → text

    1 条签名

  • justify_days日期/时间函数和操作符

    调整间隔，将 30 天的时间段转换为月份

    justify_days ( interval ) → interval

    1 条签名

  • justify_hours日期/时间函数和操作符

    调整间隔，将 24 小时时间段转换为天数

    justify_hours ( interval ) → interval

    1 条签名

  • lastval序列操作函数

    返回 nextval 在当前会话中最近返回的值。这个函数与 currval 相同，不同之处在于它没有使用序列名作为参数，而是引用当前会话中 nextval 最近应用到的序列。如果在当前会话中还没有调用 nextval，那么调用 lastval 是一个错误。

    lastval ( ) → bigint

    1 条签名

  • GREATEST条件表达式

    GREATEST 和 LEAST 函数从由任意数量的表达式组成的列表中选取最大值或最小值。这些表达式都必须能转换为同一个数据类型，该类型将作为结果类型（详情参见第 10.5 节）。

    GREATEST(value [, ...])

    1 条签名

  • LEAST条件表达式

    GREATEST 和 LEAST 函数从由任意数量的表达式组成的列表中选取最大值或最小值。这些表达式都必须能转换为同一个数据类型，该类型将作为结果类型（详情参见第 10.5 节）。

    LEAST(value [, ...])

    1 条签名

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

    用户是否具有角色权限？允许的权限类型为 MEMBER、USAGE 和 SET。MEMBER 表示对该角色的直接或间接成员资格，而不考虑由此授予的具体权限。USAGE 表示该角色的权限是否无需执行 SET ROLE 即可立即使用，而 SET 表示是否可以使用 SET ROLE 命令切换到该角色。任一权限类型后面都可以附加 WITH ADMIN OPTION 或 WITH GRANT OPTION，用于测试是否持有 ADMIN 权限（这六种写法测试的都是同一件事）。此函数不允许将 user 设置为 public 这一特殊情况，因为 PUBLIC 伪角色永远不能成为实际角色的成员。

    pg_has_role ( user, role, privilege ) → boolean

    2 条签名

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

    返回服务器启动时的时间。

    pg_postmaster_start_time ( ) → timestamp with time zone

    1 条签名

  • pg_column_size系统管理函数

    显示用于存储任何单个数据值的字节数。如果直接应用于表的列值，则反映所做的任何压缩。

    pg_column_size ( any ) → int

    1 条签名

  • pg_database_size系统管理函数

    计算具有指定名称或 OID 的数据库使用的总磁盘空间。要使用此函数，您必须对指定数据库具有 CONNECT 权限（默认情况下授予），或者具有 pg_read_all_stats 角色的权限。如果数据库不存在，则抛出错误。

    pg_database_size ( oid ) → bigint

    2 条签名

  • pg_ls_dir系统管理函数

    返回指定目录中所有文件的名称（包括目录及其他特殊文件）。include_dot_dirs 参数指示结果集中是否包含“.”和“..”；默认不包含它们。在 missing_ok 为 true 时，包含它们有助于区分不存在的目录和空目录。

    pg_ls_dir ( dirname text ) → setof text

    1 条签名

  • pg_read_file系统管理函数

    返回一个文本文件的全部或部分，从给定的字节 offset 开始，最多返回 length 字节（如果先到达文件末尾，则返回更少）。如果 offset 为负，则它相对于文件末尾计算。如果省略 offset 和 length，则返回整个文件。从文件中读取的字节会按数据库编码解释为字符串；如果它们在该编码下无效，则会抛出错误。

    pg_read_file ( filename text, offset bigint, length bigint ) → text

    1 条签名

  • pg_relation_size系统管理函数

    计算指定关系的一个“分支”所使用的磁盘空间。（注意在大多数情况下，使用更高级的函数 pg_total_relation_size 或 pg_table_size 更方便，它们将所有分支的大小相加。）使用一个参数，这将返回关系的主数据分支的大小。第二个参数可以用来指定要检查哪个分支：

    pg_relation_size ( oid ) → bigint

    2 条签名

  • pg_reload_conf系统管理函数

    使 PostgreSQL 服务器的所有进程重新加载其配置文件。（这是通过向 postmaster 进程发送 SIGHUP 信号来启动的，postmaster 进程又向其每个子进程发送 SIGHUP。）您可以使用 pg_file_settings、pg_hba_file_rules 和 pg_ident_file_mappings 视图来检查可能存在的错误，然后再重新加载配置文件。

    pg_reload_conf ( ) → boolean

    1 条签名

  • pg_rotate_logfile系统管理函数

    通知日志文件管理器立即切换到一个新的输出文件。这仅在内置日志收集器运行时有效，因为否则没有日志文件管理器子进程。

    pg_rotate_logfile ( ) → boolean

    1 条签名

  • pg_size_pretty系统管理函数

    将字节大小转换为更易于人类阅读的格式，带有大小单位（字节，kB，MB，GB，TB 或 PB）。请注意，单位是 2 的幂，而不是 10 的幂，因此 1kB 是 1024 字节，1MB 是 10242 = 1048576 字节，依此类推。

    pg_size_pretty ( bigint ) → text

    1 条签名

  • pg_stat_file系统管理函数

    返回一个记录，包含文件大小、最后访问时间戳、最后修改时间戳、最后文件状态变更时间戳（仅限 Unix 平台）、文件创建时间戳（仅限 Windows）以及一个指示其是否为目录的标志。

    pg_stat_file ( filename text ) → record

    1 条签名

  • pg_tablespace_size系统管理函数

    计算具有指定名称或 OID 的表空间中使用的总磁盘空间。要使用此函数，您必须对指定的表空间具有 CREATE 权限，或者具有 pg_read_all_stats 角色的权限，除非它是当前数据库的默认表空间。如果表空间不存在，则抛出错误。

    pg_tablespace_size ( oid ) → bigint

    2 条签名

  • pg_total_relation_size系统管理函数

    计算指定表所使用的总磁盘空间，包括所有索引和 TOAST 数据。结果等价于 pg_table_size + pg_indexes_size。

    pg_total_relation_size ( oid ) → bigint

    2 条签名

移除函数1

  • box_intersect几何函数和操作符

    交集矩形框

    box_intersect ( box, box ) → box

    于 8.1 移除上一版有 1 条签名

签名变化45

函数 分组 增删 第一条新增签名
round 数学函数和操作符 +1−1 round ( v numeric, s int ) → numeric
setseed 数学函数和操作符 +1−1 setseed ( dp ) → int
trunc 数学函数和操作符 +1−1 trunc ( v numeric, s int ) → numeric
width_bucket 数学函数和操作符 +1−1 width_bucket ( op numeric, b1 numeric, b2 numeric, count int ) → int
ascii 字符串函数和操作符 +1−1 ascii ( text ) → int
bit_length 字符串函数和操作符 +1−1 bit_length ( string ) → int
char_length 字符串函数和操作符 +1−1 char_length ( string ) → int
character_length 字符串函数和操作符 +1−1 character_length ( string ) → int
chr 字符串函数和操作符 +1−1 chr ( int ) → text
length 字符串函数和操作符 +2−2 length ( string text ) → int
lpad 字符串函数和操作符 +1−1 lpad ( string text, length int [, fill text] ) → text
md5 字符串函数和操作符 +1 md5 ( string ) → text
octet_length 字符串函数和操作符 +1−1 octet_length ( string ) → int
overlay 字符串函数和操作符 +1−1 overlay ( string placing string from int [for int] ) → text
position 字符串函数和操作符 +1−1 position ( substring in string ) → int
repeat 字符串函数和操作符 +1−1 repeat ( string text, number int ) → text
rpad 字符串函数和操作符 +1−1 rpad ( string text, length int [, fill text] ) → text
split_part 字符串函数和操作符 +1−1 split_part ( string text, delimiter text, field int ) → text
substring 字符串函数和操作符 +2−2 substring ( string [from int] [for int] ) → text
to_hex 字符串函数和操作符 +1−1 to_hex ( number int or bigint ) → text
get_bit 二进制串函数和操作符 +1−1 get_bit ( string, offset ) → int
get_byte 二进制串函数和操作符 +1−1 get_byte ( string, offset ) → int
to_timestamp 数据类型格式化函数 +1 to_timestamp ( double precision ) → timestamp with time zone
current_time 日期/时间函数和操作符 +1−1 CURRENT_TIME (precision)
current_timestamp 日期/时间函数和操作符 +1−1 CURRENT_TIMESTAMP (precision) LOCALTIME LOCALTIMESTAMP
extract 日期/时间函数和操作符 +1−1 EXTRACT(field FROM source)
localtime 日期/时间函数和操作符 +1−1 LOCALTIME (precision)
localtimestamp 日期/时间函数和操作符 +1−1 LOCALTIMESTAMP (precision)
circle 几何函数和操作符 +1 circle ( polygon ) → circle
npoints 几何函数和操作符 +2−2 npoints ( path ) → int
point 几何函数和操作符 −1 —
family 网络地址函数和操作符 +1−1 family ( inet ) → int
masklen 网络地址函数和操作符 +1−1 masklen ( inet ) → int
set_masklen 网络地址函数和操作符 +1−1 set_masklen ( inet, int ) → inet
currval 序列操作函数 +1−1 currval ( regclass ) → bigint
nextval 序列操作函数 +1−1 nextval ( regclass ) → bigint
setval 序列操作函数 +2−2 setval ( regclass, bigint ) → bigint
array_lower 数组函数和操作符 +1−1 array_lower ( anyarray, int ) → int
array_upper 数组函数和操作符 +1−1 array_upper ( anyarray, int ) → int
sum 聚合函数 +1−1 sum ( expression ) → bigint for smallint or int arguments, numeric for bigint arguments, double precision for floating-point arguments, otherwise the same as the argument data type
inet_client_port 系统信息函数和操作符 +1−1 inet_client_port ( ) → int
inet_server_port 系统信息函数和操作符 +1−1 inet_server_port ( ) → int
pg_get_userbyid 系统信息函数和操作符 +1−1 pg_get_userbyid ( roleid ) → name
pg_cancel_backend 系统管理函数 +1−1 pg_cancel_backend ( pid int ) → boolean
pg_start_backup 系统管理函数 +1−1 pg_start_backup ( label text ) → text

换了分组0

这一版没有函数换分组。