SQL エディターでクエリを記述し、データを探索する

Databricks UI には、クエリの作成、使用可能なデータの参照、視覚化の作成に使用できる SQL エディターが含まれています。また、保存したクエリをワークスペース内の他のチームメンバーと共有することもできます。この記事では、SQL エディターを使用してクエリを記述、実行、管理する方法について説明します。新しいバージョンの SQL エディターはパブリックプレビュー段階です。新しい SQL エディターを有効にして操作する方法については、「新しい SQL エディターを使用して同僚と共同作業する」を参照してください。

エディターを開いた後、SQL クエリを作成したり、使用可能なデータを参照したりできます。テキストエディタは、オートコンプリート、オートフォーマット、およびその他のさまざまなキーボードショートカットをサポートしています。

テキストエディタの上部にあるクエリタブを使用して、複数のクエリを開くことができます。各クエリタブには、クエリの実行、クエリのお気に入りとしてのマーク、および SQLウェアハウスへの接続のためのコントロールがあります。クエリを保存、 スケジュール、または共有することもできます。

SQL エディターを開く

Databricks UI で SQL エディターを開くには、サイドバー [SQL エディター ] をクリックします。

SQL エディターが開き、最後に開いたクエリが表示されます。クエリが存在しない場合、またはすべてのクエリが明示的に閉じられている場合は、新しいクエリが開きます。自動的に [新しいクエリ ] という名前が付けられ、タイトルに作成タイムスタンプが追加されます。

コンピュートに接続

クエリを実行するには、少なくとも実行中の SQLウェアハウスに対する CAN USE アクセス許可が必要です。エディターの上部にあるドロップダウンを使用して、使用可能なオプションを表示できます。リストをフィルタリングするには、テキストボックスにテキストを入力します。

クエリを初めて作成すると、使用可能な SQLウェアハウスの一覧がアルファベット順に表示されます。最後に使用した SQLウェアハウスは、次回クエリを作成するときに選択されます。

SQLウェアハウスの横のアイコンは、ステータスを示します。

ランニング
始動
停止

注：

一覧に SQLウェアハウスがない場合は、ワークスペース管理者に問い合わせてください。

選択した SQLウェアハウスは、クエリを実行すると自動的に再起動します。 SQLウェアハウスを開始するその他の方法については、「 SQLウェアハウスの開始」を参照してください。

SQLエディタでのデータオブジェクトの参照

メタデータの読み取り権限がある場合、SQL エディターのスキーマブラウザーに使用可能なデータベースとテーブルが表示されます。「カタログエクスプローラ」(Catalog Explorer) からデータオブジェクトをブラウズすることもできます。

サンプルカタログ、nyctaxi データベース、trips テーブル、およびそのテーブル内の列を表示するスキーマブラウザー。

アクティブなコンピュートを使用せずに、カタログエクスプローラーで Unity Catalogで管理されるデータベースオブジェクトをナビゲートできます。 hive_metastore およびUnity Catalogによって管理されていない他のカタログ内のデータを探索するには、適切な権限でコンピュートにアタッチする必要があります。データガバナンス with Unity Catalogを参照してください。

注：

スキーマブラウザまたはカタログエクスプローラーにデータオブジェクトが存在しない場合は、ワークスペース管理者に問い合わせてください。

スキーマブラウザの上部付近をクリックして、スキーマを更新します。検索ボックスにフィルター文字列を入力することで、スキーマをフィルター処理できます。

テーブル名をクリックすると、そのテーブルの列が表示されます。

クエリを作成する

テキストを入力して、SQL エディターでクエリを作成できます。スキーマブラウザーから要素を挿入して、カタログとテーブルを参照できます。

SQL エディターにクエリを入力します。

SQL エディターはオートコンプリートをサポートしています。入力すると、オートコンプリートによって入力候補が提示されます。たとえば、カーソル位置の有効な補完が列の場合、オートコンプリートは列名を提案します。 select * from table_name as t where t.と入力すると、オートコンプリートは t が table_name のエイリアスであることを認識し、 table_name内の列を提案します。
(オプション)編集が完了したら、[ 保存] をクリックします。 By デフォルト, クエリは your user ホームフォルダーに保存されますが、別の場所を選択することもできます。次に、[ 保存] をクリックします。

オートコンプリートのオンとオフを切り替える

ライブオートコンプリートでは、スキーマトークン、クエリ構文識別子( SELECT や JOINなど)、およびクエリスニペットのタイトルを補完できます。これは、データベーススキーマが 5,000 個のトークン (テーブルまたは列) を超えない限り、デフォルトで有効になります。

SQL エディターの下にあるトグルを使用して、ライブオートコンプリートをオンまたはオフにします。

ライブオートコンプリートをオフにするには、 Ctrl + Space を押すか、SQL エディターの下にあるボタンをクリックします。

クエリの保存

SQL エディターの右上にある [保存 ] ボタンは、クエリを保存します。

重要

クエリを変更しても明示的に [ 保存] をクリックしない場合、その状態はクエリの下書きとして保持されます。クエリの下書きは 30 日間保持されます。 30 日が経過すると、クエリの下書きは自動的に削除されます。変更を保持するには、変更を明示的に保存する必要があります。

複数のクエリを編集する

デフォルトでは、SQL エディターはタブを使用するため、複数のクエリを同時に編集できます。新しいタブを開くには、[ +] をクリックし、[新しいクエリ の作成 ] または [ 既存のクエリを開く] を選択します。 [ 既存のクエリを開く ] をクリックして、保存されているクエリの一覧を表示します。 [ My Queries ] または [Favorites ] をクリックして、クエリのリストをフィルタリングします。表示するクエリを含む行で、[ 開く] をクリックします。

1 つのクエリまたは複数のクエリを実行する

クエリまたはすべてのクエリを実行するには、次のようにします。

SQLウェアハウスを選択します。
SQL エディターでクエリを強調表示します (クエリペインに複数のクエリがある場合)。
Ctrl/Cmd + Enter キーを押すか、[実行] (1000) をクリックして、結果を結果ウィンドウにテーブルとして表示します。

注：

Limit 1000 は、クエリの戻り値を 1000 行に制限するために、すべてのクエリに対してデフォルトで選択されます。クエリが [制限 1000 ] 設定で保存されている場合、この設定はすべてのクエリ実行 (ダッシュボードを含む) に適用されます。このクエリのすべての行を返すには、[実行 (1000)] ドロップダウンをクリックして [LIMIT 1000] の選択を解除します。行数に別の制限を指定する場合は、選択した値を使用してクエリに LIMIT 句を追加できます。

クエリを終了する

実行中にクエリを終了するには、[ キャンセル] をクリックします。管理者は、実行中のクエリを終了する [実行中のクエリを終了] を表示することで、別のユーザーが開始した実行中のクエリを停止できます。

クエリオプション

あなたはクエリエディターの上部近くにある kebab コンテキストメニューを使用すると、クエリ情報の複製、元に戻す、フォーマット、編集を行うメニューオプションにアクセスできます。

保存したクエリに戻す

クエリを編集すると、クエリのコンテキストメニューに [ 変更を元に戻す ] オプションが表示されます。「 元に戻す 」をクリックすると、保存したバージョンに戻ることができます。

クエリの破棄と復元

クエリをゴミ箱に移動するには、次のようにします。

ケバブのコンテキストメニューをクリックSQL エディターでクエリの横にあるをクリックし、ゴミ箱に移動を選択します。
[ ゴミ箱に移動 ] をクリックして確定します。

ごみ箱からクエリを復元するには、次のようにします。

[すべてのクエリ] リストで、をクリックします。
クエリをクリックします。
ケバブのコンテキストメニューをクリックSQL エディターの右上にあるをクリックし、 [復元]をクリックします。

クエリの説明を設定し、クエリ情報を表示する

クエリの説明を設定するには、次のようにします。

クエリの横にあるケバブのコンテキストメニューをクリックし、[クエリ情報の編集] をクリックします。
[ 説明 ] テキストボックスに、説明を入力します。次に、「保存」をクリックします。このダイアログでは、クエリの作成日時や更新日時など、クエリの履歴を表示することもできます。

お気に入りクエリとタグクエリ

お気に入りとタグを使用して、ワークスペースのランディングページ、およびダッシュボードとクエリの各リストページに表示されるクエリとダッシュボードのリストをフィルタリングできます。

お気に入り: クエリをお気に入りに追加するには、[クエリ] リストでタイトルの左側にある星印をクリックします。星が黄色に変わります。

タグ: クエリとダッシュボードに、組織に対して意味のある文字列でタグを付けることができます。

タグを追加する

クエリエディタでタグを追加します。

クエリの横にあるケバブのコンテキストメニューをクリックし、[クエリ情報の編集] をクリックします。[ クエリ情報 ] ダイアログが表示されます。
クエリにタグが適用されていない場合は、タグが表示されるテキストボックスに [タグを追加 ] と表示されます。新しいタグを作成するには、ボックスにタグを入力します。複数のタグを入力するには、エントリ間でタブを押します。
「保存」をクリックしてタグを適用し、ダイアログを閉じます。

タグの削除

クエリの横にあるケバブのコンテキストメニューをクリックし、[クエリ情報の編集] をクリックします。
削除するタグの [X ] をクリックします。
「保存」をクリックしてダイアログを閉じます。

クエリ結果の表示

クエリが実行されると、その下のウィンドウに結果が表示されます。 新しい結果表は、新しい照会に対して ON です。必要に応じて、ドロップダウンをクリックしてオフにします。このセクションの画像では、新しい結果表を使用します。

結果ウィンドウを使用して、クエリ結果を操作および探索できます。結果ウィンドウには、結果を探索するための次の機能が含まれています。

視覚化、フィルター、パラメーター

をクリックして、ビジュアリゼーション、フィルター、またはパラメーターを追加します。次のオプションが表示されます。

使用可能なオプションが表示されます。

視覚化: 視覚化は、結果セットを調べるのに役立ちます。使用可能なビジュアリゼーションタイプの完全なリストについては、「ビジュアリゼーションタイプ」を参照してください。

フィルター: フィルターを使用すると、クエリの実行後の結果セットを制限できます。フィルターを適用して、データのさまざまなサブセットを選択的に表示できます。フィルターの使用方法については、「クエリフィルター」を参照してください。

パラメーター: パラメーターを使用すると、実行時に値をクエリに置き換えて結果セットを制限できます。パラメーターの適用方法については、「クエリパラメーターの操作」を参照してください。

ダッシュボードの編集、ダウンロード、またはダッシュボードへの追加

重要

Databricks では、AI/BI ダッシュボード (旧称 Lakeview ダッシュボード) の使用を推奨しています。以前のバージョンのダッシュボード (以前は Databricks SQL ダッシュボードと呼ばれていました) は、 レガシダッシュボードと呼ばれるようになりました。 Databricks では、新しいレガシダッシュボードを作成することはお勧めしません。
移行ツールまたは REST API を使用して、従来のダッシュボードを変換します。組み込み移行ツールの使用手順については、「レガシーダッシュボードをAI/BI dashboardに複製する」を参照してください。REST API を使用したダッシュボードの作成と管理に関するチュートリアルについては、ダッシュボードのチュートリアルを参照してください。

クリックダウンキャレット結果タブでさらに多くのオプションを表示します。

[ 編集 ] をクリックして、ビジュアリゼーションに表示される結果をカスタマイズします。
結果タブを削除するには、 [削除] をクリックします。
結果タブを複製するには、 [複製] をクリックします。
[ ダッシュボードに追加 ] をクリックして、クエリと視覚化を新しいダッシュボードにコピーします。
- このアクションにより、クエリに関連付けられているすべての視覚化を含む新しいダッシュボードが作成されます。ダッシュボードの編集方法については、「ダッシュボード」を参照してください。
- 新しいダッシュボードの名前を選択するように求められます。新しいダッシュボードがホームフォルダーに保存されます。
- 既存のダッシュボードに結果を追加することはできません。
結果タブを新しいまたは既存のレガシーダッシュボードに追加するには、 [レガシーダッシュボードに追加] をクリックします。
ダウンロードオプションのいずれかをクリックして、結果をダウンロードします。詳細と制限については、次の説明を参照してください。

結果のダウンロード: 結果は、CSV、TSV、または Excel ファイルとしてダウンロードできます。

Databricks SQL から最大約 1 GB の結果データを CSV および TSV 形式でダウンロードし、最大 100,000 行を Excel ファイルにダウンロードできます。

1 GB の制限は、最終的なファイルのダウンロードよりも前のステップに適用されるため、最終的なファイルのダウンロードサイズは 1 GB よりわずかに多い場合もあれば小さい場合もあります。

注：

クエリをダウンロードできない場合は、ワークスペース管理者がワークスペースのダウンロードを無効にしています。

クエリー履歴

クエリの以前の実行 (完全なクエリ構文を含む) を表示できます。過去の実行は読み取り専用モードで開き、 新しいクエリに複製 または 編集を再開するボタンが含まれます。このタブには、スケジュールされた実行は表示されません。

結果を確認する

返されたクエリ結果は、クエリの下に表示されます。 [ Raw results ] タブには、返された行が入力されます。組み込みのフィルターを使用して、値を昇順または降順で並べ替えることができます。また、フィルターを使用して、特定の値を含む結果行を検索することもできます。

結果ウィンドウのタブを使用して、視覚化、フィルター、およびパラメーターを追加できます。

散布図データのビジュアリゼーションと、新しいビジュアリゼーション、フィルター、またはパラメーターを作成するオプション。

クエリウィンドウで保存されたクエリのリストをフィルタリングする

クエリウィンドウでは、作成したクエリのリスト(マイクエリ)、お気に入り、およびタグですべてのクエリのリストをフィルタリングできます。

更新の自動化

[スケジュール] ボタンを使用して、クエリ実行の自動頻度を設定できます。自動更新は、ダッシュボードとレポートを最新のデータで最新の状態に保つのに役立ちます。スケジュールされたクエリでは、値が指定されたしきい値に達したときに通知を送信する特殊な種類のスケジュールされたタスクである Databricks SQL アラートを有効にすることもできます。

「クエリのスケジュール」を参照してください。

「 Databricks SQL アラートとは」を参照してください。

次のステップ

Databricks UI でクエリを操作する方法については、「保存されたクエリへのアクセスと管理」を参照してください。