用途:把 PostgreSQL 当作数据库引擎来安全运维,覆盖配置审查、索引与查询计划分析、vacuum 与膨胀管理、WAL 归档与时间点恢复(PITR)、复制与故障切换、扩展管理、大版本升级规划,以及基于证据的故障诊断。仅针对 PostgreSQL 这一工具;应用层数据访问、模式与数据建模、跨引擎备份与迁移方法论、Supabase 平台管理均不属于本技能。
主要能力:内置只读诊断脚本 scripts/pgdiag,通过 psql 执行并以 default_transaction_read_only=on 开启会话,输出有界 JSON。常用用法:scripts/pgdiag --help(无需集群)、scripts/pgdiag --json、scripts/pgdiag --host db1 --dbname app --json、scripts/pgdiag --check identity --check wal_archive --json、scripts/pgdiag --plan-for "SELECT * FROM orders WHERE id = 42" --json。退出码:0 正常,1 运行时/采集错误,2 用法错误,127 未找到 psql,124 超时。
使用方式:先只读发现(配置、目录统计、日志),再按症状对照证据分诊;任何变更(pg_ctl stop、提升、扩展安装、pg_upgrade、维护性 VACUUM)都需明确的人工指令指定实例并先说明回滚路径。配置以 pg_settings 为运行时事实来源,区分 reload 与 restart;索引与计划用 EXPLAIN (ANALYZE, BUFFERS) 与 pg_stat_user_indexes 验证;归档健康看 pg_stat_archiver;复制看 pg_stat_replication。
限制:备份日志不等于可恢复证据,需在临时实例上验证恢复;不得暴露完整日志、postgresql.conf 或含密码的连接串;不得把相关性当作因果;VACUUM FULL 不可作为常规操作。具体版本矩阵、参数表与运行手册见 references/ 下九份参考文档。