创建日期过滤器 create-date-filter

Last update: Tue Oct 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
功能板

创建对象：

开发人员
用户

要按日期筛选见解，必须将参数添加到可以接受日期约束的SQL查询。此操作作为查询专家模式见解创建工作流的一部分完成。请参阅查询专业模式文档以了解如何输入SQL作为您的见解。

利用查询参数，可处理动态数据，因为它们充当您在执行时添加值的占位符。这些占位符值可以通过UI更新，并使技术含量较低的用户能够根据日期范围更新见解。

如果您不熟悉查询参数，请参阅文档有关如何实现参数化查询的指导。

将日期过滤器应用于仪表板 apply-date-filter

要应用日期筛选器，请从仪表板视图的下拉菜单中选择添加筛选器，然后选择日期筛选器。

自定义仪表板的“添加筛选器”及其下拉菜单突出显示。

您会看到以下日期筛选选项。

筛选条件

描述

没有自定义日期

从多个预设值中选择一个或多个自定义日期。

自定义日期范围

从多个预设值中选择一个或多个自定义日期，或指定自定义日期范围。

自定义日期

从预设值中选择或指定仪表板的开始日期。

创建日期筛选器对话框，其中突出显示了三个自定义日期选取器选项。

创建无自定义日期过滤器

要应用预定义的日期过滤器，请选择无自定义日期，然后选择要包括的预定义日期选项。最后，使用下拉菜单选择默认日期范围，然后选择保存。

创建日期筛选器对话框未使用自定义日期筛选器并突出显示。

您将返回到仪表板，其中显示您之前选择的默认日期范围。使用下拉菜单选择其他预设日期范围。

显示默认日期范围（下拉列表突出显示）的自定义仪表板。

创建自定义日期范围过滤器

要应用自定义日期范围筛选器，请选择自定义日期范围，然后选择要包括的预定义日期选项。最后，选择 自定义 以设置默认日期范围。使用日历指定日期范围，然后选择保存。

NOTE

无需选择预定义的日期选项。

创建日期筛选器对话框，其中自定义日期范围筛选器、自定义和保存突出显示。

您将返回到仪表板，其中显示您之前指定的自定义数据范围。使用下拉菜单选择其他预设日期范围。

自定义仪表板显示自定义日期突出显示的默认日期范围。

创建自定义日期过滤器

要应用自定义日期筛选器，请选择自定义日期，然后选择要包括的预定义日期选项。最后，选择自定义，然后使用该日历选择开始日期。最后，选择保存。

NOTE

无需选择预定义的日期选项。

创建日期筛选器对话框，其中自定义日期筛选器、自定义日期筛选器和保存筛选器突出显示。

您将返回到仪表板，其中显示您之前指定的自定义数据。使用下拉菜单选择其他日期。

自定义仪表板显示自定义日期突出显示的默认日期范围。

删除日期过滤器 delete-date-filter

要删除您的日期筛选器，请选择删除筛选器图标（）。

突出显示筛选器删除图标的自定义仪表板。

编辑SQL以包含日期查询参数 include-date-parameters

接下来，请确保SQL包含查询参数，以便允许某个日期范围。如果您尚未在SQL中合并查询参数，请编辑您的分析以包含这些参数。有关如何编辑分析的说明，请参阅文档。

TIP

建议您在每个要启用日期过滤器的图表中，将$START_DATE和$END_DATE参数添加到SQL语句中。

NOTE

日期筛选器不支持时间限制。该过滤器仅适用于日期范围。这意味着，如果您在24小时内拥有多个报表，则无法区分同一天内不同的小时。因此，建议您将时间组件强制转换为日期。

如果您正在分析的数据模型或表具有时间组件，则您可以按日期对数据进行分组，然后应用这些日期过滤器。

下面的示例SQL语句演示如何合并$START_DATE和$END_DATE参数并使用cast将时间组件框架化为日期。

SELECT Sum(personalization_consent_count) AS Personalization,
       Sum(datacollection_consent_count)  AS Datacollection,
       Sum(datasharing_consent_count)     AS Datasharing
FROM   fact_daily_consent_aggregates f
       INNER JOIN dim_consent_valued
               ON f.consent_value_id = d.consent_value_id
WHERE  f.date BETWEEN Upper(Coalesce(Cast('$START_DATE' AS date), '')) AND Upper
                      (
                             Coalesce(Cast('$END_DATE' AS date), ''))
       AND ( ( Upper(Coalesce($consent_value_filter, '')) IN ( '', 'NULL' ) )
              OR ( f.consent_value_id IN ( $consent_value_filter ) ) )
LIMIT  0;

下面的屏幕截图突出显示合并到SQL语句和查询参数键值对中的日期约束。

NOTE

在query pro模式下编写语句时，必须为每个参数提供示例值，以便执行SQL语句并构建图表。合成语句时提供的示例值由您在运行时为日期（或全局）筛选器选择的实际值替换。

带有SQL中突出显示的日期参数的进入SQL对话框。