PostgreSQL 文档检索

us-states扩展与模块扩展目录Postgres大会2026年演示扩展 pgpm demo for the Postgres Conference 2026 us-states 功能特性功能特性 · 扩展目录 usage_privileges章节正文PG1835.59. usage_privileges 视图 usage_privileges 标识在多种对象上授予的所有 USAGE 权限，这些权限的授予者或被授权者是当前已启用的角色。在 PostgreSQL 中，这目前适用于排序规则、域、外部数据包装器、外部服务器和序列。对于每个对象、授予者和被授权者的组合，这里都有一行。由于 PostgreSQL 中的排序规则没有实际的权限，此…usage_privileges user函数与运算符本站词条这个相当于 current_user。 This is equivalent to current_user. user → name 系统信息函数和操作符函数 · 系统信息函数和操作符 user连接参数本站词条连接所使用的 PostgreSQL 用户名，默认与运行应用程序的操作系统用户名相同。 身份认证 user 客户端库 libpq 10.23 手册定义 手册已记载 源码中的环境变量回退 PGUSER 编译时回退表达式 NULL 默认值解析与服务文件优先级 以下环境变量可用于选择连接参数的默认值，供 PQconnectdb 、 PQsetdbLogin 和 PQsetdb 在调用…连接参数 · 身份认证 user_catalog_table存储参数本站词条将表标记为逻辑解码使用的附加目录表。 用户目录表 表与物化视图 将该表声明为逻辑复制用途的附加目录表。详见 第 48.6.2 节。不能为 TOAST 表设置此参数。 WITH (user_catalog_table = value) 适用对象 表与物化视图 取值类型 布尔值 适用范围 这是关系级设置，作用于当前表或物化视图。它不等同于会话级或实例级 GUC；同名的全局参数另有…存储参数 · 表与物化视图 user_defined_types章节正文PG1835.60. user_defined_types 视图 user_defined_types 目前包含定义在当前数据库中的所有复合类型。只有那些当前用户能够访问（作为拥有者或具有某些权限）的类型才会被显示。SQL 中有两种用户定义类型：结构类型（在 PostgreSQL 中也称为复合类型）以及独立类型（distinct type，PostgreSQL 尚未实现）。为兼顾将来，…user_defined_types user_info扩展与模块扩展目录user_info：管理辅助类 PostgreSQL 扩展，提供用户拥有对象和授予角色等信息。 Provides user-related information including owned objects and granted roles. administration ownership roles user_info 安全安全 · 扩展目录 user_mapping_options章节正文PG1835.61. user_mapping_options 视图 user_mapping_options 包含在当前数据库中为用户映射定义的所有选项。只有那些当前用户能够访问其相应外部服务器（作为拥有者或具有某些权限）的用户映射才会被显示。表 35.59. user_mapping_options 列 列类型 描述 authorization_identifier sql_ide…user_mapping_options user_mappings章节正文PG1835.62. user_mappings 视图 user_mappings 包含定义在当前数据库中的所有用户映射。只有当前用户能够访问其对应外部服务器（作为拥有者或具有某些权限）的用户映射才会被显示。表 35.60. user_mappings 列 列类型 描述 authorization_identifier sql_identifier 被映射的用户名称，如果映射是公共的则…user_mappings userlock等待事件本站词条等待获取用户锁。 Waiting to acquire a user lock. `PG_WAIT_LOCK` 位于 `src/backend/storage/lmgr/proc.c:1487`，是经 grep 核验的报告路径。公共身份/资源映射位于 `src/backend/utils/activity/wait_event_names.txt:427`。探针覆盖的操作是：等…重量级锁 · 等待事件 UTF8排序规则与编码本站词条Unicode，8 位 服务端编码 编码 UTF8 编码标识 6 语言 所有 服务端支持 支持 ICU 支持 支持 每字符字节数 1-4 每字符字节数 1–4排序规则与编码 · 服务端编码 utils扩展与模块扩展目录提供整数加法与乘法函数的极简 C 扩展示例。 Minimal C extension example providing integer addition and multiplication functions. arithmetic c-extension example learning scalar-functions utils 函数与聚合函数与聚合 · 扩展目录 utinyint扩展与模块扩展目录为 PostgreSQL 提供 1 字节无符号整数类型，以及与 smallint、integer 和 boolean 的类型转换。 One-byte unsigned integer type with casts to smallint, integer, and boolean. datatype integer utinyint utinyint 数据类型数据类型 · 扩展目录 uuid数据类型本站词条通用唯一标识符 其他内置类型 uuid 目录名称 pg_catalog.uuid 类型 OID 2950 类型种类 基础类型 声明长度 16 字节 存储策略 plain 输入函数 uuid_in 输出函数 uuid_out数据类型 · 其他内置类型 UUID 函数章节正文PG189.14. UUID 函数表 9.45 展示了 PostgreSQL 中可用于生成 UUID 的函数。表 9.45. UUID 生成函数 函数 描述 示例 gen_random_uuid ( ) → uuid uuidv4 ( ) → uuid 生成一个版本 4（随机）的 UUID gen_random_uuid() → 5b30857f-0bfa-48b5-ac0b-5c64…UUID 函数 UUID 类型章节正文PG188.12. UUID 类型 uuid 数据类型用于存储由 RFC 9562、ISO/IEC 9834-8:2005 及相关标准定义的通用唯一标识符（UUID）。（有些系统把这种数据类型称为全局唯一标识符，或 GUID。）这种标识符是一个 128 位的量，由某种算法生成，该算法的设计目标是：使已知宇宙中其他人用同一算法生成出相同标识符的概率极低。因此，对于分布式系统而言，这类标识…UUID 类型 uuid-freebsd扩展与模块扩展目录为 FreeBSD 上的 PostgreSQL 提供 UUID 生成函数。 UUID generation functions for PostgreSQL on FreeBSD. freebsd uuid uuid-freebsd 函数与聚合函数与聚合 · 扩展目录 uuid-ossp扩展与模块PG18F.49. uuid-ossp — UUID 生成器 uuid-ossp 模块提供一些函数，可使用几种标准算法之一生成通用唯一标识符（UUID）。它还提供一些函数，用于生成某些特殊的 UUID 常量。只有在需要核心 PostgreSQL 未提供的特殊功能时，才需要此模块。关于生成 UUID 的内置方式，见第 9.14 节。该模块被认为是“受信任的”，也就是说，它可以由在当前数据…uuid-ossp — UUID 生成器 uuid-ossp — UUID 生成器章节正文PG18F.49. uuid-ossp — UUID 生成器 uuid-ossp 模块提供一些函数，可使用几种标准算法之一生成通用唯一标识符（UUID）。它还提供一些函数，用于生成某些特殊的 UUID 常量。只有在需要核心 PostgreSQL 未提供的特殊功能时，才需要此模块。关于生成 UUID 的内置方式，见第 9.14 节。该模块被认为是“受信任的”，也就是说，它可以由在当前数据…uuid-ossp — UUID 生成器 uuid-ossp 函数章节正文PG18F.49.1. uuid-ossp 函数表 F.35 展示了可用于生成 UUID 的函数。相关标准 ITU-T Rec. X.667、ISO/IEC 9834-8:2005 以及 RFC 4122 规定了四种生成 UUID 的算法，分别由版本号 1、3、4 和 5 标识。（没有版本 2 算法。）这些算法中的每一种都可能适用于不同的一类应用。表 F.35. 用于生成 UUID 的…uuid-ossp 函数 uuid47扩展与模块扩展目录以 UUIDv7 存储并通过密钥输出 UUIDv4 外观的类型 UUIDv7 storage with keyed UUIDv4-looking façade I/O brin btree data-type hash-index siphash uuid uuidv4 uuidv7 uuid47 数据类型数据类型 · 扩展目录 uuid_bytea扩展与模块扩展目录在 PostgreSQL UUID 与 16 字节二进制值之间转换 Convert PostgreSQL UUID values to and from 16-byte binary values uuid_bytea 函数与聚合函数与聚合 · 扩展目录 uuid_extract_timestamp函数与运算符本站词条从版本 1、6 或 7 的 UUID 中提取 timestamp with time zone。 Extracts a timestamp with time zone from a UUID of version 1, 6, or 7. uuid_extract_timestamp ( uuid ) → timestamp with time zone UUID 函数函数 · UUID 函数 uuid_extract_version函数与运算符本站词条从符合 RFC 9562 所描述某一变体的 UUID 中提取版本号。 Extracts the version from a UUID of one of the variants described by RFC 9562. uuid_extract_version ( uuid ) → smallint UUID 函数函数 · UUID 函数 uuid_generate_v1函数与运算符PG18uuid_generate_v1 () → uuid 生成一个版本 1 UUID。这会用到计算机的 MAC 地址和时间戳。注意，这类 UUID 会暴露创建该标识符的计算机身份以及创建时间，因而可能不适合某些对安全较为敏感的应用。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_generate_v1mc函数与运算符PG18uuid_generate_v1mc () → uuid 生成一个版本 1 UUID，但会使用随机的组播 MAC 地址，而不是计算机的真实 MAC 地址。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_generate_v3函数与运算符PG18uuid_generate_v3 ( namespace uuid, name text ) → uuid 使用指定的输入名称，在给定的名字空间中生成一个版本 3 UUID。该名字空间应当是由 uuid_ns_*() 函数生成的特殊常量之一，如表 F.36 所示。（理论上也可以是任意 UUID。）该名称是在所选名字空间中的一个标识符。 例如： SELECT uuid_gener…uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_generate_v4函数与运算符PG18uuid_generate_v4 () → uuid 生成一个版本 4 UUID，它完全来源于随机数。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_generate_v5函数与运算符PG18uuid_generate_v5 ( namespace uuid, name text ) → uuid 生成一个版本 5 UUID，它的工作方式与版本 3 UUID 类似，只是使用 SHA-1 作为 hash 方法。由于 SHA-1 被认为比 MD5 更安全，因此通常应优先使用版本 5 而不是版本 3。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_nil函数与运算符PG18uuid_nil () → uuid 返回一个“nil” UUID 常量，它不会作为真正的 UUID 出现。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_ns_dns函数与运算符PG18uuid_ns_dns () → uuid 返回一个表示 UUID 的 DNS 名字空间的常量。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_ns_oid函数与运算符PG18uuid_ns_oid () → uuid 返回一个表示 UUID 的 ISO 对象标识符（OID）名字空间的常量。（这里指的是 ASN.1 OID，与 PostgreSQL 中使用的 OID 无关。）uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_ns_url函数与运算符PG18uuid_ns_url () → uuid 返回一个表示 UUID 的 URL 名字空间的常量。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_ns_x500函数与运算符PG18uuid_ns_x500 () → uuid 返回一个表示 UUID 的 X.500 可分辨名称（DN）名字空间的常量。uuid-ossp — UUID 生成器 › uuid-ossp 函数 uuid_v1扩展与模块扩展目录按时间戳排序的 UUID 第 1 版数据类型 Timestamp-ordered UUID version 1 data type uuid_v1 数据类型数据类型 · 扩展目录 uuid_v7扩展与模块扩展目录用 PL/Rust 生成及解析带时间戳 UUID v7 的可信语言扩展示例 PL/Rust trusted-language example for timestamp-based UUID v7 values pg_tle 函数与聚合函数与聚合 · 扩展目录 uuidv4函数与运算符本站词条生成一个版本 4（随机）的 UUID Generates a version 4 (random) UUID uuidv4 ( ) → uuid UUID 函数函数 · UUID 函数 uuidv7函数与运算符本站词条生成一个版本 7（按时间排序）的 UUID。 Generates a version 7 (time-ordered) UUID. uuidv7 ( [shift interval] ) → uuid UUID 函数函数 · UUID 函数 uuidv7-sql扩展与模块扩展目录用于生成、解析和转换 UUID v7 的纯 SQL 与 PL/pgSQL 函数。 Pure SQL and PL/pgSQL functions for generating, inspecting, and transforming UUID version 7 values. uuid uuidv7 postgres-uuidv7-sql 函数与聚合函数与聚合 · 扩展目录 VACUUMSQL 命令与语法本站词条垃圾收集并按需分析数据库 VACUUM [ ( option [, ...] ) ] [ table_and_columns [, ...] ] 其中option可以是下列之一： FREEZE [ boolean ] VERBOSE [ boolean ] ANALYZE [ boolean ] DISABLE_PAGE_SKIPPING [ boolean ] SKIP…SQL 命令 · 维护