选择 打开 改范围 完整检索页

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

文档 / 函数百科 / UUID 函数

FUNCTIONUUID 函数

gen_random_uuid

生成一个版本 4(随机)的 UUID

Generates a version 4 (random) UUID

UUID 函数 引入 13 现存至 20 devel 1 条签名 1 次签名变更

分组
UUID 函数
签名数
1 条
引入版本
13
状态
现存
签名变更
1 次
本版来源
本站译文

PostgreSQL 18 手册 · 9.14 UUID 函数 官方文档

版本轨迹

相对 PostgreSQL 17:新增 1 条签名,移除 1 条。

签名

PostgreSQL 18 里 gen_random_uuid 的 1 条签名,按上游手册顺序排列。参数名用斜体,类型用弱化色, 之后是返回类型。说明取自本站手册译文:标「沿用」的借用了另一版的译文,标「EN」的本站暂无译文、按英文原文显示。

  1. gen_random_uuid ( ) → uuid

    生成一个版本 4(随机)的 UUID
    • gen_random_uuid()5b30857f-0bfa-48b5-ac0b-5c64e28078d1
    • uuidv4()b42410ee-132f-42ee-9e4f-09a6485c95b8

本版移除的签名

PostgreSQL 17 有、18 不再有的 1 条签名,取自上一版快照。

  • gen_random_uuid () → uuid 这个函数返回一个版本 4(随机)UUID。这是最常用的UUID类型,适用于大多数应用。

演化历史

相邻两个大版本之间的差异,新的在前。版本号链到该版的签名。

  1. PostgreSQL 18 ← 17 签名变更

    gen_random_uuid ( ) → uuid gen_random_uuid () → uuid 说明更新

  2. PostgreSQL 13 ← 12 新增此函数

    PostgreSQL 13 起可用

签名矩阵

每条签名在给出了签名的 8 个版本里的存在情况;方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来,上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同,跨越那一跳的同一条签名会显示成两行。

存在 不存在

签名 1314151617181920
gen_random_uuid () → uuid 存在 存在 存在 存在 存在 不存在 不存在 不存在
gen_random_uuid ( ) → uuid 不存在 不存在 不存在 不存在 不存在 存在 存在 存在

同组函数

函数 签名 主签名 版本变动 最近变更
UUID FUNCTIONS UUID 函数 5 个
gen_random_uuid 1 gen_random_uuid ( ) → uuid 181 次
生成一个版本 4(随机)的 UUID 现存
uuid_extract_timestamp 1 uuid_extract_timestamp ( uuid ) → timestamp with time zone 181 次
从版本 1、6 或 7 的 UUID 中提取 timestamp with time zone。 现存
uuid_extract_version 1 uuid_extract_version ( uuid ) → smallint 181 次
从符合 RFC 9562 所描述某一变体的 UUID 中提取版本号。 现存
uuidv4 1 uuidv4 ( ) → uuid
生成一个版本 4(随机)的 UUID 现存
uuidv7 1 uuidv7 ( [ shift interval ] ) → uuid
生成一个版本 7(按时间排序)的 UUID。 现存