透過上傳帶有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. 在「設定目的地」頁面,提供你想遷移到的 Fabric 工作區名稱和新倉庫項目名稱。 選取 下一步。

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

    Note

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

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

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

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

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

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

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

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

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

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

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

使用遷移助理解決問題

某些資料庫物件中繼資料可能無法移轉。 通常,這種失敗是因為移轉小幫手無法將 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 倉庫中的物件。 提供新的來源輸入,只選擇你需要的物件,並選擇如何處理目的地中已存在的物件。 例如,遷移一組結構描述,驗證結果,然後再回來遷移更多物件或更新後的定義。

  1. 從以下任一地點開始漸進遷移:

    • 打開倉庫,選擇功能區上的 遷移 標籤,然後選擇 「取得更多物件」。

      倉庫遷移分頁上的「獲取更多物件」截圖。

    • 在遷移摘要中,展開 「複製元資料」,然後選擇 「取得更多物件」。

      已完成複製中繼資料頁面上的「取得更多物件」螢幕擷圖。

  2. 選擇來源,選擇輸入方式,然後繼續「 選擇更多物件以遷移」 步驟。

    移轉小幫手 的「選擇更多要遷移的物件」頁面螢幕擷圖。

  3. 在 選擇更多要遷移的物件時,選擇要遷移的物件:

    • 使用篩選器查看所有來源物件、有命名衝突的物件,或沒有命名衝突的物件。

      「選擇更多物件以遷移」頁面的命名衝突過濾器截圖。

    • 倉庫中已有名稱的物件會顯示警告圖示。 如果你選擇其中一個物件,會稍後在遷移過程中解決命名衝突。

      倉庫中已有名稱的物件的警告圖示與提示截圖。

    • 預設情況下,移轉小幫手 在選擇物件時會包含直接相依關係。 選擇物件名稱即可在右側窗格查看其直接相依關係。

      選取物件的直接相依關係截圖。

    • 如果輸入檔案中的物件沒有綱要名稱,移轉小幫手 會將該物件指派到預設 dbo 綱要。

  4. 在 審查時,確認來源、目的地及物件遷移摘要。

    檢視頁面上來源、目的地及物件遷移摘要的截圖。

  5. 選取移轉。 移轉小幫手 會轉譯所選物件,並建立不會有命名衝突的物件。 有命名衝突的物件會一直待處理,直到你解決每個衝突為止。

解決衝突與修復物件

當你透過增量遷移更新現有倉庫時,衝突解決讓你選擇要保留哪個物件定義。

  1. 在 移轉小幫手 摘要中,請檢視 待解決的衝突 計數。 展開 2。解決衝突並修正物件。

    待解決衝突數量和「解決衝突並修復物件」步驟的螢幕擷取畫面。

  2. 在 衝突 標籤中,檢視有命名衝突的物件。

    衝突索引標籤上的物件截圖。

  3. 選擇一個物件來比較其 SQL 定義。 現有定義顯示在左側,而傳入的翻譯定義則顯示在右側。

    截圖比較物件現有與傳入的 SQL 定義。

  4. 請為該物件選擇以下動作之一:

    • 保留現有項目:保留現有的物件定義,並捨棄傳入的翻譯定義。
    • 保留傳入內容:將現有物件定義替換為傳入的翻譯定義。 出現提示時,確認操作。
    • 重新命名 incoming 物件:以不同名稱建立 incoming 物件,並保留現有物件。

    針對物件的「Keep incoming」、「Keep existing」和「Rename incoming」動作的截圖。

    如果你選擇 重新命名傳入項目,請輸入結構描述和物件名稱,然後選擇 重新命名。

    重新命名已遷移物件對話方塊的截圖。

  5. 可選:在保留它之前先編輯接收的腳本。 要捨棄你的編輯並還原翻譯後的劇本,請選擇 「重設傳入內容」。

    Reset incoming 的截圖,位於編輯過的 incoming SQL 定義上方。

  6. 要套用傳入的定義,請選擇 「保留傳入內容(覆寫現有內容)」。 如果你編輯了接收到的腳本,請選擇 覆蓋現有 。

    Warning

    對於表格,保留匯入資料 會卸除並重新建立現有表格。 如果資料表包含資料,這個動作會導致資料遺失,你必須重新載入資料。 如果 移轉小幫手 無法套用這個傳入的指令碼,它會還原之前的物件定義,但不會恢復已刪除的資料。

    對於表格,選擇 替換表格 以確認動作。

    替換現有資料表確認對話框的截圖。

  7. 當腳本成功執行時,移轉小幫手 會標記該衝突已解決。

    截圖顯示物件衝突已解決。

  8. 對每個有命名衝突的物件重複這些步驟。 要對多個物件套用相同的動作,選取物件,然後選擇「保持現有」或「保持傳入內容」。

    大量「保留傳入」和「保留現有」動作的螢幕擷取畫面。

  9. 確認每個成功處理的物件都被標記為已解決。 如果物件需要更多修改,請檢視右側窗格的資訊。

透過遷移助理複製資料

複製資料有助於移轉您所移轉物件所使用的資料。 你可以用 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 入口網站移轉小幫手的螢幕快照,其中顯示所有四個作業步驟都已完成,並顯示恭喜的彈出視窗。