练习：创建仪表板参数

已完成

在本单元中，需要创建用于筛选仪表板可视化效果的参数。

创建参数

首先，需要从查看模式切换到编辑模式。

1. 选择“查看”，然后将模式切换为“编辑”。

   

2. 在顶部菜单栏中，选择“[@] 参数”。 “参数”窗格随即打开。

3. 选择“+ 新建参数”

4. 在“添加参数”窗格中填写参数选项，如下所示：

   

   字段	描述	建议的值
   Label	仪表板或编辑卡上显示的参数名称。	状态
   参数类型	单选：只能在筛选器中选择一个值作为参数的输入。 多选：可在筛选器中选择一个或多个值作为参数的输入。 时间范围：基于时间筛选查询和仪表板。 自定义文本：用户可以键入值或将值复制/粘贴到文本字段。	多重选择
   变量名称	要在查询中使用的参数名称。	_state
   Data type	参数值的数据类型。	字符串
   在页面上显示	选择要在其中显示此参数的页面。	全选
   Source	固定值：手动引入的静态筛选器值。 查询：使用 KQL 查询动态引入的值。	查询
   数据源	基于查询的参数的源。 请参阅编辑查询。

编辑参数源查询

需要为此参数创建可能值列表。 要创建的参数称为 State。 你希望使用它根据发生事件的州来筛选结果。 可以手动输入所有可能的州的列表，但是，使用查询动态返回此列表会更简单。

1. 在“数据源”中，选择“示例”数据库。

2. 在“查询结果”字段中，选择“编辑查询”。

3. 将以下查询复制/粘贴到编辑器中：

   StormEvents
   | distinct (State)
   

4. 选择运行。 此查询会返回列“州”列中所有不同值的列表。

   

5. 选择“添加”以返回到“添加参数”对话框。

6. 选择“默认值”下拉列表并选择其中一个州（例如 Minnesota）。

   

7. 选择“完成” 。

编辑这两个磁贴查询以包含参数

现在已创建了参数，但仪表板看起来还是一样。 需要在查询中使用生成视觉对象的参数。

按日期划分的事件

1. 在“按日期划分的事件”磁贴中，选择铅笔图标。

   

2. 使用参数选项中定义的变量名称作为查询中的筛选条件。 在此例中，变量名称为 state。 编辑查询以包含以下行：

   | where State has_any (_state)
   

   查询应如下图所示：

   

3. 选择“应用更改”。

Event count by state

1. 在“按州划分的事件计数”磁贴中，选择铅笔图标。

2. 编辑查询以包含以下行：

   | where State has_any (_state)
   

   查询应如下图所示：

   

3. 选择“应用更改”。

使用参数

选择 State 参数，然后在下拉菜单中选择其中一个选项，例如 TEXAS。 请确保取消选中默认值，以便仅选择一个州。 请注意可视化效果如何更改为仅显示与所选州相关联的数据。