Problembehandlung bei Import- und Migrationsfehlern

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Im Tool für die Datenmigration werden Fehler angezeigt, die Sie beheben müssen, bevor Sie eine Migration zu Azure DevOps Services durchführen. 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.

Hinweis

Es wird empfohlen, dass Sie den Migrationsleitfaden verwenden, um den Import zu durchlaufen. Der Leitfaden enthält bei Bedarf Links zur technischen Dokumentation.

Mit der Veröffentlichung von Azure DevOps Server 2019 wurde der Team Foundation Server (TFS)-Datenbankimportdienst neu als Branding versehen, um das Datenmigrationstool für Azure DevOps zu werden. Das Datenmigrationstool TfsMigrator wurde kurz als Migrator umbenannt. Der Dienst funktioniert weiterhin genau wie der vorherige Importdienst. Wenn Sie eine ältere Lokale Version mit TFS als Branding verwenden, können Sie Migration weiterhin zu Azure DevOps verwenden, solange Sie ein Upgrade auf eine der unterstützten Versionen durchführen. Ausführliche Informationen finden Sie unter Migrieren von Daten von Azure DevOps Server zu Azure DevOps Services.

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.

Die folgende Warnung bedeutet, dass Sie die SQL Azure VM-Methode verwenden müssen, um den Import abzuschließen. Sobald eine Datenbank eine bestimmte Größe erreicht hat, wird es schneller, eine SQL Azure-VM einzurichten, um den Import in Azure DevOps Services abzuschließen. Um den virtuellen Computer einzurichten und den Import 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 import method. Please see the following page to learn how to import using a SQL Azure VM: https://aka.ms/AzureDevOpsImportLargeCollection

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

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

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

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

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 Der Datenbank vor dem Import zu verringern. Das Verringern der Größe bietet den anderen Vorteil, den Import 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 zu groß für den Import 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 dem Import 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 den Import 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 importieren können.

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

Wenn Sie eine nicht unterstützte Sortierung in Azure DevOps Services importieren, wird die Sortierung in eine unterstützte Sortierung transformiert. Obwohl diese Transformation im Allgemeinen ohne Problem funktioniert, können unerwartete Ergebnisse nach dem Import oder Importfehler auftreten.

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

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 import 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 Importzeit 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 import 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 dem 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 weist darauf hin, dass mindestens eine Gruppe eine Berechtigung fehlt, die erwartet wird. Verwenden Sie zum Beheben dieses Fehlers den Befehl TFSSecurity.exe , um die erwarteten Berechtigungen auf die gekennzeichneten Systemgruppen anzuwenden. Der erste Schritt besteht darin, zu ermitteln, welche TFSSecurity-Befehle Sie ausführen müssen.

Fehlermeldung "Gültige Benutzer" der Project-Auflistung

Überprüfen Sie die Fehlermeldung(en), 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 Fehlermeldung(en), 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, müssen Sie das Datenmigrationsüberprüfungstool erneut ausführen, 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.

Wichtig

Stellen Sie sicher, dass Sie über eine Sicherung Ihrer Sammlungs- und Konfigurationsdatenbanken verfügen, bevor Sie die folgenden Befehle ausführen, um den Fehler zu beheben.

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 wurden. Wenn die Fehler weiterhin bestehen, wenden Sie sich an den Kundensupport von Azure DevOps Services.

Wichtig

Um diese Fehler zu beheben, muss die Auflistung angefügt werden.

Wenn Sie beim Ausführen des Befehls ein Ergebnis von -1 erhalten, stellen Sie sicher, dass die Sammlungsdatenbank, die den Fehler erzeugt hat, an Ihre Azure DevOps Server-Instanz angefügt ist und dass Sie den Befehl in der Konfigurationsdatenbank ausführen.

Microsoft Entra-Timeoutausnahme

In seltenen Fällen erhalten Sie möglicherweise einen Microsoft Entra-Timeoutfehler, wenn Sie den Befehl zum Vorbereiten des Datenmigrationstools 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 auf der separaten Seite "Prozessvorlagen ".

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

Hinweis

Wenn der Feldtyp etwas anderes als HTML oder PlainText ist und Felddaten nicht wichtig sind oder das Feld in keinem Projekt verwendet wird, empfehlen wir, das Feld zu löschen.

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

Wichtig

Das Löschen eines Felds führt zu einem Verlust von Felddaten in der gesamten Sammlung.

Beheben von Importfehlern

Fehler, die während des Imports auftreten, fallen in eine von zwei Kategorien, Überprüfungsfehler und Importfehler.

Überprüfungsfehler

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

VS403254

Die Region, die Sie für ihren Azure DevOps Services-Import 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 Importspezifikationsdatei, und aktualisieren Sie die Region, die Sie mit dem richtigen Kurznamen für die Region angegeben haben.

VS403249

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

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

Wählen Sie einen anderen Organisationsnamen aus, und aktualisieren Sie die Importspezifikationsdatei, bevor Sie den Import 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 Importwarteschlange.

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.

Hinweis

Es gibt ein bekanntes Problem mit der Verwendung sp_addrolemember zum Hinzufügen TFSEXECROLE zu einer vorhandenen SQL-Anmeldung. Die Rollenmitgliedschaft wird erst angewendet, wenn alle offenen Verbindungen mit dieser Identität geschlossen werden. Wenn Sie den fehler "VS403263" erhalten und bestätigt haben, dass Ihre Identität die Rolle hat, empfehlen wir Ihnen, eine neue Identität für Den Import zu erstellen. Details zum Erstellen einer neuen SQL-Anmeldung, die für den Import verwendet werden kann, finden Sie unter "Große Sammlungen importieren".

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

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

VS40325

Das Azure DevOps Server Update hat den Dateimigrationsauftrag in die Warteschlange gestellt. Importe können erst ausgeführt werden, wenn dieser Auftrag abgeschlossen wurde. 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 könnte nach dem Kopieren der SAS-Taste 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 import specification file.

Entfernen Sie den Zeilenumbruch, und versuchen Sie es erneut.

VS403271

Ihre Importdateien und DACPAC befinden sich nicht in der erforderlichen Azure-Region, um den Import in Ihre 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 import put their DACPACs in Central US. Please move your DACPAC to Central US and requeue the import.

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 an import 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:

Stellen Sie sicher, 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, den Import erneut aufzuwarteschlangen. Eine Liste der IP-Adressen finden Sie unter Importieren großer Sammlungen, Einschränken des Zugriffs auf Azure DevOps Services-IPs

VS403373

Das Datenmigrationstool unterstützt nicht das Importieren mehrerer Kopien der SAME-Auflistung . Das Importieren geteilter Kopien einer Auflistung 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 importiert 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 import.json Datei, um den Import in die Warteschlange zu stellen.

VS403379

Der Datenimport schlägt fehl, da ein oder mehrere Projekte, die in dieser Auflistung gefunden werden, 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 den Datenimport ausführen. Ausführliche Informationen finden Sie unter "Löschen eines Projekts".

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

Überprüfen Sie die Sammlung, für die Sie das Datenmigrationstool ausführen, projekte in der vorläufig gelöschten Phase. 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 den Datenimport ausführen.

Importfehler

Importfehler bedeuten, dass der Import in die Warteschlange eingereiht wurde, aber nicht abgeschlossen wurde. Die Person, die den Import 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 auf dieser Seite angegebenen Schritte zur Problembehandlung, um die Fehler zu beheben und den Import 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, den Import erst dann erneut zu versuchen, wenn der Fehler behoben wurde, der das Problem verursacht hat.