Azure Databricks 介面包含一個 SQL 編輯器，您可以使用它來撰寫查詢、與同事協作、尋找可用資料並建立視覺化。 本頁介紹了新的 SQL 編輯器，並連結到詳細介紹每個任務的頁面。
本頁介紹了新的 SQL 編輯器。 若要瞭解如何使用舊版 SQL 編輯器，請參閱 在舊版 SQL 編輯器中撰寫查詢和探索數據。
備註
自 2026 年 5 月底起，所有工作區將預設啟用新的 SQL 編輯器。 在工作區層關閉新 SQL 編輯器的功能將不再提供。 在此期間，個別使用者仍可切換至舊版編輯器。 自 2026 年 7 月底起，舊有的 SQL 編輯器將被淘汰，所有使用者將使用新的 SQL 編輯器。 請參閱《 即將推出 》以獲取更多詳情。
開啟 SQL 編輯器
要在Azure Databricks介面中開啟 SQL 編輯器，請點擊側邊欄的 
SQL Editor。
SQL 編輯器會開啟至您上次開啟的查詢。 如果沒有任何查詢存在，或已明確關閉所有查詢，SQL 編輯器登陸頁面就會開啟。
開啟新的SQL 編輯器
使用 [ 新增 SQL 編輯器] 切換開關，在目錄和架構下拉式選取器右邊，開啟新的編輯器。 在窄型顯示器上，您可以在目錄和架構選取器的右邊，按下 以找到 Kebab menu icon.新增 SQL 編輯器 的切換開關。
針對您擁有的任何查詢啟用新的編輯器。
- 按下 [新 SQL 編輯器：關閉]。 [c0] 新增 SQL 編輯器 [/c0] 快顯選單隨即開啟。
- 預設會勾選「套用至所有查詢」核取方塊。 保留此設定，以針對您擁有的所有查詢啟用編輯器。
- 若要只啟用該活躍查詢的新編輯器，請清除 「套用至所有查詢 」的勾選框。
- 將 [新增 SQL 編輯器] 切換為 [開啟]。
新的 SQL 編輯器無法用於所有查詢。 如果下列任一項成立，則無法切換至查詢的新 SQL 編輯器：
- 您不擁有該查詢的控制權。
- 此查詢包含不支持 的查詢型下拉式清單。 請參見使用命名參數標記。
當您開啟新的 SQL 編輯器時，您的查詢會在新的 UI 中重新開啟。 結果集是空的，直到您執行查詢為止。
備註
查詢結果會與所有共同作業者共用，且限制為64,000個數據列。
導覽
本節強調 UI 中的主要差異，並說明如何尋找和使用可用的功能。
- 開啟工作區檔案系統：你可以直接從 SQL 編輯器開啟並組織工作區物件。
- 使用整合的 Genie Code：與 Genie Code 聊天，協助你撰寫、精煉或理解查詢。 從側邊窗格執行由 Genie Code 產生的程式碼。
- 折疊程式碼區段：按下程式碼區塊左邊的折疊箭號，選擇性地隱藏和展開程式碼區段。 這可讓處理大型檔案變得更容易。
- 開啟命令選擇區：命令選擇區包含一般動作、鍵盤快速鍵、自定義主題和連結，以協助您快速找出您需要的項目。 開啟之後，請使用搜尋列來尋找特定工具和快速鍵。
- 在程式碼上註解：將註解新增至程式碼，以增強共同作業。
- 檢閱版本歷程記錄：檢閱查詢的最新變更。
使用 SQL 編輯器
以下頁面討論了你可以在新 SQL 編輯器中執行的主要任務：
| 任務 | 說明 |
|---|---|
| 撰寫查詢 | 連接運算、瀏覽資料資產及撰寫查詢。 |
| 執行並分享查詢 | 執行單句或多句查詢，分享並即時編輯。 |
| 查看查詢結果 | 探索、視覺化、下載並篩選查詢結果。 |
| 使用參數 | 使用命名參數並設定參數小工具。 |
| 自訂格式 SQL | 自訂 SQL 自動格式化選項。 |
| 鍵盤快速鍵 | 常見鍵盤快捷鍵參考。 |
複製舊有查詢 ID
要取得你遷移到新 SQL 編輯器的查詢的舊有查詢 ID，從 檔案 選單複製它。 舊版查詢 ID 對於參照該 ID 的 API 呼叫或其他整合作業可能會很有幫助。
- 在新的 SQL 編輯器中開啟查詢。
- 點擊編輯器頂端的烤
。 - 點擊 檔案>複製舊有查詢 ID。
停用新的 SQL 編輯器
備註
自 2026 年 5 月底起，新 SQL 編輯器的工作區層級退出功能將被移除。 個別使用者仍可切換至舊有編輯器，直到 2026 年 7 月底，舊有 SQL 編輯器將完全退役。 請參閱《 即將推出 》以獲取更多詳情。
要關閉新的 SQL 編輯器：
- 按下 [新增 SQL 編輯器：開啟]。 [c0] 新增 SQL 編輯器 [/c0] 快顯選單隨即開啟。
- 將 [新的 SQL 編輯器] 切換為 [OFF]。
- 在確認對話框中，選擇是只關閉該啟動查詢的新編輯器，或是關閉所有符合資格的查詢。
- 未選取 [停用所有符合條件的查詢] 。 如果你只想針對目前使用中的查詢停用新編輯器，請保留這項設定。
- 若要為所有查詢停用新的 SQL 編輯器，請選取核取方塊 為所有符合條件的查詢停用。
若要防止查詢在新的 SQL 編輯器中自動開啟：
- 在Azure Databricks工作區，點擊頂欄的使用者名稱，選擇Settings。
- 在左窗格的 使用者下，按一下 開發人員 標籤。
- 關閉 [建立並在 新的 SQL 編輯器中開啟所有符合資格的查詢]。
工作區系統管理員可以造訪預覽入口網站並搜尋 SQL 編輯器，在工作區層級關閉此功能。 請參見 管理Azure Databricks預覽。