文章目录
- 参数传递的基本方法
- 参数类型的设定
- Test类型
- number类型
- Dropdown Lists类型
- Query Based Dropdown List类型
- list的多值类型
- Data类型
- 参数的个数设定
- 两个相同类型的参数
- 两个不同类型的参数
- 参数在dashbord上的映射
参数传递的基本方法
使用参数,您可以在运行时将值替换到查询中,而不必编辑源代码。双大括号{{}}之间的任何字符串都将被视为参数。结果窗格上方将出现一个小部件,以便您更改参数值。
在编辑模式下,您可以单击每个参数小部件的齿轮图标来调整其设置。当您单击“仅显示数据”时,齿轮图标将消失,以便不拥有查询的用户无法更改参数行为。
参数类型的设定
设置时点上面的一个小齿轮就出来了,主要是设置类型
Test类型
此类型有一个需要注意的点:
(官方)
我可以在嵌入式可视化和共享仪表板中使用参数吗?
是的,只有一个例外。如果查询使用文本类型参数,则无法将其嵌入,因为文本参数在SQL注入中不安全。所有其他类型的查询参数都可以安全地用于嵌入式可视化和仪表板.embeddes共享仪表盘。
设置后点应用就可以了
number类型
设置之后
我这里截图截不出来方框右边的两个上下的按钮,可以调节数字大小的
Dropdown Lists类型
左边的数据源Q1是二次查询的数据源的意思,根据sql语句进行二次查询,id作为参数
后面的效果就是这样
Query Based Dropdown List类型
这个需要关联另一张表的主码,在第三行的输入框,他会自动下拉出可以关联的表,选择一个
最后成这样
list的多值类型
在上一个类型下面有一个单选框,选择就和出现单引号和双引号的选择,这里要特别注意参数格式,以防语法错误,上面的id属性就去掉了之前的单引号,在再下拉框选择单引号类型才可以最后效果
Data类型
data类型有很多这里主要讲 data range
其余的差不多
语法这么写
效果是这样
选择两个节点日期,就可以查询了
参数的个数设定
两个相同类型的参数
就这样差不多没什么变化,就多加了一个参数,下面也只会出现一个小方框给你输入参数的值
两个不同类型的参数
两个不同的参数,只需要注意参数名字要不同,还有出现了两个输入框输入参数值
参数在dashbord上的映射
这里上面进入一个dashbord只需要编辑状态下在添加widget时候,点击红色圈起来的笔的icon
出现一个小弹窗
有四个选项他们的意思分别是
- New dashboard parameter:仪表板参数允许您在仪表板的一个位置设置参数值,并将其映射到多个可视化效果。使用此选项可创建新的仪表板级别参数。
- Existing dashboard parameter:如果您已经设置了一个特定于仪表板的参数,请使用该参数设置仪表板。您需要指定将映射哪个预先存在的仪表板参数。
- Widget parameter: 此选项将在仪表板小部件中显示一个值选择器。这对于小部件之间不共享的一次性参数非常有用
- Static value:选择此选项将允许您为这个小部件选择一个静态值,而不管其他小部件上使用的值是什么。静态映射的参数值不会在仪表板上更紧凑的任何位置显示值选择器。这使您能够充分利用查询参数的灵活性,而不会在某些参数预计不会频繁更改时扰乱仪表板上的用户界面。