共用方式為

在 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 權限，才能執行查詢。 您可以使用編輯器頂端附近的下拉式清單來查看可用的選項。 若要篩選 list，請在文字框中輸入文字。

SQL 倉儲選取器

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

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

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

注意

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

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

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

如果您有元資料讀取權限，SQL 編輯器中的 schema 瀏覽器會顯示可用的資料庫和 tables。 您也可以從 Catalog Explorer瀏覽資料物件。

schema 瀏覽器，其中顯示範例 catalog、nyctaxi 資料庫、table，以及該 table中的 columns。

您可以在 Catalog Explorer 中巡覽 Unity Catalog管理的資料庫物件，而不需要啟動計算運算。 若要探索不受 Unity Catalog控管的 hive_metastore 和其他 catalogs 中的數據，您必須連接到具有適當許可權的計算機。 請參閱 使用 Unity 進行的數據控管 Catalog。

注意

如果 schema 瀏覽器或 Catalog 檔案總管中不存在任何數據物件，請聯絡您的工作區管理員。

點擊靠近 schema 瀏覽器頂端的 RefreshSchema 圖示，以 refreshschema。 您可以在搜尋方塊中輸入篩選字串，以篩選 schema。

按兩下 table 名稱以顯示該 table的 columns。

建立查詢

您可以在 SQL 編輯器中輸入文字來建立查詢。 您可以在 schema 瀏覽器中 insert 元素，以參考 catalogs 和 tables。

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

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

    自動完成別名

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

開啟和關閉自動完成

即時自動完成可以完成 schema 標記、查詢語法識別符號（例如 SELECT 和 JOIN），以及 查詢片段的標題。 預設會啟用它，除非您的資料庫 schema 超過五千個令牌（tables 或 columns）。

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

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

儲存查詢

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

重要

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

編輯多個查詢

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

查詢對話方塊

執行單一查詢或多個查詢

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

  1. Select SQL 資料庫。

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

  3. 按 Ctrl/Cmd + Enter，或點擊 [執行] (1000)，以在結果窗格中將結果顯示為 table。

    查詢結果

注意

默認會選取 Limit 1000，讓所有查詢 limit 查詢傳回 1000 個數據列。 如果查詢是以 Limit 1000 設定儲存，此設定會套用至所有查詢執行（包括在儀錶板中）。 若要傳回此查詢的所有數據列，您可以單擊 [執行 (1000)] 下拉式清單，取消選取 LIMIT 1000。 如果您想在資料列的數目上指定不同的 limit，您可以在查詢中新增 LIMIT 子句，並設置您選擇的值。

終止查詢

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

查詢選項

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

還原為已儲存的查詢

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

捨棄和還原查詢

若要將查詢移至垃圾桶：

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

若要從垃圾桶 restore 查詢：

  1. 在 [所有查詢] list中，按兩下 [垃圾桶]。
  2. 按下查詢。
  3. 按一下 kebab 操作選單 Kebab 選單 在 SQL 編輯器右上角，然後按一下 [Restore]。

Set 查詢描述和檢視查詢資訊

若要 set 查詢描述：

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

    內容功能表

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

我的最愛和標記查詢

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

我的最愛：若要將查詢設為我的最愛，請按一下查詢 list中標題左邊的星形圖示。 星星會變成黃色。

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

新增標籤

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

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

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

    新增標記

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

Remove 標籤

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

檢視查詢結果

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

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

視覺效果、篩選器和 parameters

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

顯示了可用的選項。

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

Filter：篩選器允許您在執行查詢後 limit 結果 set。 您可套用篩選來選擇性地顯示不同的資料子集。 請參閱查詢篩選，以瞭解如何使用篩選。

參數：Parameters 允許您在執行時，將查詢中的 values 替換來 limit 結果 set。 為了解如何套用 parameters，請參閱 並使用查詢 parameters 。

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

重要

  • 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 limit是在較早的步驟中套用的，而非在最終檔案下載時。

注意

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

過去的執行

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

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

瀏覽結果

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

使用搜尋來篩選結果

您可以使用結果窗格中的頁籤來新增視覺效果、篩選和 parameters。

數據散佈圖視覺效果的可視化，並可選擇建立新視覺效果、篩選或 parameters。

在查詢 window 中篩選已儲存查詢的 list

在查詢 window中，您可以依您所建立的查詢 list 篩選所有查詢的 list（我的查詢]、依我的最愛和標記。

自動更新

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

請參閱<排程查詢>。

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

共用查詢

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

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

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

後續步驟

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