次の方法で共有


クエリベースのパラメーターの使用

この記事では、クエリベースのパラメーターを使用する対話型ダッシュボードを作成する手順について説明します。 Azure Databricks でのダッシュボード構築に関する基本的な知識があることを前提としています。 ダッシュボードの作成に関する基本的な手順については、「開始するには」を参照してください。

要件

  • Azure Databricks ワークスペースにログインしています。
  • そのワークスペースでの SQL エンタイトルメントがあること。
  • 1 つ以上の SQL ウェアハウスに対する、"使用可能" 以上のアクセス権があること。

ダッシュボード データセットを作成する

このチュートリアルでは、Azure Databricks にある samples カタログから生成されたデータを使用します。

  1. サイド バーで 新規アイコン [新規] をクリックし、メニューから [ダッシュボード] を選択します。

  2. [データ] タブをクリックします。

  3. [SQL から作成] をクリックし、次のクエリをエディターに貼り付けます。 その後、[実行] をクリックすると、結果が返されます。

    SELECT
      *
    FROM
      samples.tpch.customer
    
  4. 新しく定義したデータセットは、"無題のデータセット" という名前で自動保存されます。 タイトルをダブルクリックし、名前を「マーケティング セグメント」に変更します。

パラメーターを追加する

このデータセットにパラメーターを追加して、返される値をフィルター処理できます。 この例のパラメーターは :segment です。 パラメーター構文の詳細については「ダッシュボード パラメーターの操作」を参照してください。

  1. 次の WHERE 句をクエリの一番下に貼り付けます。 クエリの下にパラメーター名 segment を持つテキスト フィールドが表示されます。

    WHERE
      c_mktsegment = :segment
    
  2. クエリの下のテキスト フィールドに BUILDING と入力して、パラメーターの既定値を設定します。

  3. クエリを再実行して結果を調べます。

視覚化ウィジェットを構成する

次の手順を完了して、キャンバス上にデータセットの視覚化を追加します。

  1. [キャンバス] タブをクリックします。
  2. 作成アイコン [視覚化の追加] をクリックして視覚化ウィジェットを追加し、マウスを使ってそれをキャンバスに配置します。

X 軸を設定する

  1. [視覚化] ボックスの一覧から [横棒] を選びます。
  2. [フィールドの追加] アイコン をクリックして、X 軸に沿って表示されるデータを選びます。 検索バーを使って名前でフィールドを検索できます。 c_nationkey を選択します。
  3. 選んだフィールド名をクリックしてその他の構成オプションを表示します。
    • [スケールの種類] で、[カテゴリ別] を選びます。
    • [変換] の選択で、[なし] を選びます。

Y 軸を設定する

  1. Y 軸の隣の [フィールドの追加] アイコン をクリックし、c_acctbal を選択します。
  2. 選んだフィールド名をクリックしてその他の構成オプションを表示します。
    • [スケールの種類] で、[定量] を選びます。
    • [変換] の選択で、[SUM] を選びます。

視覚化は、構成に応じて自動的に更新されます。 データには、segmentBUILDING であるレコードのみ含まれています。

前の手順で説明したように構成された視覚化ウィジェット。

フィルターを追加する

ダッシュボード ビューアーが焦点を当てるマーケティング セグメントを制御できるようにフィルターを設定します。

  1. フィルター アイコン [フィルターの追加 (フィールド/パラメーター)] をクリックして、フィルター ウィジェットを追加します。 それをキャンバスに配置します。
  2. 構成パネル内の [フィルター] ボックスの一覧から、[単一値] を選びます。
  3. [タイトル] チェックボックスを選んでフィルター ウィジェットにタイトル フィールドを表示します。
  4. ウィジェットのプレースホルダー タイトルをクリックし、「セグメント」と入力してフィルターに新しいタイトルを付けます。
  5. 構成パネルの [パラメーター] の横にある [フィールドの追加] アイコン をクリックします。
  6. マーケティング セグメント データセットからセグメントを選択します。

構成されたフィルター ウィジェットに、データセットの既定のパラメーター値が表示されます。

説明に従って、パラメーターで構成されたフィルター ウィジェット。

値の選択を定義する

作成したフィルターは機能的ですが、ビューアーが選択を入力できるようになる前に、利用可能な選択の範囲を把握しておく必要があります。 また、目的のパラメーター値を入力する場合は、大文字と小文字を一致させる必要があります。

ビューアーが利用可能なオプションの一覧からパラメーターを選択できるようにドロップダウン リストを作成するには、可能な値の一覧を定義するために新しいデータセットを作成します。

  1. [データ] タブをクリックします。

  2. [SQL から作成] をクリックして、新しいデータセットを作成します。

  3. 次の内容をコピーしてエディターに貼り付けます。

    SELECT
      DISTINCT c_mktsegment
    FROM
      samples.tpch.customer
    
  4. クエリを実行し、結果を調べます。 テーブルの 5 つのマーケティング セグメントが結果に表示されます。

  5. 自動生成されたタイトルをダブルクリックし、このデータセットの名前を「セグメントの選択」に変更します。

フィルターの更新

既存のフィルターを更新して、作成したばかりのデータセットを使用して、ユーザーが選択できる値のドロップダウン リストを作成します。

  1. [キャンバス] をクリックします。 次に、前の手順で作成したフィルター ウィジェットをクリックします。
  2. [フィールド] の横にある [フィールドの追加] アイコン をクリックします。
  3. [セグメントの選択] をクリックし、フィールド名 c_mktsegment をクリックします。

構成を変更すると、フィルター ウィジェットが更新されます。 フィルター ウィジェットのフィールドをクリックすると、ドロップダウン メニューに利用可能な選択肢が表示されます。

Note

このチュートリアルには、クエリベースのパラメーターの使用方法を示すために、簡単なユース ケースが含まれます。 このダッシュボードを作成する別の方法は、c_mktsegment フィールドにフィルターを適用することです。

説明に従って、フィールドで構成されたフィルター ウィジェット。

次のステップ

次の記事で、ダッシュボードの操作方法の学習を継続してください。