变量类型

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

• Map
• 查询
• CSV

Map

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

Map 变量最常见的用例是将简单、人类可读的键别名化为复杂的值。

Map 变量示例

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)  

选择变量值

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

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