AIGC标识 推荐一个新的原生pg客户端,pgNimbus

pgNimbus 使用指南

一个原生的 PostgreSQL 客户端:双击就到窗口,查询结果边跑边显示,不打扰你的数据库,也不打扰你。

来源:Shman4ik/pgNimbus · 本文截图取自本机 v1.4.0(简体中文界面)


一、为什么值得用:原生,所以快

很多数据库客户端是"网页壳"(Electron)——启动要等好几秒,滚动大结果集会卡,内存动辄几百兆。pgNimbus 走的是完全不同的路子:

对比项 pgNimbus
技术栈 原生 .NET 11 + Avalonia 12,最终以 NativeAOT 编译成机器码,不是 Web 包装
启动速度 约 0.2 秒到窗口(每个版本都会实测),不用"泡杯茶回来它还在转"
结果加载 边执行边出结果(流式返回),不必等整条查询跑完;Esc 随时打断正在跑的语句
界面 原生控件渲染,中文界面自带,滚动 / 排序 / 多标签都是系统级手感,不糊、不卡
体积与内存 单个可执行文件,不背浏览器内核
隐私 无遥测、无账号、无云同步、无更新检查,只连你自己配置的 Postgres 和 SSH 隧道
平台 Windows / macOS / Linux(MIT 开源)

一句话:它是给"一天要进数据库十几次"的人用的——查一行数据、看看迁移到底改了啥、找出谁在锁表,每次都该是"打开就能干",而不是"等软件打开"。


二、安装与启动

任选其一(Windows 是主要目标平台,macOS / Linux 目前是 beta):

  • Microsoft Store(推荐):搜索 pgNimbus 安装。Store 包由微软签名、自动更新,没有 SmartScreen 警告。
  • WinGet:winget install pgNimbus --source msstore(装的是同一个 Store 包,签名相同)。
  • 便携版 zip:从 Releases 下载 pgNimbus-<版本>-win-x64.zip(Arm 设备用 win-arm64),解压到任意位置,进文件夹运行 PgNimbus.App.exe——不用安装、不需要管理员权限。
    • 这个 zip 没有代码签名,首次运行 SmartScreen 会拦一下:点 更多信息 → 仍要运行。
    • 更新就是换掉整个文件夹;配置存在 %AppData%\pgNimbus,不在程序目录里,所以会保留。
  • 就当前目录:本机就是便携版,直接运行 PgNimbus.App.exe(v1.4.0)。

界面语言跟随系统:系统是简体中文,打开就是中文。想改:连接窗口右上角的语言按钮,或 Ctrl + , 打开设置 → 常规 → 语言,切换立即生效、无需重启。SQL 关键字、服务端消息和数据本身不会被翻译。


三、连接数据库

  1. 启动后是连接窗口:把连接串粘进去即可(postgres://user:pass@host:5432/db 或 host=... dbname=... 两种写法都认)。
  2. 常用的连接可存成配置(profile),下次点一下就连上。
  3. 生产库可以配色标记:标记为生产环境后,连接打开时写入默认关闭,要在这个窗口里显式允许才放开写操作——手滑的代价能降到零。
  4. 需要跳板机就用 SSH 隧道;主机密钥会被校验,不会默默信任。
  5. 密码由操作系统的密钥库加密保存(Windows 上是 DPAPI),不会写进配置文件。

四、界面速览

主界面:左侧模式树,上方查询标签页,下方结果网格

  • 左侧栏:模式 标签是数据库对象树(public 下双击表就能浏览),下面是 角色(用户 / 权限)。搜索框可直接过滤表和视图。
  • 中间:查询标签页 + SQL 编辑器,可以开很多个;底部状态栏显示 1 行 · 23 ms · 首字节 3 ms 这样的耗时(首字节时间最直观地反映了"响应有多快")。
  • 工具条:运行、取消、开始事务、解释、导出、导入,后面是格式化与筛选。
  • 顶部中间那个搜索框(Ctrl + K):全应用总入口,能模糊搜表、已保存的查询和所有操作命令。

原生界面在这里最直观:切标签、翻页、排序都是瞬时响应,没有"网页在转圈"的那一层。


五、写查询、看结果

运行与编辑

操作 快捷键
运行查询 Ctrl + Enter / F5
只运行光标所在的那一条语句 Shift + Enter
取消正在跑的查询 Esc
自动补全(也边打字边弹) Ctrl + Space
格式化光标所在语句 Ctrl + Shift + F / Alt + Shift + F
把 SELECT * 展开成列名 Ctrl + Shift + 8
新建 / 关闭 / 重开标签页 Ctrl + T / Ctrl + W / Ctrl + Shift + T

不写 SQL 也能看表

  • 在左侧树里双击表进入浏览模式:分页和点击表头排序都是下推到 Postgres 执行的(ORDER BY / LIMIT / OFFSET),一亿行的表翻一页和一千行的表一样快。
  • 网格里 Ctrl + F(浏览表时)弹出筛选器:选列、选比较方式(文本是"包含 / 开头是 / 等于…",数字日期是 > < ≥…,还有"是空 / 非空")。条件会变成网格上方一排可点删的条件标签,并写回编辑器里的 SQL——你永远看得见到底跑了什么。
  • F2 或双击就地编辑单元格(编辑器按列类型区分,JSON 是一等公民);
  • 空格 或双击查看单元格完整内容(JSON 会格式化,可切树形浏览);
  • Ctrl + I 打开行详情表单,Tab 在字段间跳,‹ › 切换上 / 下一行;
  • 改动可以先暂存,审阅后再提交(安全模式),外键单元格还能顺着外键跳转到关联行。

事务

Ctrl + Shift + B 开始 · Ctrl + Shift + Enter 提交 · Ctrl + Shift + Backspace 回滚。事务期间状态栏有明确提示;语句失败时 pgNimbus 会帮你整块回滚,不会把你留在 Postgres 的"事务已中止"死状态里。


六、Explain:不只是把执行计划打印出来

执行计划:树形结构 + 耗时条,可切换时间 / 行数 / 成本 / 缓冲区

操作 快捷键
解释(估算计划,不执行) Ctrl + E
解释并分析(真的执行,然后回滚) Ctrl + Shift + E

要点:

  • 分析写语句也安全:EXPLAIN ANALYZE 真的会执行,但 pgNimbus 把每次 analyze 都放进一个随后回滚的事务,INSERT/UPDATE/DELETE 也不会留下任何数据改动;如果语句是写操作,顶部警告条会明确告诉你"这是写语句,已回滚"。
  • 树 + 热力图:每个节点的条长按自耗时(不含子节点)缩放,最慢的节点会高亮成瓶颈。没有 ANALYZE 时间时自动退化为按成本着色。
  • 换指标着色:右上角 着色 可在 时间 / 行数 / 成本 / 缓冲区 之间切换并就地重算——"慢节点其实只是在等 I/O"这种情况,切到缓冲区一眼就能看出来。
  • 纯文本视图:文本 按钮给出和 EXPLAIN (FORMAT TEXT) 相同的排版,零值计数被折叠,读起来更清爽。
  • 通俗语言警告条:行数估算错得离谱、排序 / 哈希溢写到磁盘、不该出现的顺序扫描、lossy bitmap 块……每条都带"该怎么办"。
  • 导入别人的计划:命令面板里的 导入查询计划… 能把剪贴板中的计划(JSON 或文本,自动识别格式)画成同样的树——不需要连那台服务器,同事贴在工单里的计划也能看。
  • 导出计划:计划头部的 导出 菜单可复制 / 保存为 JSON(服务端原始输出,可回灌到其它工具)或渲染后的文本。

Query Lab:两份计划做对比

  1. 跑一次 Ctrl + Shift + E,在计划头部 对比 菜单里选 保存到 Query Lab…(同名再存就是更新);
  2. 去加个索引;
  3. 再跑一次 Ctrl + Shift + E,选 与…对比(Compare With) → 选刚才保存的那份。

Query Lab 会给出 摘要(执行 / 规划时间、返回行数与估算行数、成本、缓冲区读取量,以及差值)和 计划变化(把两份计划合成一棵树,标出 相同 / 变化 / 新增 / 移除,例如"原来是 Parallel Seq Scan on orders o")。

它很克制:单次运行的快慢不会被它断言成"更好",只会提示"各跑了一次""缓存的差异可能解释一部分差别"这类你需要知道的前提。


七、服务器活动与监控

所有监控窗口都能从命令面板打开,也都有快捷键;同一时间只会有一份实时实例(再按一次是把已有窗口提到前面,不会重复开)。

服务器活动:后端进程列表 + 取消查询 / 终止 + 自动刷新

服务器活动 Ctrl + Shift + M

两个标签,每 2 秒自动刷新:

  • 后端进程:实时的 pg_stat_activity 列表——谁连着、在跑什么、跑了多久、在等什么。工具栏可对选中进程 取消查询(停掉当前语句) 或 终止(踢掉会话)。生产配置下这两个按钮默认关闭,要先在这个窗口里允许写入。
  • 阻塞:"谁阻塞了谁"的锁等待树。持锁者在上面,等待者嵌套在下面,每条都标着卡在哪个锁上。它基于 pg_blocking_pids() 而不是手写 pg_locks 自连接,所以锁组、并行 worker 这类情况也判得准;链式等待、一个等待者被多方阻塞、死锁环都能显示。
    • 要点:动手时瞄准链条最上面的持锁者——放掉它,下面所有等待者一起解放;去杀一个等待者毫无意义。

数据库概览 Ctrl + Shift + G

数据库概览:大小、缓存命中率、最大的表、扫描方式、未使用索引

只读健康面板(基于 pg_stat_* / pg_statio_*):

  • 数据库大小、最大的表(堆与索引分别列出,含缓存命中率);
  • 顺序扫描 vs 索引扫描次数(顺带标出"疑似缺索引");
  • 未使用的索引:不支撑任何约束、纯粹占磁盘的那些。

另外三个

功能 入口
慢查询(pg_stat_statements,按总时间 / 均值 / 调用次数排序;可只统计打开窗口之后的工作量) 命令面板搜 慢查询
LISTEN / NOTIFY 监视器(订阅频道、看 NOTIFY 载荷、还能用 pg_notify() 发一条测试) Ctrl + Shift + L
角色与权限 Ctrl + Shift + U

pg_stat_statements 需要超级用户开启(shared_preload_libraries + CREATE EXTENSION)。缺哪一步,pgNimbus 会告诉你并给出一段供你审阅的脚本,但绝不会替你执行。


八、导出与导入

导出

结果网格工具栏的导出菜单:CSV / JSON / 电子表格安全模式

  • 点工具栏 导出 → 导出为 CSV… / 导出为 JSON…。
  • 浏览表时导出的是整张表:它会把你当前的分页查询去掉 LIMIT 重新执行,把行流式写入文件,并保留当前的筛选条件和排序——表多大都不占内存;状态栏实时数行,取消 会停止并删掉半成品文件。
  • 自己写的查询:导出网格里的行(网格最多容纳 100,000 行;超出部分会在状态栏明确提示。需要全量就"浏览表"或用 OFFSET 分段导出——它不会擅自把你的 SELECT 再跑第二遍,因为带函数的 SELECT 可能真的会写数据)。
  • 复制到剪贴板:Ctrl + C,可在导出菜单里选 TSV / CSV / JSON / Markdown 表格 / INSERT 语句。
  • 电子表格安全模式:菜单底部那个开关。开启后,以 = + - @ 开头的文本会在 CSV 和复制的单元格前加一个 ',防止 Excel / LibreOffice / Google Sheets 把数据当公式执行(数字和负数不受影响)。默认关闭,因为那确实改动了数据;你的选择会被记住。

导入

导入对话框:CSV 或 JSON

  • 点工具栏 导入 → 选 CSV 或 JSON 文件 → 通过 PostgreSQL 的 COPY 流式灌入目标表,并对导入列做类型推断。
  • 限制:单文件 ≤ 512 MB、≤ 1,000,000 行、≤ 1000 列;超了会说清超了哪一条(拆文件,或用 psql 的 \copy)。

顺带一提:备份 / 恢复

从 1.2 起可以直接用 PostgreSQL 官方的 pg_dump / pg_restore 备份与恢复整库、某个模式、或单张表(命令面板里搜 备份 / 恢复)。


九、键盘流:记住这几个就够

命令面板:搜索表、已保存的查询和所有操作,右侧标注快捷键

目的 快捷键
命令面板(搜表 / 查询 / 操作,应用总入口) Ctrl + K(或 Ctrl + P)
快捷键速查表 F1
运行 / 只跑当前语句 / 取消 Ctrl + Enter(或 F5)/ Shift + Enter / Esc
解释(估算)/ 解释并分析 Ctrl + E / Ctrl + Shift + E
服务器活动 / 数据库概览 Ctrl + Shift + M / Ctrl + Shift + G
LISTEN/NOTIFY 监视 / 角色与权限 Ctrl + Shift + L / Ctrl + Shift + U
折叠左侧栏 / 编辑器与结果切换焦点 Ctrl + B / F6
刷新模式树 / 切换连接 / 新窗口打开连接 Ctrl + Shift + R / Ctrl + Shift + O / Ctrl + Shift + N
设置 Ctrl + ,

F1 快捷键速查表(按区域分组,跟随界面语言)

大部分功能故意不放工具栏按钮——它们住在命令面板里,每条都标着自己的快捷键。用几次之后就自然过渡到直接按快捷键。
macOS 上 Ctrl 自动换成 ⌘(可在 设置 → 快捷键方案 里强制任意一种)。


十、几条值得知道的小贴士

  1. 关闭窗口是安全收尾:有暂存改动、开着事务或正在跑的查询时,它会先问你要丢什么;不管问不问,关闭时都会取消查询、回滚事务,不在服务器上留下一个 idle in transaction 的僵尸会话占着锁。
  2. 未保存的 SQL 不会丢:关掉窗口后,标签和文本会随连接一起恢复。
  3. 搜索框就是命令面板:想找"备份""慢查询""导入计划"这类功能,直接 Ctrl + K 打字。
  4. 历史 / 标签 / 已保存查询是本地明文存储(历史可在设置里关掉;历史与标签里的密码会被打码)。密码本身走系统密钥库。
  5. 大结果集:网格上限 10 万行,导出走流式;别指望客户端把一亿行塞进表格,用导出。
  6. 生产环境务必给连接打上"生产"标记——默认禁写,出事概率立刻降一个量级。

十一、参考

本文截图来自本机 v1.4.0。想自己重截一套,可用 screenshots\_shot.ps1
(PowerShell:聚焦窗口 → 发快捷键 → 用 PrintWindow 抓窗口,不受其它窗口遮挡影响)
例:pwsh -File screenshots\_shot.ps1 -Out out.png -Keys '^+m' -Target new -WaitMs 2500 -CloseAfter

01-main-window

02-export-menu

03-import-dialog

04-explain-plan

05-server-activity

06-database-overview

07-command-palette

08-shortcuts

posted @ 2026-11-22 13:53  首席装逼官  阅读(29)  评论(0)    收藏  举报