KQL 查詢集中的查詢資料。

在本文中,您將瞭解如何使用 KQL 查詢集。 KQL 查詢集是用於對 KQL 資料庫中的資料執行查詢、檢視和自訂查詢結果的項目。

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

必要條件

選取資料庫

查詢會在資料庫的內容中執行。 您可以隨時變更相關聯的資料庫,並保留儲存在查詢編輯器中的查詢。 您可以將 KQL 查詢集與來自 Azure 資料總管叢集的 KQL 資料庫或資料庫產生關聯。

選取對應至所需資料庫類型的索引標籤。

  1. 開啟您的 KQL 查詢集

  2. 在 [資料庫] 底下,選取 [V] 以展開 [資料庫連線] 功能表。

    顯示已連線資料庫清單的資料庫功能表螢幕擷取畫面。

  3. 在 [聯機來源] 底下,選取 [OneLake 資料中樞]。

  4. 出現的 OneLake 資料中樞 視窗中,選取 KQL 資料庫,然後選取 [ 選取]。

    OneLake 資料中樞視窗的螢幕擷取畫面,其中顯示選取的 KQL 資料庫。

與此資料庫相關聯的資料表清單會出現在資料庫名稱下方。

撰寫查詢

現在您已連線到資料源,您可以對此資料執行查詢。 KQL 查詢集會使用 Kusto 查詢語言 (KQL) 從您有權存取的任何資料庫查詢資料。 若要深入瞭解 KQL,請參閱 Kusto 查詢語言概觀

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

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

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

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

    KQL 查詢集的螢幕擷取畫面,其中顯示查詢的結果。查詢和結果窗格都會反白顯示。

管理查詢集索引標籤

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

在 KQL 查詢集中編輯索引標籤的選項螢幕擷取畫面。

  • 重新命名索引標籤:選取 索引標籤名稱旁的鉛筆圖示
  • 新增索引標籤:選取現有索引標籤+右側的加號。 不同的索引標籤可以連線到不同的資料庫。
  • 變更現有的資料庫連接:在 [資料庫] 底下,選取現有的資料庫連線以開啟資料中樞。

複製查詢

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

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

  2. 選取 [ 複製查詢]。

    KQL 查詢集 [管理] 索引標籤的螢幕擷取畫面,其中顯示複製查詢或查詢結果選項的下拉式清單。

    下表概述如何共用查詢的許多選項。

    重要

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

    動作 描述
    複製查詢 複製查詢文字。
    連結到剪貼簿 複製可用來執行查詢的深層連結。
    連結和查詢至剪貼簿 複製可用來執行查詢和查詢文字的連結。
    將、查詢和結果連結至剪貼簿 複製可用來執行查詢、查詢文字和查詢結果的連結。
    複製結果 複製查詢結果。
  3. 從上表選取所需的共享動作。

  4. 將此資訊貼到任何編輯器中,例如Microsoft Word。

將查詢資料匯出為 CSV

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

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

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

    KQL 查詢集 [首頁] 索引標籤的螢幕擷取畫面,其中顯示將結果匯出至 CSV 的醒目提示選項。

  2. 選取 [ 將結果匯出至 CSV]。

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

刪除 KQL 查詢集

若要刪除 KQL 查詢集:

  1. 選取您的 KQL 查詢集相關聯的工作區。

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

    Microsoft Fabric 工作區顯示如何刪除 KQL 查詢集的螢幕擷取畫面。

後續步驟