使用和管理变量

仪表板变量允许您更改单元格查询的特定组件，而无需编辑查询，使您可以轻松与仪表板单元格交互并探索您的数据。

变量的作用域由组织决定。

使用仪表板变量

预定义的预定义仪表板变量和自定义仪表板变量都存储在与每个仪表板相关联的v记录中。使用点符号引用每个变量（例如v.variableName）。

from(bucket: v.bucket)
    |> range(start: v.timeRangeStart, stop: v.timeRangeStop)
    |> filter(fn: (r) => r._measurement == v.measurement and r._field == v.field)
    |> aggregateWindow(every: v.windowPeriod, fn: mean)

在为仪表板单元构建Flux查询时，可以在变量选项卡中查看可用的仪表板变量，位于函数选项卡旁边。

单击一个变量名将其添加到您的查询中，并从值下拉菜单中选择一个值。

链接到URL中定义变量的仪表板

当您将变量应用到仪表板时，&vars[variable_name]=value 会附加到URL上，以便您可以分享包含变量的链接。

预定义仪表板变量

InfluxDB 用户界面 (UI) 提供以下预定义的仪表板变量：

v.timeRangeStart

指定查询时间范围的开始。 这个变量通常用来定义start 参数 的 range() 函数。

时间范围 选择器定义了该变量的值。

v.timeRangeStop

指定查询时间范围的结束。 该变量通常用于定义stop参数 的range()函数。

时间范围选择器定义了这个变量的值。 默认值为 now。

v.windowPeriod

指定窗口数据的时间段。 这个变量通常用于定义window()函数中数据聚合操作的every或period参数。

这个变量的值是通过分析它所使用的Flux查询的持续时间来计算的。从较长时间范围获取数据的查询将具有更长的 v.windowPeriod 持续时间。

自定义仪表板变量

在InfluxDB用户界面（UI）中创建、管理和使用自定义仪表板变量。