KQL 查詢集中的查詢資料。

在本文中，您將瞭解如何使用 KQL 查詢集。 KQL Queryset 是用來執行查詢、檢視和自定義不同數據源數據的查詢結果的專案，例如 Eventhouse、KQL 資料庫等等。

KQL 查詢集使用 Kusto 查詢語言來建立查詢，並且還支援許多 SQL 函數。 如需查詢語言的詳細資訊，請參閱 Kusto 查詢語言概觀。

必要條件

• 工作區，具有已啟用 Microsoft Fabric 的容量
• 具有編輯權限和資料的 KQL 資料庫，或是具有 AllDatabaseAdmin 權限的 Azure 資料總管叢集和資料庫。

選取數據源

查詢會在數據來源的情境下執行。 您可以隨時變更相關聯的數據源，並保留儲存在查詢編輯器中的查詢。 您可以將 KQL 查詢集與不同類型的多個數據源產生關聯，包括 KQL 資料庫或來自 Azure 數據總管叢集的數據源。

選取對應至所需數據源類型的索引標籤。

KQL 資料庫

1. 開啟您的 KQL 查詢集。

2. 在查詢頁面左側的窗格中，在 [總管] 和搜尋列底下，使用資料庫切換器展開資料來源連線選單。

   

3. 選取 新增數據源，然後選取 OneLake 數據中樞。

4. 在 出現的 OneLake 數據中樞 視窗中，選取要連線至 KQL 查詢集的 KQL 資料庫，然後選取 [ 連線]。 或者，關閉 [OneLake 數據中樞] 視窗，並使用 [+ 新增數據源] 功能表連接到不同的數據源。

Azure 資料總管叢集

1. 開啟您的 KQL 查詢集。

2. 在查詢頁面左側的窗格中，在 [總管] 和搜尋列底下，使用資料庫切換器展開數據源連線功能表。

   

3. 選取 新增數據源，然後選取 Azure 數據總管。

4. 在 [連線 URI] 下，輸入叢集 URI。

   若要尋找連線 URI，請移至 Azure 入口網站 中的叢集資源。 連線 URI 是概觀中找到的 URI。 若要新增免費範例叢集，請指定「輔助說明」作為連線 URI。

   

5. 在 [資料庫] 下，選取下拉功能表以展開叢集中的數據源清單，然後選取數據源。

6. 選取 Connect。

與此數據源相關聯的數據表清單會出現在數據源名稱下方。

撰寫查詢

現在您已連線到資料源，您可以對此資料執行查詢。 KQL 查詢集使用 Kusto 查詢語言（KQL）來查詢您有權限存取的任何數據源中的數據。 若要深入了解 KQL，請參閱 Kusto 查詢語言概觀。

下列範例會使用 在 https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv公開提供的資料。

1. 在 KQL 查詢集頂端窗格中寫入或複製查詢。

2. 選取執行或按 Shift+Enter 以執行查詢。

   產生的查詢輸出會顯示在結果方格中，其會出現在查詢窗格下方。 請注意綠色檢查，指出查詢已順利完成，以及用來計算查詢結果的時間。

   

與數據源互動

資料來源瀏覽器允許您在連接到所處查詢集標籤頁的資料來源之間進行切換。

在 [數據源總管] 窗格頂端，在 [總管] 底下 您可以使用搜尋列來搜尋特定數據源。 您也可以使用搜尋列下方的資料庫開關來展開資料來源連線選單。 選取您想要使用的資料來源。 如果標籤名稱先前尚未編輯，它會自動命名為資料來源。

數據源瀏覽器窗格有兩個部分。 上方區段會列出數據源中的所有專案，而下一節會顯示查詢集中的所有可用數據源。

數據源中的項目

數據源瀏覽器的上半部分會顯示您正在使用的數據源中包含的所有項目。

• 表格
• 具體化檢視
• 快捷方式
• 功能

選取您要展開的項目左邊的箭頭 >。 您可以選取後續清單層級中專案左邊 > 箭號，向下切入以顯示更多詳細數據。 例如，在 [數據表]下，選取數據表左邊的箭號 >，以顯示該數據表中的數據行清單。

若要開啟動作功能表，請將滑鼠停留在展開清單中的項目上方，然後選取 [其他動作] 功能表 [...]。選單會顯示下列選項：

• 重新整理資料庫
• 檢視資料概要
• 插入：建立和複製腳本
• 取得數據：新增數據源
• 建立儀錶板
• 刪除資料表

不同的動作適用於不同的項目類型。

可用的數據源

數據源瀏覽器的下方區域顯示新增至查詢集的所有可用數據源。

若要開啟動作功能表，請將滑鼠停留在資料來源名稱上，然後選取 更多動作 選單[...]。選單會顯示下列選項：

• 重新整理資料庫
• 使用此資料庫：在目前標籤頁切換至使用此資料來源
• 新索引標籤中的查詢：在查詢集中的新索引標籤中開啟此數據源
• 拿掉來源：移除該數據源中的所有資料庫
• 拿掉資料庫：僅移除選取的資料庫

複製查詢

您可能想要複製並分享您所建立的查詢。

1. 在查詢視窗頂部，選取 首頁 索引標籤。

2. 在查詢窗格中，選取 [ 複製查詢]。

   

   下表概述如何複製查詢的許多選項。

   動作	描述
   複製查詢	複製查詢文字。
   連結到剪貼簿	複製可用來執行查詢的深層連結。
   連結和查詢至剪貼簿	複製可用來執行查詢和查詢文字的連結。
   將、查詢和結果連結至剪貼簿	複製可用來執行查詢、查詢文字和查詢結果的連結。
   複製結果	複製查詢結果。

3. 從清單中選取所需的動作。

4. 貼上這些資訊以進行編輯或分享，例如在 Microsoft Word、Microsoft Teams 或 Microsoft Outlook。

   重要

   接收查詢連結的用戶必須具有基礎資料的檢視權限，才能執行查詢和檢視結果。

管理查詢集索引標籤

在 KQL 查詢集中，您可以建立多個索引標籤。 每個索引標籤都可以與不同的 KQL 資料庫產生關聯，並允許您儲存查詢以供日後使用或與其他人共用以共同作業進行資料探索。 您也可以變更與任何索引標籤相關聯的 KQL 資料庫，讓您對不同資料庫中的數據執行相同的查詢。

您可以透過下列方式管理索引標籤：

• 變更現有的資料來源連線：在 [瀏覽器] 和搜尋列底下，使用資料庫切換器展開資料來源連線功能表。
• 重新命名索引標籤：在索引標籤名稱旁，選取 鉛筆圖示。
• 新增索引標籤：在命令行中現有索引標籤的右邊，選取加號 +。 不同的索引標籤可以連線到不同的數據源。
• 更多動作：在命令行右側，有一個索引標籤表有更多動作來管理查詢集中的多個索引標籤。
• 變更索引標籤位置：使用拖放手勢。

將查詢資料匯出為 CSV

您也可以匯出查詢結果，而不是直接複製貼上查詢輸出。

這是導出包含查詢結果的 CSV 檔案的一次性方法。

1. 在查詢視窗頂部，選取 首頁 索引標籤。

   

2. 在查詢窗格中，選取 [ 導出至 CSV]。

3. 將 CSV 檔案儲存在本機。

刪除 KQL 查詢集

若要刪除 KQL 查詢集：

1. 選取 KQL 查詢集所在的工作區。

2. 將滑鼠停留在您想要刪除的 KQL 查詢集上。 選取 [更多[...]]，然後選取 [ 刪除]。

   

後續步驟

在 KQL 查詢集結果方格中自訂結果