仪表板输入标记
标记就像是程序变量，一个输入标记由标记名称和标记值组成，您可以在仪表板图表的查询语句中使用标记，传递您需要的数值。 使用时，标记名称语法使⽤ $...$ 分隔符。
例如，如果您将查询字段输⼊标记定义为$field$，数据来源定义为$source$，则查询语句为
SELECT $field$, COUNT(*) FROM $source$ GROUP BY $field$
在使用仪表板的标记时，交互最直接的是输入标记，因为添加的输入标记可以直接显示在仪表板页面上，并且可以自由调整尺寸和布局，以及在预览和编辑两种模式下都能交互实现变更标记值的目的。
文本类型输入标记可以通过在文本框输入内容，选择器类型输入标记和时间类型的输入标记可通过鼠标点选来更新标记值。输入标记既可以使用静态文字和选项，也可以使用动态的查询结果作为选项来使用，更多的使用细节请参考使用手册。
接下来让我们看一下除了输入标记以外，仪表板还有哪些地方可以使用标记。
仪表板不止输入标记
鸿鹄仪表板提供了多种编辑和访问标记的方式，除了输入标记之外，还包括了设置标记，钻取标记和查询标记。
仪表板设置标记
仪表板的"设置标记"也是包含标记名称和标记值的仪表板标记。不同于仪表板的输入标记直接显示在仪表板页面上并可以随时交互去修改输入标记值，"设置标记"不需要显示在仪表板页面上的，你可以使用仪表板的设置标记来创建和管理一些需要初始值且不常修改的标记变量。
设置标记多应用于以下场景：
-
标记赋值的操作可能是一次性的，或者这些标记不需要用户经常修改。
-
这些标记不需要显示在仪表板页面上。标记值对应了一些用户不必关注文本内容，例如事件的唯一标识符，时间戳，目标数据的数据集等。
创建一个设置标记select_module，赋予标记值%。设置标记既不会显示在仪表板页面上，同时你又可以使用标记初始值用来渲染生成图表。
钻取标记
除了输入标记和仪表板设置标记，你还可以通过图表钻取来设置钻取标记。例如，您可以在表格上启用钻取，然后使用 $click.value$ 等预定义标记访问单击的表格单元格中的值。当点击图表数据点时，钻取会将单击数据的参数设置到目标标记上。关于更多的钻取设置标记的信息请查看钻取交互。
钻取标记多应用于以下场景：
-
图表数据联动 - 钻取标记也是动态的，根据点击的数据点而生成标记值。
-
覆盖标记值 - 钻取除了可以新建仪表板标记，还可以覆写已经存在的标记值。不仅可以更新“输入标记”的标记值，同时也可以用于更新“设置标记”的标记值。
图中的设置就是将点选的数据点的值，设置给仪表板中名为field1的标记，标记值为$click.value$，而当仪表板中其余地方引用了这个标记（例如在图表查询语句中， 或者在图表的标题中使用了$field1$)，这些地方就会根据用户点选的数据点而变化。想要了解更多预定义标记语法，请查看这里
（https://www.yanhuangdata.com/honghu_manual/docs/dashboard/dashboard_drill_down/#%E8%AE%BE%E7%BD%AE%E6%A0%87%E8%AE%B0）。
当用户的查询语句为 select * from _internal limit $field1$时，当用户点击一个值为20的数据点，并且数据点所在的图表按照上图设置了钻取，那么这个就会被替查询语句换为 select * from _internal limit 20
查询结果设置标记
当图表查询完成之后，能否将动态的查询结果数据赋予给仪表板标记呢？答案是肯定的，功能将在后续的鸿鹄平台以及炎凰数据平台企业版中推出，敬请期待。
标记对比
仪表板钻取不止新建标记
仪表板图表钻取可以将单击数据的参数设置到标记上，钻取标记的目标可以是一个新增的仪表板标记，也可以是一个已有的仪表板标记。
例如下图所示，图表钻取标记覆盖已有的"仪表板设置标记"select_module和"输入标记"text_input，同时也增加一个新的仪表板标记new_token。
当点击图表数据点时，钻取动作关联的标记就会通过$click.category$被赋予标记值，例如:
⚠️限制:
-
钻取动作设置标记需要先配置好图表的钻取动作，并通过鼠标点击图表上的数据点来赋予标记值。
-
虽然钻取动作设置标记可以覆盖已经存在的仪表板标记值，但是不能更新时间类型的输入标记:
-
钻取设置的标记名也不能和仪表板基础查询重名。
使用提示:
设置标记的初始标记值虽然只能通过设置-设置标记页面来修改，但其运行时标记值是可以通过图表钻取动作来覆盖修改并应用在当前仪表板中的，例如：
"设置标记"select_module在图表点击时被赋予标记值$click.category$
仪表板标记过滤器
标记过滤器是对标记值的筛选编辑工具，确保您正确捕获标记值。 您可以在使用 $...$ 分隔符以访问标记值的时候，加上 |dq (double quote 双引号)、|sq (single quote 单引号) 或|u(URL 格式)等过滤器:
标记过滤器的使用场景
1、在图表查询语句中使用
我们经常需要把查询字段用双引号包装，把查询中使用的字段值用单引号包装。不仅写查询语句的时候不方便，而且还容易出错。接下来我们看一个在图表查询中使用标记过滤器来简化查询语句的实例, 下图中的表格图表用来查询某个字段在时间范围内的数量并显示:
先设置图表查询语句为 select "_source", count(*) from _internal where _time > 'now-5m' and "_source" is not null group by "_source" having count(*) > 3000
然后把其中的查询字段和时间过滤条件分别用两个输入标记( $fieldname$ 和 $time1$) 来表示, 就得到了含有输入标记的查询语句为select "$fieldname$", count(*) from _internal where _time > '$time1$' and "$fieldname$" is not null group by "$fieldname$" having count(*) > 3000
使用标记过滤器简化上面的查询语句，即用|dq 来修饰 $fieldname|dq$ 则标记 $fieldname|dq$ 在图表查询语句中可以不用再额外包装双引号"。同理，使用 |sq 来修饰 $time1|sq$ 之后，标记 $time1|sq$ 在图表查询语句中也无需再额外包装单引号'
select $fieldname|dq$, count(*) from _internal where _time > $time1|sq$ and $fieldname|dq$ is not null group by $fieldname|dq$ having count(*) > 3000
2、在标记查询中使用
跟图表的查询语句类似，您可以在查询选项类型的标记的查询语句中使用标记过滤器，来达到简化查询语句的效果, 例如:
select $fieldToken|dq$ from my_event_set where $fieldToken1|dq$ is $tokenValue|sq$
3、在钻取标记中使用
除了在查询语句中使用标记和标记过滤器以外，你还可以在钻取设置标记时使用标记过滤器。 例如，把图形点击得到的数据用双引号包装的话，则可以设置myvalue = $click.value|dq$
⚠️ 限制:
对于表格图表，如果想要通过$row.fieldname$ 去设置标记过滤器是不支持的。
例如，表格的字段名为count(*)，那么标记$row.count(*)$无法使用编辑器|，即$row.count(*)|dq$是不支持的。
提示:
你可以先将$row.count(*)$设置为标记table_token，然后在您的查询语句中使用标记过滤器去修饰你的标记$table_token|dq$。
仪表板标记使用小结
标记的选择
鸿鹄仪表板提供了多种类型的标记，除了输入标记之外，还包括了设置标记，钻取标记和查询标记。不同类型的标记有不同的适用场景，详情可以参考标记对比
标记值的更新
除了通过仪表板页面交互更新输入标记的标记值，设置标记页面编辑设置标记的标记值之外，图表的钻取交互同样可以更新标记值，具体内容请参考钻取不止新建标记
标记值的修饰
使用标记过滤器可以对标记值进行筛选编辑，确保您正确捕获标记值，从而简化引用仪表板标记的查询语句，更多内容请看标记过滤器。
同时，鸿鹄后续版本会提供更多类型的仪表板标记，还包括更丰富的过滤器修饰格式，敬请期待。