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