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

この記事では、クエリベースのパラメーターを使用する対話型ダッシュボードを作成する手順について説明します。 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] を選びます。

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

フィルターを追加する

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

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 フィールドにフィルターを適用することです。

次のステップ

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

• フィルターの適用に関する詳細を参照してください。 「フィルター」を参照してください。
• ダッシュボード パラメーターの詳細を参照してください。 「ダッシュボード パラメーターとは」を参照してください。
• ダッシュボードを発行して共有します。 「ダッシュボードを発行する」を参照してください。