Compartilhar via

Resolver erros de migração

  • Artigo

A Ferramenta de Migração de Dados sinaliza erros que você precisa corrigir antes de importar para o Azure DevOps Services. Este artigo descreve os avisos e erros mais comuns que você pode receber ao se preparar para importar. Depois de corrigir cada erro, execute novamente o comando validar migrador para verificar a resolução.

Para obter mais ajuda, consulte a seção perguntas frequentes no final deste artigo.

Resolver avisos de tamanho

Coleções extra-grandes podem gerar uma das seguintes mensagens depois de executar a Ferramenta de Migração de Dados. Se você receber qualquer um desses avisos ou erros, recomendamos que você tente reduzir o tamanho do banco de dados.

O aviso a seguir significa que você precisa usar o método de VM do SQL Azure para completar sua migração. Quando um banco de dados atinge um determinado tamanho, torna-se mais rápido configurar uma VM do Azure do SQL para concluir a migração para o Azure DevOps Services. Para configurar a VM e concluir a migração, siga as instruções vinculadas da mensagem de aviso.

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

Este aviso NÃO significa que sua coleção é muito grande para migração.

Semelhante ao aviso anterior, o aviso a seguir significa que você deve usar o método VM (Máquina Virtual) do SQL Azure para concluir a migração. Para configurar a VM e concluir a migração, siga as instruções vinculadas da mensagem de aviso.

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

Este aviso NÃO significa que sua coleção é muito grande para migração.

O aviso a seguir significa que seu banco de dados está se aproximando do limite para o tamanho total de metadados. O tamanho dos metadados refere-se ao tamanho do banco de dados sem incluir arquivos, código e outros dados binários. Recomendamos que você reduza o tamanho do banco de dados antes da migração. Reduzir o tamanho fornece o outro benefício de acelerar sua migração.

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

O aviso NÃO significa que sua coleção é muito grande para migração, em vez disso, seu tamanho de metadados é maior do que a maioria dos outros bancos de dados.

Tamanho dos metadados do banco de dados excede o tamanho máximo suportado

Diferente de avisos anteriores, o erro a seguir IRÁ impedir que você continue realizando a migração.

Indica que o volume de metadados em sua coleção é muito grande. Para continuar com a migração, você precisa reduzir o tamanho para ficar abaixo do limite indicado.

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

Resolver avisos de agrupamento

Os avisos de agrupamento referem-se ao agrupamento do banco de dados da coleção. As ordenações controlam a maneira como os valores de cadeia de caracteres são classificados e comparados. Coleções que não estão usando SQL_Latin1_General_CP1_CI_AS nem Latin1_General_CI_AS recebem uma das mensagens de aviso.

Sem suporte nativo

Receber o aviso a seguir significa que você precisa considerar os envolvimentos da ordenação antes de executar a migração.

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

Este aviso NÃO significa que você não pode migrar sua coleção.

Este aviso exige que você reconheça a aceitação do aviso. Aceitar o aviso permite que a Ferramenta de Migração de Dados continue os preparativos para a migração.

Quando você migra uma ordenação sem suporte para o Azure DevOps Services, a ordenação é transformada em uma ordenação com suporte. Embora essa transformação geralmente funcione sem problemas, resultados inesperados após a migração ou falhas de migração podem ocorrer.

Por exemplo, os clientes podem observar ordenações diferentes para cadeias de caracteres que contêm caracteres que não são em inglês. Caracteres que não são em inglês, como 'é', podem se tornar equivalentes ao inglês 'e' após a migração. Ao migrar uma coleção com uma ordenação sem suporte, é importante executar e verificar uma migração de teste.

Sem suporte nativo, sem conexão com a Internet

Se a Ferramenta de Migração de Dados não puder se conectar à Internet, ela não poderá validar a conversão da ordenação. É apenas um aviso, para que você possa continuar com o processo de migração. No entanto, ao executar o comando preparar, é necessária uma conexão com a Internet, e a conversão de ordenação é validada nesse momento.

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

Ordenação de banco de dados sem suporte

Geralmente, você pode converter uma ordenação sem suporte em uma ordenação com suporte no momento da migração. Entretanto, determinadas ordenações não podem ser convertidas. Se sua coleção usar uma dessas ordenações, você receberá a seguinte mensagem de erro .

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

Para continuar, você precisa alterar a ordenação da coleção para uma das ordenações com suporte no Azure DevOps Services.

Resolver erros de identidade

Corrija erros de identidade antes da migração para evitar problemas. Esses erros são raros e ocorrem quando operações antigas são inválidas em um novo Servidor do Azure DevOps. Por exemplo, alguns usuários podem não fazer mais parte do grupo de usuários válido.

As seções a seguir fornecem diretrizes para resolver os erros de identidade mais comuns.

ISVError: 100014

Esse erro indica que uma permissão está ausente de um grupo de segurança do sistema. Por exemplo, cada coleção criada tem grupos de Administradores de Coleção de Projetos e Usuários Válidos da Coleção de Projetos. O sistema os cria por padrão. Esses grupos não dão suporte à edição de suas permissões.

Esse erro indica que um ou mais grupos estão perdendo uma permissão que ele deve ter. Para resolver esse erro, use o comando TFSSecurity.exe para aplicar as permissões esperadas aos grupos de sistema sinalizados. Sua primeira etapa é identificar qual comando TFSSecurity que você precisa executar.

Mensagem de erro Usuários Válidos da Coleção de Projetos

Examine uma ou mais mensagens de erro realçadas pela Ferramenta de Migração de Dados. Se o grupo sinalizado terminar com "0-0-0-0-3", como no exemplo a seguir, será necessário corrigir uma permissão ausente para o grupo Usuários Válidos da Coleção de Projetos.

Execute o comando a seguir, substitua o escopo pelo da mensagem de erro e especifique a URL da coleção.

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

Você determina o escopo e a SID (ID de segurança de grupo) da mensagem de erro.

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

O comando final é semelhante à seguinte entrada:

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

Mensagem de erro dos administradores da coleção de projetos

Examine cuidadosamente as mensagens de erro realçadas pela Ferramenta de Migração de Dados. Se o grupo sinalizado terminar com "0-0-0-0-1", como no exemplo a seguir, então será necessário corrigir uma permissão ausente para o grupo Administradores da Coleção de Projetos. Execute os comandos a seguir em TFSSecurity.exe, substitua o escopo pelo da mensagem de erro e especifique sua coleção.

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}

No exemplo a seguir, tire o escopo e o grupo SID da mensagem de erro e adicione-os ao comando anterior.

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

O comando final é semelhante à seguinte entrada:

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

Quando você precisa corrigir vários erros, recomendamos que você crie um arquivo em lote para automatizar a execução dos comandos. Depois de executar os comandos, execute a ferramenta de validação de migração de dados novamente, para verificar a resolução. Se alguns erros ainda persistirem, entre em contato com o suporte ao cliente do Azure DevOps Services .

ISVError: 300005

ISVError: 300005 indica que uma identidade que não pertence a um grupo é membro de um grupo que inclui todos, mais comumente conhecido como grupo de Usuários Válidos. Grupos de usuários válidos são grupos padrão definidos para todos os projetos e coleções. Esses grupos não são editáveis. Eles foram projetados para conter apenas outros grupos de segurança ou permissão do Azure DevOps como membros. Esse erro indica que um grupo ou identidade de usuário do Active Directory (AD) tem uma associação direta em um grupo de Usuários Válidos.

Importante

Verifique se você tem um backup de sua coleção e bancos de dados de configuração antes de executar os comandos a seguir para resolver o erro.

Como você não pode editar diretamente grupos de Usuários Válidos, é necessário executar uma instrução SQL no banco de dados de configuração para remover a identidade ofensiva e corrigir a associação inválida. Examine cuidadosamente as mensagens de erro realçadas pela Ferramenta de Migração de Dados. Copie o GroupSid, MemberIde ScopeId, pois você precisa colocar esses valores no comando a seguir.

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

O exemplo a seguir lista uma mensagem ISVError: 300005 da Ferramenta de Migração de Dados.

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

Se a mensagem de erro listar um MemberSid, você precisará obter o MemberID da tabela dbo.tbl_Identity no banco de dados de configuração. Com o MemberID, você pode procurar o GUID para o 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

Copie o GroupSid, MemberIde ScopeId no comando 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'

Execute o comando concluído no banco de dados de configuração do Servidor do Azure DevOps. Repita este comando para cada instância ISVError: 300005 relatada. Você pode agrupar erros com o mesmo identificador de escopo em um único comando. Depois de executar os comandos, execute novamente a Ferramenta de Migração de Dados para garantir que os erros sejam corrigidos. Se os erros ainda persistirem, entre em contato com o suporte ao cliente do Azure DevOps Services.

Importante

Para resolver esses erros, a coleção deve ser anexada.

Se você receber um resultado -1 ao executar o comando, verifique se o banco de dados de coleção que produziu o erro está anexado à instância do Servidor do Azure DevOps e se você está executando o comando no banco de dados de configuração.

Exceção de tempo limite do Microsoft Entra

Em raras ocasiões, você pode receber um erro de tempo limite do Microsoft Entra ao executar o comando de preparação da Ferramenta de Migração de Dados.

Exception Message: Request failed (type AadGraphTimeoutException)

Esse erro significa que as solicitações ao Microsoft Entra ID para localizar as identidades correspondentes do Microsoft Entra para usuários em sua coleção esgotaram o tempo limite. Em geral, você pode resolver esse erro aguardando para executar o comando preparar em uma hora menos movimentada do dia, como após o horário comercial regular.

Para solucionar problemas, teste a conexão do Microsoft Entra ID de preparar o computador. Siga estas etapas para obter dados do usuário do Microsoft Entra ID.

Abra o PowerShell no modo elevado e substitua 'someone@somecompany.com' no comando a seguir pela sua identidade de usuário do 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'"

Se as etapas falharem ou você não conseguir encontrar o usuário, verifique a conexão entre o prepare computador e o Microsoft Entra ID. Execute um rastreamento de rede usando e prepare para ver se a rede bloqueia chamadas. Caso contrário, entre em contato com o suporte do Azure. Verifique o arquivo de log para obter as informações do usuário.

Number of active users is {Number of Users}.

Se o número de usuários ativos for maior que 50.000, o volume de identidades mapeadas poderá exigir mais tempo do que o fornecido pelo limite de tempo limite. Inspecione sua coleção em busca de inclusões de grupos grandes, como um grupo "todos". Se possível, remova esses grupos e tente novamente. Se você ainda não conseguir resolver esse erro, entre em contato com o suporte ao cliente do Azure DevOps Services .

Resolver erros de processo

Para obter detalhes sobre como resolver erros comuns do processo, consulte o artigo Validar fase, Resolver modelos de processo.

Resolver erros de validação de campo

VS403310

A mensagem de erro a seguir pode ocorrer quando uma inconsistência nos arquivos de coleção é detectada. Entre em contato com o suporte ao cliente se encontrar esse erro.

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

VS403442

Às vezes, ocorrem conflitos de nome de campo entre sua coleção local e um campo de sistema do Azure DevOps Services.

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

Para resolver esse erro, altere o nome do campo de coleção. Use o comando witadmin changefield de witadmin.

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

VS403443

O erro a seguir indica que existe um conflito de nome de campo entre sua coleção local e um campo específico do Azure DevOps Services.

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

Para resolver esse erro, use o comando witadmin changefield. Para obter detalhes, consulte witadmin.

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

VS403444

O erro a seguir indica que existe um conflito de tipo de campo entre sua coleção local e o Azure DevOps Services.

Usando witadmin, você pode alterar o tipo de dados somente para campos HTML ou PlainText.

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

Se o tipo de campo for HTML ou PlainText, você poderá alterar seu tipo para o tipo necessário.

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

Nota

Se o tipo de campo for algo diferente de HTML ou PlainText e os dados de campo não forem importantes ou o campo não for usado em nenhum projeto, recomendamos que você exclua o campo.

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

Importante

Excluir um campo resulta em uma perda de dados de campo em toda a coleção.

Resolver falhas de verificação

Falhas de verificação significam que a migração não foi iniciada. A Ferramenta de Migração de Dados tentou enfileirar uma migração, mas recebeu um erro. Sua solicitação de migração não é válida. Corrija as mensagens de erro e tente migrar novamente.

VS403254

Não há suporte para a região que você inseriu para a migração do Azure DevOps Services.

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

Abra o arquivo de especificação de migração e atualize a região que você forneceu com o nome curto correto para a região .

VS403249

O nome da organização selecionado por sua equipe já está em uso por uma organização existente. Todas as migrações do Azure DevOps Services entram em uma nova organização que é criada no momento da migração.

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

Selecione um nome de organização diferente e atualize o arquivo de especificação de migração antes de tentar novamente a migração.

VS403250 & VS403286

O DACPAC não é criado com base em uma coleção desanexada.

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.

Desconecte seu banco de dados da coleção e crie o DACPAC novamente.

VS403243

Não é possível fazer uma conexão com o banco de dados usando a Cadeia de Conexão SQL fornecida.

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

Examine os parâmetros fornecidos para garantir que eles estejam corretos e tente novamente.

VS403260 & VS403351

O banco de dados da coleção não é desconectado.

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.

Desconecte seu banco de dados da coleção e tente enfileirar a migração novamente.

VS403261

A cadeia de conexão deve ser criptografada; do contrário, a senha é enviada em texto claro.

VS403261: The SQL connection string must use encryption.

Adicione Encrypt=true à cadeia de conexão do SQL.

VS403262

A cadeia de conexão deve usar a Autenticação SQL.

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

Adicione Segurança Integrada=False à cadeia de conexão do SQL.

VS403263

Sua conta de usuário de entrada do SQL não tem a função de banco de dados necessária.

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

Verifique se a conta de usuário do fazer login recebeu a função 'TFSEXECROLE'.

Nota

Há um problema conhecido com o uso de sp_addrolemember para adicionar TFSEXECROLE a um logon do SQL existente. A associação de função não é aplicada até que todas as conexões abertas que estiverem usando essa identidade sejam fechadas. Se você receber o erro VS403263 e tiver confirmado que a sua identidade possui essa função, recomendamos criar uma nova identidade para sua migração.

VS403264

A cadeia de conexão não aponta para um banco de dados da coleção do Azure DevOps Server.

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

Verifique ou corrija os pontos da cadeia de conexão ao banco de dados da coleção.

VS40325

A Atualização do Servidor do Azure DevOps enfileirou o trabalho de migração de arquivos. Você não poderá executar migrações até que este trabalho seja concluído. O tempo de conclusão desse trabalho depende do tamanho da coleção.

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

Você pode acompanhar o progresso do trabalho executando a seguinte consulta no banco de dados da coleção:

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

Depois que o número de arquivos restantes a serem migrados for zero, você poderá executar a Ferramenta de Migração de Dados.

VS403282

Existe um novo caractere de linha no valor do local de origem. Esse caractere pode permanecer depois de copiar a chave SAS do console do 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.

Remova a quebra de linha e tente novamente.

VS403271

Os arquivos de migração e o DACPAC não estão localizados na região do Azure necessária para executar a migração para a região de destino do 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.

Criar uma nova conta de armazenamento do Microsoft Azure na região necessária e copiar seus arquivos. O exemplo a seguir mostra como copiar seus dados usando do 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

Inconsistências foram detectadas em alguns arquivos de controle de versão do Team Foundation (TFVC) em sua coleção.

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.

Trabalhe com o suporte ao cliente do Azure DevOps Services. Abra um ticket de suporte, e eles trabalharão com você para resolver o erro.

VS403366

A Ferramenta de Migração de Dados não pôde se conectar à VM do Azure do SQL.

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:

Verifique se você inseriu as informações corretamente na cadeia de conexão e se pode se conectar à VM.

Os IPs que a mensagem de erro lista são para o Azure DevOps Services. Os IPs do Azure DevOps Services podem ser alterados temporariamente durante as implantações. Adicione-os às exceções do firewall e tente enfileirar a migração novamente. Para obter uma lista de endereços IP, consulte Migrar grandes coleções, Restringir o acesso apenas aos IPs do Azure DevOps Services.

VS403373

A Ferramenta de Migração de Dados não dá suporte à migração de várias cópias da coleção SAME. Porém, ele É compatível com a migração de cópias divididas de uma coleção. Altere o GUID para o DataImportCollectionID.

No SSMS (SQL Server Management Studio), abra as propriedades avançadas para as cópias particionadas que você ainda não migrou. Adicione um GUID recém-gerado à propriedade "TFS_DATAIMPORT_COLLECTIONID". Em seguida, execute o comando preparar novamente e use o novo arquivo migration.json para enfileirar a migração.

VS403379

A migração de dados não pode ser concluída porque um ou mais projetos encontrados nesta coleção estão na fase de exclusão temporária. Restaure os projetos excluídos temporariamente ou exclua-os permanentemente antes de executar a migração de dados. Para obter detalhes, consulte Excluir um projeto.

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.

Verifique se a coleção na qual você está executando a Ferramenta de Migração de Dados tem projetos no estado de exclusão temporária. Depois que um projeto é excluído, ele permanece em um estado de exclusão temporária por 28 dias durante o qual o projeto excluído pode ser restaurado. Você pode ler sobre como restaurar um projeto excluído no Restaurar um projeto. Se você tiver projetos no estágio de exclusão reversível, remova-os completamente ou restaure-os antes de executar a migração de dados.

Resolver falhas de migração

Falhas na migração significam que a migração foi enfileirada, mas não executada. A pessoa que enfileirou a migração recebe a notificação de falha por email. Na maioria das vezes, esse email inclui um motivo para a falha. Se isso acontecer, use as etapas de solução de problemas fornecidas no email e nesta página para resolver os erros e tentar novamente sua migração.

Se o erro for mais complexo, o email recebido fornecerá instruções sobre como arquivar um caso de suporte ao cliente. Depois de enviar um caso de suporte ao cliente, sua equipe deve reverter o processo, colocando sua instância do Azure DevOps Server online novamente e reanexando a sua coleção. Os membros da equipe podem continuar trabalhando. Recomendamos que você não tente a migração novamente até que a falha que causa o problema seja resolvida.

Perguntas frequentes

P: O que devo fazer se minha migração foi colocada na fila, mas falhou e não recebi um email com as etapas seguintes?

R: Se a migração foi colocada na fila, mas falhou e você não recebeu uma notificação por e-mail, siga estas etapas:

  • Verifique os logs de migração: examine os logs de migração em busca de mensagens de erro que possam indicar a causa da falha. Os logs podem fornecer insights sobre o que deu errado durante o processo de migração.
  • Siga as etapas de solução de problemas: consulte as etapas de solução de problemas descritas neste guia de solução de problemas de migração. Essas etapas podem ajudá-lo a identificar e resolver problemas comuns que talvez tenham causado a falha.
  • Contate o Suporte ao Cliente: se o erro for complexo ou você não puder resolver o problema usando os logs e as etapas de solução de problemas, considere arquivar um caso de suporte ao cliente para obter mais assistência.
  • Reverter e tentar novamente: Se necessário, reverta sua instância do Azure DevOps Server e reconecte a coleção, antes de tentar repetir a migração.