ダッシュボード データセットの作成と管理
この記事では、 AI/BI dashboardのデータセットエディタを使用してダッシュボードデータセットを作成および管理する方法について説明します。
データセットの定義
既存のデータセットを定義またはアクセスするには、ダッシュボードの左上隅にある [データ ] タブをクリックします。 ダッシュボードごとに最大 100 個のデータセットを定義できます。
データセットは次のように定義できます。
1 つ以上のテーブルまたはビューに対する新しいクエリ。
既存の Unity Catalog テーブルまたはビュー。
注:
すべてのデータセットはクエリによって定義されます。 既存の Unity Catalog テーブルまたはビューを選択すると、そのデータセットのクエリは、そのテーブルまたはビューに対する SELECT *
ステートメントになります。 クエリを変更して、データセットを絞り込むことができます。
データセットを定義したら、データセット名の右側にある ケバブメニューを使用して、次のオプションにアクセスします。
改名する: データセットにわかりやすい名前を付けると、編集またはレビューするクエリを自分とチームがすばやく特定できます。
名前の提案: クエリに基づいて推奨される名前を自動的に生成します。 この名前は、生成後に編集できます。
クローン: クエリのインプレース コピーを作成します。 クエリは、クローニング後に編集できます。
削除: データセットを削除します。 このオプションは、データセットがキャンバスで使用されている場合は使用できません。
ダウンロード: データセットは、CSV、TSV、または Excel ファイルとしてダウンロードできます。
結果テーブルの表示
データセットを作成すると、クエリが自動的に実行され、結果はエディターの下のウィンドウにテーブルとして表示されます。 各列には、そのデータ型を示すアイコンが含まれています。
列の値を並べ替えるには:
各列にカーソルを合わせると、 ソートアイコンが表示されます。
アイコンをクリックすると、値が昇順または降順で並べ替えられます。
複数ステートメントのクエリの記述
場合によっては、複数の SQL ステートメントを使用してデータセットを構築することがあります。 複数のステートメントを実行するには、各ステートメントをセミコロン (;
) で終了します。 これらのコマンドを実行してデータセットを作成すると、エディタの最後のステートメントの結果が出力に表示されます。 このデータセットは、キャンバス上の関連する視覚化に使用されます。
ステートメントは、発行されるデータセットに対してローカルです。 たとえば、カタログまたはスキーマを設定する USE
ステートメントを使用してデータセットを作成した場合、その設定はそのデータセットにのみ適用されます。
例:
次の例は、複数ステートメント・クエリの一般的な使用方法を示しています。
カタログとスキーマを設定する
USE
ステートメントを記述して、クエリ内のテーブルのカタログとスキーマを宣言できます。次のクエリには 3 つのステートメントが含まれています。 1 つ目はカタログ名を設定します。 2 つ目はスキーマを設定します。 SELECT
文は、カタログとスキーマが設定されているため、テーブル名のみを参照します。USE CATALOGを参照してください。
USE CATALOG samples;
USE SCHEMA tpch;
SELECT * FROM customer;
ANSI モードの設定
クエリは、 ANSI_MODE
を TRUE
または FALSE
に設定して実行するように設定できます。 Databricks SQLの場合、ANSI_MODE
のシステム デフォルト値は TRUE
です。ANSI_MODEを参照してください。
次のクエリでは、 ANSI_MODE
を FALSE
に設定して、無効なデータ型の入力がエラーをスローするのではなく NULL
を返すようにします。
SET ANSI_MODE = FALSE;
SELECT cast('a' AS INTEGER);
複雑なクエリをパラメーター化する
複数のステートメントを使用して、共通テーブル式またはその他の複雑なクエリのビュー名をパラメータ化できます。
次のクエリは、2 つの一時ビューを作成します。 SELECT
ステートメントは、IDENTIFIER
句を使用して、入力文字列をテーブル名として解釈します。IDENTIFIER 句を参照してください。
CREATE TEMPORARY VIEW v1 AS SELECT 1;
CREATE TEMPORARY VIEW v2 AS SELECT 2;
SELECT * FROM IDENTIFIER(:view_name)
変数の設定
次のクエリは、最初のステートメントで変数と値を宣言します。 2 番目のステートメントは、変数の値を変更します。 3 番目のステートメントは、変数の終了値が 5 であることを示しています。一時変数の使用に関する詳細と完全な構文については、 SET VARIABLE を参照してください。
DECLARE VARIABLE myvar1 INT DEFAULT 7;
SET VAR myvar1 = 5;
VALUES (myvar1);