Linux 上 pgAdmin 自定义报表实用指南
一 功能与适用场景
- pgAdmin 4 提供“查询工具”与“仪表盘”两类可视化输出，适合做运维与业务监控报表。
- 在 Linux 上，pgAdmin 支持 桌面模式 与 Web 模式 两种部署；两者界面一致，报表功能相同，仅访问方式不同（桌面为本地应用，Web 通过浏览器访问）。若需多人共享报表，建议使用 Web 模式。
二 快速做法 使用查询工具导出报表
- 新建查询：在左侧对象树选择数据库 → 打开“查询工具”，编写返回结果集的 SQL（建议只返回需要的列，必要时加 LIMIT）。
- 参数化查询：在查询中可使用 $1、$2 等占位符，执行时输入参数，便于复用同一报表模板。
- 导出结果：执行后使用结果面板“下载”按钮，导出为 CSV、Excel（XLSX） 等格式，作为报表数据文件分发或归档。
- 保存与复用：将 SQL 保存为“脚本”，下次打开直接执行即可得到最新报表数据。
三 进阶做法 仪表盘图表与面板
- 创建仪表盘：左侧对象树展开“仪表盘” → 右键目标服务器或数据库 → “创建” → “仪表盘”，命名并保存。
- 添加图表：在仪表盘页面点击“添加面板”，选择图表类型（如 条形图、折线图、饼图、表格 等），配置：
- 数据源：选择“查询”，写入返回两列或多列的 SQL（如“类别, 数值”）。
- 刷新间隔：设置自动刷新（如 30 秒/5 分钟），用于实时监控。
- 外观与分组：配置颜色、堆叠、排序、阈值等，突出关键指标。
- 布局与共享：拖拽面板调整布局；仪表盘以对象形式保存，可复制、重命名，便于为不同业务线维护多套报表视图。
四 共享与权限控制
- 多用户共享：在 Web 模式 下，多个用户可同时登录 pgAdmin；但“连接配置的密码不共享”，各用户需分别保存自己的凭据。适合团队集中查看同一套报表。
- 连接信息迁移：使用“Import/Export Servers”以 JSON 格式批量导入/导出服务器连接，便于在新环境快速复用报表所需的服务器列表（注意：密码需重新保存）。
五 常见问题与实用建议
- 中文与界面：通过“File → Preferences → Miscellaneous → User language”切换界面语言（如中文），便于本地团队使用。
- 权限与可见性：确保报表所用的数据库用户具备相应 SELECT 权限；跨库查询需授予权限或使用具备权限的专用只读账号。
- 性能建议：报表 SQL 建议只查询必要列、合理使用索引与过滤条件，必要时做聚合与预计算；大数据量报表可结合物化视图或定时任务生成中间结果。
- 导出格式：对外分发优先 CSV（通用、体积小）；需要样式与多表头时选 Excel（XLSX）。
- 版本差异：菜单名称与位置可能随版本略有变化，建议保持 pgAdmin 为较新稳定版本以获得更好的图表与导出体验。
