Share via


從 OneLake 取得數據

在本文中,您將瞭解如何將數據從 OneLake 擷取到新的或現有的數據表。

必要條件

從 Lakehouse 複製檔案路徑

  1. 在體驗切換器中,選擇 [資料工程師]。

  2. 選取包含您要使用的數據源的 Lakehouse 環境。

  3. 將游標放在所需的檔案上,然後選取 [更多 ] 功能表,然後選取 [ 屬性]。

    重要

    • 不支援資料夾路徑。
    • 不支援通配符 \ 。

    Lakehouse 檔案下拉功能表的螢幕快照。標題為 [屬性] 的選項會反白顯示。

  4. 在 [URL] 底下,選取 [複製到剪貼簿] 圖示,並將它儲存在稍後步驟中擷取的位置。

    Lakehouse 檔案 [屬性] 窗格的螢幕快照。檔案 URL 右邊的複製圖示會反白顯示。

  5. 返回您的工作區,然後選取 KQL 資料庫。

來源

  1. 在 KQL 資料庫的下方功能區上,選取 [ 取得數據]。

    在 [取得數據] 視窗中,已選取 [來源] 索引標籤

  2. 從可用的清單中選取資料來源。 在此範例中,您要從 OneLake 擷取數據。

    [取得數據] 視窗的螢幕快照,其中已選取來源索引卷標。

設定

  1. 選取目標數據表。 如果您想要將資料內嵌到新的資料表中,請選取 [+新增數據表 ],然後輸入數據表名稱。

    注意

    數據表名稱最多可以有 1024 個字元,包括空格、英數位元、連字元和底線。 但不支援萬用字元。

  2. OneLake 檔案中,貼上您從 Lakehouse 複製檔案路徑中 複製的 Lakehouse 檔案路徑。

    注意

    您可以新增最多10個專案,每個專案最多1 GB未壓縮的大小。

    [設定] 索引標籤的螢幕快照,其中已輸入新的數據表和已新增 OneLake 檔案路徑。

  3. 選取 [下一步]。

檢查

[檢查] 索引標籤隨即開啟,並預覽數據。

若要完成擷取程式,請選取 [ 完成]。

[檢查] 索引標籤的螢幕快照。

或者:

  • 選取 [命令檢視器 ] 以檢視和複製從輸入產生的自動命令。
  • 使用 [ 架構定義檔案 ] 下拉式清單來變更從中推斷架構的檔案。
  • 從下拉式清單中選取所需的格式,以變更自動推斷的數據格式。 如需詳細資訊,請參閱 即時智慧所支持的數據格式。
  • 編輯數據行
  • 根據數據類型探索進階選項。

編輯資料行

注意

  • 對於表格式格式 (CSV、TSV、PSV),您無法對應資料行兩次。 若要對應至現有的數據行,請先刪除新的數據行。
  • 您無法變更現有的資料行類型。 如果您嘗試對應至具有不同格式的數據行,最後可能會有空的數據行。

您可以在資料表中所做的變更取決於下列參數:

  • 數據表 類型是新的或現有的
  • 對應 類型是新的或現有的
資料表類型 對應類型 可用的調整
新增資料表 新的對應 重新命名資料列, 變更資料型態, 變更資料來源, 對應轉換加入資料行, 刪除資料列
現有的資料表 新的對應 新增資料列(然後您可以變更資料類型、重新命名和更新)
現有的資料表 現有的對應 none

開啟以供編輯之數據行的螢幕快照。

對應轉換

某些數據格式對應 (Parquet、JSON 和 Avro) 支援簡單的擷取時間轉換。 若要套用對應轉換,請在 [ 編輯 數據行] 視窗中建立或更新數據行。

對應轉換可以在字串或 datetime 類型的數據行上執行,而來源具有數據類型 int 或 long。 支援的對應轉換如下:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

以數據類型為基礎的進階選項

表格式 (CSV、TSV、PSV)

  • 如果您要內嵌現有資料表中的表格式格式,您可以選取 [進階>保留數據表架構]。 表格式數據不一定包含用來將源數據對應至現有數據行的數據行名稱。 核取此選項時,對應會依序完成,而且數據表架構會維持不變。 如果未核取此選項,不論數據結構為何,都會為傳入數據建立新的數據行。

  • 若要使用第一個數據列作為數據行名稱,請選取 [進階>第一列是數據行標頭]。

    進階 CSV 選項的螢幕快照。

JSON:

  • 若要判斷 JSON 數據的數據行除法,請選取 [進階>巢狀層級],從 1 到 100。

  • 如果您選取 [進階>略過有錯誤的 JSON 行],則會以 JSON 格式擷取數據。 如果您將此複選框保留為未選取,數據會以 multijson 格式內嵌。

    進階 JSON 選項的螢幕快照。

摘要

在 [ 數據準備 ] 視窗中,當數據擷取成功完成時,所有三個步驟都會標示為綠色複選標記。 您可以選取要查詢的卡片、卸除內嵌的數據,或查看擷取摘要的儀錶板。

已完成擷取的摘要頁面螢幕快照。