视图变量¶
视图变量在动态可视化数据分析中发挥着关键作用,它允许用户通过更改一个或多个视图变量的值,实时更新可视化结果,从而根据自身需求动态筛选和分析数据。
开始添加¶
- 变量名:当前视图变量集合所属的变量名称,在仪表板中添加图表时,需要在图表查询中引用,格式为:
#{变量名}
; - 显示名:当前视图变量集合在仪表板中显示的名称,例如:变量名为
host
,显示名为主机名
; -
查询:定义视图变量的查询逻辑
- 排序:针对查询返回的视图变量进行默认、升降、排序排列。
-
显示选项
-
是否隐藏:开启后,在非编辑模式下,该变量在仪表板内不可见。
-
包含 * 选项:默认开启。
-
是否多值:允许同时选择多个值。
-
-
默认值:当前视图变量在仪表板中的初始值。下拉框会根据您在“显示选项”中的配置列出变量,可选择仪表板默认显示的初始值。若默认值为空,则仪表板显示最新的字段数据。
-
*:忽略此字段筛选。图表查询中将不会包含该变量的过滤条件;
-
All values:将视图变量查询语句得到的结果值当作变量传参;
-
自定义:直接在选择栏输入值后回车创建。您可以在选择栏搜索查找您的目标变量。
-
点击选中,即可选中当前列表的所有值。
如何理解 All values
将变量查询语句的实时结果作为筛选值。图表查询中会自动添加 字段 IN [值1, 值2, ...]
的过滤条件,筛选值会随查询结果动态变化。为了避免数据过多引发性能问题,建议 all values
的值不超过 50 个。
适用场景:当需要图表随变量查询动态精准筛选时使用。例如,选择 project
变量后,host
变量会自动获取该项目的主机列表,启用 all values
后,图表仅显示这些主机的数据(如 host IN [A, B, C]
)。
注意
当工作空间数据中断时,可在视图变量中预设字段;数据恢复后,系统会自动匹配。
管理变量¶
可通过以下操作对视图变量进行处理:
- 可直接克隆、再次编辑或删除变量;
- 若在配置视图变量时选择隐藏某一变量,则该变量会在列表右侧显示 隐藏按钮。