ダッシュボード データセットの作成と管理

この記事では、 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_MODETRUE または FALSEに設定して実行するように設定できます。 Databricks SQLの場合、ANSI_MODE のシステム デフォルト値は TRUE です。ANSI_MODEを参照してください。

次のクエリでは、 ANSI_MODEFALSE に設定して、無効なデータ型の入力がエラーをスローするのではなく 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);

SQL によるデータ アクセスの制限

ダッシュボードの閲覧者は、ビジュアライゼーションに表示されていない場合でも、データセット内のすべてのデータにアクセスできます。 機密データがブラウザーで公開されるのを防ぐには、データセットを定義する SQL クエリの列を制限します。 たとえば、テーブルからすべての列を選択する代わりに、視覚化に必要な特定のフィールドのみを含めます。