进阶 tableplus.com 2026-11-16 08:30:30 · 6 阅读
第29章 指标面板(Metrics Board)
GUI Tools
指标面板
指标面板是一个画布,你可以在其中放置图表、表格和表单控件,这些数据通过 SQL 查询加载。你可以用它在几分钟内构建一个简单的实时报告或小型内部工具。
打开指标面板
点击工具栏上的“Metrics”按钮,或者导航至 工具 (Tools) > 显示指标面板 (Show Metrics Board)。
左侧边栏列出了你的所有面板。右键点击可新建 (New...) 面板,或进行重命名 (Rename...)、复制 (Duplicate)、删除 (Delete)、导入指标面板 (Import Metrics Board) 或导出指标面板 (Export Metrics Board,用于以文件形式分享面板)。
指标面板窗口的工具栏包含以下按钮:
- 状态:开始或停止刷新面板数据。
- 添加:向面板添加新对象。
- 锁定:锁定面板,防止对象被意外移动或编辑。
- 网格:显示画布网格,并显示或隐藏对象间的连接。
- 数据库:返回工作区。
指标面板详情
添加对象
点击工具栏的“添加”,或者右键点击画布并选择“添加”,然后选择一个对象:
| 对象 | 功能 |
|---|---|
| 数据表 (Data table) | 以表格形式展示查询结果。 |
| 记分牌 (Scoreboard) | 展示单个数值(分数)及详情行。 |
| 柱状图、折线图 (Bar chart, Line chart) | 绘制查询结果。选择 X 轴列,以及一个或多个 Y 轴列。 |
| 饼图 (Pie chart) | 根据标签列和数值列绘制饼图。 |
| 导出器 (Exporter) | 将查询结果导出为 CSV、JSON、SQL 或 Excel 文件。 |
| 导入器 (Importer) | 将 CSV、JSON 或 SQL 文件导入到表中。 |
| 输入框 (Input field) | 文本框,其值会发送给其他对象。 |
| 下拉菜单 (Dropdown) | 值列表(固定值或通过查询加载),选择值会发送给其他对象。 |
| 按钮 (Button) | 向相连的对象发送事件。 |
| 连接 (Connection) | 使相连的对象使用另一个 TablePlus 连接和数据库。 |
添加对象操作
拖动对象以移动位置,拖动其边缘以调整大小。点击对象以查看其设置。
创建图表或数据表
- 添加一个柱状图、折线图、饼图、数据表或记分牌。
- 点击该对象以打开设置。
- 输入标签和加载数据的查询语句,例如:
SELECT strftime('%Y-%m', ordered_at) AS month, SUM(total) AS revenue FROM orders GROUP BY month ORDER BY month; - 对于图表,选择 X 轴和 Y 轴的列(对于饼图则是标签和数值列)。对于记分牌,选择分数 (Score) 和详情 (Detail) 的列。
- 选择刷新率 (Refresh rate):
- 从 1 秒到 30 分钟的时间间隔:对象将在该间隔内重新加载数据。
- 事件刷新 (Refresh on Event):当其他对象(如输入框、下拉菜单或按钮)发送事件时,对象重新加载数据。
- 不自动刷新 (Do not auto refresh):对象仅加载一次。请使用对象上的刷新按钮重新加载。
- 点击确定 (OK)。
图表设置
你还可以从查询结果构建图表:在 SQL 编辑器中打开结果的“图表”选项卡,并点击“添加到指标面板”。参见“处理查询结果”。
通过输入框或下拉菜单过滤
输入框和下拉菜单会将值传递给其他对象的查询:
- 添加图表、表格或记分牌,并将其刷新率设置为“事件刷新”。
- 在查询中,使用 $ 变量引用该值。字符串值将按输入类型插入,因此在查询中需加引号:
SELECT first_name, last_name, email, city FROM customers WHERE country = '$country'; - 添加一个输入框(或下拉菜单)。在其设置中,设置变量名称(此处为 country;默认为 input),并选择提交值的时机:按下 Enter 提交、结束编辑时提交,或事件触发时提交(对于下拉菜单:值变更时提交或事件触发时提交)。
- 将输入框连接到对象:选中输入框,从连接点拖拽到对象。
- 当输入框提交值时,相连的对象将使用新值重新加载。
连接到数据表的输入框
按钮会向相连的对象发送事件。将按钮连接到设置为“事件刷新”(或“事件触发提交”)的对象,以便在点击时重新加载或提交它们。
使用另一个连接
默认情况下,对象会在打开该面板的工作区连接上运行查询。若要使用不同的连接,请添加一个连接 (Connection) 对象,在其设置中选择 TablePlus 连接和数据库,并将其连接到应使用该连接的对象。该连接的安全模式 (Safe Mode) 将应用于这些对象。