ダッシュボードとは何ですか?

Dashboard は、ダッシュボードをインタラクティブにする 1 つの方法であり、閲覧者が単一値セレクターと日付ピッカーを使用して、ダッシュボード クエリに特定の値を入力できるようにします。 たとえば、 は、 SQLクエリで集計される前に、日付や製品カテゴリなどの基準に基づいてデータをフィルタリングできるため、より効率的なクエリと正確な分析が可能になります。

ウィジェットは、ダッシュボードの作成者または編集者によってデータセットに追加され、ダッシュボードのキャンバス上の 1 つ以上のウィジェットに接続されます。 ダッシュボード閲覧者は、フィルター ウィジェットで値を選択してダッシュボード データを操作します。 これにより、関連するクエリが再実行され、フィルター処理されたデータに基づいて構築された視覚化が表示されます。

クエリを直接変更できるので、非常に便利です。 データセット フィルターは、ダッシュボードのインタラクティブ性、より多くの機能、および引数よりも大きいデータセットを使用した優れたパフォーマンスも提供できます。 「 フィルター」を参照してください。

クエリに

ダッシュボード データセットにエントリを追加するには、ドラフト ダッシュボードに対する「編集可能」権限以上が必要です。 [データ] タブの [パラメータ] クエリに を直接追加できます。

Gif は次のステップの例を示します。

クエリに を追加するには:

  1. クエリ内の配置する場所にカーソルを置きます。

  2. 新しいものを挿入するには、 [追加]をクリックします。

    これにより、デフォルト名parameterを持つ新しいコンテナーが作成されます。 デフォルト名を変更するには、クエリ エディターで置き換えます。 クエリ エディターでこの構文を入力して、パラメーターを追加することもできます。

クエリを編集する

編集するには:

  1. クリック歯車アイコン名前の横に。 詳細ダイアログが表示され、次の構成オプションが含まれます。

    • キーワード: クエリ内の要素を表すキーワード。 これは、クエリ内のテキストを直接更新することによってのみ変更できます。

    • 表示名: フィルター エディターでの名前。 デフォルトでは、タイトルはキーワードと同じになります。

    • タイプ: サポートされているタイプには、文字列、日付、日付と時刻、数値が含まれます。

      • デフォルトタイプは文字列です。

      • 数値データ型では、Decimal と Integer のどちらかを指定できます。デフォルトの数値型はDecimalです。

  2. UI の別の部分をクリックして、ダイアログを閉じます。

デフォルト値を設定する

引数名の下のテキスト フィールドに引数のデフォルト値を入力すると、その値を設定できます。 クエリを実行して、引数値が適用されたクエリ結果をプレビューします。 クエリを実行すると、デフォルト値も保存されます。 キャンバス上のフィルター ウィジェットを使用してこの 構造体 を設定すると、 デフォルト 値が使用されます。

クエリベース

クエリベースの を使用すると、作成者は、閲覧者がダッシュボードでデータを探索するときに選択できる値の動的または静的なリストを定義できます。 クエリベースのダッシュボードを作成するには、ダッシュボード作成者は次の手順を実行します。

  1. 結果セットが可能な 引数 値のリストに制限される 引数 を作成します。

  2. 引数を使用するデータセットクエリを作成します。

  3. フィールドをフィルターし、 を使用するフィルター ウィジェットをキャンバス上に構成します。

    • フィールド構成は、適切な引数値の必要なリストを持つフィールドを使用するように設定する必要があります。

    • 値を選択するには、構成を設定する必要があります。

注：

クエリベースの引数で使用されるデータセットがダッシュボード上の他の視覚化でも使用されている場合、閲覧者のフィルター選択によって、接続されているすべてのクエリが変更されます。 これを回避するには、作成者はダッシュボード上の他の視覚化では使用されない、クエリベースの引数専用の 定数 を作成する必要があります。

クエリベースの 構造体 と視覚化を追加する方法を示すステップバイステップのチュートリアルについては、「クエリベースの 構造体 の使用」を参照してください。

動的なリストを作成する

閲覧者が値を選択するために使用するドロップダウンにデータを入力する動的なデータセットを作成するには、単一のフィールドを返し、そのフィールド内のすべての値を含めるSQLクエリを記述します。 パラメータが更新されると、そのフィールドの新しい値は自動的に引数選択として追加されます。 SQL クエリの例は次のとおりです。

 SELECT
    DISTINCT c_mktsegment
  FROM
    samples.tpch.customer

静的リストを作成する

データセットにハードコードした値のみを含む静的データセットを作成できます。 クエリの例を次に示します。

SELECT
  *
FROM
  (
    VALUES
      ('MACHINERY'),
      ('BUILDING'),
      ('FURNITURE'),
      ('HOUSEHOLD'),
      ('AUTOMOBILE')
  ) AS data(available_choices)

フィルターの種類

単一値フィルターと日付ピッカーフィルターは設定をサポートします。 日付ピッカーフィルターを使用してクエリベースのパラメーターを設定すると、基になるクエリの結果に表示される日付が黒で表示されます。 クエリ結果に表示されない日付は灰色で表示されます。 ユーザーは、基になるクエリに含まれていない灰色の日付を選択できます。

クエリを削除する

シンボルを削除するには、クエリからシンボルを削除します。

ダッシュボードに表示する

ダッシュボード キャンバスにフィルターを追加すると、閲覧者はフィルター値を選択して変更できるようになり、インタラクティブにデータを探索および分析できるようになります。 ダッシュボードで デフォルト パラメーター を公開しない場合、閲覧者にはクエリで設定した デフォルト パラメーター 値を使用するクエリ結果のみが表示されます。

ダッシュボードに追加するには:

  1. クリックフィルター アイコンフィルター（フィールド/）を追加します。

  2. クリック[フィールドの追加] アイコン構成パネルの横にあります。

  3. このウィジェットでビューアが使用するウィジェット名をクリックします。

URLに含める

引数設定は URL に保存されるため、ユーザーはそれをブックマークして、事前設定されたフィルターや引数を含むダッシュボードの状態を維持したり、同じフィルターや引数を一貫して適用するために他のユーザーと共有したりできます。

構文例

次の例は、 の一般的な使用例を示しています。

日付を挿入する

次の例には、クエリ結果を特定の日付以降のレコードに制限するDateが含まれています。

SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  sum(o_totalprice) AS `Total Price`
FROM
  samples.tpch.orders
WHERE
  o_orderdate > :date_param
GROUP BY
  1,
  2

数値を挿入する

次の例には、 o_total_priceフィールドが指定された引数値より大きいレコードに結果を制限するNumericTextが含まれています。

SELECT
  o_orderdate AS Date,
  o_orderpriority AS Priority,
  o_totalprice AS Price
FROM
  samples.tpch.orders
WHERE
  o_totalprice > :num_param

フィールド名を挿入する

次の例では、 field_param IDENTIFIER関数と共に使用して、クエリのしきい値を指定します。 引数の値は、クエリで使用されるテーブルの列名である必要があります。

SELECT
  *
FROM
  samples.tpch.orders
WHERE
  IDENTIFIER(:field_param) < 10000

データベース・オブジェクトの挿入

次の例では、3 つのオブジェクトcatalog 、 schema 、 tableを作成します。 ダッシュボード閲覧者は、キャンバス上のフィルター ウィジェットを使用してフィルター値を選択できます。

SELECT
  *
FROM
  IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

IDENTIFIER 句を参照してください。

重要

ダッシュボードの閲覧者がテーブル名やカタログ名などの構造選択を通じてデータにアクセスできるようにすると、機密情報が誤って公開される可能性があります。 これらのオプションを使用してダッシュボードを公開する場合、Databricks では公開されたダッシュボードに資格情報を埋め込まないことをお勧めします。

複数の

他のSQL関数に含めることができます。 この例では、閲覧者が従業員の役職と番号 ID を選択できるようにします。 クエリはformat_string関数を使用して 2 つの文字列を連結し、一致する行をフィルターします。 format_string 関数 (function function) を参照。

SELECT
  o_orderkey,
  o_clerk
FROM
  samples.tpch.orders
WHERE
  o_clerk LIKE format_string('%s%s', :title, :emp_number)

ダッシュボードの構築 vs. Databricks SQLクエリの構築

ダッシュボード マーカーは、名前付き マーカーと同じ構文を使用します。 名前付きマーカーを参照してください。 ダッシュボードはDatabricks SQLスタイルの呼び出しをサポートしていません。