メインコンテンツまでスキップ

クエリ フィルター

クエリ フィルターを使用すると、ビジュアリゼーションに表示されるデータ量を対話形式で減らすことができます。 クエリ フィルターはクエリ パラメーターと似ていますが、いくつかの重要な違いがあります。 クエリ フィルターは、クエリの実行 後に データを制限します。 これにより、フィルターは、クエリの実行に時間がかかる、レートが制限される、またはコストがかかる小規模なデータセットや環境に最適です。

次に、Databricks SQL の利点について説明します。

  • 以前のクエリ フィルターはクライアント側でのみ動作していましたが、更新されたフィルターはクライアント側またはサーバー側で動的に動作し、パフォーマンスを最適化します。
  • 簡素化されたUIエクスペリエンス: [+フィルターを追加 ]ボタンをクリックし、ドロップダウンから列を選択してフィルターを追加します。 列の個別の値をフィルター処理するために、個別のクエリを作成、許可、更新する必要はありません。
  • 「関連する値を強調表示する」を有効にして、他のフィルターを選択した場合にフィルター内のどの選択が結果を返すかを確認します。 たとえば、「都道府県」と「市区町村」の両方のフィルターを持っているユーザーを考えてみましょう。 ユーザーが関連する値を強調表示することを選択した場合、州のフィルターで「カリフォルニア」を選択すると、「都市」フィルターでカリフォルニア州の都市のみが強調表示されます。 強調表示されていないオプションは、ドロップダウンの [除外] メニュー オプションの下に配置されます。
  • テキスト入力フィルター: テキスト入力検索に基づいて列の結果をフィルターします。 検索で一致を見つけることができるモードには、完全一致、次を含む、および開始の 3 つがあります。
  • クイック日付セレクターを使用すると、先週、先月、昨年など、事前定義された日付範囲でフィルタリングできます。
  • 日付フィルターを作成するときに、デフォルトの日付範囲を設定できます。
  • ダッシュボードでクエリ フィルターを使用することもできます。 デフォルトでは、フィルター ウィジェットは、フィルターがクエリに追加された各ビジュアリゼーションの横に表示されます。 フィルター ウィジェットをダッシュボード レベルのクエリ フィルターにリンクするには、「 ダッシュボード フィルター」を参照してください。

機能の説明

クエリを実行した後、[ 結果 ] パネルで [ + ] をクリックし、[ フィルター] を選択します。

+フィルターを追加ボタンはポップアップメニューを開き 、次のフィルターと設定を適用できます。

  • 列: フィルターを適用する列。

    • 現在、文字列、数値、日付がサポートされています。
    • 選択した列に日付が含まれている場合、ユーザーは日付、月、または年で時間ビン分割を指定することを選択できます。
  • タイプ: 適用するフィルターのタイプ

    • Single Select: 1 つのフィールド値のみにフィルターします。
    • Multi Select: 複数のフィールド値にフィルターします
    • テキスト入力:文字列を入力して、特定の列で一致する値を検索します。 "contains"、"exact match"、"starts with" をサポート
    • 日付/時刻ピッカーとレンジャーピッカー:日付または日付範囲を選択して、日付データ型でフィルタリングする機能
  • 並べ替え順序: フィルター ドロップダウンで値が並べ替えられる順序。 「昇順」または「降順」から選択できます。

  • 関連する値を強調表示 (y/n): これを有効にすると、フィルター内のどの選択が他のフィルター選択に対して結果を返すかを簡単に確認できます。 たとえば、「都道府県」と「市区町村」の両方のフィルタを持つユーザーについて考えてみます。 ユーザーが関連する値を強調表示することを選択した場合、州のフィルターで [カリフォルニア] を選択すると、[市区町村] フィルターで使用可能な一連のオプションが強調表示され、カリフォルニア州の都市のみが表示されます。一方、強調表示されていないオプションは、ドロップダウンの [フィルターで除外] メニュー オプションの下に配置されます。 これには、フィルターが更新されるたびにクエリを実行する必要があります。

  • デフォルト値: "日付" 型の列を選択し、時間ビン値 (日、月、または年) を選択した場合、ユーザーはフィルターのデフォルトの日付範囲を設定することもできます。 デフォルトのフィルターは、クエリが更新されるたびに自動的に適用されます。

制限

  • クエリ フィルターはデータセット全体に適用されることに注意することが重要です。 ただし、クエリ フィルターのドロップダウン セレクターは 64k の一意の値に制限されています。 ユーザーが 64k を超える一意のフィルター値がある状況でフィルター処理する場合は、代わりに Text パラメーターを使用することをお勧めします。
  • フィルターは、クエリによって返された列にのみ適用でき、参照されるテーブルのすべての列に適用できるわけではありません。
  • フィルターは、返された結果に指定された列のオプションの個別のリストを表示します。 結果が限られている場合(つまり、 クエリを制限 1000 で実行した場合、フィルターには、これらの 1000 件の結果内から一意の値のみが表示されます。
  • クエリに適用されるフィルターは、パフォーマンスを向上させるためにクライアント側またはサーバー側で実行されるように最適化されますが、ダッシュボードに適用されるフィルターは常にサーバー側で実行されます。