Beheben von Migrationsfehlern

Das Datenmigrationstool kennzeichnet Fehler, die Sie korrigieren müssen, bevor Sie zu Azure DevOps Services migrieren. In diesem Artikel werden die häufigsten Warnungen und Fehler beschrieben, die beim Vorbereiten der Migration auftreten können. Nachdem Sie jeden Fehler korrigiert haben, führen Sie den Migrationsüberprüfungsbefehl erneut aus, um die Auflösung zu überprüfen.

Beheben von Warnungen zur Größe

Nach dem Ausführen des Datenmigrationstools wird möglicherweise eine der folgenden Meldungen generiert. Wenn Sie eine dieser Warnungen oder Fehler erhalten, empfehlen wir, die Größe Ihrer Datenbank zu verringern.

Datenbankgröße über empfohlene Größe

Die folgende Warnung bedeutet, dass Sie die SQL Azure VM-Methode verwenden müssen, um Ihre Migration abzuschließen. Sobald eine Datenbank eine bestimmte Größe erreicht hat, wird es schneller, eine SQL Azure-VM einzurichten, um die Migration zu Azure DevOps Services abzuschließen. Um den virtuellen Computer einzurichten und die Migration abzuschließen, folgen Sie den Anweisungen, die mit der Warnmeldung verknüpft sind.

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

Diese Warnung bedeutet NICHT , dass Ihre Sammlung für die Migration zu groß ist.

Tabellengröße über empfohlene Größe

Ähnlich wie bei der vorherigen Warnung bedeutet die folgende Warnung, dass Sie die SQL Azure Virtual Machine (VM)-Methode verwenden müssen, um die Migration abzuschließen. Um den virtuellen Computer einzurichten und die Migration abzuschließen, folgen Sie den Anweisungen, die mit der Warnmeldung verknüpft sind.

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  

Diese Warnung bedeutet NICHT , dass Ihre Sammlung für die Migration zu groß ist.

Größe der Datenbankmetadaten über die empfohlene Größe

Die folgende Warnung bedeutet, dass sich die Datenbank dem Grenzwert für die Gesamtmetadatengröße nähert. Die Metadatengröße bezieht sich auf die Größe Ihrer Datenbank, ohne Dateien, Code und andere Binärdaten einzuschlussen. Es wird empfohlen, die Größe Ihrer Datenbank vor der Migration zu verringern. Die Verringerung der Größe bietet den anderen Vorteil, ihre Migration zu beschleunigen.

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

Die Warnung bedeutet NICHT , dass Ihre Sammlung für die Migration zu groß ist, und die Metadatengröße ist größer als die meisten anderen Datenbanken.

Größe der Datenbankmetadaten über die maximale unterstützte Größe

Im Gegensatz zu den vorherigen Warnungen wird durch den folgenden Fehler verhindert, dass Sie mit Ihrer Migration fortfahren.

Es gibt an, dass das Volumen der Metadaten in Ihrer Sammlung zu groß ist. Um mit der Migration fortzufahren, müssen Sie die Größe unter dem angegebenen Grenzwert verringern .

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

Beheben von Warnungen zur Sortierung

Sortierwarnungen beziehen sich auf die Sortierung der Sammlungsdatenbank. Sortierungen steuern, wie Zeichenfolgenwerte sortiert und verglichen werden. Sammlungen, die weder eine SQL_Latin1_General_CP1_CI_AS der Warnmeldungen verwenden noch Latin1_General_CI_AS empfangen.

Keine native Unterstützung

Wenn Sie die folgende Warnung erhalten, müssen Sie die Auswirkungen der Sortierung berücksichtigen, bevor Sie die Migration durchführen.

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

Diese Warnung bedeutet NICHT , dass Sie Ihre Sammlung nicht migrieren können.

Diese Warnung erfordert, dass Sie die Annahme der Warnung bestätigen. Durch Akzeptieren der Warnung kann das Datenmigrationstool die Migrationsvorbereitungen fortsetzen.

Wenn Sie eine nicht unterstützte Sortierung zu Azure DevOps Services migrieren, wird die Sortierung in eine unterstützte Sortierung transformiert. Obwohl diese Transformation im Allgemeinen ohne Probleme funktioniert, können unerwartete Ergebnisse nach der Migration oder Migrationsfehler auftreten.

Kunden können beispielsweise eine andere Reihenfolge für Zeichenfolgen bemerken, die nicht englische Zeichen enthalten. Nicht englische Zeichen wie "é" können nach der Migration gleichbedeutend mit dem englischen "e" werden. Es ist wichtig, dass Sie eine Testausführungsmigration abschließen und überprüfen, wenn Sie eine Sammlung mit einer nicht unterstützten Sortierung migrieren.

Keine native Unterstützung, keine Internetverbindung

Wenn das Datenmigrationstool keine Verbindung mit dem Internet herstellen kann, kann die Konvertierung Ihrer Sortierung nicht überprüft werden. Es ist nur eine Warnung, sodass Sie den Migrationsprozess fortsetzen können. Wenn Sie den Befehl "Vorbereiten " ausführen, ist jedoch eine Internetverbindung erforderlich, und die Sortierungskonvertierung wird zu diesem Zeitpunkt überprüft.

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

Nicht unterstützte Datenbanksortierung

Im Allgemeinen können Sie eine nicht unterstützte Sortierung zur Migrationszeit in eine unterstützte Sortierung konvertieren. Einige Sortierungen können jedoch nicht konvertiert werden. Wenn Ihre Sammlung eine dieser Sortierungen verwendet, wird die folgende Fehlermeldung angezeigt.

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

Um den Vorgang fortzusetzen, müssen Sie die Sortierung Ihrer Sammlung in eine der unterstützten Sortierungen in Azure DevOps Services ändern.

Beheben von Identitätsfehlern

Beheben Sie Identitätsfehler vor der Migration, um Probleme zu vermeiden. Sie sind selten und treten auf, wenn alte TFS-Vorgänge auf einem neuen Azure DevOps-Server ungültig sind. Beispielsweise können sich einige Benutzer nicht mehr in einer gültigen Benutzergruppe befinden.

In den folgenden Abschnitten finden Sie Anleitungen zum Beheben der häufigsten Identitätsfehler.

ISVError: 100014

Dieser Fehler weist darauf hin, dass eine Berechtigung in einer Systemsicherheitsgruppe fehlt. Beispielsweise verfügt jede von Ihnen erstellte Auflistung über Gültige Benutzer- und Projektsammlungsadministratorgruppen. Das System erstellt sie standardmäßig. Diese Gruppen unterstützen die Bearbeitung ihrer Berechtigungen nicht.

Dieser Fehler gibt an, dass mindestens eine Gruppe eine Berechtigung fehlt, über die sie verfügen sollte. Verwenden Sie zum Beheben dieses Fehlers den Befehl TFSSecurity.exe , um die erwarteten Berechtigungen auf die gekennzeichneten Systemgruppen anzuwenden. Der erste Schritt besteht darin, den TFSSecurity-Befehl zu identifizieren, den Sie ausführen müssen.

Fehlermeldung "Gültige Benutzer" der Project-Auflistung

Überprüfen Sie mindestens eine Fehlermeldung, die das Datenmigrationstool hervorgehoben hat. Wenn die gekennzeichnete Gruppe mit "0-0-0-0-3" endet, z. B. im folgenden Beispiel, müssen Sie eine fehlende Berechtigung für die Gruppe "Gültige Benutzer" der Project-Auflistung korrigieren.

Führen Sie den folgenden Befehl aus, ersetzen Sie den Bereich durch den Bereich aus der Fehlermeldung, und geben Sie die Sammlungs-URL an.

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

Sie bestimmen den Bereich und die Gruppensicherheits-ID (SID) aus der Fehlermeldung.

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 

Der letzte Befehl ähnelt dem folgenden Eintrag:

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

Fehlermeldung für Projektsammlungsadministratoren

Überprüfen Sie sorgfältig die Fehlermeldungen, die das Datenmigrationstool hervorgehoben hat. Wenn die gekennzeichnete Gruppe, die mit "0-0-0-0-0-1" endet, wie im folgenden Beispiel, endet, müssen Sie eine fehlende Berechtigung für die Gruppe " Projektsammlungsadministratoren " korrigieren. Führen Sie die folgenden Befehle für TFSSecurity.exe aus, ersetzen Sie den Bereich durch den Bereich aus der Fehlermeldung, und geben Sie Ihre Sammlung an.

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}

Nehmen Sie im folgenden Beispiel den Bereich und die Gruppe SID aus der Fehlermeldung, und fügen Sie sie dem vorherigen Befehl hinzu.

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 

Der letzte Befehl ähnelt dem folgenden Eintrag:

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

Wenn Sie mehrere Fehler korrigieren müssen, empfiehlt es sich, eine Batchdatei zu erstellen, um die Ausführung der Befehle zu automatisieren. Nachdem Sie die Befehle ausgeführt haben, führen Sie das Überprüfungstool für die Datenmigration erneut aus, um die Auflösung zu überprüfen. Wenn einige Fehler weiterhin bestehen, wenden Sie sich an den Kundensupport von Azure DevOps Services.

ISVError: 300005

ISVError: 300005 gibt an, dass eine Nichtgruppenidentität Mitglied einer Jeder-Gruppe ist, die häufiger als gültige Benutzergruppen bezeichnet wird. Gültige Benutzergruppen sind Standardgruppen, die für alle Projekte und Sammlungen definiert sind. Diese Gruppen können nicht bearbeitet werden. Sie sind so konzipiert, dass sie nur andere Azure DevOps-Berechtigungs- oder Sicherheitsgruppen als Mitglieder enthalten. Dieser Fehler gibt an, dass eine Active Directory-Gruppe oder Benutzeridentität eine direkte Mitgliedschaft in einer Gruppe "Gültige Benutzer" aufweist.

Da Sie gültige Benutzergruppen nicht direkt bearbeiten können, müssen Sie eine SQL-Anweisung für die Konfigurationsdatenbank ausführen, um die fehlerhafte Identität zu entfernen und die ungültige Mitgliedschaft zu korrigieren. Überprüfen Sie sorgfältig die vom Datenmigrationstool hervorgehobenen Fehlermeldungen. Kopieren Sie den GroupSid, MemberIdund ScopeId fügen Sie diese Werte wie folgt in den folgenden Befehl ein.

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

Im folgenden Beispiel wird ein Beispiel für einen ISVError aufgelistet: 300005 Nachricht aus dem Datenmigrationstool.

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

Wenn die Fehlermeldung eine MemberSidListe enthält, müssen Sie die MemberID Aus der tabelle dbo.tbl_Identity in der Konfigurationsdatenbank abrufen. Mit dem MemberID, können Sie dann die GUID für die 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

Kopieren Sie den GroupSid, MemberId, und ScopeId in den SQL-Befehl.

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'

Führen Sie den abgeschlossenen Befehl für die Azure DevOps Server-Konfigurationsdatenbank aus. Wiederholen Sie diesen Befehl für jeden ISVError: 300005 gemeldete Instanz. Sie können Fehler mit derselben Bereichs-ID in einem einzigen Befehl batchen. Nachdem Sie die Befehle ausgeführt haben, führen Sie das Datenmigrationstool erneut aus, um sicherzustellen, dass die Fehler korrigiert werden. Wenn die Fehler weiterhin bestehen, wenden Sie sich an den Kundensupport von Azure DevOps Services.

Microsoft Entra-Timeoutausnahme

In seltenen Fällen erhalten Sie möglicherweise einen Microsoft Entra-Timeoutfehler, wenn Sie den Befehl "Datenmigrationstool vorbereiten" ausführen.

Exception Message: Request failed (type AadGraphTimeoutException)

Dieser Fehler bedeutet, dass die Anforderungen an die Microsoft Entra-ID, um die übereinstimmenden Microsoft Entra-Identitäten für Benutzer in Ihrer Sammlung zu finden, timeout. Im Allgemeinen können Sie diesen Fehler beheben, indem Sie auf die Ausführung des Befehls "Vorbereiten " zu einer weniger ausgelasteten Tageszeit warten, z. B. nach regulären Geschäftszeiten.

Testen Sie zur Problembehandlung die Microsoft Entra-ID-Verbindung vom Vorbereiten des Computers. Führen Sie die folgenden Schritte aus, um Benutzerinformationen aus der Microsoft Entra-ID abzurufen.

Öffnen Sie PowerShell im Modus mit erhöhten Rechten, und ersetzen Sie "someone@somecompany.com" im folgenden Befehl durch Ihre Microsoft Entra-Benutzeridentität.

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

Wenn die Schritte fehlschlagen oder der Benutzer nicht gefunden werden kann, überprüfen Sie die Verbindung zwischen dem Vorbereitungscomputer und der Microsoft Entra-ID. Führen Sie eine Netzwerkablaufverfolgung mit vorbereitungsbereit aus, um festzustellen, ob die Netzwerkanrufe blockiert werden. Falls nicht, wenden Sie sich an Azure-Support. Überprüfen Sie die Protokolldatei auf die Benutzerinformationen.

Number of active users is {Number of Users}.

Wenn die Anzahl der aktiven Benutzer über 50.000 liegt, erfordert das zugeordnete Identitätsvolumen möglicherweise mehr Zeit als durch das Timeoutlimit bereitgestellt wird. Überprüfen Sie Ihre Sammlung auf Einschlüsse großer Gruppen, z. B. auf eine Gruppe "jeder". Entfernen Sie diese Gruppen, wenn möglich, und versuchen Sie es erneut. Wenn Sie diesen Fehler immer noch nicht beheben können, wenden Sie sich an den Kundensupport von Azure DevOps Services.

Beheben von Prozessfehlern

Ausführliche Informationen zum Beheben häufiger Prozessfehler finden Sie im Artikel zur Überprüfungsphase.

Beheben von Fehlern bei der Feldüberprüfung

VS403310

Die folgende Fehlermeldung kann auftreten, wenn eine Inkonsistenz in Sammlungsdateien erkannt wird. Wenden Sie sich an den Kundensupport, wenn dieser Fehler auftritt.

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

VS403442

Feldnamenkonflikte treten manchmal zwischen Ihrer lokalen Sammlung und einem Azure DevOps Services-Systemfeld auf.

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

Ändern Sie den Namen des Sammlungsfelds, um diesen Fehler zu beheben. Verwenden Sie den Befehl "witadmin changefield " von witadmin.

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

VS403443

Der folgende Fehler gibt an, dass ein Feldnamekonflikt zwischen Ihrer lokalen Auflistung und einem bestimmten Azure DevOps Services-Feld besteht.

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

Verwenden Sie den Befehl "witadmin changefield ", um diesen Fehler zu beheben. Weitere Informationen finden Sie unter witadmin.

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

VS403444

Der folgende Fehler gibt an, dass ein Feldtypkonflikt zwischen Ihrer lokalen Sammlung und Azure DevOps Services besteht.

Mit witadmin können Sie den Datentyp nur für HTML- oder PlainText-Felder ändern.

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

Wenn ihr Feldtyp HTML oder PlainText ist, können Sie dessen Typ in den erforderlichen Typ ändern.

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

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

Beheben von Überprüfungsfehlern

Überprüfungsfehler bedeuten, dass die Migration nicht gestartet wurde. Das Datenmigrationstool hat versucht, eine Migration in die Warteschlange zu stellen, hat aber stattdessen einen Fehler erhalten. Ihre Migrationsanforderung ist ungültig. Beheben Sie die Fehlermeldungen, und versuchen Sie dann erneut, zu migrieren.

VS403254

Die Region, die Sie für Ihre Azure DevOps Services-Migration eingegeben haben, wird nicht unterstützt.

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

Öffnen Sie Die Migrationsspezifikationsdatei, und aktualisieren Sie die Region, die Sie mit dem richtigen Kurznamen für die Region angegeben haben.

VS403249

Der name der Organisation, den Ihr Team ausgewählt hat, wird bereits von einer vorhandenen Organisation verwendet. Alle Azure DevOps Services-Migrationen gehen in eine neue Organisation ein, die zur Migrationszeit erstellt wird.

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

Wählen Sie einen anderen Organisationsnamen aus, und aktualisieren Sie die Migrationsspezifikationsdatei, bevor Sie die Migration wiederholen.

VS403250 & VS403286

Die DACPAC ist nicht aus einer getrennten Sammlung aufgebaut.

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.

Trennen Sie die Sammlungsdatenbank, und generieren Sie den DACPAC erneut.

VS403243

Mit der bereitgestellten SQL-Verbinden ion-Zeichenfolge kann keine Verbindung mit der Datenbank hergestellt werden.

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

Überprüfen Sie die Parameter, die bereitgestellt wurden, um sicherzustellen, dass sie korrekt sind, und versuchen Sie es erneut.

VS403260 & VS403351

Die Sammlungsdatenbank wird nicht getrennt.

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.

Trennen Sie Die Sammlungsdatenbank, und wiederholen Sie die Migrationswarteschlange.

VS403261

Die Verbindungszeichenfolge muss verschlüsselt werden, andernfalls wird das Kennwort im Klaren gesendet.

VS403261: The SQL connection string must use encryption.

Fügen Sie "Encrypt=true" zu Ihrem SQL-Verbindungszeichenfolge hinzu.

VS403262

Die Verbindungszeichenfolge müssen die SQL-Authentifizierung verwenden.

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

Fügen Sie der SQL-Verbindungszeichenfolge integrierte Sicherheit=False hinzu.

VS403263

Ihr SQL-Anmeldebenutzerkonto verfügt nicht über die erforderliche Datenbankrolle.

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

Stellen Sie sicher, dass dem Benutzerkonto für die Anmeldung die Rolle "TFSEXECROLE" zugewiesen ist.

VS403264

Die Verbindungszeichenfolge verweist nicht auf eine Azure DevOps Server-Sammlungsdatenbank.

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

Überprüfen oder korrigieren Sie die Verbindungszeichenfolge verweist auf Ihre Sammlungsdatenbank.

VS40325

Das Azure DevOps Server Update hat den Dateimigrationsauftrag in die Warteschlange gestellt. Sie können Migrationen erst ausführen, wenn dieser Auftrag abgeschlossen ist. Die Fertigstellungszeit für diesen Auftrag hängt von der Größe der Sammlung ab.

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

Sie können den Auftragsfortschritt nachverfolgen, indem Sie die folgende Abfrage in der Sammlungsdatenbank ausführen:

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

Sobald die Anzahl der zu migrierenden Dateien null ist Standard können Sie das Datenmigrationstool ausführen.

VS403282

Im Quellspeicherortwert ist ein neues Zeilenzeichen vorhanden. Dieses Zeichen kann nach dem Kopieren des SAS-Schlüssels aus der Windows-Konsole erneut Standard werden.

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.

Entfernen Sie den Zeilenumbruch, und versuchen Sie es erneut.

VS403271

Ihre Migrationsdateien und DACPAC befinden sich nicht in der erforderlichen Azure-Region, um die Migration zu Ihrer Zielregion Azure DevOps Services abzuschließen.

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.

Erstellen Sie ein neues Microsoft Azure-Speicherkonto in der erforderlichen Region, und kopieren Sie Ihre Dateien. Das folgende Beispiel zeigt, wie Sie Ihre Daten mithilfe von AzCopy kopieren.

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

Inkonsistenzen wurden in einigen TfVC-Dateien (Team Foundation Version Control) in Ihrer Sammlung erkannt.

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.

Arbeiten Sie mit dem Azure DevOps Services-Kundensupport. Öffnen Sie ein Supportticket, und arbeiten Sie mit Ihnen zusammen, um den Fehler zu beheben.

VS403366

Das Datenmigrationstool konnte keine Verbindung mit der SQL Azure-VM herstellen.

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:

Vergewissern Sie sich, dass Sie die Informationen korrekt in Ihre Verbindungszeichenfolge eingegeben haben und dass Sie eine Verbindung mit dem virtuellen Computer herstellen können.

Die IPs, die in der Fehlermeldung aufgelistet sind, gelten für Azure DevOps Services. Azure DevOps Services-IPs können sich während der Bereitstellung vorübergehend ändern. Fügen Sie sie zu Ihren Firewall-Ausnahmen hinzu, und versuchen Sie erneut, die Migration in die Warteschlange zu stellen. Eine Liste der IP-Adressen finden Sie unter Migrieren großer Sammlungen, Beschränken des Zugriffs auf Azure DevOps Services-IPs.

VS403373

Das Datenmigrationstool unterstützt nicht das Migrieren mehrerer Kopien der SAME-Auflistung . Das Migrieren geteilter Kopien einer Sammlung wird jedoch unterstützt. Ändern Sie die GUID für die DataImportCollectionID.

Öffnen Sie in SQL Server Management Studio (SSMS) die erweiterten Eigenschaften für die geteilten Kopien, die Sie noch nicht migriert haben. Fügen Sie der Eigenschaft "TFS_DATAIMPORT_COLLECTIONID" eine neu generierte GUID hinzu. Führen Sie dann den Befehl "Vorbereiten " erneut aus, und verwenden Sie die neue migration.json-Datei , um die Migration in die Warteschlange zu stellen.

VS403379

Die Datenmigration schlägt fehl, da ein oder mehrere Projekte in dieser Auflistung in der Phase vorläufig gelöscht sind. Stellen Sie die vorläufig gelöschten Projekte wieder her, oder löschen Sie sie endgültig, bevor Sie die Datenmigration ausführen. Ausführliche Informationen finden Sie unter "Löschen eines Projekts".

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.

Überprüfen Sie die Sammlung, für die Sie das Datenmigrationstool ausführen, Projekte in der Phase vorläufig gelöscht. Nachdem ein Projekt gelöscht wurde, wird Standard es 28 Tage lang in einem Vorläufiglöschzustand erneut gelöscht, in dem das gelöschte Projekt wiederhergestellt werden kann. Informationen zum Wiederherstellen eines gelöschten Projekts finden Sie unter "Wiederherstellen eines Projekts". Wenn Projekte in der Vorläufig gelöschten Phase vorhanden sind, entfernen Sie sie vollständig, oder stellen Sie sie wieder her, bevor Sie die Datenmigration ausführen.

Beheben von Migrationsfehlern

Migrationsfehler bedeuten, dass die Migration in die Warteschlange gestellt wurde, aber nicht abgeschlossen wurde. Die Person, die die Migration in die Warteschlange gestellt hat, erhält eine E-Mail-Benachrichtigung mit Fehlern. Meistens enthält diese E-Mail einen Grund für den Fehler. Wenn dies der Fall ist, verwenden Sie die in der E-Mail und dieser Seite angegebenen Schritte zur Problembehandlung, um die Fehler zu beheben und die Migration erneut zu versuchen.

Wenn der Fehler komplexer ist, enthält die E-Mail, die Sie erhalten, Anweisungen zum Einreichen eines Kundensupportfalles. Nachdem Sie einen Kundensupportfall eingereicht haben, muss Ihr Team einen Rollback ausführen, indem Sie Ihre Azure DevOps Server-Instanz wieder online schalten und Ihre Sammlung erneut anfügen. Ihre Teammitglieder können ihre Arbeit dann fortsetzen. Es wird empfohlen, die Migration erst dann erneut zu versuchen, wenn der Fehler behoben wurde, der das Problem verursacht hat.

Verwandte Artikel

• Ausführen von Aufgaben nach der Migration
• Löschen eines Projekts