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 エディターのスキーマブラウザーに使用可能なデータベースとテーブルが表示されます。 カタログエクスプローラからデータオブジェクトを参照することもできます。
Unity Catalog で管理されるデータベース オブジェクトは、アクティブなコンピュートなしで Catalog Explorer で移動できます。 Unity Catalogによって管理されていないhive_metastoreおよびその他のカタログ内のデータを探索するには、適切な権限でコンピュートにアタッチする必要があります。データガバナンス 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 エディタはタブを使用するため、複数のクエリを同時に編集できます。 新しいタブを開くには、[ + ] をクリックし、[ 新しいクエリを作成 ] または [ 既存のクエリを開く ] を選択します。 [ 既存のクエリを開く ] をクリックして、保存したクエリの一覧を表示します。 [ マイクエリ] または [お気に入り ]をクリックして、クエリのリストをフィルタリングします。 表示するクエリが含まれている行で、[ 開く ] をクリックします。
1 つまたは複数のクエリを実行する
クエリまたはすべてのクエリを実行するには:
-
SQLウェアハウスを選択します。
-
SQL エディターでクエリを強調表示します (クエリ ペインに複数のクエリがある場合)。
-
Ctrl/Cmd + Enter を押すか、 実行 (1000) をクリックして、結果を結果ペインにテーブルとして表示します。
Limit 1000 は、クエリの戻り値を 1000 行に制限するために、すべてのクエリに対してデフォルトで選択されます。クエリが [制限 1000 ] 設定で保存されている場合、この設定はすべてのクエリ実行 (ダッシュボードを含む) に適用されます。 このクエリのすべての行を返すには、[ 実行 (1000)] ドロップダウンをクリックして [LIMIT 1000 ] の選択を解除します。行数に別の制限を指定する場合は、選択した値を使用してクエリに LIMIT 句を追加できます。
クエリの終了
クエリの実行中にクエリを終了するには、[ キャンセル] をクリックします。 管理者は、 実行中のクエリを終了するを表示することで、別のユーザーが開始した実行中のクエリを停止できます。
クエリオプション
クエリエディタの上部にある 
ケバブのコンテキストメニューを使用して、クエリ情報のクローン作成、元に戻す、フォーマット、および編集を行うメニューオプションにアクセスできます。
保存したクエリに戻す
クエリを編集すると、クエリのコンテキスト メニューに [変更を元に戻す ] オプションが表示されます。 [元に戻す ] をクリックすると、保存したバージョンに戻ることができます。
クエリの破棄と復元
クエリをごみ箱に移動するには:
- SQL エディターでクエリの横にあるケバブのコンテキスト メニュー をクリックし、[ ごみ箱に移動 ] を選択します。
- [ ゴミ箱に移動 ] をクリックして確定します。
ごみ箱からクエリを復元するには:
- すべてのクエリリストで、をクリックします
。 - クエリをクリックします。
- SQL エディターの右上にあるケバブのコンテキスト メニュー をクリックし、[ 復元] をクリックします。
クエリの説明を設定し、クエリ情報を表示する
クエリの説明を設定するには:
-
クエリの横にある
ケバブのコンテキストメニューをクリックし、[ クエリ情報の編集 ] をクリックします。
-
説明テキストボックスに 、説明を入力します。 次に、[ 保存 ] をクリックします。 このダイアログでは、クエリの作成日や更新日などの履歴を確認することもできます。
お気に入りクエリとタグクエリ
お気に入りとタグを使用して、ワークスペース ランディングページに表示されるクエリとダッシュボードのリスト、およびダッシュボードとクエリの各リストページに表示されるクエリとダッシュボードのリストをフィルタリングできます。
お気に入り : クエリをお気に入りに追加するには、[クエリ] リストでタイトルの左側にある星をクリックします。 星が黄色に変わります。
タグ : クエリとダッシュボードに、組織に対して意味のある任意の文字列をタグ付けできます。
タグを追加する
クエリエディタでタグを追加します。
-
クエリの横にある
ケバブのコンテキストメニューをクリックし、[ クエリ情報の編集 ] をクリックします。 [クエリ情報 ] ダイアログが表示されます。 -
クエリにタグが適用されていない場合は、タグが表示されるテキスト ボックスに [ タグを追加 ] が表示されます。 新しいタグを作成するには、ボックスにタグを入力します。 複数のタグを入力するには、エントリ間でタブを押します。
-
「保存 」をクリックしてタグを適用し、ダイアログを閉じます。
タグの削除
- クエリの横にある ケバブのコンテキストメニューをクリックし、[ クエリ情報の編集 ] をクリックします。
- 削除するタグの [X ] をクリックします。
- [保存 ] をクリックしてダイアログを閉じます。
クエリ結果の表示
クエリが実行されると、その下のペインに結果が表示されます。 新しい結果テーブル は、新しいクエリに対して オン になります。必要に応じて、ドロップダウンをクリックしてオフにします。 このセクションのイメージでは、新しい結果テーブルを使用します。
結果ペインを使用して、クエリ結果を操作したり、探索したりできます。 結果ペインには、結果を探索するための次の機能が含まれています。
視覚化、フィルター、パラメーター
をクリックして、ビジュアリゼーション、フィルター、またはパラメーターを追加します。次のオプションが表示されます。
視覚化 : 視覚化は、結果セットの調査に役立ちます。 使用可能な視覚化タイプの完全なリストについては 、視覚化タイプ を参照してください。
フィルター : フィルターを使用すると、クエリの実行後に結果セットを制限できます。 フィルターを適用して、データのさまざまなサブセットを選択的に表示できます。 フィルターの使い方については、「クエリフィルター」を参照してください。
パラメーター : パラメーターを使用すると、実行時に値をクエリに置き換えて結果セットを制限できます。 パラメーターの適用方法については、「 クエリ パラメーターの操作 」を参照してください。
ダッシュボードの編集、ダウンロード、またはダッシュボードへの追加
- Databricks では、AI/BI ダッシュボード (旧称 Lakeview ダッシュボード) の使用を推奨しています。 以前のバージョンのダッシュボード (以前は Databricks SQL ダッシュボードと呼ばれていました) は、 レガシ ダッシュボード と呼ばれるようになりました。 Databricks では、新しいレガシ ダッシュボードを作成することはお勧めしません。
サポート終了のタイムライン :
-
2025 年 4 月 7 日 : 従来のバージョンのダッシュボードの公式サポートが終了します。 重大なセキュリティ問題とサービスの停止のみが対処されます。
-
2025 年 11 月 3 日: Databricks は、過去 6 か月間アクセスされていないレガシーダッシュボードのアーカイブを開始します。 アーカイブされたダッシュボードにはアクセスできなくなり、アーカイブプロセスはローリングベースで行われます。 アクティブに使用されているダッシュボードへのアクセスは変更されません。
Databricks は、2025 年 11 月 3 日以降にアクティブなレガシ ダッシュボードの移行計画を策定するために、顧客と協力します。
-
移行ツールまたは REST API を使用して、従来のダッシュボードを変換します。 組み込み移行ツールの使用手順については、「レガシーダッシュボードをAI/BI dashboardに複製する」を参照してください。REST API を使用したダッシュボードの作成と管理に関するチュートリアルについては 、ダッシュボードのチュートリアル を参照してください。
結果タブの 
をクリックすると、その他のオプションが表示されます。
-
[編集 ] をクリックして、ビジュアライゼーションに表示される結果をカスタマイズします。
-
[削除 ] をクリックして、結果タブを削除します。
-
「複製」 をクリックして、結果タブを複製します。
-
[ ダッシュボードに追加 ] をクリックして、クエリとビジュアリゼーションを新しいダッシュボードにコピーします。
- このアクションにより、クエリに関連付けられているすべての視覚化を含む新しいダッシュボードが作成されます。 ダッシュボードの編集方法については、 ダッシュボード を参照してください。
- 新しいダッシュボードの名前を選択するように求められます。 新しいダッシュボードがホームフォルダーに保存されます。
- 既存のダッシュボードに結果を追加することはできません。
-
[ レガシーダッシュボードに追加 ] をクリックして、結果タブを新規または既存のレガシーダッシュボードに追加します。
-
ダウンロードオプションのいずれかをクリックして、結果をダウンロードします。 詳細と制限については、次の説明を参照してください。
結果のダウンロード : 結果を CSV、TSV、または Excel ファイルとしてダウンロードできます。
Databricks SQL から最大 1 GB の結果データを CSV および TSV 形式でダウンロードでき、Excel ファイルには最大 100,000 行までダウンロードできます。
最終的なファイルのダウンロード サイズは、最終的なファイル ダウンロードよりも前のステップに 1 GB の制限が適用されるため、1 GB よりわずかに大きい場合と小さい場合があります。
クエリをダウンロードできない場合は、ワークスペース管理者がワークスペースのダウンロードを無効にしています。
過去の処刑
クエリの以前の実行 (完全なクエリ構文を含む) を表示できます。 過去の実行は読み取り専用モードで開き、[ 新しいクエリに複製] または [編集を再開] のボタンが含まれています。 このタブには、 スケジュールされた実行は表示されません。
結果を調べる
返されたクエリ結果は、クエリの下に表示されます。 [Raw results ] タブには、返された行が入力されます。組み込みフィルターを使用して、昇順または降順の値で結果を並べ替えることができます。 また、フィルターを使用して、特定の値を含む結果行を検索することもできます。
結果ペインのタブを使用して、ビジュアリゼーション、フィルター、およびパラメーターを追加できます。
クエリウィンドウで保存したクエリのリストをフィルタリングする
クエリ ウィンドウでは、作成したクエリのリスト ( マイ クエリ )、お気に入り、およびタグですべてのクエリのリストをフィルタリングできます。
更新の自動化
[スケジュール ] ボタンを使用して、クエリ実行の自動周期を設定できます。自動更新により、ダッシュボードとレポートを最新のデータで最新の状態に保つことができます。 スケジュールされたクエリでは、値が指定されたしきい値に達したときに通知を送信する特別な種類のスケジュールされたタスクである Databricks SQL アラートを有効にすることもできます。
「クエリのスケジュール設定」を参照してください。
「Databricks SQL アラートとは」を参照してください。
クエリの共有
[共有 ] ボタンを使用すると、ワークスペース内の他のユーザーとクエリを共有できます。共有する場合は、次のオプションから選択します。
- 所有者として実行 (所有者の資格情報): この設定は、閲覧者がクエリ所有者と同じクエリ結果を表示できることを意味します。 これは、スケジュールされたクエリ実行または手動クエリ実行に適用されます。
- 閲覧者として実行 (閲覧者の認証情報): この設定では、閲覧者に割り当てられた権限に結果が制限されます。
「クエリのアクセス許可を構成する」を参照してください。
次のステップ
Databricks UI でクエリを操作する方法については、「 保存されたクエリへのアクセスと管理 」を参照してください。