クエリベースのパラメーターの使用
この記事では、クエリベースのパラメーターを使用する対話型ダッシュボードを作成する手順について説明します。 Azure Databricks でのダッシュボード構築に関する基本的な知識があることを前提としています。 ダッシュボードの作成に関する基本的な手順については、「開始するには」を参照してください。
要件
- Azure Databricks ワークスペースにログインしています。
- そのワークスペースでの SQL エンタイトルメントがあること。
- 1 つ以上の SQL ウェアハウスに対する、"使用可能" 以上のアクセス権があること。
ダッシュボード データセットを作成する
このチュートリアルでは、Azure Databricks にある samples カタログから生成されたデータを使用します。
サイド バーで
[新規] をクリックし、メニューから [ダッシュボード] を選択します。
[データ] タブをクリックします。
[SQL から作成] をクリックし、次のクエリをエディターに貼り付けます。 その後、[実行] をクリックすると、結果が返されます。
SELECT * FROM samples.tpch.customer
新しく定義したデータセットは、"無題のデータセット" という名前で自動保存されます。 タイトルをダブルクリックし、名前を「マーケティング セグメント」に変更します。
パラメーターを追加する
このデータセットにパラメーターを追加して、返される値をフィルター処理できます。 この例のパラメーターは :segment
です。 パラメーター構文の詳細については「ダッシュボード パラメーターとは」を参照してください。
次の
WHERE
句をクエリの一番下に貼り付けます。 クエリの下にパラメーター名segment
を持つテキスト フィールドが表示されます。WHERE c_mktsegment = :segment
クエリの下のテキスト フィールドに
BUILDING
と入力して、パラメーターの既定値を設定します。クエリを再実行して結果を調べます。
視覚化ウィジェットを構成する
次の手順を完了して、キャンバス上にデータセットの視覚化を追加します。
- [キャンバス] タブをクリックします。
[視覚化の追加] をクリックして視覚化ウィジェットを追加し、マウスを使ってそれをキャンバスに配置します。
X 軸を設定する
- [視覚化] ボックスの一覧から [横棒] を選びます。
をクリックして、X 軸に沿って表示されるデータを選びます。 検索バーを使って名前でフィールドを検索できます。 c_nationkey を選択します。
- 選んだフィールド名をクリックしてその他の構成オプションを表示します。
- [スケールの種類] で、[カテゴリ別] を選びます。
- [変換] の選択で、[なし] を選びます。
Y 軸を設定する
- Y 軸の隣の
をクリックし、c_acctbal を選択します。
- 選んだフィールド名をクリックしてその他の構成オプションを表示します。
- [スケールの種類] で、[定量] を選びます。
- [変換] の選択で、[SUM] を選びます。
視覚化は、構成に応じて自動的に更新されます。 データには、segment
が BUILDING
であるレコードのみ含まれています。
フィルターを追加する
ダッシュボード ビューアーが焦点を当てるマーケティング セグメントを制御できるようにフィルターを設定します。
[フィルターの追加 (フィールド/パラメーター)] をクリックして、フィルター ウィジェットを追加します。 それをキャンバスに配置します。
- 構成パネル内の [フィルター] ボックスの一覧から、[単一値] を選びます。
- [タイトル] チェックボックスを選んでフィルター ウィジェットにタイトル フィールドを表示します。
- ウィジェットのプレースホルダー タイトルをクリックし、「セグメント」と入力してフィルターに新しいタイトルを付けます。
- 構成パネルの [パラメーター] の横にある
をクリックします。
- マーケティング セグメント データセットからセグメントを選択します。
構成されたフィルター ウィジェットに、データセットの既定のパラメーター値が表示されます。
値の選択を定義する
作成したフィルターは機能的ですが、ビューアーが選択を入力できるようになる前に、利用可能な選択の範囲を把握しておく必要があります。 また、目的のパラメーター値を入力する場合は、大文字と小文字を一致させる必要があります。
ビューアーが利用可能なオプションの一覧からパラメーターを選択できるようにドロップダウン リストを作成するには、可能な値の一覧を定義するために新しいデータセットを作成します。
[データ] タブをクリックします。
[SQL から作成] をクリックして、新しいデータセットを作成します。
次の内容をコピーしてエディターに貼り付けます。
SELECT DISTINCT c_mktsegment FROM samples.tpch.customer
クエリを実行し、結果を調べます。 テーブルの 5 つのマーケティング セグメントが結果に表示されます。
自動生成されたタイトルをダブルクリックし、このデータセットの名前を「セグメントの選択」に変更します。
フィルターの更新
既存のフィルターを更新して、作成したばかりのデータセットを使用して、ユーザーが選択できる値のドロップダウン リストを作成します。
- [キャンバス] をクリックします。 次に、前の手順で作成したフィルター ウィジェットをクリックします。
- [フィールド] の横にある
をクリックします。
- [セグメントの選択] をクリックし、フィールド名
c_mktsegment
をクリックします。
構成を変更すると、フィルター ウィジェットが更新されます。 フィルター ウィジェットのフィールドをクリックすると、ドロップダウン メニューに利用可能な選択肢が表示されます。
Note
このチュートリアルには、クエリベースのパラメーターの使用方法を示すために、簡単なユース ケースが含まれます。 このダッシュボードを作成する別の方法は、c_mktsegment
フィールドにフィルターを適用することです。
次のステップ
次の記事で、ダッシュボードの操作方法の学習を継続してください。
- フィルターの適用に関する詳細を参照してください。 「フィルター」を参照してください。
- ダッシュボード パラメーターの詳細を参照してください。 「ダッシュボード パラメーターとは」を参照してください。
- ダッシュボードを発行して共有します。 「ダッシュボードを発行する」を参照してください。
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示