变量类型

变量类型决定了变量可能值的列表是如何填充的。
以下是可用的变量类型：

• 地图
• 查询
• CSV

映射

映射变量使用CSV格式的键值对列表将键映射到特定值。键在InfluxDB用户界面（UI）中填充变量的值列表，但在实际处理查询时使用值。

映射变量最常见的用例是将简单的、易读的键别名为复杂的值。

映射变量示例

Juanito MacNeil,"5TKl6l8i4idg15Fxxe4P"
Astrophel Chaudhary,"bDhZbuVj5RV94NcFXZPm"
Ochieng Benes,"YIhg6SoMKRUH8FMlHs3V"
Mila Emile,"o61AhpOGr5aO3cYVArC0"

查询

查询变量值通过Flux查询的 _value 列填充。

查询变量示例

// List all buckets
buckets()
    |> rename(columns: {"name": "_value"})
    |> keep(columns: ["_value"])

有关仪表板变量查询的示例，请参阅 常见变量查询。

CSV

CSV变量使用CSV格式的列表来填充变量值。一个常见的用例是当潜在值的列表是静态的，不能从InfluxDB查询时。

CSV变量示例

value1, value2, value3, value4

value1
value2
value3
value4

使用自定义仪表板变量

使用 Flux v 记录和 点或括号表示法 来访问自定义仪表板变量。

例如，要在查询中使用名为 exampleVar 的自定义仪表板变量，引用该变量使用 v.exampleVar:

from(bucket: "telegraf")
    |> range(start: v.timeRangeStart, stop: v.timeRangeStop)
    |> filter(fn: (r) => r._measurement == "cpu" )
    |> filter(fn: (r) => r._field == "usage_user" )
    |> filter(fn: (r) => r.cpu == v.exampleVar)  

选择变量值：

• 在仪表板中： 使用仪表板变量下拉菜单位于仪表板的顶部。
• 在脚本编辑器中： 点击脚本编辑器右侧的变量选项卡，点击变量的名称，然后从下拉菜单中选择变量值。

有关仪表板变量的更多信息，请参见 使用和管理变量。