從 Azure 儲存體取得資料

在本文中，您會瞭解如何從 Azure 儲存體 (ADLS Gen2 容器、Blob 容器或個別 Blob) 取得資料到新的或現有的資料表。

必要條件

• 工作區，具有已啟用 Microsoft Fabric 的容量
• 具有編輯權限的 KQL 資料庫
• 儲存體帳戶

來源

1. 在 KQL 資料庫的下方功能區上，選取取得資料。

   在取得資料視窗中，已選取來源索引標籤。

2. 從可用清單中選取資料來源。 在此範例中，您會從 Azure 儲存體擷取資料。

   取得資料視窗的螢幕擷取畫面，其中已選取來源索引標籤。

設定

1. 選取目標資料表。 如果您想要將資料擷取到新的資料表，請選取 + 新增資料表，然後輸入資料表名稱。

   注意

   資料表名稱最多可以有 1024 個字元，包括空格、英數字元、連字號和底線。 但不支援特殊字元。

2. 若要新增資料來源，請將儲存體連接字串貼到 URI 欄位，然後選取 +。 下表列出支援的驗證方法和從 Azure 儲存體擷取資料所需的權限。

   驗證方法	個別 Blob	Blob 容器	Azure Data Lake Storage Gen2
   共用存取 (SAS) 權杖	讀取和寫入	讀取和列示	讀取和列示
   儲存體帳戶存取金鑰

   注意

   • 您可以新增最多 10 個個別 Blob，或從單一容器擷取最多 5000 個 Blob。 您不能同時擷取兩者。
   • 每個 blob 最多可以為 1 GB (未壓縮)。

   1. 如果您已貼上 Blob 容器或 Azure Data Lake Storage Gen2 的連接字串，則可以新增下列選用篩選：

      輸入新資料表及選取一範例資料檔案以設定索引標籤的螢幕擷取畫面。

      設定	欄位描述
      檔案篩選 (選用)
      資料夾路徑	篩選資料以擷取具有特定資料夾路徑的檔案。
      副檔名	篩選資料以僅擷取具有特定副檔名的檔案。

3. 選取下一個

檢查

檢查索引標籤隨即開啟，其中包含資料的預覽。

若要完成擷取程序，請選取完成。

「檢查」索引標籤的螢幕擷取畫面。

或者：

• 選取命令檢視器以檢視和複製從輸入產生的自動命令。
• 使用結構描述定義檔案下拉式清單來變更結構描述所匯出的檔案。
• 從下拉式清單中選取所需的格式，變更自動推斷的資料格式。 如需詳細資訊，請參閱即時智慧所支援的資料格式。
• 編輯資料行。
• 探索基於資料類型的進階選項。

編輯資料行

注意

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

您可以在資料表中進行的變更取決於下列參數：

• 資料表類型是新的或現有的
• 對應類型是新的或現有的

資料表類型	對應類型	可用的調整
新增資料表	新的對應	重新命名資料行、變更資料類型、變更資料來源、對應轉換、新增資料行、刪除資料行
現有的資料表	新的對應	新增資料行 (然後您可以在其中變更資料類型、重新命名和更新)
現有的資料表	現有的對應	none

開啟供編輯資料行的螢幕擷取畫面。

對應轉換

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

對應變換可以在 string 或 datetime 類型的資料行上執行，而來源具有資料類型 int 或 long。 支援的對應轉換如下：

• DateTimeFromUnixSeconds
• DateTimeFromUnixMilliseconds
• DateTimeFromUnixMicroseconds
• DateTimeFromUnixNanoseconds

基於資料類型的進階選項

表格式 (CSV、TSV、PSV)：

• 如果您要在現有資料表中擷取資料表格式，您可以選取進階>保留資料表結構描述。 資料表式資料不一定包含用來將來源資料對應至現有資料行的資料行名稱。 勾選此選項時，會按順序進行對應，資料表結構描述保持不變。 如果未勾選此選項，無論資料結構如何，都會為傳入資料建立新資料行。

• 若要使用第一列作為資料行名稱，請選取進階>以第一列作為資料行標題。

  進階 CSV 選項的螢幕擷取畫面。

JSON：

• 若要確定 JSON 資料的資料行劃分，請選取進階>巢狀層級，從 1 到 100。

• 如果您選取進階>略過包含錯誤的 JSON 行，則會以 JSON 格式擷取資料。 如果未選取此核取方塊，則會以 multijson 格式擷取資料。

  進階 JSON 選項的螢幕擷取畫面。

摘要

在資料準備視窗中，當資料擷取成功完成時，會以綠色核取記號標記所有三個步驟。 您可以選取要查詢的卡片、卸除擷取的資料，或查看擷取摘要的儀表板。

成功完成擷取的摘要頁面的螢幕擷取畫面。

相關內容

• 若要管理資料庫，請參閱管理資料
• 若要建立、儲存和匯出查詢，請參閱查詢 KQL 查詢集中的資料