Share via

Risolvere gli errori di migrazione

  • Articolo

Lo strumento di migrazione dati contrassegna gli errori che è necessario correggere prima di eseguire la migrazione ad Azure DevOps Services. Questo articolo descrive gli avvisi e gli errori più comuni che è possibile ricevere durante la preparazione della migrazione. Dopo aver corretto ogni errore, eseguire di nuovo il comando di convalida della migrazione per verificare la risoluzione.

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

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 indica che la raccolta è troppo grande per la migrazione.

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 indica che la raccolta è troppo grande per la migrazione.

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 indica che la raccolta è troppo grande per la migrazione, ma le dimensioni dei metadati sono maggiori della maggior parte degli altri database.

Dimensioni dei metadati del database oltre le dimensioni massime supportate

A differenza degli avvisi precedenti, l'errore seguente impedirà di procedere con la migrazione.

Indica che il volume di metadati nella raccolta è troppo grande. Per procedere con la migrazione, è necessario ridurre le dimensioni 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 avvisi relativi alle regole di confronto

Gli avvisi sulle regole di confronto fanno riferimento alle regole di confronto del database di raccolta. Le regole di confronto controllano la modalità di ordinamento e confronto dei valori stringa. 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 regole di confronto 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 significa che non è possibile eseguire la migrazione della 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 esecuzione dei test quando si esegue la migrazione di una raccolta con regole di confronto non supportate.

Nessun supporto nativo, nessuna connessione Internet

Se lo strumento di migrazione dei dati non è in grado di connettersi a Internet, non può convalidare la conversione delle regole di confronto. Si tratta solo di un avviso, quindi è possibile continuare con il processo di migrazione. Tuttavia, quando si esegue il comando prepare , è 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

Regole di confronto del database non supportate

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

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 le regole di confronto della raccolta in una delle regole di confronto supportate in Azure DevOps Services.

Risolvere errori di identità

Correggere gli errori di identità prima della migrazione per evitare problemi. Sono rari e si verificano quando le operazioni TFS precedenti non sono valide in un nuovo server Azure DevOps. Ad esempio, alcuni utenti non possono più trovarsi nel gruppo 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 creata include gruppi di utenti validi e raccolta progetti Amministrazione istrators. 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 il comando TFSSecurity da eseguire.

Messaggio di errore Utenti validi per la raccolta di 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", ad esempio nell'esempio seguente, è necessario correggere un'autorizzazione mancante per il gruppo Utenti validi della raccolta di progetti.

Eseguire il comando seguente, sostituire l'ambito con quello del messaggio di errore e specificare l'URL della raccolta.

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

È possibile 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 è simile alla voce seguente:

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 Amministrazione istrators 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 Amministrazione istrators. Eseguire i comandi seguenti su TFSSecurity.exe, sostituire l'ambito con quello del messaggio di errore e specificare la 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 prendere l'ambito e il gruppo SID dal messaggio di errore e aggiungerli 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 la risoluzione. Se alcuni errori rimangono persistenti, contattare il supporto tecnico 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 gruppi 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.

Importante

Assicurarsi di disporre di un backup dei database di raccolta e configurazione prima di eseguire i comandi seguenti per risolvere l'errore.

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. GroupSidCopiare , MemberIde ScopeId come è 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 elenca un esempio di ISVError: 300005 messaggio dello 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 MemberSidoggetto , è necessario ottenere MemberID dalla tabella dbo.tbl_Identity nel database di configurazione. MemberIDCon , è quindi possibile cercare il GUID per .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

GroupSidCopiare , 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 ISVError: 300005'istanza segnalata. È possibile inviare in batch errori con lo stesso ID ambito in un singolo 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 il supporto tecnico di Azure DevOps Services.

Importante

Per risolvere questi errori, è necessario allegare la raccolta.

Se si riceve un risultato -1 quando si esegue il comando, assicurarsi che il database di raccolta che ha generato l'errore sia collegato all'istanza di Azure DevOps Server e che il comando sia in esecuzione nel database di configurazione.

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 hanno esaurito il timeout. In genere, è possibile risolvere questo errore attendendo di eseguire il comando di preparazione 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 dal computer di preparazione . 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 hanno esito negativo o non è possibile trovare l'utente, controllare la connessione tra il computer di preparazione e Microsoft Entra ID. Eseguire una traccia di rete con preparazione per verificare se la rete blocca le chiamate. In caso contrario, contattare supporto tecnico di Azure. Controllare il file di log per le informazioni utente.

Number of active users is {Number of Users}.

Se il numero di utenti attivi è superiore a 50.000, il volume di identità di cui viene eseguito il mapping potrebbe richiedere più tempo rispetto al limite di timeout specificato. Esaminare la raccolta per individuare le inclusioni di gruppi di grandi dimensioni, ad esempio un gruppo "everyone". Se possibile, rimuovere questi gruppi e riprovare. Se non è ancora possibile risolvere questo errore, contattare il supporto tecnico di Azure DevOps Services.

Risolvere errori di processo

Vedere l'articolo Convalida fase, Risolvere i modelli di processo per informazioni dettagliate sulla risoluzione degli errori di processo comuni.

Risolvere errori di convalida 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 la 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, modificare il nome del campo della raccolta. Usare il comando witadmin changefield di 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

Nota

Se il tipo di campo è diverso da HTML o PlainText e i dati dei campi non sono importanti o il campo non viene usato in alcun progetto, è consigliabile eliminare il campo.

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

Importante

L'eliminazione di un campo comporta la perdita di dati di campo nella raccolta.

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.

Aprire il file delle specifiche di migrazione e aggiornare l'area specificata con il nome breve corretto per l'area.

VS403249

Il nome dell'organizzazione selezionato è già in uso da un'organizzazione esistente. Tutte le migrazioni di Azure DevOps Services passano a una nuova organizzazione creata in fase di 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 e VS403286

L'applicazione livello dati non è compilata da una raccolta scollegata.

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.

Scollegare il database di raccolta e generare di nuovo il file DACPAC.

VS403243

Impossibile stabilire una connessione al database usando la stringa sql Connessione ion 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 e VS403351

Il database di raccolta non viene 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 il database di raccolta e ripetere la coda di migrazione.

VS403261

Il stringa di connessione deve essere crittografato; in caso contrario, la password viene inviata in chiaro.

VS403261: The SQL connection string must use encryption.

Aggiungere Encrypt=true al stringa di connessione SQL.

VS403262

Il stringa di connessione deve usare l'autenticazione SQL.

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

Aggiungere Integrated Security=False al stringa di connessione SQL.

VS403263

L'account utente di accesso SQL non ha il ruolo del database necessario.

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 "TF edizione Standard XECROLE".

Nota

Si è verificato un problema noto relativo all'uso sp_addrolemember di per aggiungere TFSEXECROLE a un account di accesso SQL esistente. L'appartenenza al ruolo non viene applicata fino a quando non vengono chiuse tutte le connessioni aperte che usano tale identità. Se viene visualizzato l'errore di VS403263 e si è verificato che l'identità ha il ruolo, è consigliabile creare una nuova identità per la migrazione.

VS403264

Il 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 il stringa di connessione punta al database di raccolta.

VS40325

Azure DevOps Server Update 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 esiste un nuovo carattere di riga. Questo carattere potrebbe rimanere dopo la copia della chiave di firma di accesso condiviso 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.

Rimuovere l'interruzione di riga e riprovare.

VS403271

I file di migrazione e daCPAC non si trovano nell'area di Azure necessaria 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

Incoerenze rilevate in alcuni file di controllo della versione di Team Foundation (TFVC) all'interno della 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.

Collaborare con il supporto clienti di Azure DevOps Services. 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 nel 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. Aggiungerli alle eccezioni del firewall e provare a accodare nuovamente la migrazione. Per un elenco di indirizzi IP, vedere Eseguire la migrazione di raccolte di grandi dimensioni, 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, supporta la migrazione di copie suddivisedi una raccolta. Modificare il GUID per 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". Eseguire quindi di nuovo il comando prepare e usare il nuovo file di migration.json per accodare 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.

Verificare che la raccolta in cui si esegue lo Strumento di migrazione dei dati includa progetti nella fase 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. Per informazioni su come ripristinare un progetto eliminato, vedere Ripristinare un progetto. Se sono presenti progetti nella fase di eliminazione temporanea, rimuoverli completamente o ripristinarli prima di eseguire la migrazione dei dati.

Risolvere gli errori di migrazione

Gli errori di migrazione indicano che la migrazione è stata accodata, ma non è stata completata. L'utente che ha accodato la migrazione riceve una notifica di posta elettronica di errore. 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 un caso di supporto clienti, il team deve eseguire il rollback 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.