仪表板筛选器允许查看者专注于可视化效果中的特定数据。 你可以将筛选器设计为交互式筛选器，使查看者能够动态调整值或静态值，其中仪表板作者预定义了值。
交互式和静态控件级别筛选器
筛选器可以是交互式的，也可以是静态的，每个筛选器都提供不同的用途：
- 交互式筛选器： 允许查看者动态调整值，将所选筛选器应用于共享同一数据集的同一页上的所有可视化效果。
- 静态筛选器：按仪表板作者显示数据集的预定义视图。。 它们仅适用于配置它们的小组件，从而在小组件之间实现同一数据集的唯一视图。 请参阅静态小组件筛选器。
过滤器控件
筛选器小组件是仪表板画布上的交互式元素，用于将筛选器应用于数据集字段或参数值。
注释
基于查询的参数在单个小组件中结合了字段筛选器和参数筛选器。 有关详细信息，请参阅 基于查询的参数。
设置默认筛选器值
当刷新仪表板而不选择新的筛选值时，使用默认值。 要设置默认值，请从筛选器小组件的配置设置的“默认值”下拉列表中选择一个值。
筛选器应用于整个数据集。 对于小型数据集，筛选器在浏览器中应用以优化性能。 如果数据集较大，则会将筛选器添加到在 SQL 仓库中运行的查询。 请参阅数据集优化和缓存。
按字段筛选
字段筛选器按特定数据集字段缩小数据范围。 例如，字段筛选器可能会根据数据集中的日期字段将数据限制为特定的日期范围。 字段筛选器可以连接到一个或多个数据集，从而根据所选内容对可用筛选值进行动态更改。 若要将筛选器连接到多个数据集中的字段，请添加多个字段，每个数据集最多添加一个字段。 此筛选器适用于基于所选数据集构建的所有可视化效果。 为一个筛选器选择值会动态更改其他筛选器下拉菜单中显示的可用值。 下图显示了设置为对两个字段进行筛选的筛选器配置面板。
按参数筛选
参数筛选器直接修改 SQL 查询，提供动态查询调整。 筛选器可以连接到一个或多个参数。 若要将筛选器连接到多个参数，请在筛选器配置面板中添加多个参数。 筛选器小组件中设置的默认值将覆盖查询编辑器中设置的默认值。 如果筛选器连接到参数，则无论数据集大小如何，它都会针对 SQL 仓库运行查询。 请参阅使用仪表板参数。
可以将参数值设置为接受以下数据类型之一：
- 字符串
- 数字
- 整数
- 十进制
- 日期
- 日期和时间
- 日期范围
- 日期和时间范围
是否应筛选字段或参数？
下表将直接对数据集字段进行筛选与使用参数进行筛选进行比较。
| 筛选类型 | 说明 | 性能 | 多功能性 |
|---|---|---|---|
| 对字段进行筛选 | 直接应用于数据集字段，而无需修改数据集。 | 通常更快。 可以在浏览器中筛选小型数据集。 通过重新运行查询并应用筛选条件来筛选大型数据集。 请参阅数据集优化和缓存。 | 仅限于筛选解析的数据集结果。 不能在子查询或自定义条件逻辑中使用。 |
| 对参数进行筛选 | 在运行时将值直接插入到数据集查询中。 | 每当参数值发生更改时，都需要重新运行查询。 | 可用于子查询、条件逻辑或修改查询结构。 |
筛选器类型
字段和参数筛选器支持各种筛选器类型：
- 字段筛选器： 单个值、多个值、日期选取器、日期范围选取器、文本输入、范围滑块。
- 参数筛选器： 单个值、多个值、日期选取器、日期范围。
有关如何配置不同筛选器类型的示例，请参阅 仪表板筛选器类型。
已发布仪表板 URL 中的筛选器
已发布的仪表板将字段筛选器和参数选择存储在 URL 中。 这样，用户就可以使用特定筛选器配置为仪表板添加书签或共享。 当用户打开 URL 时，仪表板会加载已应用这些筛选器值。
筛选器标识符不存储为命名值。 每个筛选器由页面 name 值和小组件 name 值的组合标识，用波形符（~）分隔。 这些值默认自动生成。 筛选器标识符和值作为 URL 的一部分被传递，以使用指定的筛选器加载仪表板。
注释
密钥 name 显示在定义仪表板的序列化文件中，并且无法从 Azure Databricks UI 访问。 它与 "displayName" 值分开，该值定义 UI 中显示的页面名称。 请参阅 “编辑仪表板”文件。
以下示例显示了具有所选筛选器值的仪表板 URL 的结构：
<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_<page-name>~<widget-name>=<filter-value>
- URL 的第一部分标识已公布的仪表板。 请参阅仪表板 URL 和 ID。
- 标识筛选器的部分以
f_开头，然后是page-name和widget-name，由波浪号（~）分隔。 - 等号（
=）右侧的值是所选的筛选器值。
创建仪表板时，page-name值和widget-name值自动生成。 可以在序列化 lvdash.json 文件中编辑这些名称。 名称在导入、导出和重新发布等操作中保留。 请参阅 “编辑仪表板”文件。
在 URL 中访问和设置筛选器值
以下示例显示了包含所选筛选器值的已发布仪表板的 URL：
<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=10013
此示例引用的仪表板包含三个筛选器：时间范围、取件邮编和投递邮编。 仅为“取件邮编”筛选器分配了值。 在 URL 中，它已设置为 10013 使用标识符 f_53eadf26~3490f286。
若要创建类似于此示例中使用的仪表板，请参阅 “创建仪表板”。
在 URL 中指定相对日期范围值
如果使用相对时间筛选器（例如 过去 5 分钟 或 过去 12 小时），则相应的值将显示在 URL 中。
以下示例显示了一个 URL，其中选择了 “过去 12 小时 ”。
<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=now-12h
在这种情况下，筛选器标识符 f_53eadf26~3490f286 设置为相对值 now-12h。
静态控件筛选器
静态小组件筛选器可用于在画布上显示相同数据集的不同视图。 与仪表板筛选器不同，静态组件筛选器仅适用于可视化组件中配置的组件。 这些筛选器是静态的，无法被仪表板查看者更改。
示例用例
假设你要创建一个分析区域绩效的销售仪表板。 你使用包含所有区域销售数据的数据集。 通过应用静态小组件筛选器，可以配置一个小组件以显示区域 A 的销售，配置另一个小组件以显示区域 B 的销售。此方法使查看者能够并排比较区域绩效（即使这两个小组件都从同一数据集中提取）。 由于静态小组件筛选器是固定的，因此查看者无法修改筛选器，从而确保仪表板始终呈现一致的数据视图。
添加静态组件筛选器
向可视化效果添加静态小组件筛选器：
向草稿仪表板画布添加可视化小组件。
选择新的小组件后，从配置面板中的“数据集”下拉列表中选择一个数据集。
单击“显示筛选器”。 筛选器字段选项显示在数据集标题下。 对于包含参数的数据集，还会显示一个“参数”部分。
要添加字段筛选器，请执行以下操作：
单击“筛选器字段”标题右侧的加号，然后从下拉菜单中选择一个字段。
默认情况下，该筛选值设置为“全部”。 使用下拉菜单选择一个新值。 导航离开下拉菜单以显示应用了新筛选器的可视化效果。
查看仪表板。
若要了解如何设置静态小组件级参数，请参阅 静态小组件参数。