在 KQL 查詢集中查詢數據

  • 發行項

在本文中，您將瞭解如何使用 KQL 查詢集。 KQL Queryset 是用來執行查詢、檢視及自定義 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 查詢集。

後續步驟

在 KQL 查詢集結果方格中自定義結果