分享方式：

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

  • 文章

Azure Databricks UI 包含 SQL 編輯器，可用來撰寫查詢、瀏覽可用資料，以及建立視覺效果。 您也可與工作區中的其他小組成員共用已儲存的查詢。

SQL 編輯器 UI

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

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

開啟 SQL 編輯器

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

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

連線到計算

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

SQL 倉儲選取器

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

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

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

注意

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

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

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

如果您有中繼資料讀取權限，SQL 編輯器中的結構描述瀏覽器會顯示可用的資料庫和資料表。 您也可以從目錄總管瀏覽資料物件。

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

您可以在目錄總管中瀏覽 Unity Catalog 控管的資料庫物件，而無需作用中的計算。 若要探索不受 Unity Catalog 控管之 hive_metastore 和其他目錄中的資料，您必須連結至具有適當權限的計算。 請參閱使用 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]，或按下 [執行 (1000)]，將結果顯示為結果窗格中的資料表。

    查詢結果

注意

預設會選取限制 1000，讓所有查詢將查詢傳回限制為 1000 個資料列。 如果以 [限制 1000] 設定儲存查詢，此設定會套用至所有查詢執行 (包含在儀表板中)。 若要傳回此查詢的所有資料列，您可以按下 [執行 (1000)] 下拉式清單，取消選取 [限制 1000]。 如果您要針對資料列數目指定不同的限制，可以在查詢中新增 LIMIT 子句，並使用您選擇的值。

終止查詢

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

查詢選項

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

還原為儲存的查詢

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

捨棄和還原查詢

若要將查詢移至垃圾桶：

  • 按下 SQL 編輯器中查詢旁的 Kebab 特色選 Kebab 功能表，然後選取 [移至垃圾桶]。
  • 按下 [移至垃圾桶] 以確認。

若要從垃圾桶還原查詢：

  1. 在 [所有查詢] 清單中，按下 資源回收筒。
  2. 按下查詢。
  3. 按下 SQL 編輯器右上方的 Kebab 特色選單 Kebab 功能表，然後按下 [還原]。

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

若要設定查詢描述：

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

    內容功能表

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

我的最愛與標記查詢

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

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

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

新增標籤

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

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

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

    新增標記

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

移除標記

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

檢視查詢結果

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

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

視覺效果、篩選和參數

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

顯示了可用的選項。

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

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

參數：參數可讓您藉由在執行階段將值取代為查詢，以限制結果集。 請參閱使用查詢參數，以了解如何套用參數。

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

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

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

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

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

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

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

注意

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

過去的執行

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

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

瀏覽結果

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

使用搜尋來篩選結果

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

具有建立新視覺效果、篩選或參數之選項的資料散佈圖視覺效果。

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

在 [查詢] 視窗中，您可以依所建立的查詢清單 (我的查詢)、我的最愛和標籤來篩選所有查詢的清單。

自動更新

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

請參閱排程查詢。

請參閱什麼是 Azure SQL Database 警示？。

共用查詢

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

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

請參閱設定查詢權限。

後續步驟

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