共用方式為

教學：使用 Kqlmagic 配合 Fabric 筆記本查詢 KQL 資料庫

網狀架構筆記本可讓您建立及共用包含即時程序代碼、方程式、視覺效果和敘事文字的檔。 它適用於各種工作，例如數據清理和轉換、數值模擬、統計模型、數據視覺效果和機器學習。

Kqlmagic 會擴充 Fabric 筆記本中 Python 核心的功能，讓您可以從筆記本數據格原生執行 Kusto 查詢語言 （KQL） 查詢。 您可以將 Python 和 KQL 結合使用，並利用與 呈現 運算元整合的功能強大的 Plotly 庫來查詢和可視化數據。

如需筆記本的更多資訊，請參閱如何使用 Microsoft Fabric 筆記本。

在本教學課程中，您將瞭解如何使用 Kqlmagic 從 KQL 資料庫中的數據執行進階查詢和視覺效果。 它會在 Real-Time Intelligence 和 Microsoft Fabric 中的數據工程環境中使用預先建立的數據集和筆記本。

在本教學課程中，您將瞭解如何：

  • 建立 KQL 資料庫
  • 取得資料
  • 使用 Kqlmagic 匯入筆記本
  • 執行筆記本程式

先決條件

1.建立 KQL 資料庫

在此步驟中，您會在工作區或現有的 Eventhouse 中建立名為 NYCTaxiDB 的空白 KQL 資料庫。

  1. 從左側導覽列選取您的工作區。

  2. 請遵循下列其中一個步驟來開始建立 KQL 資料庫：

    • 選取 新增項目 然後 Eventhouse。 在 [Eventhouse 名稱 ] 字段中，輸入 NYCTaxiDB，然後選取 [ 建立]。 KQL 資料庫會以相同的名稱建立。
    • 在現有的 eventhouse 中，選取 資料庫。 在 [KQL 資料庫 ] 下，選取 +[ KQL 資料庫名稱 ] 字段中，輸入 NYCTaxiDB，然後選取 [ 建立]。

  3. 選取 NYCTaxiDB 資料庫，展開 [ 資料庫詳細數據]，複製 [查詢 URI ]，並將它貼到某處，例如記事本，以供稍後步驟使用。

    資料庫詳細資料卡片的螢幕擷取畫面，顯示資料庫的詳細資料。標題為 [複製 URI] 的 [查詢 URI] 選項會反白顯示。

2.取得數據

在此步驟中，您會使用腳本用於先建立具有指定對應的資料表，接著從公用 Blob 中獲取數據輸入到此資料表。

  1. 從 GitHub 上的網狀架構範例存放庫複製 KQL 腳本

    GitHub 存放庫的螢幕快照，其中顯示 NYC 計程車範例筆記本的 KQL 腳本。複製圖示已被反白顯示。

  2. 瀏覽至您的 KQL 資料庫。

  3. 選取 程式碼查詢以在 NYCTaxiDB_queryset 中開啟空白標籤頁。

  4. 貼上步驟 1 中的 KQL 腳本。 然後選取 [ 執行] 按鈕。

    第一個查詢會建立數據表和架構對應。 此查詢的輸出會顯示資料表和對應建立資訊，包括命令類型，以及當操作完成時的結果狀態為 完成。 第二個查詢會載入您的數據。 數據載入可能需要幾分鐘的時間才能完成。

    查詢集視窗的螢幕快照，其中顯示數據表對應和數據擷取的完整狀態。

  5. 重新整理查詢集並選取 [ 數據表 ]，以查看名為 trips2 的新建立數據表概觀。 您可以從這裡展開數據表架構、預覽數據，以及檢視查詢深入解析。

    「表格」索引標籤的螢幕快照，顯示「trips2」資料表。

3.下載 NYC 計程車示範筆記本

使用範例筆記本來查詢和可視化您在 KQL 資料庫中載入的範例數據。

  1. 在 GitHub 上開啟 Fabric 範例存放庫，並下載 NYC 計程車 KQL Notebook。。

    顯示 NYC 計程車演示筆記本的 GitHub 儲存庫螢幕快照。標題為 Raw 的選項已被反白。

  2. 請將筆記本下載至您的本機裝置。

    備註

    筆記本必須以 .ipynb 檔格式儲存。

4.匯入筆記本

此工作流程的其餘部分會使用 Kqlmagic 來查詢和可視化 KQL 資料庫中的數據。

  1. 在您的工作區中，選取 [從這部計算機><]。

    Data Engineering 中項目選項的螢幕快照。標題為 [匯入筆記本] 的項目已標示。

  2. 在 [ 匯入狀態 ] 窗格中，選取 [ 上傳]。

    新開啟 Postman 視窗的螢幕擷取畫面。已醒目提示 [匯入] 按鈕。

  3. 選取您在 步驟 3 中下載的 NYC 計程車 KQL Notebook。

  4. 匯入完成後，請選取 [移至工作區] ，然後開啟此筆記本。

    上傳成功完成並移至工作區的螢幕快照。

5.執行筆記本

選取 播放 按鈕以循序執行每個儲存格，或選取儲存格，然後按 Shift+ Enter。 針對每個套件重複此步驟。

備註

等候完成複選標記出現，再執行下一個單元格。

顯示匯入命令的儲存格區塊的螢幕截圖。播放按鈕被突出顯示。

循序執行其餘儲存格，以建立 NYC 計程車取車的熱度圖。 如需 Kqlmagic 的詳細資訊，請參閱 使用 Jupyter Notebook 和 Kqlmagic 擴充功能來分析數據

  1. 下列儲存格會匯整指定地理邊界內的所有取貨。

    顯示匯總查詢的程式代碼儲存格螢幕快照。

  2. 執行下列單元格來繪製NYC計程車取車的熱度圖。

    顯示查詢以建立熱度圖的程式代碼單元格螢幕快照。

    在產生的熱度圖中，您可以看到大部分計程車上車都位於曼哈頓下區。 此外，JFK和拉瓜迪亞機場也有許多計程車服務。

    顯示NYC計程車取車熱度圖的筆記本螢幕快照。

6.清除資源

導覽至建立這些項目的工作區，清理它們。

  1. 在工作區中，將滑鼠停留在您想要刪除的筆記本上，選取 [ 更多] 功能表 [...] >刪除。

    顯示 NYC 計程車筆記本下拉選單的工作區截圖。標示為 [刪除] 的選項被反白顯示。

  2. 選擇 刪除。 一旦刪除筆記本，就無法復原筆記本。

相關內容

  • Last updated on