使用基于查询的参数

本文将引导你完成创建使用基于查询的参数的交互式仪表板的步骤。 文中假定你基本熟悉如何在 Azure Databricks 上生成仪表板。 有关创建仪表板的基础说明，请参阅入门。

要求

• 你已登录到 Azure Databricks 工作区。
• 你在该工作区中具有 SQL 权利。
• 你至少具有“可以使用”权限来访问一个或多个 SQL 仓库。

创建仪表板数据集

本教程使用 Azure Databricks 上的示例目录中生成的数据。

1. 单击边栏中的 “新建”，然后从菜单中选择“仪表板”。

2. 单击“数据”选项卡。

3. 单击“从 SQL 创建”,并将以下查询粘贴到编辑器中。 然后单击“运行”以返回结果。

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. 新定义的数据集使用名称“无标题数据集”自动保存。 双击标题，然后将其重命名为“营销细分”。

添加参数

可以将参数添加到此数据集以筛选返回的值。 此示例中的参数为 :segment。 请参阅使用仪表板参数，以详细了解参数语法。

1. 将以下 WHERE 子句粘贴到查询底部。 查询下方会显示一个参数名称为 segment 的文本字段。

   WHERE
     c_mktsegment = :segment
   

2. 在查询下方的文本字段中键入 BUILDING 以设置参数的默认值。

3. 重新运行查询以查看结果。

配置可视化效果小组件

通过完成以下步骤，在画布上为数据集添加可视化效果：

1. 单击“画布”选项卡。
2. 单击 “添加可视化效果”添加一个可视化小组件，并使用鼠标将其放在画布中。

设置 X 轴

1. 如有必要，从“可视化效果”下拉列表中选择“条形图”。
2. 单击 选择沿“X 轴”显示的数据。 可以使用搜索栏按名称搜索字段。 选择“c_nationkey”。
3. 单击所选的字段名称以查看其他配置选项。
   • 在“规模类型”处，选择“分类”。
   • 在“转换”选择处，选择“无”。

设置 Y 轴

1. 单击“Y 轴”旁边的 ，然后选择“c_acctbal”。
2. 单击所选的字段名称以查看其他配置选项。
   • 在“规模类型”处，选择“定量”。
   • 在“转换”选择处，选择“总和”。

配置可视化效果时，可视化效果将自动更新。 显示的数据仅包括 segment 为 BUILDING 的记录。

添加筛选器

设置筛选器，以便仪表板查看者可以控制要关注的营销细分。

1. 单击 “添加筛选器(字段/参数)”来添加筛选器小组件。 将它放在画布上。
2. 在配置面板中的“筛选器”下拉菜单中，选择“单个值”。
3. 选中“标题”复选框，在筛选器小组件上显示标题字段。
4. 单击小组件上的占位符标题，然后键入“细分”以重新设置筛选器。
5. 在配置面板中单击“参数”旁边的 。
6. 从“营销细分”数据集中选择“细分”。

配置的筛选器小组件将显示数据集的默认参数值。

定义值的选择

创建的筛选器是有效的，但它要求查看者在输入选择之前知道可用的选择范围。 它还要求用户在输入所需的参数值时匹配大小写和拼写。

若要创建下拉列表，以便查看者可以从可用选项列表中选择参数，请创建一个新数据集来定义可能值的列表。

1. 单击“数据”选项卡。

2. 单击“从 SQL 创建”以创建新数据集。

3. 复制以下代码并将其粘贴到编辑器中：

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. 运行查询并查看结果。 表中的五个营销细分将出现在结果中。

5. 双击自动生成的标题，然后将此数据集重命名为“细分选择”。

更新筛选器

更新现有筛选器，以使用刚刚创建的数据集来填充用户可以从中选择的值下拉列表。

1. 单击“画布”。 然后，单击在上一步中创建的筛选器小组件。
2. 单击“字段”旁边的 。
3. 单击“细分选项”，然后单击字段名称 c_mktsegment。

更改配置时，将更新筛选器小组件。 单击筛选器小组件中的字段可查看下拉菜单中的可用选项。

注意

本教程包含一个简化的用例，用于演示如何使用基于查询的参数。 创建此仪表板的另一种方法是将筛选器应用于 c_mktsegment 字段。

后续步骤

通过以下文章继续了解如何使用仪表板：

• 详细了解如何应用筛选器。 请参阅 “使用筛选器”。
• 详细了解仪表板参数。 请参阅使用仪表板参数。
• 发布和共享仪表板。 请参阅发布仪表板。