Azure Databricks UI には、クエリの記述、同僚との共同作業、使用可能なデータの検索、視覚化の作成に使用できる SQL エディターが含まれています。 このページでは、新しい SQL エディターと、各タスクについて詳しく説明するページへのリンクを紹介します。
このページでは、新しい SQL エディターについて説明します。 従来の SQL エディターを使用する方法については、従来の SQL エディター でのクエリの記述とデータの探索に関するページを参照してください。
注
2026 年 5 月下旬以降、すべてのワークスペースに対して新しい SQL エディターが既定で有効になります。 ワークスペース レベルで新しい SQL エディターをオフにする機能は使用できなくなります。 この期間中も、個々のユーザーはレガシ エディターに切り替えることができます。 2026 年 7 月下旬以降、従来の SQL エディターは廃止され、すべてのユーザーは新しい SQL エディターを使用します。 詳細については、「 今後の予定」 を参照してください。
SQL エディターを開く
Azure Databricks UI で SQL エディターを開くには、サイドバーの 
SQL エディター をクリックします。
SQL エディターで最後に開いたクエリが表示されます。 クエリが存在しない場合、またはすべてのクエリが明示的に閉じられている場合は、SQL エディターのランディング ページが開きます。
新しい SQL エディターを有効にする
新しいエディターを有効にするには、カタログとスキーマのドロップダウン セレクターの右側にある [新しい SQL エディター] トグルを使用します。 狭い画面では、カタログとスキーマ セレクターの右側にある kebab メニューの をクリックすると、[Kebab menu icon.新しい SQL エディター] トグルが表示されます。
所有するすべてのクエリに対して新しいエディターを有効にします。
-
[新しい SQL エディター: オフ] をクリックします。
[新しい SQL エディター] ポップオーバー メニューが開きます。
- [すべてのクエリに適用する] チェック ボックスは既定でオンになっています。 自分が所有するすべてのクエリに対してエディターを有効にするには、この設定をそのままにします。
- アクティブなクエリに対してのみ新しいエディターを有効にするには、[ すべてのクエリに適用 ] チェックボックスをオフにします。
- [新しい SQL エディター] トグルを [オン] に設定します。
新しい SQL エディターをすべてのクエリに使用することはできません。 次のいずれかに該当する場合、クエリを新しい SQL エディターに切り替えることはできません。
- 自分が所有するクエリではありません。
- クエリには、サポートされていない クエリ ベースのドロップダウン リストが含まれています。 名前付きパラメーター マーカーの使用を参照してください。
新しい SQL エディターを有効にすると、クエリが新しい UI で開き直されます。 クエリを実行するまで、結果セットは空です。
注
クエリ結果はすべてのコラボレーターと共有され、64,000 行に制限されます。
オリエンテーション
このセクションでは、UI の主な違いを明らかにし、利用できる機能を見つけて使う方法について説明します。
- ワークスペース ファイル システムを開く: SQL エディターから直接ワークスペース オブジェクトを開いて整理できます。
- 統合された Genie Code: Genie Code とのチャットを使用して、クエリの作成、絞り込み、または理解に役立ちます。 Genie Code によって生成されたコードをサイド ウィンドウから実行します。
- コードのセクションを折りたたむ: コード ブロックの左側にある折りたたみ矢印をクリックして、選んだコード セクションを非表示にするか展開します。 これにより、大きなファイルの処理がいっそう容易になります。
- コマンド パレットを開く: コマンド パレットには、一般的な操作、キーボード ショートカット、カスタム テーマ、必要なものをすばやく見つけるのに役立つリンクが含まれています。 開いた後、検索バーを使って特定のツールとショートカットを探します。
- コードにコメントする: コードにコメントを追加して共同作業を円滑にします。
- バージョン履歴を確認する: クエリに対する最近の変更を確認します。
SQL エディターの操作
次のページでは、新しい SQL エディターで実行できる主なタスクについて説明します。
| Task | Description |
|---|---|
| クエリを記述する | コンピューティングに接続し、データ資産を参照し、クエリを作成します。 |
| クエリの実行と共有 | 単一または複数ステートメントのクエリを実行し、それらを共有し、リアルタイムでまとめて編集します。 |
| クエリ結果を表示する | クエリ結果の探索、視覚化、ダウンロード、フィルター処理を行います。 |
| パラメーターを使用する | 名前付きパラメーターを使用し、パラメーター ウィジェットを構成します。 |
| カスタム形式の SQL | SQL の自動書式設定オプションをカスタマイズします。 |
| キーボード ショートカット | 一般的なキーボード ショートカットのリファレンス。 |
レガシ クエリ ID をコピーする
新しい SQL エディターに移行したクエリのレガシ クエリ ID を取得するには、[ ファイル ] メニューからコピーします。 レガシ クエリ ID は、API 呼び出しや、それを参照する他の統合に役立ちます。
- 新しい SQL エディターでクエリを開きます。
- エディターの上部にあるケバブメニュー
をクリックします。 - ファイル>レガシ クエリ ID をコピーをクリックします。
新しい SQL エディターを無効にする
注
2026 年 5 月下旬以降、新しい SQL エディターのワークスペース レベルのオプトアウトは削除されます。 従来の SQL エディターが完全に廃止される 2026 年 7 月下旬まで、個々のユーザーはレガシ エディターに切り替えることができます。 詳細については、「 今後の予定」 を参照してください。
新しい SQL エディターをオフにするには:
- [新しい SQL エディター: オン] をクリックします。 [新しい SQL エディター] ポップオーバー メニューが開きます。
- [新しい SQL エディター] トグルを [オフ] に設定します。
- 確認ダイアログで、アクティブなクエリのみに対して新しいエディターをオフにするか、すべての対象クエリに対してオフにするかを選択します。
- [対象となるすべてのクエリで無効にする] はオフになっています。 アクティブなクエリに対してのみ新しいエディターをオフにする場合は、この設定を維持します。
- すべてのクエリの新しい SQL エディターをオフにするには、[すべての対象クエリに 対して無効にする] チェック ボックスをオンにします。
新しい SQL エディターでクエリが自動的に開かないようにするには:
- Azure Databricks ワークスペースで、上部のバーでユーザー名をクリックし、Settings を選択します。
- 左側のウィンドウの [ ユーザー] で、[ 開発 ] タブをクリックします。
- [Create and open all eligible queries in the new SQL editor]\(対象となるすべてのクエリを作成して新しい SQL エディターで開く\) をオフにします。
ワークスペース管理者は、プレビュー ポータルにアクセスして SQL エディターを検索することで、ワークスペース レベルでこの機能をオフにすることができます。 Manage Azure Databricks プレビューを参照してください。