ダッシュボード フィルターを使用する

フィルターは、ユーザーが特定の条件を満たすデータに集中できるように、ダッシュボードの視覚化に表示されるデータを制限します。 このページでは、使用可能なフィルターの種類とその使用方法について説明します。

インタラクティビティとスコープのフィルター

ダッシュボード作成者は、フィルターを対話型に構成できます。これにより、ビューアーは動的または静的に値を調整できます。ここで、ダッシュボード作成者はフィルター値を事前に定義します。 対話型フィルターを使用すると、ダッシュボード ビューアーは、関連する視覚化のデータセット値を選択できます。 ダッシュボード エディターでは、静的フィルター値が構成され、それらが構成されているウィジェットにのみ適用され、ウィジェット間で同じデータセットの一意のビューが有効になります。

ダッシュボード フィルターは、それぞれ固有の特性を持つさまざまなスコープで動作します。

• グローバル フィルター: 1 つ以上のデータセットを共有する視覚化のために、ダッシュボード内のすべてのページに適用される対話型フィルター。 ビューアーはこれらの値を動的に調整でき、変更はダッシュボード全体に影響します。 グローバル フィルターを参照してください。

• ページ レベルのフィルター: 1 つ以上のデータセットを共有する同じページ上のすべての視覚エフェクトに適用される対話型フィルター ウィジェット。 閲覧者はこれらの値を変更して、その特定のページのビューを変更できます。

• ウィジェット レベルのフィルター: 構成されている個々の視覚化ウィジェットにのみ適用される静的フィルター。 ダッシュボードの作成者は、ビューアーが変更できない値でフィルターを設定します。 これらのフィルターは、異なるウィジェット間で同じデータセットの一意のビューを作成します。

アクティブなフィルター バー

ダッシュボード上のすべてのアクティブなフィルターは、ダッシュボードの上部近くのアクティブなフィルター バーに表示されます。 このバーには、すべてのフィルター (グローバルまたはページ レベル) が [すべて] に設定されていないフィルターとクロスフィルター処理が表示されます。 アクティブなフィルター バーには、値がユーザーによって設定されているか、既定値から継承されたかに関係なく、すべてのグローバル フィルターとページ レベルのフィルターが値と共に表示されます。

アプリケーションの動作をフィルター処理する

既定では、ビューアーがドロップダウン メニューから値を選択すると、すぐにフィルターが適用されます。 ダッシュボード作成者は、ビューアーが [ 適用 ] ボタンをクリックした場合にのみ適用するようにフィルターを構成できます。これにより、閲覧者はダッシュボードを更新する前に複数のフィルター値を選択できます。 フィルター アプリケーションの動作を構成するには、「 フィルター アプリケーションの動作を構成する」を参照してください。

グローバル フィルター

すべてのグローバル フィルターを表示するには、[ をクリックします。ダッシュボードの左上隅にあるフィルター アイコン。 ダッシュボードの右側にパネルが開きます。

グローバル フィルターを作成するには:

1. [ をクリックします。ダッシュボード キャンバスの左上隅にあるフィルター アイコン。
2. +をクリックします。 キャンバスの右側にフィルター構成パネルが開きます。
3. 他の対話型フィルター ウィジェットと同様に、フィルター構成を設定します。 フィルター ウィジェットの設定例については、「ダッシュボード フィルターの 種類」を参照してください。

ウィジェットのフィルター処理

フィルター ウィジェットは対話型の要素であり、ビューアーはデータセットのフィールドとパラメーターのページ レベルのフィルター値を調整できます。

フィルター ウィジェットを作成するには:

1. [ フィルター ウィジェットを追加するフィルター (フィールド/パラメーター) を追加します。 次に、ダッシュボード キャンバスのページにフィルターを配置します。 フィルターが選択され、画面の右側に構成パネルが開きます。
2. ウィジェットの タイトル をオンにして、ウィジェットにタイトル フィールドを表示します。 ウィジェットのタイトルを編集します。
3. [説明] をオンにします。
4. 構成パネルの [フィルター ] ドロップダウン メニューで、[ 日付範囲の選択] を選択します。
5. [ をクリックします。[ フィールド] メニューの横にあるプラスアイコンをクリックします。 ドロップダウン メニューから [tpep_pickup_datetime ] をクリックします。

既定のフィルター値を設定する

既定値は、新しいフィルター値を選択せずにダッシュボードを更新するときに使用されます。 既定値を設定するには、フィルター ウィジェットの構成設定の [既定値 ] ドロップダウンから値を選択します。

フィルターはデータセット全体に適用されます。 小さなデータセットの場合、パフォーマンスを最適化するためにブラウザーでフィルターが適用されます。 データセットが大きい場合は、SQL ウェアハウスで実行されるクエリにフィルターが追加されます。 データセットの最適化とキャッシュ を参照してください。

フィールドでのフィルター処理

フィールド フィルターは、特定のデータセット フィールドによってデータを絞り込みます。 たとえば、フィールド フィルターでは、データセット内の日付フィールドに基づいて、データを特定の日付範囲に制限できます。 フィールド フィルターは 1 つ以上のデータセットに接続でき、選択に基づいて使用可能なフィルター値を動的に変更できます。 フィルターを複数のデータセットのフィールドに接続するには、複数の フィールド(データセットごとに最大 1 つ) を追加します。 フィルターは、選択したデータセットに基づいて構築されたすべての視覚化に適用されます。 1 つのフィルターの値を選択すると、他のフィルターのドロップダウン メニューに表示される使用可能な値が動的に変更されます。 次の図は、2 つのフィールドでフィルター処理するように設定されたフィルター構成パネルを示しています。

パラメーターでフィルターする

パラメーター フィルターは SQL クエリを直接変更し、動的なクエリ調整を提供します。 フィルターは、1 つ以上のパラメーターに接続できます。 フィルターを複数のパラメーターに接続するには、フィルター構成パネルに複数の パラメーター を追加します。 フィルター ウィジェットで設定された既定値は、クエリ エディターで設定された既定値をオーバーライドします。 フィルターがパラメーターに接続されている場合、データセットのサイズに関係なく、SQL ウェアハウスに対してクエリが実行されます。 「ダッシュボード パラメーターの操作」を参照してください。

パラメーター値は、次のいずれかのデータ型を受け入れるように設定できます。

• 文字列
• 数字
  • 整数
  • 10 進法
• 日付
• 日時
• 日付範囲
• 日付と時刻の範囲

フィールドまたはパラメーターをフィルター処理する必要がありますか?

比較的小さいデータセットの場合、多くの場合、Azure Databricks はクエリを再実行せずにブラウザーで適用するため、フィールド フィルターの方がパラメーターよりも効率的に実行されます。

パラメーターは実行時に値を置き換え、常に関連するクエリを再実行する必要があります。 ただし、パラメーターを使用すると、クエリの最適化の柔軟性が向上する可能性があります。 フィールド フィルターは、SQL を共通テーブル式 (CTE) でラップし、クエリの最後に適用します。これは、場合によっては効率が低下する可能性があります。

パラメーターを使用すると、クエリ内の任意の場所 (結合の後ではなく結合前など) にフィルター条件を配置できます。 この柔軟性により、データ構造とアクセス パターンに基づいてクエリのパフォーマンスを最適化できます。 たとえば、結合前にフィルター処理すると、結合操作中に処理されるデータが大幅に減少します。

次の表は、データセット フィールドでの直接フィルター処理と、パラメーターを使用したフィルター処理を比較したものです。

フィルターの種類

フィールド フィルターとパラメーター フィルターでは、さまざまなフィルターの種類がサポートされています。

• フィールド フィルター: 単一値、複数の値、日付ピッカー、日付範囲ピッカー、テキスト入力、範囲スライダー。
• パラメーター フィルター: 単一値、複数の値、日付の選択、日付範囲。

さまざまなフィルターの種類を構成する方法を示す例については、「ダッシュボードのフィルターの種類 を参照してください。

発行されたダッシュボード URL 内のフィルター

発行されたダッシュボードには、フィールド フィルターとパラメーターの選択が URL に格納されます。 これにより、ユーザーは特定のフィルター構成でダッシュボードをブックマークまたは共有できます。 ユーザーが URL を開くと、これらのフィルター値が既に適用された状態でダッシュボードが読み込まれます。

フィルター識別子は名前付き値として格納されません。 各フィルターは、ページ name 値とウィジェット name 値の組み合わせによって識別され、チルダ (~) で区切ります。 これらの値は、既定で自動的に生成されます。 フィルター識別子と値は、指定されたフィルター選択を使用してダッシュボードを読み込む URL の一部として渡されます。

次の例は、選択したフィルター値を持つダッシュボード 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

次の使用例は、 時間範囲、 ピックアップ Zip、 ドロップオフ Zip の 3 つのフィルターを含むダッシュボードを参照します。 Pickup Zip フィルターにのみ値が割り当てられます。 URL では、識別子10013を使用してf_53eadf26~3490f286するように設定されています。

この例で使用されているダッシュボードと同様のダッシュボードを作成するには、「 ダッシュボードを作成する」を参照してください。

URL で相対日付範囲の値を指定する

過去 5 分や過去 12 時間などの相対時間フィルターを使用すると、対応する値が URL に表示されます。

次の例は、[ 過去 12 時間 ] が選択された URL を示しています。

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=now-12h

この場合、フィルター識別子 f_53eadf26~3490f286 は、 now-12hの相対値に設定されます。

静的ウィジェット フィルター

静的ウィジェット レベルのフィルターでは、ダッシュボード作成者によって設定されたデータセットのビューが表示されます。 これらは、それらが構成されているウィジェットにのみ適用され、異なるウィジェットで同じデータセットの一意のビューが有効になります。 グローバル およびページ レベルのフィルターとは異なり、静的ウィジェット フィルターは、それらが構成されている視覚化ウィジェットにのみ適用されます。 これらのフィルター値は、ダッシュボード ビューアーでは変更できません。

ユース ケースの例

地域のパフォーマンスを分析する販売ダッシュボードを作成しているとします。 データセットは、すべてのリージョンの売上データと共に使用します。 静的ウィジェット フィルターを適用することで、リージョン A の売上を表示するように 1 つのウィジェットを構成し、リージョン B の売上を表示する別のウィジェットを構成できます。このアプローチでは、両方のウィジェットが同じデータセットから描画される場合でも、視聴者はリージョンのパフォーマンスを並べて比較できます。 静的ウィジェット フィルターは固定されているため、閲覧者はフィルターを変更できないため、ダッシュボードには常にデータの一貫性のあるビューが表示されます。

ウィジェット レベルのフィルターでサポートされているフィルターの種類

ウィジェット レベルのフィルターでは、次のフィルターの種類がサポートされています。

• 1 つの値: フィールドから特定の値をフィルター処理する
• 複数の値: フィールドから 1 つ以上の値をフィルター処理する
• 日付ピッカー: 特定の日付でフィルター処理する
• 日付範囲ピッカー: 相対日付範囲 (過去 7 日間、先月など) を含む日付範囲でフィルター処理します。
• 範囲スライダー: 数値範囲でフィルター処理する
• テキスト 入力: テキストの一致に基づいてフィルター処理する

各フィルターの種類の構成例については、「 ダッシュボード フィルターの種類」を参照してください。

静的ウィジェット レベルのフィルターを追加する

静的ウィジェット レベルのフィルターを視覚エフェクトに追加するには:

1. 下書きダッシュボード キャンバスに視覚化ウィジェットを追加します。

2. 新しいウィジェットが選択されたら、構成パネルの [データセット] ドロップダウンからデータセットを選択します。

3. [フィルターの表示] をクリックします。 フィルター フィールド オプションがデータセット タイトルの下に表示されます。 パラメーターを含むデータセットの場合は、Parameters セクションも表示されます。

   

フィールド フィルターを追加するには、次の操作を行います。

1. 見出しの フィルター フィールドの右側にあるプラス記号 クリックし、ドロップダウン メニューからフィールドを選択します。
2. 既定では、フィルター値は「すべて」に設定されます。 ドロップダウン メニューを使用して、新しい値を選択します。 ドロップダウン メニューから移動して、新しいフィルターが適用された視覚化を表示します。
3. ダッシュボードを確認します。

静的ウィジェット レベルのパラメーターの設定については、「静的ウィジェット パラメーター を参照してください。