Sdílet prostřednictvím

Řešení chyb migrace

Nástroj pro migraci dat označí chyby, které je potřeba opravit před importem do Azure DevOps Services. Tento článek popisuje nejběžnější upozornění a chyby, které se můžou zobrazit při přípravě na import. Po opravě každé chyby znovu spusťte příkaz migrator validate a ověřte správnost.

Další nápovědu najdete v části nejčastější dotazy na konci tohoto článku.

Řešení upozornění týkajících se velikosti

Extra velké kolekce můžou po spuštění nástroje pro migraci dat generovat jednu z následujících zpráv. Pokud se zobrazí některá z těchto upozornění nebo chyb, doporučujeme, abyste se pokusili zmenšit velikost databáze.

Následující upozornění znamená, že k dokončení migrace potřebujete použít metodu virtuálního počítače SQL Azure. Jakmile databáze dosáhne určité velikosti, bude rychlejší nastavit virtuální počítač SQL Azure pro dokončení migrace do Azure DevOps Services. Pokud chcete nastavit virtuální počítač a dokončit migraci, postupujte podle pokynů propojených ze zprávy upozornění.

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

Toto upozornění NEZNAMENÁ, že kolekce je pro migraci příliš velká.

Podobně jako v předchozím upozornění následující upozornění znamená, že k dokončení migrace musíte použít metodu virtuálního počítače SQL Azure. Pokud chcete nastavit virtuální počítač a dokončit migraci, postupujte podle pokynů propojených ze zprávy upozornění.

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

Toto upozornění NEZNAMENÁ, že kolekce je pro migraci příliš velká.

Následující upozornění znamená, že se vaše databáze blíží limitu celkové velikosti metadat. Velikost metadat odkazuje na velikost databáze bez zahrnutí souborů, kódu a dalších binárních dat. Před migrací doporučujeme zmenšit velikost databáze. Zmenšení velikosti poskytuje další výhodu zrychlení migrace.

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).

Upozornění NEZNAMENÁ, že je vaše kolekce pro migraci příliš velká, ale její velikost metadat je větší než většina ostatních databází.

Velikost metadat databáze nad maximální podporovanou velikostí

Na rozdíl od předchozích upozornění vás následující chyba BUDE při migraci zablokovat.

Označuje, že objem metadat v kolekci je příliš velký. Pokud chcete pokračovat v migraci, musíte zmenšit velikost pod zadaný limit.

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

Řešte upozornění ohledně kolace

Upozornění týkající se kolace se vztahují k databázi vaší kolekce. Kolace řídí způsob řazení a porovnávání řetězcových hodnot. Kolekce, které nepoužívají buď SQL_Latin1_General_CP1_CI_AS, nebo Latin1_General_CI_AS, obdrží jednu ze zpráv upozornění .

Žádná nativní podpora

Když se zobrazí následující upozornění, musíte před provedením migrace zvážit důsledky kolace.

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

Toto upozornění NEZNAMENÁ, že nemůžete migrovat kolekci.

Toto upozornění vyžaduje potvrzení přijetí upozornění. Přijetím upozornění umožníte nástroji pro migraci dat pokračovat v přípravách migrace.

Při migraci nepodporované skladby znaků do Azure DevOps Services se skladba znaků transformuje na podporovanou. I když tato transformace obecně funguje bez problému, může dojít k neočekávaným výsledkům po migraci nebo selhání migrace.

Zákazníci si například mohou všimnout různých pořadí řetězců obsahujících znaky jiných jazyků. Neanglické znaky, jako je é, se po migraci můžou stát ekvivalentem anglického znaku "e". Je důležité, abyste dokončili a ověřili zkušební migraci při migraci kolekce s nepodporovanou kolací.

Žádná nativní podpora, žádné připojení k internetu

Pokud se nástroj pro migraci dat nemůže připojit k internetu, nemůže ověřit převod vaší kolace. Je to jenom upozornění, takže můžete pokračovat v procesu migrace. Když však spustíte příkaz připravit, vyžaduje se připojení k internetu a převod kolace se v tuto chvíli ověří.

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 migration 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

Nepodporovaná kolace databáze

Obecně platí, že v době migrace můžete převést nepodporovanou kolaci na podporovanou kolaci. Některé kolace se ale nedají převést. Pokud vaše kolekce používá jednu z těchto kolací, obdržíte následující chybovou zprávu .

The collection database's collation '{collation}' is not supported for migration 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

Abyste mohli pokračovat, musíte změnit kolaci kolekce na jednu z podporovaných kolací ve službě Azure DevOps Services.

Řešení chyb identit

Opravte chyby identit před migrací, abyste zabránili problémům. Tyto chyby jsou vzácné a dochází k nim v případě, že staré operace na novém serveru Azure DevOps nejsou platné. Někteří uživatelé už například nemusí být součástí platné skupiny uživatelů.

Následující části obsahují pokyny k řešení nejběžnějších chyb identit.

IsVError: 100014

Tato chyba značí, že ve skupině zabezpečení systému chybí oprávnění. Každá kolekce, kterou vytvoříte, má například skupiny Platné uživatele kolekce projektů a správci kolekcí projektů. Systém je ve výchozím nastavení vytvoří. Tyto skupiny nepodporují úpravy jejich oprávnění.

Tato chyba značí, že jedna nebo více skupin nemá oprávnění, které by měla mít. Pokud chcete tuto chybu vyřešit, použijte příkaz TFSSecurity.exe k aplikaci očekávaných oprávnění na označené systémové skupiny. Prvním krokem je identifikace příkazu TFSSecurity, který potřebujete spustit.

Chybová zpráva pro platné uživatele kolekce projektů

Projděte si jednu nebo více chybových zpráv, které nástroj pro migraci dat zvýraznil. Pokud skupina označená příznakem končí na "0-0-0-0-3", například v následujícím příkladu, musíte opravit chybějící oprávnění pro skupinu platné uživatele kolekce projektů .

Spusťte následující příkaz, nahraďte obor oborem z chybové zprávy a zadejte adresu URL kolekce.

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

Obor a ID zabezpečení skupiny (SID) určíte z chybové zprávy.

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

Poslední příkaz se podobá následující položce:

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

Chybová zpráva správců kolekcí projektů

Pečlivě zkontrolujte chybové zprávy zvýrazněné nástrojem pro migraci dat. Pokud skupina označená příznakem končící na "0-0-0-0-1", například v následujícím příkladu, musíte opravit chybějící oprávnění pro skupinu správce kolekce projektů. Spusťte následující příkazy pro TFSSecurity.exe, nahraďte obor oborem z chybové zprávy a zadejte kolekci.

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}

V následujícím příkladu převezměte obor a skupinu SID z chybové zprávy a přidejte je do předchozího příkazu.

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

Poslední příkaz se podobá následující položce:

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

Pokud potřebujete opravit více chyb, doporučujeme vytvořit dávkový soubor pro automatizaci provádění příkazů. Po spuštění příkazů znovu spusťte nástroj pro validaci migrace dat a ověření, abyste potvrdili vyřešení. Pokud některé chyby přetrvávají, kontaktujte zákaznickou podporu azure DevOps Services.

IsVError: 300005

ISVError: 300005 indikuje, že identita mimo skupinu je členem skupiny pro všechny, běžně známé jako skupina Valid Users. Platné skupiny Uživatelů jsou výchozí skupiny definované pro všechny projekty a kolekce. Tyto skupiny se nedají upravovat. Jsou navržené tak, aby obsahovaly jenom další oprávnění Azure DevOps nebo skupiny zabezpečení jako členy. Tato chyba značí, že skupina služby Active Directory (AD) nebo identita uživatele má přímé členství ve skupině Platné uživatele.

Důležité

Před spuštěním následujících příkazů se ujistěte, že máte zálohu kolekcí a konfiguračních databází, abyste chybu vyřešili.

Vzhledem k tomu, že nemůžete přímo upravovat skupiny Valid Users, musíte spustit příkaz SQL pro konfigurační databázi, aby se odebrala neplatná identita a opravili neplatné členství. Pečlivě zkontrolujte chybové zprávy zvýrazněné nástrojem pro migraci dat. Zkopírujte GroupSid, MemberIda ScopeId, protože tyto hodnoty potřebujete umístit do následujícího příkazu.

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

Následující příklad uvádí příklad zprávy chyby ISVError: 300005 z nástroje pro migraci dat.

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

Pokud chybová zpráva obsahuje MemberSid, musíte získat MemberID z tabulky dbo.tbl_Identity v konfigurační databázi. Pomocí MemberIDpak můžete vyhledat identifikátor GUID pro MemberSid.

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

Zkopírujte GroupSid, MemberIda ScopeId do příkazu 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'

Spusťte dokončený příkaz pro konfigurační databázi Azure DevOps Serveru. Opakujte tento příkaz pro každou isVError: 300005 hlášené instance. Můžete chyby se stejným ID oboru dávkovat do jednoho příkazu. Po spuštění příkazů znovu spusťte nástroj pro migraci dat, abyste se ujistili, že se chyby opraví. Pokud chyby přetrvávají, obraťte se na zákaznickou podporu Azure DevOps Services.

Důležité

Aby bylo možné tyto chyby vyřešit, musí být kolekce připojena.

Pokud se při spuštění příkazu zobrazí -1 výsledek, ujistěte se, že je databáze kolekce, která vytvořila chybu, připojena k instanci Azure DevOps Serveru a že spouštíte příkaz v konfigurační databázi.

Výjimka časového limitu Microsoft Entra

Ve výjimečných případech se při spuštění příkazu Příprava nástroje pro migraci dat může zobrazit chyba časového limitu Microsoft Entra.

Exception Message: Request failed (type AadGraphTimeoutException)

Tato chyba znamená, že vypršel časový limit požadavků na ID Microsoft Entra k vyhledání odpovídajících identit Microsoft Entra pro uživatele ve vaší kolekci. Obecně platí, že tuto chybu můžete vyřešit tak, že počkáte na spuštění připravit příkaz v méně zaneprázdněné době dne, například po běžné pracovní době.

Pokud chcete vyřešit potíže, otestujte připojení Microsoft Entra ID z připraveného počítače. Podle těchto kroků získáte informace o uživateli z ID Microsoft Entra.

Otevřete PowerShell v režimu se zvýšenými oprávněními a v následujícím příkazu nahraďte 'someone@somecompany.com' svou identitou uživatele Microsoft Entra.

# 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'"

Pokud kroky selžou nebo nemůžete najít uživatele, zkontrolujte připojení mezi počítačem přípravy a ID Microsoft Entra. Spusťte trasování sítě pomocí a připravte, abyste zjistili, jestli blokuje síť volání. Pokud ne, obraťte se na podporu Azure. Zkontrolujte informace o uživateli v souboru protokolu.

Number of active users is {Number of Users}.

Pokud počet aktivních uživatelů přesahuje 50 000, může mapování množství identit vyžadovat více času, než je stanoveno v časovém limitu. Prozkoumejte kolekci a zkontrolujte zahrnutí velkých skupin, jako je skupina "všichni". Pokud je to možné, odeberte tyto skupiny a zkuste to znovu. Pokud se vám tato chyba stále nedaří vyřešit, obraťte se na zákaznickou podporu služby Azure DevOps.

Řešení chyb procesu

Podrobnosti o řešení běžných chyb procesu najdete v článku o fázi ověření a v článku o šablonách procesů.

Řešení chyb ověřování polí

VS403310

Následující chybová zpráva může nastat, když je zjištěna nekonzistence v souborech kolekce. Pokud dojde k této chybě, obraťte se na zákaznickou podporu.

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

VS403442

Mezi místní kolekcí a systémovým polem Azure DevOps Services někdy dochází ke konfliktům názvů polí.

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

Pokud chcete tuto chybu vyřešit, změňte název pole kolekce. Použijte příkaz witadmin changefield z witadmin .

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

VS403443

Následující chyba značí konflikt názvů polí mezi vaší místní kolekcí a konkrétním polem Azure DevOps Services.

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

Pokud chcete tuto chybu vyřešit, použijte příkaz witadmin changefield. Podrobnosti viz witadmin.

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

VS403444

Následující chyba značí konflikt typu pole mezi místní kolekcí a službou Azure DevOps Services.

Pomocí witadminmůžete změnit datový typ pouze pro pole HTML nebo PlainText.

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

Pokud je váš typ pole HTML nebo PlainText, můžete jeho typ změnit na požadovaný typ.

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

Poznámka:

Pokud se váš typ pole liší od html nebo prostého textu a data polí nejsou důležitá nebo se pole nepoužívá v žádném projektu, doporučujeme pole odstranit.

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

Důležité

Odstraněním pole dojde ke ztrátě dat polí v kolekci.

Řešení chyb ověření

Selhání ověření znamenají, že se migrace nespustí. Nástroj pro migraci dat se pokusil o vytvoření fronty migrace, ale místo toho došlo k chybě. Vaše žádost o migraci není platná. Opravte chybové zprávy a zkuste migrovat znovu.

VS403254

Oblast, kterou jste zadali pro migraci azure DevOps Services, se nepodporuje.

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

Otevřete soubor specifikace migrace a aktualizujte oblast, kterou jste zadali se správným krátkým názvem oblasti.

VS403249

Vybraný tým už používá název vaší organizace. Všechny migrace Azure DevOps Services jsou zahrnuty do nové organizace, která je vytvořena během migrace.

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

Před opakováním migrace vyberte jiný název organizace a aktualizujte soubor specifikace migrace.

VS403250 a VS403286

DaCPAC není sestavena z odpojené kolekce.

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.

Odpojte databázi kolekce a znovu vygenerujte DACPAC.

VS403243

Nelze vytvořit připojení k databázi pomocí zadaného připojovacího řetězce SQL.

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

Zkontrolujte zadané parametry, abyste měli jistotu, že jsou správné, a zkuste to znovu.

VS403260 a VS403351

Databáze kolekce není odpojená.

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.

Odpoj databázi kolekce a zkuste znovu frontu migrace.

VS403261

Připojovací řetězec musí být zašifrovaný, jinak se heslo odešle v nezašifrovaném kódu.

VS403261: The SQL connection string must use encryption.

Přidejte do připojovacího řetězce SQL Encrypt=true.

VS403262

Připojovací řetězec musí používat ověřování SQL.

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

Přidejte do připojovacího řetězce SQL Integrated Security=False.

VS403263

Přihlašovací uživatelský účet SQL nemá požadovanou roli databáze.

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

Ujistěte se, že uživatelskému účtu pro přihlášení je přiřazena role 'TFSEXECROLE'.

Poznámka:

Existuje známý problém s použitím sp_addrolemember k přidání TFSEXECROLE do existujícího přihlášení SQL. Členství v roli se nepoužije, dokud se nezavřou všechna otevřená připojení používající danou identitu. Pokud se zobrazí chyba VS403263 a ověřili jste, že vaše identita má roli, doporučujeme pro migraci vytvořit novou identitu.

VS403264

Připojovací řetězec neodkazuje na databázi kolekce Azure DevOps Serveru.

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

Ověřte nebo opravte připojovací řetězec odkazující na vaši databázi kolekce.

VS40325

Aktualizace Azure DevOps Server zařadila úlohu migrace souborů do fronty. Migrace nemůžete provádět, dokud se tato úloha nedokončí. Doba dokončení pro tuto úlohu závisí na velikosti kolekce.

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

Průběh úlohy můžete sledovat spuštěním následujícího dotazu v databázi kolekce:

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

Jakmile je počet souborů, které zbývá migrovat, nula, můžete spustit nástroj pro migraci dat.

VS403282

Ve zdrojové hodnotě umístění existuje nový znak řádku. Tento znak může zůstat po zkopírování klíče SAS z konzoly windows.

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

Odstraňte konec řádku a zkuste to znovu.

VS403271

Vaše migrační soubory a DACPAC se nenachází v požadované oblasti Azure pro dokončení migrace do cílové oblasti Azure DevOps Services.

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

Vytvořte nový účet úložiště Microsoft Azure v požadované oblasti a zkopírujte soubory. Následující příklad ukazuje, jak kopírovat data pomocí 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

V některých souborech správy verzí Team Foundation (TFVC) v kolekci byly zjištěny nekonzistence.

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

Spolupracujte se zákaznickou podporou služby Azure DevOps Services . Otevřete podpůrný ticket a pracovníci podpory s vámi spolupracují na vyřešení chyby.

VS403366

Nástroj pro migraci dat se nemohl připojit k virtuálnímu počítači SQL Azure.

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:

Ověřte, že jste správně zadali informace v připojovacím řetězci a že se můžete připojit k virtuálnímu počítači.

IP adresy, které obsahuje seznam chybových zpráv, jsou určené pro Azure DevOps Services. IP adresy Azure DevOps Services se během nasazení můžou dočasně změnit. Přidejte je do výjimek brány firewall a zkuste migraci zařadit do fronty. Seznam IP adres najdete v tématu Migrace velkých kolekcí, omezení přístupu pouze na IP adresy Azure DevOps Services.

VS403373

Nástroj pro migraci dat nepodporuje migraci více kopií kolekce SAME. ale podporuje migraci rozdělení kopií kolekce. Změňte GUID pro DataImportCollectionID.

V aplikaci SQL Server Management Studio (SSMS) otevřete rozšířené vlastnosti rozdělených kopií, které jste ještě nemigrovali. Do vlastnosti "TFS_DATAIMPORT_COLLECTIONID" přidejte nově vygenerovaný identifikátor GUID. Pak znovu spusťte příkaz připravit a pomocí nového souboru migration.json zařaďte migraci do fronty.

VS403379

Migrace dat selže, protože jeden nebo více projektů nalezených v této kolekci je v režimu měkkého smazání. Před spuštěním migrace dat obnovte měkkou smazané projekty nebo je trvale odstraňte. Podrobnosti najdete v tématu Odstranění projektu.

VS403379: Data migration 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 migration.

Ověřte, zda kolekce, proti které spouštíte nástroj pro migraci dat, obsahuje projekty ve fázi měkkého odstranění. Po odstranění projektu zůstane po dobu 28 dnů ve stavu obnovitelného odstranění, během kterého je možné odstraněný projekt obnovit. Můžete si přečíst, jak obnovit odstraněný projekt, v sekci Obnovit projekt. Pokud máte projekty ve fázi obnovitelného odstranění, před spuštěním migrace dat je úplně odeberte nebo je znovu obnovte.

Řešení chyb migrace

Selhání migrace znamenají, že migrace byla ve frontě, ale nedokončila se. Jednotlivec, který migraci zařadil do fronty, obdrží e-mailové oznámení o selhání. Většinou tento e-mail obsahuje důvod selhání. Pokud ano, pomocí kroků pro řešení potíží uvedených v e-mailu a na této stránce vyřešte chyby a zkuste migraci zopakovat.

Pokud je chyba složitější, najdete v e-mailu, který dostanete, pokyny k vytvoření případu zákaznické podpory. Jakmile odešlete případ zákaznické podpory, váš tým musí vrátit instanci Azure DevOps Serveru online a znovu ji propojit s kolekcí. Členové vašeho týmu pak budou moct pokračovat v práci. Doporučujeme, abyste migraci nepokusili znovu, dokud se problém nevyřeší.

Řešení potíží s migrací pomocí AI

Následující příklad výzvy ke službě Copilot Chat vám pomůže vyřešit chyby nástroje pro migraci dat Azure DevOps a problémy s migrací. Zkopírujte a vložte tuto výzvu do chatu Copilot a nahraďte zástupné symboly vašimi konkrétními informacemi.

Pokud potřebujete nejlepší pomoc s AI, uveďte konkrétní podrobnosti, jako je přesný kód chyby, fáze migrace, kde došlo k chybě, informace o velikosti databáze a všechny související podrobnosti konfigurace.

I'm encountering this Azure DevOps migration error: [PASTE YOUR ERROR MESSAGE HERE]

Migration details:
- Error code: [ERROR CODE like VS403###, ISVError:###]
- Migration phase: [VALIDATION/PREPARATION/MIGRATION phase]
- Collection database size: [SIZE IN GB if known]
- Migration method: [DACPAC/SQL Azure VM]
- Azure DevOps Server version: [VERSION like 2019, 2020, 2022]
- Target Azure region: [REGION like East US, West Europe]
- Collation: [DATABASE COLLATION if known]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the migration error
2. Fix the database, configuration, or migration settings issue
3. Verify the solution allows migration to proceed

Context: This is for migrating from Azure DevOps Server to Azure DevOps Services using the Data Migration Tool. The error might be related to database size, collation, identity permissions, field conflicts, process templates, or connection string issues.

Copilot využívá AI, takže překvapení a chyby jsou možné. Další informace najdete v tématu Nejčastější dotazy k obecnému použití copilotu.

Nejčastější dotazy

Otázka: Co mám dělat, když se migrace zařadila do fronty, ale selhala a nepřišel mi e-mail s dalšími kroky?

A: Pokud vaše migrace byla zařazena do fronty, ale selhala a neobdrželi jste e-mailové oznámení, postupujte takto:

  • Zkontrolujte protokoly migrace: Zkontrolujte protokoly migrace a vyhledejte chybové zprávy, které můžou značit příčinu selhání. Protokoly můžou poskytnout přehled o tom, co se během procesu migrace nepovedlo.
  • Postupujte podle kroků pro řešení potíží: Projděte si postup řešení potíží popsaný v tomto průvodci odstraňováním potíží s migrací. Tyto kroky vám můžou pomoct identifikovat a vyřešit běžné problémy, které mohly způsobit selhání.
  • kontaktujte zákaznickou podporu: Pokud je chyba složitá nebo nemůžete problém vyřešit pomocí protokolů a kroků pro řešení potíží, zvažte podání žádosti o podporu pro další pomoc.
  • Vrácení změn a opakování: V případě potřeby obnovte instanci Azure DevOps Serveru a před dalším pokusem o migraci znovu připojte kolekci.

Související obsah

  • Last updated on