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

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

百科 / 系统目录 / 系统视图

SYSTEM VIEW系统视图

pg_aios

正在使用的异步 I/O 句柄

系统视图 引入 18 现存至 20 devel 0 次结构变更

类别
系统视图
关系 OID
12355
关系类型
v(视图)
字段数
15
引入版本
18
版本状态
当前稳定版
结构变更
0 次

PostgreSQL 18 手册 官方文档

版本轨迹

PostgreSQL 18 新增此关系,共 15 个字段。

pg_aios 视图列出当前正在使用的全部异步 I/O 句柄。I/O 句柄用于引用正在准备、执行或处于完成过程中的 I/O 操作。pg_aios 为每个 I/O 句柄提供一行。

该视图主要对 PostgreSQL 开发者有用,但在调优 PostgreSQL 时也可能有帮助。

字段

PostgreSQL 18.7 的 15 个字段,按定义顺序排列。说明默认用本站手册的译文,没有译文的按英文原文显示。

字段 类型 说明
pid 新 integer 发起该 I/O 的服务器进程 ID。
io_id 新 integer I/O 句柄的标识符。I/O 完成后(或者在 I/O 启动前释放句柄时),句柄会被复用。每次复用时,pg_aios.io_generation 都会递增。
io_generation 新 bigint I/O 句柄的代次。
state 新 text I/O 句柄的状态: HANDED_OUT,已被代码引用但尚未使用 DEFINED,执行所需的信息已知 STAGED,已就绪,可执行 SUBMITTED,已提交执行 COMPLETED_IO,已完成,但结果尚未处理 COMPLETED_SHARED,共享完成处理已完成 COMPLETED_LOCAL,后端本地完成处理已完成
operation 新 text 使用 I/O 句柄执行的操作: invalid,尚未知晓 readv,向量化读取 writev,向量化写入
off 新 bigint I/O 操作的偏移量。
length 新 bigint I/O 操作的长度。
target 新 text I/O 的目标对象类型: smgr,关系上的 I/O
handle_data_len 新 smallint 与 I/O 操作关联的数据长度。对于指向或来自 shared_buffers 和 temp_buffers 的 I/O,该值表示 I/O 正在操作的缓冲区个数。
raw_result 新 integer I/O 操作的底层结果;如果操作尚未完成,则为 NULL。
result 新 text I/O 操作的高层结果: UNKNOWN 表示操作结果尚未知晓。 OK 表示 I/O 已成功完成。 PARTIAL 表示 I/O 完成时没有出错,但未处理全部数据。通常调用方需要在单独的 I/O 中重试并完成剩余工作。 WARNING 表示 I/O 完成时没有出错,但执行 I/O 时触发了警告。例如,在启用 zero_damaged_pages 时遇到损坏的缓冲区。 ERROR 表示 I/O 因错误而失败。
target_desc 新 text I/O 操作目标的描述。
f_sync 新 boolean 标记该 I/O 是否同步执行。
f_localmem 新 boolean 标记该 I/O 是否引用进程本地内存。
f_buffered 新 boolean 标记该 I/O 是否为缓冲 I/O。

演化历史

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

  1. PostgreSQL 18 ← 17 新增此关系

    共 15 个字段

字段矩阵

每个字段在 3 个收录版本里的存在情况;方格指向该版的字段表。「有变」指类型、可空、隐式或数组维数与上一版不同。

存在 有变 已移除 不存在

字段 181920
pid 存在 存在 有变
io_id 存在 存在 有变
io_generation 存在 存在 有变
state 存在 存在 存在
operation 存在 存在 存在
off 存在 存在 有变
length 存在 存在 有变
target 存在 存在 存在
handle_data_len 存在 存在 有变
raw_result 存在 存在 有变
result 存在 存在 存在
target_desc 存在 存在 存在
f_sync 存在 存在 有变
f_localmem 存在 存在 有变
f_buffered 存在 存在 有变

同类关系

关系 引入 字段 版本变动 最近变更
SYSTEM VIEW 系统视图 39 个 ↗
pg_aios 18 15 —
正在使用的异步 I/O 句柄 现存
pg_available_extension_versions 9.1 10 192 次
扩展的可用版本 现存
pg_available_extensions 9.1 5 191 次
可用的扩展 现存
pg_backend_memory_contexts 14 10 181 次
后端内存上下文 现存
pg_config 9.6 2 —
编译时配置参数 现存
pg_cursors 8.2 6 —
打开的游标 现存
pg_dsm_registry_allocations 19 3 —
DSM 注册表跟踪的共享内存分配 现存
pg_file_settings 9.5 7 —
配置文件内容摘要 现存
pg_group 7.4基线 3 8.11 次
数据库用户组 现存
pg_hba_file_rules 10 11 161 次
客户端认证配置文件内容的摘要 现存
pg_ident_file_mappings 15 7 161 次
客户端用户名映射配置文件内容摘要 现存
pg_indexes 7.4基线 5 8.01 次
索引 现存
pg_locks 7.4基线 16 144 次
当前持有或等待的锁 现存
pg_matviews 9.3 7 —
物化视图 现存
pg_policies 9.5 8 101 次
策略 现存
pg_prepared_statements 8.2 8 162 次
预备语句 现存
pg_prepared_xacts 8.1 5 —
预备事务 现存
pg_publication_sequences 19 3 —
发布及其关联序列的信息 现存
pg_publication_tables 10 5 151 次
发布及其关联表的信息 现存
pg_replication_origin_status 9.5 4 —
有关复制源的信息,包括复制进度 现存
pg_replication_slots 9.4 22 199 次
复制槽信息 现存
pg_roles 8.1 13 9.52 次
数据库角色 现存
pg_rules 7.4基线 4 —
规则 现存
pg_seclabels 9.1 8 —
安全标签 现存
pg_sequences 10 11 —
序列 现存
pg_settings 7.4基线 17 9.54 次
参数设置 现存
pg_shadow 7.4基线 9 124 次
数据库用户 现存
pg_shmem_allocations 13 4 —
共享内存分配 现存
pg_shmem_allocations_numa 18 3 —
共享内存分配的 NUMA 节点映射 现存
pg_stats 7.4基线 19 194 次
规划器统计信息 现存
pg_stats_ext 12 17 193 次
扩展规划器统计信息 现存
pg_stats_ext_exprs 14 22 192 次
表达式的扩展规划器统计信息 现存
pg_tables 7.4基线 8 9.52 次
表 现存
pg_timezone_abbrevs 8.2 3 —
时区缩写 现存
pg_timezone_names 8.2 4 —
时区名称 现存
pg_user 7.4基线 9 124 次
数据库用户 现存
pg_user_mappings 8.4 6 9.01 次
用户映射 现存
pg_views 7.4基线 4 —
视图 现存
pg_wait_events 17 3 —
等待事件 现存