跳转至

SaveDatabaseQuery

将只读的 SELECT 保存为实时问题,并取回显示其答案的块。将返回的 markdown 原样粘贴到你的回复中,或粘贴到通过 CreateDocument/EditDocument 创建或编辑的文档中,它就会渲染为实时数字、表格或图表,并会以查看者的权限重新运行,因此会随着数据变化而保持最新。

当用户询问有关其数据的问题或要求提供图表时,请使用此工具。先用 QueryDatabase 运行该 SELECT,以确认其返回结果符合预期,然后原样保存该 SQL。该 SQL 是 QueryDatabase 的方言,已在其文档中说明,且仅限于单个 SELECT。

  • displayMode:scalar 用于单个数字(单个 COUNT/SUM/AVG),table 用于行,bar 用于比较类别,line 用于有序列上的趋势,area 用于各系列合计为一个整体的趋势,scatter 用于将一个数值列与另一个数值列绘制成图,pie 用于整体占比。
  • chart(bar/line/area/scatter/pie):x 是标签列,y 是数值结果列,列名必须与结果列完全一致;要为聚合函数设置别名(COUNT(*) AS invites),以便它们有稳定的名称。color 指定一个结果列,其值将一个 y 系列拆分为每个值一个系列(例如,按状态着色的每个活动的邀请数);stack 将条形或面积系列堆叠起来,而不是并排显示。
  • 传入 databaseId,以便问题针对该数据库的表进行解析。

已保存的问题永远不会更改。若要更改,请保存一个新问题并使用其新块。

参数

参数 类型 必填 说明
databaseId string 否 问题所涉及的数据库的 ID,来自 ListDatabases。当另一个数据库存在同名的表时,该数据库的表优先。
sql string 是 要保存的 SELECT,必须与 QueryDatabase 运行时的完全一致。
title string 是 与答案一起显示的简短标题,例如“每个活动的邀请数”。
displayMode "table" | "scalar" | "bar" | "line" | "area" | "scatter" | "pie" 是 查询结果的呈现提示;不影响 SQL 执行。
chart ToolChart 否 用于 bar、line、area、scatter 和 pie 的图表配置。
prompt string 否 用户提出的问题。默认为标题;在有人编辑问题时显示。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 macro3/macro