透過上傳帶有Fabric 移轉小幫手的檔案來遷移

適用於:Microsoft Fabric 中的✅ 資料庫

Fabric 移轉小幫手提供引導式體驗,協助將來源中繼資料和資料移轉至 Fabric Data Warehouse。 本指南說明如何從以下地點遷移元資料:

  • 使用 DACPAC 檔案搭配 Azure Synapse Analytics 或 SQL Server
  • 使用包含 .bteq 及/或 .sql 檔案的 .zip 封存檔來存取 Teradata

先決條件

開始之前,請確定您具備下列項目:

要使用 移轉小幫手 的 AI 輔助遷移功能來解決遷移問題,您需要啟用 Copilot:

  • 您的系統管理員必須先啟用租用戶切換功能,然後您才能開始使用 Copilot。 如需詳細資訊,請參閱 Copilot 租用戶設定。
  • 您的 F2 或 P1 容量 必須位於 網狀架構區域可用性中列出的其中一個區域。
  • 如果您的租用戶或容量位於美國或法國境外,則 Copilot 預設為停用,除非您的 Fabric 租用戶系統管理員在 >>>租用戶設定 中啟用 傳送至 Azure OpenAI 的資料可在您的容量所屬地理區域、合規界限或國家雲端執行個體之外進行處理 租用戶設定。
  • 試用版 SKU 不支援 Microsoft Fabric 中的 Copilot。 目前僅支持付費 SKU(F2 或更新版本或 P1 或更高版本)。
  • 如需詳細資訊,請參閱 Fabric 和 Power BI 中的 Copilot 概觀。

複製中繼資料

  1. 在您的 Fabric 工作區中,選取專案動作簡報表上的 [遷移] 按鈕。

    Fabric 入口網站中,顯示在動作工具列上的 [遷移] 按鈕的螢幕擷取畫面。

  2. 在 遷移至 Fabric 的來源功能表中,於 遷移至倉儲 下方,選取來源系統圖塊:

    • 對於 Azure Synapse Analytics,請選擇 Azure Synapse Analytics 專用 SQL 池。
    • 對於 SQL Server、Azure SQL Database 或 Azure SQL 受控執行個體,請選擇 SQL Server database。
    • 對於 Teradata,請選擇 Teradata (預覽)。

    從 Fabric 入口顯示來源系統圖塊的截圖。

  3. 如果出現「 選擇你的方法 」頁面,選擇 「上傳包含來源元資料的檔案」,然後選擇 「下一步」。

    Fabric 入口網站的截圖,展示如何上傳檔案進行遷移。

  4. 在 設定來源時,選擇 選擇檔案,選擇來源檔案,然後選擇 下一步。

    從 Fabric 入口網站截圖,顯示 移轉小幫手 中原始資料檔案上傳步驟。

  5. 在「設定目的地」頁面,提供你想遷移到的 Fabric 工作區名稱和新倉庫項目名稱。 選取 下一步。

  6. 檢閱您的輸入,然後選取 [移轉]。 遷移助理會建立一個新的倉庫項目並開始元資料遷移。

    Note

    使用遷移助理時,新倉庫的整理是不區分大小寫的,無論預設的倉庫整理設定如何。

    遷移助理 檢查頁面 Fabric 入口網站的螢幕快照。來源是 DACPAC 檔案,而目的地是名為 AdventureWorks 的新倉庫項目。

    在此步驟中,遷移助理會將 T-SQL 元資料轉換為 Fabric Data Warehouse 中支援的 T-SQL 語法。 元資料遷移完成後,遷移助理會開啟。 你可以隨時透過倉庫功能區主頁籤中的 遷移 按鈕存取遷移助理。

  7. 在遷移助手中查看中繼資料遷移摘要。 你會看到遷移物件的數量,以及需要修復才能遷移的物件數量。

    Fabric 入口網站有關移轉小幫手的中繼資料移轉摘要的螢幕擷取畫面。[顯示已移轉的物件] 選項被反白顯示。

  8. 選擇 「顯示已遷移的物件 」以展開該區塊,並查看你成功遷移到 Fabric 倉庫的物件清單。

    Fabric 入口網站中關於移轉助理的中繼資料移轉摘要及已移轉物件清單的螢幕擷取畫面。

    狀態欄位表示遷移助理在轉譯到 Fabric Data Warehouse 時是否調整了物件的元資料。 例如,您可能會看到某些資料行資料類型或 T-SQL 語言建構會自動轉換成 Fabric 中支援的資料類型。 詳細資料欄位顯示 移轉小幫手 對物件所做的調整資訊。

  9. 選擇任一物件即可查看遷移助理在遷移過程中所做的調整。

  10. 以全螢幕檢視開啟中繼資料移轉摘要,以提高可讀性。 套用篩選器來檢視特定物件類型。

    移轉助理已移轉物件的中繼資料移轉摘要全螢幕檢視的螢幕擷取畫面。

使用遷移助理解決問題

某些資料庫物件中繼資料可能無法移轉。 通常,這種失敗是因為移轉小幫手無法將 T-SQL 元資料轉換成 Fabric Data Warehouse 支援的元資料,或是轉譯後的程式碼未能套用到 T-SQL。

讓我們透過 Microsoft SQL Server 移轉小幫手的協助來修正這些指令碼。

  1. 選取 Microsoft SQL Server 移轉小幫手中的 [修正問題] 步驟,以查看無法移轉的指令碼。

    zh-TW: Fabric 入口網站上 [遷移助手] 的 [修正問題清單] 螢幕擷取畫面。

  2. 選取無法移轉的資料庫物件。 在 [總管] 中的 [共用查詢] 下開啟新的查詢。 這個新查詢會顯示中繼資料的定義,以及對其所做的調整,這些調整作為自動註解添加到 T-SQL 程式碼中。

  3. 檢閱指令碼開頭的註解,以查看對指令碼進行的調整。

  4. 利用錯誤資訊和文件審查並修正錯誤腳本。

  5. 若要使用 AI 支援的 Copilot 來協助修正錯誤,請在 [建議的動作] 區段中選取 [修正查詢錯誤]。 Copilot 會使用建議來更新指令碼。 當 Copilot 使用 AI 時,可能會發生錯誤,因此請確認程式碼建議,並進行任何您需要的調整。

    查詢編輯器網狀架構入口網站的螢幕快照,其中顯示無法移轉的 T-SQL 查詢,以及 Copilot 建議的批注和修正。

  6. 選取 [執行] 以驗證並建立物件。

  7. 下一個需要修正的腳本打開了。

  8. 繼續修正其餘的指令碼。 您可以選擇在這一步驟中略過不需要的腳本調整。

  9. 當所有需要的中繼資料準備好進行遷移時,請在 「解決問題 」面板中選擇返回按鈕,返回遷移助理的頂層視圖。 檢查遷移助理中的2. 修復問題步驟。

透過遷移助理複製資料

複製資料有助於移轉您所移轉物件所使用的資料。 你可以用 Fabric Data Factory 的複製工作 手動完成,或在遷移助理中依照這些步驟進行複製工作整合。

  1. 選取 [Microsoft SQL Server 移轉小幫手] 中的 [複製資料] 步驟。

  2. 選擇 使用複製工作。

  3. 將名稱指派給新作業,然後選取 [ 建立]。

  4. 在 「連接資料來源 」頁面,提供你來源系統的連線憑證。 選取 下一步。

  5. 在 「選擇資料 」頁面,選擇你想遷移的資料表。 選取 下一步。

    Fabric 入口網站的 [選擇資料] 窗格螢幕快照,其中已選取一些資料表。

  6. 在 [選擇資料目的地] 頁面中,從 OneLake 目錄中選擇新的 Fabric 倉儲項目。 選取 下一步。

  7. 在 映射至目的地 頁面中,配置每個資料表的欄位映射。 選取 下一步。

  8. 在 [複製作業模式] 頁面中,選擇複製模式。 選擇一次性完整資料複製 (建議用於移轉),或連續增量複製。 選取 下一步。

  9. 檢閱工作摘要。 選取 [儲存 + 執行]。

  10. 複製作業完成後,檢查遷移助理中的3. 複製資料步驟。 選擇頂部的返回按鈕可返回遷移助理的頂層視圖。

重新路由連線

最後一步,重新連接資料載入與報告平台,使其連接指向你的新 Fabric 倉庫。

  1. 識別現有來源倉儲上的連線。

    • 在 SQL Server 實例中,您可以使用動態管理視圖,例如:
    SELECT 
        s.program_name
    , s.login_name
    , c.client_net_address
    FROM sys.dm_exec_sessions AS s 
    INNER JOIN sys.dm_exec_connections AS c 
    ON s.session_id = c.session_id
    WHERE s.session_id >= 50 --retrieve only user spids
    and s.session_id <> @@SPID; --ignore myself
    
    • 在 Azure Synapse Analytics 專用的 SQL 池中,你可以找到會話資訊,包括來源應用程式、連接使用者、連線來源及認證方法:
    SELECT DISTINCT CASE 
             WHEN len(tt) = 0
                 THEN app_name
             ELSE tt
             END AS application_name
         ,login_name
         ,ip_address
    FROM (
         SELECT DISTINCT app_name
             ,substring(client_id, 0, CHARINDEX(':', ISNULL(client_id, '0.0.0.0:123'))) AS ip_address
             ,login_name
             ,isnull(substring(app_name, 0, CHARINDEX('-', ISNULL(app_name, '-'))), 'h') AS tt
         FROM sys.dm_pdw_exec_sessions
         ) AS a;
    
  2. 更新報告平台的連結,連結至您的 Fabric 倉儲。

  3. 在重新路由之前,先利用一些報告來測試 Fabric 資料庫。 在報告平台中執行比較和資料驗證測試。

  4. 更新資料載入 (ETL/ELT) 平台的連線,以指向您的 Fabric 資料倉庫。

    • 針對 Power BI/Fabric 資料管道:
      1. 使用 清單連線 REST API 來尋找舊資料來源 (也就是 Azure Synapse Analytics 專用 SQL 集區) 的連線。
      2. 透過設定中的「管理連線與閘道」頁面更新新倉庫的連線。
  5. 完成之後,請在遷移助理中檢查「 重新路由連接 」步驟。

祝賀! 你現在準備好開始使用你的新倉庫了。

Fabric 入口網站移轉小幫手的螢幕快照,其中顯示所有四個作業步驟都已完成,並顯示恭喜的彈出視窗。