SQL pgAdmin 4 的服务器组与查询工具查询历史管理实践

pgadmin 4 查询历史默认仅内存保存，v7+起需手动启用query_history_save=true并重启生效，历史存于本地sqlite文件，不自动同步且无版本管理功能。

pgAdmin 4 查询历史在哪？默认不持久保存

pgAdmin 4 的查询工具（Query Tool）里点过的 SQL、按过的历史下拉箭头，关掉标签页就丢了——这不是你操作错了，是它默认只存内存里。历史记录只在当前会话生命周期内有效，重启 pgAdmin 或切换服务器组后清空。

• pgAdmin 4 v7+ 起才支持可选的本地 sqlite 历史持久化，但需手动开启且不自动同步到其他设备
• 历史记录文件路径通常是：~/.pgadmin/storage/your_email@domain.com/query_history.sqlite（linux/macos）或 %APPDATA%pgAdminstorageyour_email@domain.comquery_history.sqlite（windows）
• 该数据库只存 query_text 和时间戳，不存结果、不存连接上下文，也不记录是否执行成功

怎么让查询历史真正“留下来”？启用 storage 配置

靠界面点几下是开不了持久历史的，必须改配置文件。关键不是勾选项，而是让 pgAdmin 启动时加载正确的 config_local.py。

• 找到 pgAdmin 配置目录：~/.pgadmin/（Linux/macOS）或 %APPDATA%pgAdmin（Windows）
• 新建或编辑 config_local.py，加入这行：QUERY_HISTORY_SAVE = True
• 重启 pgAdmin —— 不是刷新页面，是彻底退出再启动；否则配置不生效
• 验证是否生效：执行一条 SQL 后关闭 Query Tool 标签，重新打开，点历史下拉，应能看到刚那条

注意：QUERY_HISTORY_SAVE 在 v6.20 之前叫 QUERY_HISTORY_ENABLED，版本不对会静默失效。

服务器组删了，历史记录会跟着丢吗？不会，但容易误判

服务器组（Server Group）只是 ui 分组逻辑，和查询历史存储完全无关。删掉一个分组，只是隐藏了服务器列表，query_history.sqlite 文件纹丝不动。

• 真正影响历史可见性的，是「当前连接的服务器」：历史下拉默认只显示与当前连接同类型（如 postgresql 15）的语句，避免混用语法出错
• 如果你换了服务器但没重连，历史列表可能为空——不是丢了，是过滤掉了
• 想看全部历史？暂时没法直接切，得导出 query_history.sqlite 用 DB 浏览器查 query_history 表

别依赖 pgAdmin 做 SQL 版本管理，它不是 git

它的历史设计目标是临时回溯，不是代码归档。没有分支、没有注释、不能打标签、无法 diff，重复语句会被重复存多遍。

• 高频修改的 SQL，建议用外部文件管理：queries/report_daily.sql，配合 i queries/report_daily.sql 在 Query Tool 中执行
• 需要协作或审计？直接把 SQL 放进项目仓库，用 psql -f 或 CI 调度，比翻 pgAdmin 下拉框靠谱得多
• 误删重要语句？检查 query_history.sqlite 是否被杀毒软件锁定，或是否启用了系统级磁盘写入限制（尤其 macOS 的 Full Disk access）

真要恢复某条语句，别指望 UI，直接打开那个 SQLite 文件，查 query_history 表的 query_text 字段——这是唯一确定能捞回来的方式。