进阶 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 连接和数据库。

添加对象操作

拖动对象以移动位置,拖动其边缘以调整大小。点击对象以查看其设置。

创建图表或数据表

  1. 添加一个柱状图、折线图、饼图、数据表或记分牌。
  2. 点击该对象以打开设置。
  3. 输入标签和加载数据的查询语句,例如:
    SELECT strftime('%Y-%m', ordered_at) AS month, SUM(total) AS revenue FROM orders GROUP BY month ORDER BY month;
  4. 对于图表,选择 X 轴和 Y 轴的列(对于饼图则是标签和数值列)。对于记分牌,选择分数 (Score) 和详情 (Detail) 的列。
  5. 选择刷新率 (Refresh rate):
    • 从 1 秒到 30 分钟的时间间隔:对象将在该间隔内重新加载数据。
    • 事件刷新 (Refresh on Event):当其他对象(如输入框、下拉菜单或按钮)发送事件时,对象重新加载数据。
    • 不自动刷新 (Do not auto refresh):对象仅加载一次。请使用对象上的刷新按钮重新加载。
  6. 点击确定 (OK)。

图表设置

你还可以从查询结果构建图表:在 SQL 编辑器中打开结果的“图表”选项卡,并点击“添加到指标面板”。参见“处理查询结果”。

通过输入框或下拉菜单过滤

输入框和下拉菜单会将值传递给其他对象的查询:

  1. 添加图表、表格或记分牌,并将其刷新率设置为“事件刷新”。
  2. 在查询中,使用 $ 变量引用该值。字符串值将按输入类型插入,因此在查询中需加引号:
    SELECT first_name, last_name, email, city FROM customers WHERE country = '$country';
  3. 添加一个输入框(或下拉菜单)。在其设置中,设置变量名称(此处为 country;默认为 input),并选择提交值的时机:按下 Enter 提交、结束编辑时提交,或事件触发时提交(对于下拉菜单:值变更时提交或事件触发时提交)。
  4. 将输入框连接到对象:选中输入框,从连接点拖拽到对象。
  5. 当输入框提交值时,相连的对象将使用新值重新加载。

连接到数据表的输入框

按钮会向相连的对象发送事件。将按钮连接到设置为“事件刷新”(或“事件触发提交”)的对象,以便在点击时重新加载或提交它们。

使用另一个连接

默认情况下,对象会在打开该面板的工作区连接上运行查询。若要使用不同的连接,请添加一个连接 (Connection) 对象,在其设置中选择 TablePlus 连接和数据库,并将其连接到应使用该连接的对象。该连接的安全模式 (Safe Mode) 将应用于这些对象。

评论 (0)