Jimmy Angelakos：pg_statviz 1.2发布，支持PostgreSQL 19并新增功能
内容提要
pg_statviz 1.2发布，支持PostgreSQL 19，新增WAL字节计数和阻塞锁分析模块，可统计阻塞会话及锁类型。引入OpenAI AI提供商，更新默认AI模型。工具保持轻量，无需外部代理，AI分析可选，数据可自由导出。
延伸解读
阻塞锁分析：更全面的等待队列视角
新模块基于 pg_blocking_pids() 检测阻塞，不仅统计硬冲突，还计入等待队列中的软阻塞。这意味着即使会话未直接冲突，只要排在锁等待队列中也会被记录。存储大小与会话数无关，保持轻量。该模块同样提供图表和 AI 判定，且持续阻塞不会被误报为健康，有助于识别潜在的性能瓶颈。
AI 分析：可选且兼容多种服务
新增 OpenAI 提供商，通过 --ai openai 即可使用 OpenAI API 或兼容的本地服务。可通过环境变量自定义端点和模型，默认模型已更新为 claude-sonnet-5 和 gemini-3.7-flash。AI 分析完全可选，不传 --ai 时工具行为不变，无额外依赖，也不向外部发送数据，适合对数据隐私敏感的用户。
轻量设计：无需外部代理，数据自由
pg_statviz 强调极简，扩展仅用 SQL 和 PL/pgSQL，无需加载模块，可视化工具可独立运行。数据存储在数据库内，易于导出，不依赖商业监控平台所需的侵入式代理或开放连接。这降低了部署复杂性和安全风险，适合希望保持环境干净的用户。
Q&A
pg_statviz 1.2 新增了哪些主要功能？
pg_statviz 1.2 新增了对 PostgreSQL 19 的支持，包括捕获新的 wal_fpi_bytes 计数器，并记录 PG18/19 的 I/O worker、有效 WAL 级别和 autovacuum 评分设置。此外，还引入了阻塞锁分析模块，可统计阻塞会话数和锁类型，并新增了 OpenAI AI 提供商，更新了默认 AI 模型。
pg_statviz 1.2 如何支持 PostgreSQL 19？
pg_statviz 1.2 增加了对 PostgreSQL 19 的支持，能够捕获新的 wal_fpi_bytes 计数器，并在快照中记录 PG18/19 的 I/O worker、有效 WAL 级别和 autovacuum 评分设置。该版本已针对 PostgreSQL 19 beta3 进行测试，并支持 PostgreSQL 13 到 19 的整个范围。
pg_statviz 的阻塞锁分析模块是如何工作的？
阻塞锁分析模块在每个快照中记录阻塞和被阻塞的会话数，并按锁类型（如关系、事务ID、元组等）进行细分。它基于 pg_blocking_pids() 函数，因此不仅统计硬冲突，还统计软阻塞（即仅在锁等待队列中靠前的会话）。存储保持轻量，表大小与会话数量无关。该模块生成图表和 AI 判定，并应用确定性严重性下限，持续阻塞不会被报告为健康。
pg_statviz 1.2 中如何使用 OpenAI 作为 AI 提供商？
使用 --ai openai 参数即可调用 OpenAI API，该参数同样适用于任何实现 OpenAI API 的服务或本地服务器。可以通过环境变量 OPENAI_BASE_URL 和 OPENAI_MODEL 选择端点和模型。安装时需使用 pip install pg_statviz[ai] 来包含 AI 功能。
pg_statviz 的设计理念是什么？它如何保持轻量？
pg_statviz 的设计理念是轻量、极简。它不需要侵入式代理或打开数据库连接，所有内容都存在于数据库内部。扩展使用纯 SQL 和 PL/pgSQL，无需加载模块；可视化工具独立运行，可从任何地方使用；数据可自由导出。AI 分析是可选的，如果不传递 --ai 参数，则不会产生额外依赖或外部调用。
pg_statviz 1.2 更新了哪些默认 AI 模型？
pg_statviz 1.2 将 Claude 的默认模型更新为 claude-sonnet-5，将 Gemini 的默认模型更新为 gemini-3.7-flash。
pg_statviz 可以从哪些渠道安装？
pg_statviz 可以从 PostgreSQL 仓库或 PGXN 下载安装，也可以从 PyPI 安装工具，使用 pip install pg_statviz[ai] 可包含 AI 功能。此外，还支持手动安装。
