日付フィルターの作成 create-date-filter

最終更新日： 2025年10月14日

トピック：
Dashboards

作成対象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

インサイトを日付でフィルタリングするには、日付制約を受け入れることができるパラメーターをSQL クエリに追加する必要があります。これは、クエリプロモードのinsight作成ワークフローの一部として行われます。インサイトにSQLを入力する方法については、クエリプロモードのドキュメントを参照してください。

クエリパラメーターを使用すると、実行時に追加する値のプレースホルダーとして機能する動的データを操作できます。これらのプレースホルダー値はUIで更新でき、技術的な知識のないユーザーでも日付範囲に基づいてインサイトを更新できます。

クエリパラメーターについて詳しくない場合は、パラメーター化されたクエリの実装方法に関するガイダンスのドキュメントを参照してください。

ダッシュボードへの日付フィルターの適用 apply-date-filter

日付フィルターを適用するには、ダッシュボードビューのドロップダウンメニューから「フィルターを追加」、「日付フィルター」を選択します。

フィルターとそのドロップダウンメニューがハイライト表示されたカスタムダッシュボード。

次の日付フィルタリングオプションが表示されます。

フィルター

説明

カスタム日付なし

複数のプリセット値から1つ以上のカスタム日付を選択します。

カスタム日付範囲

複数のプリセット値から1つ以上のカスタム日付を選択するか、カスタム日付範囲を指定します。

カスタム日付

プリット値から選択するか、ダッシュボードの開始日を指定します。

3つのカスタム日付ピッカーオプションがハイライト表示された日付フィルターを作成ダイアログ。

カスタム日付フィルターを作成しない

定義済みの日付フィルターを適用するには、カスタム日付なしを選択し、含める定義済みの日付オプションを選択します。最後に、ドロップダウンを使用してデフォルトの日付範囲を選択し、保存を選択します。

カスタム日付フィルターと保存がハイライト表示されていない日付フィルターを作成ダイアログ。

ダッシュボードに戻り、以前に選択したデフォルトの日付範囲が表示されます。ドロップダウンメニューを使用して、別のプリセット日付範囲を選択します。

ドロップダウンが強調表示されたデフォルトの日付範囲を表示するカスタムダッシュボード。

カスタム日付範囲フィルターの作成

カスタム日付範囲フィルターを適用するには、カスタム日付範囲を選択し、含める定義済みの日付オプションを選択します。最後に、カスタムを選択して、デフォルトの日付範囲を設定します。カレンダーを使用して日付範囲を指定し、保存を選択します。

NOTE

定義済みの日付オプションを選択する必要はありません。

カスタム日付範囲フィルター、カスタムおよび保存がハイライト表示された日付フィルターを作成ダイアログ。

ダッシュボードに戻され、以前に指定したカスタムデータ範囲が表示されます。ドロップダウンメニューを使用して、別のプリセット日付範囲を選択します。

カスタム日付がハイライト表示されたデフォルトの日付範囲を表示するカスタムダッシュボード。

カスタム日付フィルターの作成

カスタム日付フィルターを適用するには、カスタム日付を選択し、含める定義済みの日付オプションを選択します。最後に、カスタムを選択し、カレンダーを使用して開始日を選択します。最後に、保存を選択します。

NOTE

定義済みの日付オプションを選択する必要はありません。

カスタム日付フィルター、カスタムおよび保存がハイライト表示された日付フィルターを作成ダイアログ。

ダッシュボードに戻され、以前に指定したカスタムデータが表示されます。ドロップダウンメニューを使用して、別の日付を選択します。

カスタム日付がハイライト表示されたデフォルトの日付範囲を表示するカスタムダッシュボード。

日付フィルターの削除 delete-date-filter

日付フィルターを削除するには、削除フィルターアイコン（）を選択します。

フィルター削除アイコンがハイライト表示されたカスタムダッシュボード。

日付クエリパラメーターを含めるようにSQLを編集します include-date-parameters

次に、日付範囲を許可するために、SQLにクエリパラメーターが含まれていることを確認します。 SQLにクエリパラメーターをまだ組み込んでいない場合は、これらのパラメーターを含めるようにインサイトを編集します。 Insightを編集する方法については、ドキュメントを参照してください。

TIP

日付フィルターを有効にする各グラフのSQL ステートメントに$START_DATEおよび$END_DATE個のパラメーターを追加することをお勧めします。

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

クエリプロモードでステートメントを作成する場合は、SQL ステートメントを実行してグラフを構築するために、各パラメーターにサンプル値を指定する必要があります。ステートメントの作成時に指定したサンプル値は、実行時に日付（またはグローバル）フィルターに選択した実際の値に置き換えられます。

SQLで日付パラメーターがハイライト表示されたSQLを入力ダイアログ。

各insightで日付パラメーターを有効にする enable-date-parameters

インサイトのSQLに適切なパラメーターを組み込むと、Start_date変数とEnd_date変数がウィジェットコンポーザーの切り替えスイッチとして使用できるようになります。 Insightの編集方法について詳しくは、query pro mode widget population セクションを参照してください。

ウィジェットコンポーザーから、「Start_date」と「End_date」のパラメーターを有効にする切り替えスイッチを選択します。

開始日と終了日の切り替えがハイライト表示されたウィジェットコンポーザー。