共用方式為

在 SQL 編輯器中撰寫查詢和探索資料

  • 發行項

Azure Databricks UI 包含 SQL 編輯器，可用來撰寫查詢、瀏覽可用的資料，以及建立視覺效果。 您也可以與工作區中的其他小組成員共用已儲存的查詢。 本文說明如何使用 SQL 編輯器來撰寫、執行和管理查詢。 新版本的 SQL 編輯器處於公開預覽狀態。 若要瞭解如何啟用及使用新的 SQL 編輯器，請參閱 使用新的 SQL 編輯器與同事共同作業。

SQL 編輯器 UI

開啟編輯器之後，您可以撰寫 SQL 查詢或瀏覽可用的資料。 文字編輯器支援自動完成、自動格式化和其他各種鍵盤快捷方式。

您可使用文字編輯器頂端的 [查詢] 索引標籤來開啟多個查詢。 每個查詢索引標籤都有執行查詢、將查詢標示為我的最愛，以及連線到 SQL 倉儲的控制項。 您也可 [儲存]、[排程] 或 [共享] 查詢。

開啟 SQL 編輯器

若要在 Azure Databricks UI 中開啟 SQL 編輯器，請按下側邊欄中的 SQL 編輯器圖示[SQL 編輯器]。

SQL 編輯器會開啟至您上次開啟的查詢。 如果沒有任何查詢存在，或已明確關閉所有查詢，就會開啟新的查詢。 它會自動命名為 [新增查詢]，並在標題中附加建立時間戳記。

連線至 Compute

您至少要具有執行中 SQL 倉儲的 CAN USE 權限，才能執行查詢。 您可以使用編輯器頂端附近的下拉式清單來查看可用的選項。 若要篩選清單，請在文字框中輸入文字。

SQL 倉儲選取器

第一次建立查詢時，可用的 SQL 倉儲清單會依字母順序顯示。 下次建立查詢時，會選取最後一個使用的 SQL 倉儲。

SQL 倉儲旁的圖示表示狀態：

  • 執行中 執行中
  • 啟動中 啟動中
  • 已停止 已停止

注意

如果清單中沒有 SQL 倉儲，請連絡您的工作區管理員。

當您執行查詢時，選取的 SQL 倉儲會自動重新啟動。 請參閱啟動 SQL 倉儲，以瞭解啟動 SQL 倉儲的其他方式。

在 SQL 編輯器中瀏覽資料物件

如果您有元數據讀取許可權，SQL 編輯器中的架構瀏覽器會顯示可用的資料庫和數據表。 您也可以透過 目錄總管瀏覽資料物件。

架構瀏覽器，其中顯示範例目錄、nyctaxi 資料庫、trips 數據表，以及該數據表中的數據行。

您可以在目錄總管中巡覽 Unity 目錄控管的資料庫物件，而不需使用中的計算。 要探索 hive_metastore 和其他不受 Unity Catalog 控管的目錄中的數據，您必須連接到具有適當權限的計算資源。 請參閱 Unity Catalog 中的資料控管。

注意

如果架構瀏覽器或目錄總管中沒有任何數據物件存在，請連絡您的工作區管理員。

點擊 [重新整理架構] 圖示 在架構瀏覽器頂端附近，以重新整理架構。 您可以在搜尋方塊中輸入篩選字串來篩選架構。

按兩下資料表名稱以顯示該資料表的數據列。

建立查詢

您可以在 SQL 編輯器中輸入文字來建立查詢。 您可以從架構瀏覽器插入元素，以參考目錄和資料表。

  1. 在 SQL 編輯器中輸入您的查詢。

    SQL 編輯器支援自動完成。 當您輸入時，自動完成會建議完成。 例如，如果游標位置的有效完成是一個列，則自動完成會建議列名稱。 如果您輸入 select * from table_name as t where t.，則自動完成功能會識別 t 是 table_name 的別名，並建議 table_name中的欄位。

    自動完成別名

  2. (選擇性) 當您完成編輯時，按下 [儲存]。 根據預設，查詢會儲存到您的用戶主資料夾，或者您可以選取不同的位置。 然後，按一下 [儲存]。

開啟和關閉自動完成

即時自動完成可以完成架構令牌、查詢語法識別碼（例如 SELECT 和 JOIN），以及 查詢片段的標題。 除非您的資料庫結構超過五千個欄位（資料表或欄位），否則預設會啟用此功能。

使用 SQL 編輯器下方的切換，以關閉或開啟即時自動完成。

  • 若要關閉即時自動完成，請按 [Ctrl + 空格] 鍵，或按下 SQL 編輯器下方的 自動完成啟用按鈕。

儲存查詢

SQL 編輯器右上方附近的 [儲存] 按鈕會儲存您的查詢。

重要

當您修改查詢但未明確按下 [儲存] 時，該狀態會保留為查詢草稿。 查詢草稿會保留 30 天。 30 天後，會自動刪除查詢草稿。 若要保留變更，您必須明確儲存這些變更。

編輯多個查詢

根據預設，SQL 編輯器會使用索引標籤，以便您同時編輯多個查詢。 若要開啟新的索引標籤，請按兩下 [+]，然後選取 [建立新的查詢 或 開啟現有的查詢。 按兩下 [開啟現有的查詢 以查看已儲存的查詢清單。 按兩下 [我的查詢] ，或 按兩下 [我的最愛] 來篩選查詢清單。 在包含您要檢視之查詢的資料列中，按下 [開啟]。

查詢對話方塊

執行單一查詢或多個查詢

若要執行查詢或所有查詢：

  1. 選取 SQL 倉儲。

  2. 在 SQL 編輯器中醒目提示查詢 (如果查詢窗格中有多個查詢)。

  3. 按 Ctrl/Cmd + Enter，或點擊 Run (1000)，以在結果窗格中將結果顯示為表格。

    查詢結果

注意

預設會在所有查詢中選取 限制 1000，以將查詢返回限制為 1000 列。 如果查詢是以 [限制 1000] 設定儲存，此設定將套用到所有的查詢執行中（包括在儀錶板中）。 若要傳回此查詢的所有數據列，您可以單擊 [執行 (1000)] LIMIT 下拉式清單，取消選取 1000。 如果您想要指定資料列數目的不同限制，您可以在查詢中新增具有您選擇的值 LIMIT 子句。

終止查詢

若要在執行時終止查詢，請按下 [取消]。 系統管理員可以藉由檢視終止執行中的查詢來停止另一位使用者啟動的執行查詢。

查詢選項

您可以使用查詢編輯器頂端附近的 Kebab 功能表kebab 特色選單來存取功能表選項，以複製、還原、格式化和編輯查詢資訊。

還原為已儲存的查詢

當您編輯查詢時，查詢的特色選單中會出現 [還原變更] 選項。 您可以按下 [還原]，傳回已儲存的版本。

捨棄和還原查詢

若要將查詢移至垃圾桶：

  • 點擊 SQL 編輯器中查詢旁的 kebab 操作選單 ，然後選取 [移至垃圾桶] 。
  • 按下 [移至垃圾桶] 以確認。

若要從垃圾桶還原查詢：

  1. 在 [所有查詢] 列表中，按兩下 [垃圾桶]。
  2. 按下查詢。
  3. 按下位於 SQL 編輯器右上方的 Kebab 操作選單 Kebab 選單，然後按下 [還原] 。

設定查詢描述和檢視查詢資訊

若要設定查詢描述：

  1. 按下查詢旁的 Kebab 功能表Kebab 特色選單，然後按下 [編輯查詢資訊]。

    內容功能表

  2. 在 [描述] 文字方塊中，輸入描述。 然後，按一下 [儲存]。 您也可以在此對話方塊中檢視查詢的歷程記錄，包括建立和更新查詢的歷程記錄。

我的最愛和標記查詢

您可以使用我的最愛和標籤來篩選工作區登陸頁面上，以及儀表板和查詢的每個清單頁面上顯示的查詢和儀表板。

[我的最愛]：若要將查詢設為我的最愛，請在 [查詢] 列表中按兩下標題左邊的星號。 星星會變成黃色。

標籤：您可以使用帶有任何有意義的字串標記查詢和儀表板給組織。

新增標籤

在查詢編輯器中新增標籤。

  1. 按下查詢旁的 Kebab 功能表Kebab 特色選單，然後按下 [編輯查詢資訊]。 [查詢資訊] 對話方塊隨即出現。

  2. 如果查詢未套用標籤，[新增一些標籤] 會顯示在標籤將顯示的文字框中。 若要建立新的標籤，請在方塊中輸入。 若要輸入多個標籤，請按項目之間的索引標籤。

    新增標記

  3. 按下 [儲存] 以套用標籤並關閉對話方塊。

拿掉標籤

  1. 按下查詢旁的 Kebab 功能表Kebab 特色選單，然後按下 [編輯查詢資訊]。
  2. 在任何要移除的標記上，按兩下 [X]。
  3. 按下 [儲存]關閉對話方塊。

檢視查詢結果

執行查詢之後，結果會出現在其下方的窗格中。 新結果數據表 對於新查詢 是開啟的。 如有必要，請按下下拉式清單將其關閉。 本節中的影像會使用新的結果數據表。

您可使用結果窗格來與查詢結果互動並探索查詢結果。 結果窗格包含下列功能以便探索結果：

視覺效果、篩選和參數

按下 加號 (+) 圖示以新增視覺效果、篩選或參數。 下列選項會出現：

顯示了可用的選項。

視覺效果：視覺效果可協助探索結果集。 如需可用視覺效果類型的完整清單，請參閱 視覺效果類型。

篩選：篩選可讓您在查詢執行之後限制結果集。 您可套用篩選來選擇性地顯示不同的資料子集。 請參閱查詢篩選，以瞭解如何使用篩選。

Parameter：參數可讓您藉由在運行時將值代入查詢來限制結果集。 請參閱 使用查詢參數 瞭解如何套用參數。

編輯、下載或新增至儀表板

重要

  • Databricks 建議使用 AI/BI 儀表板 (先前稱為 Lakeview 儀表板)。 舊版儀錶板，先前稱為 Databricks SQL 儀錶板，現在稱為 舊版儀錶板。 Databricks 不建議建立新的舊版儀表板。

終止支援時程表：

  • 2025 年 4 月 7 日：舊版儀錶板的官方支援將會結束。 只會解決重要的安全性問題和服務中斷問題。

  • 2025 年 11 月 3 日：Databricks 將開始封存過去六個月未存取的舊版儀錶板。 已封存的儀錶板將無法再存取，封存過程將會以循環方式進行。 已經在使用的儀錶板的存取權會保持不變。

    Databricks 將在 2025 年 11 月 3 日之後與客戶合作，開發現有舊版儀錶板的遷移計畫。

  • 使用移轉工具或 REST API 轉換舊版儀表板。 如需使用內建移轉工具的指示，請參閱將舊版儀表板複製到 AI/BI 儀表板。 如需使用 REST API 建立和管理儀表板的教學課程，請參閱 儀表板 教學課程。

按下 [結果] 索引標籤中的 向下插入點，以檢視更多選項。

自訂、下載結果及新增至儀表板的選項。

  1. 按下 [編輯] 以自訂視覺效果中顯示的結果。
  2. 按下 [刪除]以刪除結果索引標籤。
  3. 按下 [複製] 以複製結果索引標籤。
  4. 按下 [新增至儀表板] 將查詢和視覺效果複製到新的儀表板。
    • 此動作會建立新的儀表板，其中包含與查詢相關聯的所有視覺效果。 請參閱儀表板，以瞭解如何編輯您的儀表板。
    • 系統會提示您選擇新儀表板的名稱。 新的儀表板會儲存至主資料夾。
    • 您無法將結果新增至現有的儀表板。
  5. 按下 [新增至舊版儀表板]，將結果索引卷標新增至新的或現有的舊版儀表板。
  6. 按一下任何下載選項即可下載結果。 如需詳細資料和限制，請參閱下列描述。

下載結果：您可以將查詢結果下載為 CSV、TSV 或 Excel 檔案。

可以從 Databricks SQL 下載最多約 1GB 的 結果資料 (CSV 和 TSV 格式)，以及最多 100,000 個資料列到 Excel 檔案。

最終檔案下載大小可能略高於或小於 1GB，因為 1GB 限制會套用至比最終檔案下載還舊的步驟。

注意

如果您無法下載查詢，工作區管理員已停用工作區的下載。

過去的執行

您可檢視查詢的先前執行，包括完整的查詢語法。 過去的執行會以唯讀模式開啟，並包含 [複製到新查詢]或 [繼續編輯]的按鈕。 此索引標籤不會顯示排程的執行。

記錄會顯示每一次執行查詢，包括特定的查詢語法。

瀏覽結果

傳回的查詢結果會在查詢下方顯示。 [原始結果]索引標籤會填入傳回的資料列。 您可以使用內建篩選條件，藉由遞增或遞減值來重新排序結果。 您也可以使用篩選來搜尋包含特定值的結果資料列。

使用搜尋來篩選結果

您可以使用結果窗格中的索引標籤來新增視覺效果、篩選和參數。

數據的散佈圖視覺化，並提供建立新視覺化、篩選或參數的選項。

在查詢視窗中篩選已儲存的查詢清單

在查詢視窗中，您可以依您所建立的查詢清單來篩選所有查詢的清單（我的查詢）、我的最愛和標記。

自動更新

您可以使用 [排程] 按鈕來設定查詢執行的自動頻率。 自動更新可協助讓儀表板和報表掌握最新的資料。 排程查詢也可啟用 Databricks SQL 警示，這是一種特殊類型的排程工作，可在值達到指定的閾值時傳送通知。

請參閱<排程查詢>。

請參閱什麼是 Databricks SQL 警示？。

共用查詢

[共用]按鈕可讓您與工作區中的其他使用者共用查詢。 共用時，請在下列選項之間選擇 ：

  • 以擁有者身分執行（擁有者的認證）：此設定表示檢視者能夠看到與查詢擁有者相同的查詢結果。 這適用於排程或手動查詢執行。
  • 以查看器身分執行（檢視者認證）：此設定會將結果限製為檢視者的指派許可權。

請參閱<設定查詢權限>。

後續步驟

請參閱《存取和管理已儲存的查詢》，以瞭解如何使用 Azure Databricks UI 的查詢。