クエリベースパラメーター

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

要件

Databricksワークスペースにログインしていること。
そのワークスペースにSQL 権限があること。
少なくとも 1 つ以上の SQLウェアハウスへの CAN USE アクセス権を持っていること。

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

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

サイドバーの [ 新規 ] をクリックし 、メニューから [ダッシュボード ] を選択します。
[データ]タブをクリックします。
「SQL から作成」をクリックし、次のクエリをエディターに貼り付けます。次に、 「実行」をクリックして結果を返します。
```
SELECT
  *
FROM
  samples.tpch.customer
```
新しく定義されたデータセットは、「Untitled データセット」という名前で自動保存されます。タイトルをダブルクリックし、名前を「マーケティングセグメント」に変更します。

パラメーターを追加する

このパラメーターに引数を追加して、返される値をフィルタリングできます。この例におけるパラメーターは:segmentです。ダッシュボードパラメーターとは参照してください。パラメーター構文について詳しく学びます。

クエリの下部に次の WHERE 句を貼り付けます。クエリの下に、パラメーター名segmentのテキストフィールドが表示されます。
```
WHERE
  c_mktsegment = :segment
```
パラメーターのデフォルト値を設定するには、クエリの下のテキストフィールドにBUILDINGと入力します。
クエリを再実行して、結果を調べます。

ビジュアライゼーションウィジェットの構成

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

[キャンバス]タブをクリックします。
「ビジュアリゼーションの追加 」をクリックしてビジュアリゼーション・ウィジェットを追加し、マウスを使用してキャンバスに配置します。

X 軸の設定

必要に応じて、 [視覚化]ドロップダウンメニューから[バー]を選択します。
X 軸に沿って表示されるデータをクリックして選択します。検索バーを使用して、フィールドを名前で検索できます。 [c_nationkey] を選択します。
選択したフィールド名をクリックすると、追加の設定オプションが表示されます。
- 「スケール・タイプ」として、「カテゴリー」を選択します。
- [ 変換] の選択で [ なし] を選択します。

Y軸の設定

Y 軸の横にあるをクリックし、[ c_acctbal ] を選択します。
選択したフィールド名をクリックすると、追加の設定オプションが表示されます。
- 「スケール・タイプ」として、「定量的」を選択します。
- [ Transform (トランスフォーム )] 選択で [SUM] を選択します。

ビジュアライゼーションは、構成すると自動的に更新されます。表示されるデータには、 segment が BUILDINGレコードのみが含まれます。

フィルターを追加する

ダッシュボード閲覧者がどのマーケティングセグメントに重点を置くかを制御できるようにフィルターを設定します。

クリックフィルターウィジェットを追加するには、フィルター (フィールド/パラメーター) を追加します。キャンバスに配置します。
構成パネルの [ フィルター ] ドロップダウンメニューから、[ 単一値] を選択します。
「 タイトル 」チェックボックスを選択して、フィルターウィジェットにタイトルフィールドを表示します。
ウィジェットのプレースホルダータイトルをクリックし、「 Segment 」と入力してフィルターのタイトルを変更します。
構成パネル内のパラメーターの横にあるをクリックします。
マーケティングセグメントデータセットからセグメントを選択します。

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

値の選択肢を定義する

作成したフィルターは機能しますが、閲覧者が選択項目を入力する前に、使用可能な選択肢の範囲を把握しておく必要があります。また、ユーザーは、希望するパラメーターの値を入力するときに、大文字と小文字、およびスペルを一致させる必要があります。

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

[データ]タブをクリックします。
新しいデータセットを作成するには、 [SQL から作成]をクリックします。

以下をコピーしてエディターに貼り付けます。

SELECT
  DISTINCT c_mktsegment
FROM
  samples.tpch.customer

クエリを実行し、結果を調べます。表の 5 つのマーケティングセグメントが結果に表示されます。
自動生成されたタイトルをダブルクリックし、このデータセットの名前を「セグメント選択」に変更します。

フィルターを更新する

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

[ キャンバス] をクリックします。次に、前のステップで作成したフィルターウィジェットをクリックします。
[フィールド ] の横にある をクリックします。
[ セグメントの選択] をクリックし、フィールド名 c_mktsegmentをクリックします。

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

注：

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

次のステップ

ダッシュボードの操作方法については、次の記事を参照してください。

詳しくは、フィルターの適用についての記事をご覧ください。「フィルター」を参照してください。
ダッシュボードパラメーターの詳細をご覧ください。「ダッシュボードパラメーターとは」を参照してください。
ダッシュボードを公開して共有します。「ダッシュボードの公開」を参照してください。