Risolvere gli errori di migrazione

Lo strumento di migrazione dei dati contrassegna gli errori che è necessario correggere prima di importare in Azure DevOps Services. Questo articolo descrive gli avvisi e gli errori più comuni che è possibile ricevere quando si prepara l'importazione. Dopo aver corretto ogni errore, esegui nuovamente il comando di convalida migrazione per verificare la risoluzione.

Per ulteriori informazioni, consultare la sezione Domande Frequenti alla fine di questo articolo.

Risolvere gli avvisi relativi alle dimensioni

Le raccolte di dimensioni aggiuntive potrebbero generare uno dei messaggi seguenti dopo l'esecuzione dello strumento di migrazione dei dati. Se si riceve uno di questi avvisi o errori, è consigliabile provare a ridurre le dimensioni del database.

Dimensioni del database superiori alle dimensioni consigliate

L'avviso seguente indica che è necessario usare il metodo della macchina virtuale di SQL Azure per completare la migrazione. Quando un database raggiunge una determinata dimensione, diventa più veloce configurare una macchina virtuale di SQL Azure per completare la migrazione ad Azure DevOps Services. Per configurare la macchina virtuale e completare la migrazione, seguire le istruzioni collegate dal messaggio di avviso.

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

Questo avviso NON significa che la raccolta è troppo grande per la migrazione.

Dimensioni della tabella superiori alle dimensioni consigliate

Analogamente all'avviso precedente, l'avviso seguente indica che è necessario usare il metodo macchina virtuale (VM) di SQL Azure per completare la migrazione. Per configurare la macchina virtuale e completare la migrazione, seguire le istruzioni collegate dal messaggio di avviso.

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  

Questo avviso NON significa che la raccolta è troppo grande per la migrazione.

Dimensioni dei metadati del database rispetto alle dimensioni consigliate

L'avviso seguente indica che il database sta raggiungendo il limite per le dimensioni totali dei metadati. Le dimensioni dei metadati si riferiscono alle dimensioni del database senza includere file, codice e altri dati binari. È consigliabile ridurre le dimensioni del database prima della migrazione. La riduzione delle dimensioni offre l'altro vantaggio di velocizzare la migrazione.

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

L'avviso NON significa che la tua raccolta è troppo grande per la migrazione, bensì che la dimensione dei suoi metadati è maggiore rispetto a quella della maggior parte degli altri database.

Dimensioni dei metadati del database oltre le dimensioni massime supportate

A differenza degli avvisi precedenti, l'errore seguente WILL impedire l'avanzamento della migrazione.

Indica che il volume di metadati nella raccolta è troppo grande. Per procedere con la migrazione, è necessario ridurre la dimensione al di sotto del limite indicato.

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

Risolvere gli avvisi delle regole di confronto

Gli avvisi sulle regole di confronto fanno riferimento alle regole di confronto del database di raccolta. Le regole di confronto controllano il modo di ordinare e confrontare i valori delle stringhe. Le raccolte che non usano SQL_Latin1_General_CP1_CI_AS o Latin1_General_CI_AS ricevono uno dei messaggi di avviso .

Nessun supporto nativo

La ricezione dell'avviso seguente indica che è necessario considerare le implicazioni delle collazioni prima di eseguire la migrazione.

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

Questo avviso NON vuol dire che non puoi migrare la tua raccolta.

Questo avviso richiede di confermare l'accettazione dell'avviso. L'accettazione dell'avviso consente allo strumento di migrazione dei dati di continuare le operazioni di preparazione della migrazione.

Quando si esegue la migrazione di regole di confronto non supportate in Azure DevOps Services, le regole di confronto vengono trasformate in regole di confronto supportate. Anche se questa trasformazione funziona in genere senza problemi, potrebbero verificarsi risultati imprevisti dopo la migrazione o errori di migrazione.

Ad esempio, i clienti potrebbero notare un ordine diverso per le stringhe contenenti caratteri non inglesi. I caratteri non inglesi come 'é' potrebbero diventare equivalenti all'inglese 'e' dopo la migrazione. È importante completare e verificare una migrazione di prova quando si migra una raccolta con un ordinamento non supportato.

Nessun supporto nativo, nessuna connessione Internet

Se lo strumento di migrazione dei dati non è in grado di connettersi a internet, non sarà possibile convalidare la conversione della collatione. Si tratta solo di un avviso, quindi è possibile continuare con il processo di migrazione. Tuttavia, quando si esegue il comando preparare, è necessaria una connessione Internet e la conversione delle regole di confronto viene convalidata in quel 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

Ordinamento del database non supportato

In genere è possibile convertire regole di confronto non supportate in regole di confronto supportate in fase di migrazione. Tuttavia, alcune collazioni non possono essere convertite. Se la raccolta usa una di queste regole di confronto, riceverai il seguente messaggio di errore .

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

Per continuare, è necessario modificare la collation della raccolta a una delle collation supportate su Azure DevOps Services.

Risolvere gli errori di identità

Correggere gli errori di identità prima della migrazione per evitare problemi. Questi errori sono rari e si verificano quando le operazioni precedenti non sono valide in un nuovo server Azure DevOps. Ad esempio, alcuni utenti potrebbero non far più parte del gruppo di utenti valido.

Le sezioni seguenti forniscono indicazioni per la risoluzione degli errori di identità più comuni.

ISVError: 100014

Questo errore indica che un'autorizzazione non è presente in un gruppo di sicurezza di sistema. Ad esempio, ogni raccolta che crei include i gruppi Project Collection Valid Users e Project Collection Administrators. Il sistema li crea per impostazione predefinita. Questi gruppi non supportano la modifica delle autorizzazioni.

Questo errore indica che uno o più gruppi non dispongono di un'autorizzazione necessaria. Per risolvere questo errore, usare il comando TFSSecurity.exe per applicare le autorizzazioni previste ai gruppi di sistema contrassegnati. Il primo passaggio consiste nell'identificare quale comando TFSSecurity è necessario eseguire.

Messaggio di errore Utenti validi della raccolta progetti

Esaminare uno o più messaggi di errore evidenziati dallo strumento di migrazione dei dati. Se il gruppo contrassegnato termina con "0-0-0-0-3", come nel seguente esempio, è necessario correggere un'autorizzazione mancante per il gruppo Utenti Validi della Raccolta di Progetti.

Esegui il comando seguente, sostituisci l'ambito con quello del messaggio di errore e specifica l'URL della tua raccolta.

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

Puoi determinare l'ambito e l'ID di sicurezza del gruppo (SID) dal messaggio di errore.

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 

Il comando finale appare simile al seguente elemento:

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

Messaggio di errore degli amministratori della raccolta di progetti

Esaminare attentamente i messaggi di errore evidenziati dallo strumento di migrazione dei dati. Se il gruppo contrassegnato che termina con "0-0-0-0-1", ad esempio nell'esempio seguente, è necessario correggere un'autorizzazione mancante per il gruppo Project Collection Administrators. Eseguire i seguenti comandi su TFSSecurity.exe, sostituendo l'ambito con quello riportato nel messaggio di errore e specificando la vostra raccolta.

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}

Nell'esempio seguente, prendi l'ambito e il gruppo SID dal messaggio d'errore e aggiungili al comando precedente.

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 

Il comando finale è simile alla voce seguente:

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 è necessario correggere più errori, è consigliabile creare un file batch per automatizzare l'esecuzione dei comandi. Dopo aver eseguito i comandi, eseguire di nuovo lo strumento di convalida della migrazione dei dati per verificare che il problema sia risolto. Se alcuni errori rimangono persistenti, contattare supporto clienti di Azure DevOps Services.

ISVError: 300005

ISVError: 300005 indica che un'identità non di gruppo è un membro di un gruppo "tutti", più comunemente noto come gruppo "Utenti Validi". I gruppi utenti validi sono gruppi predefiniti definiti per tutti i progetti e le raccolte. Questi gruppi non sono modificabili. Sono progettati per contenere solo altri gruppi di autorizzazioni o gruppi di sicurezza di Azure DevOps come membri. Questo errore indica che un gruppo di Active Directory (AD) o un'identità utente ha un'appartenenza diretta a un gruppo Utenti validi.

Poiché non è possibile modificare direttamente i gruppi di utenti validi, è necessario eseguire un'istruzione SQL sul database di configurazione per rimuovere l'identità che causa l'errore e correggere l'appartenenza non valida. Esaminare attentamente i messaggi di errore evidenziati dallo Strumento di migrazione dei dati. Copiare il GroupSid, MemberIde ScopeId perché è necessario inserire questi valori nel comando seguente.

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

L'esempio seguente mostra un messaggio ISVError: 300005 dallo strumento di migrazione dei dati.

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 il messaggio di errore elenca un MemberSid, è necessario ottenere il MemberID dalla tabella dbo.tbl_Identity nel database di configurazione. Con il MemberIDè quindi possibile cercare il GUID per il 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

Copiare il GroupSid, MemberIde ScopeId nel 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'

Eseguire il comando completato nel database di configurazione del server Azure DevOps. Ripetere questo comando per ogni istanza di ISVError: 300005 segnalata. È possibile raggruppare in batch errori con lo stesso ID ambito in un unico comando. Dopo aver eseguito i comandi, eseguire di nuovo lo strumento di migrazione dei dati per verificare che gli errori vengano corretti. Se gli errori rimangono persistenti, contattare supporto clienti di Azure DevOps Services.

Eccezione di timeout di Microsoft Entra

In rari casi, è possibile che venga visualizzato un errore di timeout di Microsoft Entra durante l'esecuzione del comando di preparazione dello strumento di migrazione dei dati.

Exception Message: Request failed (type AadGraphTimeoutException)

Questo errore indica che le richieste all'ID Microsoft Entra per trovare le identità di Microsoft Entra corrispondenti per gli utenti nella raccolta sono andate in timeout. In genere, è possibile risolvere questo errore aspettando di eseguire il comando preparare in un orario meno occupato del giorno, ad esempio dopo l'orario di ufficio normale.

Per risolvere i problemi, testare la connessione a Microsoft Entra ID dalla macchina preparata in . Per ottenere informazioni sull'utente da Microsoft Entra ID, seguire questa procedura.

Aprire PowerShell in modalità con privilegi elevati e sostituire 'someone@somecompany.com' nel comando seguente con l'identità utente di 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 i passaggi falliscono o non riesci a trovare l'utente, controlla la connessione tra la preparare macchina e Microsoft Entra ID. Eseguire una traccia di rete con preparare per verificare se la rete blocca le chiamate. In caso contrario, contattare il supporto tecnico di Azure. Controllare il file di log per le informazioni dell'utente.

Number of active users is {Number of Users}.

Se il numero di utenti attivi è superiore a 50.000, il volume di identità che sono mappate potrebbe richiedere più tempo rispetto al limite di timeout previsto. Esamina la raccolta per individuare inclusioni di grandi gruppi, come ad esempio un gruppo "everyone". Se possibile, rimuovere questi gruppi e riprovare. Se non è ancora possibile risolvere questo errore, contattare supporto clienti di Azure DevOps Services.

Risolvere gli errori del processo

Per informazioni dettagliate sulla risoluzione degli errori di processo comuni, vedere l'articolo della fase di convalida e il modello di risoluzione del processo.

Risolvere gli errori di convalida dei campi

VS403310

Il messaggio di errore seguente può verificarsi quando viene rilevata un'incoerenza nei file di raccolta. Se si verifica questo errore, contattare il supporto tecnico.

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

VS403442

Talvolta si verificano conflitti tra i nomi dei campi nella raccolta locale e un campo di sistema di Azure DevOps Services.

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

Per risolvere questo errore, modifica il nome del campo della tua raccolta. Usare il comando witadmin changefield da witadmin.

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

VS403443

L'errore seguente indica che esiste un conflitto di nomi di campo tra la raccolta locale e un campo specifico di Azure DevOps Services.

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

Per risolvere questo errore, usare il comando witadmin changefield. Per informazioni dettagliate, vedere witadmin.

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

VS403444

L'errore seguente indica che esiste un conflitto di tipo di campo tra la raccolta locale e Azure DevOps Services.

Usando witadmin, è possibile modificare il tipo di dati solo per i campi HTML o PlainText.

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

Se il tipo di campo è HTML o PlainText, è possibile modificarne il tipo nel tipo richiesto.

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

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

Risolvere gli errori di verifica

Gli errori di verifica indicano che la migrazione non è stata avviata. Lo strumento di migrazione dei dati ha tentato di accodare una migrazione, ma si è verificato un errore. La richiesta di migrazione non è valida. Correggere i messaggi di errore e quindi riprovare a eseguire la migrazione.

VS403254

L'area immessa per la migrazione di Azure DevOps Services non è supportata.

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

Apri il file di specifiche della migrazione e aggiorna la regione che hai fornito con il nome breve corretto per la regione .

VS403249

Il nome dell'organizzazione selezionato è già in uso da un'organizzazione esistente. Tutte le migrazioni di Azure DevOps Services vengono trasferite a una nuova organizzazione creata al momento della migrazione.

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

Selezionare un nome di organizzazione diverso e aggiornare il file delle specifiche di migrazione prima di riprovare a eseguire la migrazione.

VS403250 & VS403286

Il pacchetto DAC non è costruito da una raccolta separata.

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.

Scollega il tuo database di raccolta e genera di nuovo il file DACPAC.

VS403243

Impossibile stabilire una connessione al database usando la stringa di connessione SQL specificata.

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

Esaminare i parametri forniti per assicurarsi che siano corretti e riprovare.

VS403260 & VS403351

Il database di raccolta non è scollegato.

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.

Scollegare database di raccolta e ripetere la coda di migrazione.

VS403261

La stringa di connessione deve essere crittografata in caso contrario la password viene inviata in chiaro.

VS403261: The SQL connection string must use encryption.

Aggiungere Encrypt=true alla stringa di connessione SQL.

VS403262

La stringa di connessione deve usare l'autenticazione SQL.

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

Aggiungi Integrated Security=False nella stringa di connessione SQL.

VS403263

L'account utente di accesso SQL non ha il ruolo richiesto dal database.

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

Assicurarsi che all'account utente per l'accesso sia assegnato il ruolo 'TFSEXECROLE'.

VS403264

La stringa di connessione non punta a un database di raccolta di Azure DevOps Server.

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

Verificare o correggere la stringa di connessione che punta al tuo database della raccolta.

VS40325

L'aggiornamento del server Azure DevOps ha accodato il processo di migrazione dei file. Non è possibile eseguire migrazioni fino al completamento di questo processo. Il tempo di completamento per questo processo dipende dalle dimensioni della raccolta.

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

È possibile tenere traccia dello stato del processo eseguendo la query seguente nel database di raccolta:

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

Quando il numero di file rimanenti per la migrazione è zero, è possibile eseguire lo strumento di migrazione dei dati.

VS403282

Nel valore della posizione di origine c'è un nuovo carattere di riga. Questo carattere potrebbe rimanere dopo aver copiato la chiave SAS dalla console di 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.

Rimuovi l'interruzione di riga e riprova.

VS403271

I file di migrazione e il file DACPAC non si trovano nella necessaria'area di Azure per completare la migrazione all'area di Azure DevOps Services di destinazione.

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.

Creare un nuovo account di archiviazione di Microsoft Azure nell'area richiesta e copiare i file. L'esempio seguente illustra come copiare i dati usando 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

Sono state rilevate incoerenze in alcuni file di controllo della versione del Team Foundation Version Control (TFVC) nella tua raccolta.

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.

Lavorare con Azure DevOps Services e il supporto clienti. Aprire un ticket di supporto e collaborare con l'utente per risolvere l'errore.

VS403366

Lo strumento di migrazione dei dati non è riuscito a connettersi alla macchina virtuale di 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:

Verificare di aver immesso correttamente le informazioni nella stringa di connessione e di potersi connettere alla macchina virtuale.

Gli indirizzi IP elencati nei messaggi di errore sono per Azure DevOps Services. Gli indirizzi IP di Azure DevOps Services possono cambiare temporaneamente durante le distribuzioni. Aggiungeteli alle eccezioni del firewall e provate a mettere in coda nuovamente la migrazione. Per un elenco degli indirizzi IP, consultare Migrare raccolte di grandi dimensioni e limitare l'accesso solo agli indirizzi IP di Azure DevOps Services.

VS403373

Lo strumento di migrazione dei dati non supporta la migrazione di più copie della raccolta SAME. Tuttavia, DOES supportano la migrazione di copie suddivise di una raccolta. Modificare il GUID per il DataImportCollectionID.

Da SQL Server Management Studio (SSMS), aprire le proprietà estese per le copie suddivise di cui non è ancora stata eseguita la migrazione. Aggiungere un GUID appena generato alla proprietà "TFS_DATAIMPORT_COLLECTIONID". Quindi, rieseguire il comando prepare e utilizzare il nuovo file migration.json per mettere in coda la migrazione.

VS403379

La migrazione dei dati ha esito negativo perché uno o più progetti trovati in questa raccolta si trovano nella fase di eliminazione temporanea. Ripristinare i progetti eliminati temporaneamente o eliminarli definitivamente prima di eseguire la migrazione dei dati. Per informazioni dettagliate, vedere Eliminare un progetto.

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.

Verifica che la raccolta contro la quale stai eseguendo lo Strumento di migrazione dei dati abbia progetti nello stadio di eliminazione temporanea. Una volta eliminato un progetto, rimane in uno stato di eliminazione temporanea per 28 giorni durante il quale è possibile ripristinare il progetto eliminato. È possibile leggere le informazioni su come ripristinare un progetto eliminato in Ripristinare un progetto. Se hai progetti nella fase di eliminazione temporanea (soft-delete), rimuovili completamente o ripristinali prima di eseguire la migrazione dei dati.

Risolvere gli errori di migrazione

I fallimenti di migrazione indicano che la migrazione è stata accodata, ma non è stata completata. L'utente che ha accodato la migrazione riceve una notifica di errore via posta elettronica. Nella maggior parte dei casi, questo messaggio di posta elettronica include un motivo per l'errore. In tal caso, usare i passaggi per la risoluzione dei problemi forniti nel messaggio di posta elettronica e in questa pagina per risolvere gli errori e ripetere la migrazione.

Se l'errore è più complesso, il messaggio di posta elettronica ricevuto fornisce istruzioni su come inviare un caso di supporto clienti . Dopo aver inviato una richiesta di supporto clienti, il team deve eseguire un ripristino riportando online l'istanza di Azure DevOps Server e ricollegando la raccolta. I membri del team possono quindi continuare a lavorare. È consigliabile non ritentare la migrazione finché l'errore che causa il problema non viene risolto.

Domande frequenti

D: Cosa devo fare se la migrazione è stata accodata ma non è riuscita e non ho ricevuto un messaggio di posta elettronica con i passaggi successivi?

R: Se la migrazione è stata accodata ma non è riuscita e non è stata ricevuta una notifica tramite posta elettronica, seguire questa procedura:

• Controllare i log di migrazione: esaminare i log di migrazione per eventuali messaggi di errore che potrebbero indicare la causa dell'errore. I log possono fornire intuizioni su cosa è andato storto durante il processo di migrazione.
• Seguire i passaggi per la risoluzione dei problemi: fare riferimento alla procedura di risoluzione dei problemi descritta in questa guida alla risoluzione dei problemi di migrazione. Questi passaggi consentono di identificare e risolvere i problemi comuni che potrebbero causare l'errore.
• Contattare il supporto tecnico clienti: se l'errore è complesso o non è possibile risolvere il problema usando i log e i passaggi per la risoluzione dei problemi, è consigliabile presentare un caso di supporto clienti per ulteriore assistenza.
• eseguire il rollback e riprovare: Se necessario, eseguire il rollback dell'istanza di Azure DevOps Server e ricollegare la raccolta prima di tentare nuovamente la migrazione.

Articoli correlati

• Completare le attività post-migrazione
• Eliminare un progetto