針對匯入和移轉錯誤進行疑難解答

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

資料移轉工具會標示錯誤，而您必須先更正錯誤，才能執行以 Azure DevOps Services 為目的地的移轉。 本文說明您在準備移轉時可能收到的最常見警告和錯誤。 更正每個錯誤之後，請再次執行 移轉程式 validate 命令來驗證解決方式。

注意

建議您使用 移轉指南 來逐步完成匯入。 本指南會視需要連結到技術檔。

隨著 Azure DevOps Server 2019 的發行，Team Foundation Server （TFS） 資料庫匯入服務已重新品牌成為 Azure DevOps 的數據遷移工具。 資料移轉工具 TfsMigrator 已簡短地重新命名為 Migrationor。 服務仍然與先前的匯入服務完全相同。 如果您是使用 TFS 作為商標的舊版內部部署，只要升級至其中一個支援的版本，您仍然可以使用 移轉程式 移轉至 Azure DevOps。 如需詳細資訊，請參閱 將數據從 Azure DevOps Server 遷移至 Azure DevOps Services。

解決大小警告

執行數據遷移工具之後，超大型集合可能會產生下列其中一則訊息。 如果您收到上述任何警告或錯誤，建議您嘗試 減少資料庫的大小。

下列警告表示您必須使用 SQL Azure VM 方法來完成匯入。 一旦資料庫達到特定大小，設定 SQL Azure VM 以完成匯入至 Azure DevOps Services 的速度會變快。 若要設定 VM 並完成匯入，請遵循從警告訊息連結的指示。

The database is currently {Database Size}GBs. This is above the recommended size of {DACPAC Size Limit}GBs to use the DACPAC import method. Please see the following page to learn how to import using a SQL Azure VM: https://aka.ms/AzureDevOpsImportLargeCollection

這個警告 並不 表示您的集合太大而無法匯入。

與先前的警告類似，下列警告表示您必須使用 SQL Azure 虛擬機器 （VM） 方法來完成匯入。 請遵循警告訊息中連結的指示來設定 VM 並完成匯入。

The largest table size is currently {Table size}GBs. This is above the recommended size of {Size limit}GBs to use the DACPAC import method. Please see the following page to learn how to import using a SQL Azure VM: https://aka.ms/AzureDevOpsImportLargeCollection

這個警告 並不 表示您的集合太大而無法匯入。

下列警告表示您的資料庫接近元數據大小總計的限制。 元數據大小是指資料庫的大小，而不包含檔案、程序代碼和其他二進位數據。 建議您 在匯入之前減少資料庫的大小 。 減少大小可提供加速匯入的其他優點。

The database metadata size is currently {Metadata Size}GBs. This is above the recommended size of {Warning Size}GBs. It's recommended that you consider cleaning up older data as described in [Cleaning up old data](/azure/devops/server/upgrade/clean-up-data).

警告 不 表示您的集合太大而無法匯入，而是其元數據大小大於大部分其他資料庫。

資料庫元數據大小超過支援的大小上限

不同於先前的警告，下列錯誤 會 阻止您繼續進行移轉。

它表示集合中的元數據磁碟區太大。 若要繼續進行匯入，您必須 減少 低於指定限制的大小。

The database metadata size is currently {Metadata Size}GBs. This is above the maximum supported size of {Metadata Limit}GBs.

解決定序警告

定序警告是指集合資料庫的定序。 定序會控制字串值排序和比較的方式。 未使用 SQL_Latin1_General_CP1_CI_AS 或 Latin1_General_CI_AS 接收其中一個警告訊息的集合。

沒有原生支援

收到下列警告表示在執行匯入之前，您必須考慮定序含意。

The collection database's collation '{collation}' is not natively supported in Azure DevOps Services. Importing your collection will result in your collation being converted to one of the supported Azure DevOps Services collations. See more details at https://aka.ms/AzureDevOpsImportCollations

這個警告 並不 表示您無法匯入集合。

此警告會要求您確認接受警告。 接受警告可讓數據遷移工具繼續匯入準備。

當您將非移植定序匯入 Azure DevOps Services 時，定序會轉換成支援的定序。 雖然這項轉換通常沒有問題，但匯入或匯入失敗後可能會發生非預期的結果。

例如，客戶可能會注意到包含非英文字元之字串的不同順序。 匯入之後，例如 『é』 的非英文字符可能會相當於英文 『e』。 請務必在匯入具有非支援定序的集合時，完成並確認執行中匯入。

沒有原生支持，沒有因特網連線

如果數據遷移工具無法連線到因特網，就無法驗證定序的轉換。 這隻是警告，因此您可以繼續進行移轉程式。 不過，當您執行 準備 命令時，需要因特網連線，而且此時會驗證定序轉換。

The collections database's collation '{collation}' is not natively supported in Azure DevOps Services. It could not be validated that the collation can be converted during import to a supported Azure DevOps Services collation, as there was no internet connection. Please run the command again from a machine with an internet connection. See more details at https://aka.ms/AzureDevOpsImportCollations

不支援的資料庫定序

一般而言，您可以在匯入時將非匯出定序轉換成支援的定序。 不過，某些定序無法轉換。 如果您的集合使用下列其中一個定序，您會收到下列 錯誤 訊息。

The collection database's collation '{collation}' is not supported for import to Azure DevOps Services. It will need to be changed to a supported collation before it can be imported. See more details at https://aka.ms/AzureDevOpsImportCollations

若要繼續，您必須將 集合的定序 變更為 Azure DevOps Services 上其中一個支援的定序。

解決身分識別錯誤

修正移轉前的身分識別錯誤，以避免發生問題。 當新的 Azure DevOps Server 上的舊 TFS 作業無效時，就很罕見。 例如，某些使用者無法再位於有效的使用者群組中。

下列各節提供解決最常見身分識別錯誤的指引。

ISVError：100014

此錯誤表示系統安全組缺少許可權。 例如，您建立的每個集合都有 Project Collection Valid Users 和 Project Collection 管理員 istrators 群組。 系統預設會建立它們。 這些群組不支援編輯其許可權。

此錯誤表示一或多個群組遺漏預期擁有的許可權。 若要解決此錯誤，請使用 TFSSecurity.exe 命令，將預期的許可權套用至標幟的系統群組。 您的第一個步驟是識別 您需要執行的 TFSSecurity 命令。

專案集合有效使用者錯誤訊息

檢查醒目提示的數據遷移工具錯誤訊息。 如果標幟的群組以 “0-0-0-0-3” 結尾，例如在下列範例中，您必須修正專案集合有效使用者群組遺漏的許可權。

執行下列命令，將範圍取代為錯誤訊息中的範圍，並指定您的集合 URL。

TFSSecurity.exe /a+ Identity "{scope}\\" Read sid:{Group SID} ALLOW /collection:{collectionUrl}

您可以從錯誤訊息判斷範圍和群組安全性識別碼 （SID）。

ISVError:100014 Missing permission for group:Microsoft.TeamFoundation.Identity;S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-3 for scope:397c326b-b97c-4510-8271-75aac13de7a9. Expected:1 and Actual:0

最後一個命令看起來類似下列專案：

TFSSecurity.exe /a+ Identity "397c326b-b97c-4510-8271-75aac13de7a9\\" Read sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-3 ALLOW /collection:https://localhost:8080/defaultcollection

專案集合 管理員 istrators 錯誤訊息

請仔細檢查醒目提示的數據遷移工具錯誤訊息。 如果以 “0-0-0-0-0-1” 結尾的旗標群組，例如在下列範例中，您必須修正 Project Collection 管理員 istrators 群組遺漏的許可權。 針對 TFSSecurity.exe執行下列命令，將範圍取代為錯誤訊息中的範圍，並指定您的集合。

TFSSecurity.exe /a+ Identity "{scope}\\" Read sid:{Group SID} ALLOW /collection:{collectionUrl}

TFSSecurity.exe /a+ Identity "{scope}\\" Write sid:{Group SID} ALLOW /collection:{collectionUrl}

TFSSecurity.exe /a+ Identity "{scope}\\" Delete sid:{Group SID} ALLOW /collection:{collectionUrl}

TFSSecurity.exe /a+ Identity "{scope}\\" ManageMembership sid:{Group SID} ALLOW /collection:{collectionUrl}

在下列範例中，從錯誤訊息中取得範圍和群組 SID ，並將其新增至上述命令。

ISVError:100014 Missing permission for group:Microsoft.TeamFoundation.Identity;S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 for scope:0c7c2216-fa4b-4107-a203-82b324a147ef. Expected:15 and Actual:0

最後一個命令看起來類似下列專案：

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" Read sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" Write sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" Delete sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

TFSSecurity.exe /a+ Identity "0c7c2216-fa4b-4107-a203-82b324a147ef\\" ManageMembership sid:S-1-9-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-XXXXXXXXXX-0-0-0-0-1 ALLOW /collection:https://localhost:8080/defaultcollection

當您需要更正多個錯誤時，建議您建立批處理檔，以自動執行命令。 執行命令之後，您必須重新執行資料遷移 驗證 工具來驗證解決方案。 如果仍存在某些錯誤，請連絡 Azure DevOps Services 客戶支援。

ISVError：300005

ISVError：300005指出非群組身分識別是每個人群組的成員，通常稱為「有效使用者」群組。 有效的使用者群組是針對所有專案和集合定義的預設群組。 這些群組無法編輯。 其設計目的是只包含其他 Azure DevOps 許可權或安全組作為成員。 此錯誤表示 Active Directory （AD） 群組或使用者身分識別在有效使用者群組中具有直接成員資格。

重要

執行下列命令來解決錯誤之前，請確定您有集合和組態資料庫的備份。

由於您無法直接編輯有效使用者群組，因此您必須對組態資料庫執行 SQL 語句，以移除違規的身分識別並更正無效的成員資格。 仔細檢查數據遷移工具所醒目提示的錯誤訊息。 GroupSid將、 MemberId和 ScopeId 複製到下列命令中，因為您需要將這些值放入下列命令中。

DECLARE @p6 dbo.typ_GroupMembershipTable

INSERT into @p6 values('{GroupSid}','Microsoft.TeamFoundation.Identity','{MemberId}',0)
 
EXEC prc_UpdateGroupMembership @partitionId=1,@scopeId='{ScopeId}',@idempotent=1,@incremental=1,@insertInactiveUpdates=0,@updates=@p6,@eventAuthor='9EE20697-5343-43FC-8FC5-3D5D455D21C5',@updateGroupAudit=0

下列範例會列出ISVError的範例：從數據遷移工具300005訊息。

ISVError:300005 Unexpected non group identity was found to have direct membership to everyone group. GroupSid:S-1-9-1551374245-3746625149-2333054533-2458719197-2313548623-0-0-0-0-3, MemberId:76050ddf-4fd8-48c4-a1ff-859e44364519, ScopeId:7df650df-0f8b-4596-928d-13dd89e5f34f

如果錯誤訊息列出 MemberSid，您需要從組態資料庫中的dbo.tbl_Identity資料表取得 MemberID 。 MemberID透過，您可以接著查閱的 MemberSidGUID。

ISVError:300005 Unexpected non group identity was found to have direct membership to everyone group. GroupSid:S-1-9-1551374245-3746625149-2333054533-2458719197-2313548623-0-0-0-0-3, MemberSid:System.Security.Principal.WindowsIdentity;S-1-5-21-124525095-708259637-1543119021-1737349, ScopeId:7df650df-0f8b-4596-928d-13dd89e5f34f

DECLARE @MemberId uniqueidentifier 

SET @MemberId = (Select Id from dbo.tbl_Identity where Sid ='S-1-5-21-124525095-708259637-1543119021-1737349');

SELECT @MemberId

將 GroupSid、 MemberId和 ScopeId 複製到 SQL 命令。


DECLARE @p6 dbo.typ_GroupMembershipTable

INSERT into @p6 values('S-1-9-1551374245-3746625149-2333054533-2458719197-2313548623-0-0-0-0-3','Microsoft.TeamFoundation.Identity','76050ddf-4fd8-48c4-a1ff-859e44364519',0)
 
EXEC prc_UpdateGroupMembership @partitionId=1,@scopeId='7df650df-0f8b-4596-928d-13dd89e5f34f',@idempotent=1,@incremental=1,@insertInactiveUpdates=0,@updates=@p6,@eventAuthor='9EE20697-5343-43FC-8FC5-3D5D455D21C5'

針對 Azure DevOps Server 組態資料庫執行已完成的命令。 針對每個ISVError重複此命令：回報300005實例。 您可以將具有相同範圍識別碼的錯誤批處理成單一命令。 執行命令之後，請重新執行資料遷移工具再次驗證，以確保已更正錯誤。 如果錯誤仍然持續發生，請連絡 Azure DevOps Services 客戶支援。

重要

若要解決這些錯誤，必須附加集合。

如果您在執行 命令時收到 -1 結果，請確定產生錯誤的集合資料庫已附加至您的 Azure DevOps Server 實例，而且您在組態資料庫上執行命令。

Microsoft Entra 逾時例外狀況

在極少數情況下，執行數據遷移工具 prepare 命令時，您可能會收到 Microsoft Entra 逾時錯誤。

Exception Message: Request failed (type AadGraphTimeoutException)

此錯誤表示對 Microsoft Entra 識別碼的要求，以找出集合中使用者的相符 Microsoft Entra 身分識別逾時。一般而言，您可以等候在一天較不忙碌的時間執行 準備 命令，例如在一般上班時間之後，來解決此錯誤。

若要進行疑難解答，請從 準備 計算機測試 Microsoft Entra ID 連線。 請遵循下列步驟，從 Microsoft Entra ID 取得用戶資訊。

以提升許可權模式開啟 PowerShell，並以您的 Microsoft Entra 使用者身分識別取代下列命令中的 『someone@somecompany.com』 。

# Install the Microsoft Graph PowerShell module - ensuring to select Yes to All
Install-Module Microsoft.Graph 

# Import Users module
Import-Module Microsoft.Graph.Users

# Connect to Microsoft Entra and use your Microsoft Entra ID credentials (someone@somecompany.com) to login when the pop-up appears
Connect-MgGraph  -Scopes 'User.Read.All'

# Try to retrieve information on a user from your Microsoft Entra
Get-MgUser -Filter "UserPrincipalName eq 'someone@somecompany.com'"

如果步驟失敗或找不到使用者，請檢查準備計算機與 Microsoft Entra 識別碼之間的連線。 執行網路追蹤， 準備 查看網路是否封鎖呼叫。 如果沒有，請連絡 Azure 支援。 檢查記錄檔中是否有用戶資訊。

Number of active users is {Number of Users}.

如果作用中用戶的數目超過50,000個，所對應的身分識別數量可能需要超過逾時限制所提供的時間。 檢查您的集合，以包含大型群組，例如「每個人」群組。 可能的話，請移除這些群組，然後再試一次。 如果您仍然無法解決此錯誤，請連絡 Azure DevOps Services 客戶支援。

解決進程錯誤

如需解決常見進程錯誤的詳細數據，請參閱個別 的進程範本 頁面。

解決欄位驗證錯誤

VS403310

偵測到集合檔案中的不一致時，可能會發生下列錯誤訊息。 如果您遇到此錯誤，請連絡客戶支援。

VS403310: An inconsistency was detected in some of the files in the collection.

VS403442

功能變數名稱有時會在本機集合與 Azure DevOps Services 系統欄位之間發生衝突。

In order to migrate successfully, you must rename field *{TFSfieldReferenceName}*. Given name *{TFSfieldName}* is reserved for field *{VSTSfieldReferenceName}*.

若要解決此錯誤，請變更集合欄位的名稱。 從 witadmin 使用 witadmin changefield 命令。

witadmin changefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName /name:newFieldName

VS403443

下列錯誤指出本機集合與特定 Azure DevOps Services 欄位之間存在域名衝突。

In order to migrate successfully, you must rename field *{TFSfieldReferenceName}* to *{VSTSfieldName}*. Given name for *{TFSfieldReferenceName}* is *{TFSfieldName}*

若要解決此錯誤，請使用 witadmin changefield 命令。 如需詳細資訊，請參閱 witadmin。

witadmin changefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName /name:VSTSfieldName

VS403444

下列錯誤指出本機集合與 Azure DevOps Services 之間存在欄位類型衝突。

使用 witadmin，您只能針對 HTML 或 PlainText 字段變更數據類型。

In order to migrate successfully, you must set type of field *{TFSfieldReferenceName}* to *{Type}*. Given type for *{TFSfieldReferenceName}* is *{collectionType}*.

如果您的欄位類型是 HTML 或 PlainText，則可以將其類型變更為所需的類型。

witadmin changefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName  /type:PlainText | HTML

注意

如果您的欄位類型與 HTML 或 PlainText 不同，且欄位數據不重要，或欄位未用於任何專案中，建議您刪除欄位。

witadmin deletefield /collection:http://AdventureWorksServer:8080/DefaultCollection /n:TFSfieldReferenceName

重要

刪除欄位會導致整個集合遺失欄位數據。

解決匯入錯誤

匯入期間發生的失敗分為兩種類別之一： 驗證失敗 和 匯入失敗。

驗證失敗

驗證失敗表示匯入未啟動。 數據遷移工具嘗試將匯入排入佇列，但改為收到錯誤。 您的匯入要求無效。 修正錯誤訊息，然後再次嘗試匯入。

VS403254

不支援您為 Azure DevOps Services 匯入輸入的區域。

VS403254: Region {0} might not be used for the Import, it is not a supported region.

開啟您的匯入規格檔案，並更新您為區域提供的正確簡短名稱 的區域。

VS403249

您小組選取的組織名稱已由現有組織使用。 所有 Azure DevOps Services 匯入都會進入在匯入時建立的新組織。

VS403249: The organization {0} already exists. Please select a different name and try the import again.

選取不同的組織名稱，並在重試匯入之前更新匯入規格檔案。

VS403250和VS403286

DACPAC 不會建置中斷連結的集合。

VS403250: The dacpac is not a detached Azure DevOps Server Collection database.

VS403286: The dacpac is from a Azure DevOps Server Configuration database. You must use a detached Azure DevOps Server Collection database.

中斷連結 您的收集資料庫，然後再次產生 DACPAC。

VS403243

無法使用提供的 SQL 連線 ion String 來連接資料庫。

VS403243: Unable to connect to the database using the provided SQL Connection String {0}.

檢閱所提供的參數，以確保其正確無誤，然後再試一次。

VS403260和VS403351

集合資料庫不會中斷連結。

VS403260: The database is not detached.

VS403351: The DACPAC or source database is missing an expected table. It's possible that the database was not correctly detached from Azure DevOps Server.

中斷 連結您的集合資料庫，然後重試匯入佇列。

VS403261

連接字串 必須加密，否則密碼會在清除中傳送。

VS403261: The SQL connection string must use encryption.

將 Encrypt=true 新增至 SQL 連接字串。

VS403262

連接字串 必須使用 SQL 驗證。

VS403262: The SQL connection string must use SQL Authentication, Integrated Authentication is not supported.

將整合式安全性=False 新增至 SQL 連接字串。

VS403263

您的 SQL 登入使用者帳戶沒有必要的資料庫角色。

VS403263: The User ID {0} must be member of the database role {1}.

請確定登入的用戶帳戶已 獲指派 『TFSEXECROLE』 角色。

注意

使用 sp_addrolemember 新增 TFSEXECROLE 至現有 SQL 登入時發生已知問題。 除非使用該身分識別關閉所有開啟的連線，否則不會套用角色成員資格。 如果您收到VS403263錯誤並確認您的身分識別具有角色，建議您為匯入建立新的身分識別。 如需如何建立準備匯入的新 SQL 登入的詳細資訊，請參閱 匯入大型集合。

VS403264

連接字串 不會指向 Azure DevOps Server 集合資料庫。

VS403264: The database is not a Azure DevOps Server Collection database, it cannot be used for import.

確認或更正 連接字串 指向您的集合資料庫。

VS40325

Azure DevOps Server Update 已將檔案移轉作業排入佇列。 必須先完成此作業，才能執行匯入。 此作業的完成時間取決於集合的大小。

VS403255: The collection cannot be imported due to an ongoing post upgrade job. Please wait and try again later

您可以在收集資料庫上執行下列查詢來追蹤作業進度：

SELECT  COUNT (*) as remaining_files_to_migrate
FROM    tbl_FileReference
WHERE   PartitionId > 0
        AND MigrateFileId IS NOT NULL

一旦剩餘移轉的檔案數目為零，您就可以執行數據遷移工具。

VS403282

來源位置值中有新的行字元。 從 Windows 控制台複製 SAS 金鑰之後，可能會保留此字元。

VS403282: The source location parameter contains a new line character. Please ensure the SAS key is defined on a single line in the import specification file.

拿掉換行符，然後再試一次。

VS403271

您的匯入檔案和 DACPAC 不在 必要的 Azure 區域中，無法完成匯入至目標 Azure DevOps Services 區域。

VS403271: It appears that your DACPAC was uploaded to East US. It's required that customers targeting Central US for import put their DACPACs in Central US. Please move your DACPAC to Central US and requeue the import.

在必要的區域中建立新的 Microsoft Azure 記憶體帳戶 ，並複製您的檔案。 下列範例示範如何使用 AzCopy 複製您的數據。

AzCopy.exe /Source:https://accountSCUS.blob.core.windows.net/mycontainer /SourceKey:"primary access key" /Dest:https://accountCUS.blob.core.windows.net/mycontainer /DestKey:"primary access key" /S

VS403316

在集合中的某些 Team Foundation 版本控制 （TFVC） 檔案中偵測到不一致。

VS403316: An inconsistency was detected in some TFVC files for this collection. The inconsistency needs to be corrected prior to running an import to Azure DevOps Services. Please reach out to https://aka.ms/AzureDevOpsImportSupport for assistance with addressing this issue.

請與 Azure DevOps Services 客戶支援合作。 開啟支援票證，並與您合作解決錯誤。

VS403366

數據遷移工具無法連線到 SQL Azure VM。

VS403366: A problem occurred while attempting to connect to your database. Please verify that your connection string is correct and that all required IP addresses for Azure DevOps Services have been provided exceptions for your machines firewall.

List of Azure DevOps Services IPs:

確認您已在 連接字串 中正確輸入資訊，而且您可以連線到 VM。

錯誤訊息清單的IP適用於 Azure DevOps Services。 Azure DevOps Services IP 可以在部署期間暫時變更。 將它們新增至您的防火牆例外狀況，然後再次嘗試佇列匯入。 如需IP位址清單，請參閱 匯入大型集合、僅限制對 Azure DevOps Services IP 的存取

VS403373

數據遷移工具不支援匯入 SAME 集合的多個複本。 不過，它 確實 支持匯入 集合的分割 複本。 變更 DataImportCollectionID 的 GUID。

從 SQL Server Management Studio （SSMS），開啟您尚未匯入之分割複本的擴充屬性。 將新產生的 GUID 新增至 「TFS_DATAIMPORT_COLLECTIONID」 屬性。 然後重新執行 prepare 命令，並使用新的 import.json 檔案將匯入排入佇列。

VS403379

數據匯入失敗，因為在此集合中找到的一或多個專案處於虛刪除階段。 在執行數據匯入之前，請還原虛刪除的專案或永久刪除這些專案。 如需詳細資訊，請參閱 刪除專案。

VS403379: Data import will fail as one or more projects found in this collection are in the soft-deleted stage. Please restore the soft-deleted project(s) or delete them permanently before running the data import.

確認您執行資料遷移工具的集合具有虛刪除階段中的專案。 刪除項目之後，它會保持虛刪除狀態 28 天，在此期間可以還原已刪除的專案。 您可以閱讀如何在還原專案中還原已刪除的專案。 如果您在虛刪除階段中有專案，請在執行數據匯入之前將其完全移除或還原回來。

匯入失敗

匯入失敗表示匯入已排入佇列，但未完成。 將匯入排入佇列的人員會收到失敗的電子郵件通知。 大部分時候，此電子郵件都包含失敗的原因。 如果這樣做，請使用電子郵件和此頁面中提供的疑難解答步驟來解決錯誤，然後重試匯入。

如果錯誤較為複雜，則您收到的電子郵件會提供如何提出客戶支援案例的指示。 提交客戶支援案例之後，您的小組必須讓 Azure DevOps Server 實例重新上線並重新連結您的集合來復原。 然後，您的小組成員就可以繼續工作。 建議您在失敗導致問題解決之前，不要再嘗試匯入。