Einführung in die SharePoint-AMR-API (Asynchronous Metadata Read)

Die AMR-API (Asynchronous Metadata Read) von SharePoint exportiert Metadaten asynchron aus SharePoint und OneDrive.

Verwenden Sie die AMR-API zum Exportieren von Metadaten aus SharePoint für die inkrementelle Migration und die Überprüfung nach der Migration.

AMR ist ausschließlich für Importszenarien konzipiert. Es weist eine schlechte Skalierbarkeit bei der Verarbeitung von Anforderungen für Metadaten, Berechtigungen oder Versionen auf. Wir können keine Leistungsgarantien für die AMR-Nutzung in Datenexportszenarien bereitstellen, z. B. mandantenübergreifende Migrationen.

Neuerungen

Januar 2024

Wir haben dieses Dokument neu formatiert, um Klarheit zu schaffen und Fehler zu korrigieren.

Übersicht über Exportschritte

Exportieren von Metadaten aus SharePoint in drei Schritten:

Bereitstellen der Zielcontainer und der Warteschlange

Verwenden Sie ProvisionMigrationContainers die -Methode, um die Container bereitzustellen. Weitere Informationen finden Sie unter Verwenden von Azure Blob Storage-Containern und Azure-Warteschlangen mit der Migrations-API . Sie können bei Bedarf auch eigene Container und Warteschlangen verwenden.

Verwenden der CreateSPAsyncReadJob -Methode zum Starten des Exports

Verwenden Sie CreateSPAsyncReadJob die -Methode, um Metadaten aus einer einzelnen URL oder CreateSPAsyncReadJobWithMultiUrl bei Bedarf aus mehreren URLs zu exportieren. Weitere Informationen finden Sie in der AMR-API-Referenz .

Rufen Sie inkrementelle Updates mit ChangeToken Feature ab.

Beide Methoden geben die Auftrags-ID zurück, die zum Nachverfolgen des Exportstatus verwendet werden kann.

Weitere Informationen finden Sie in der AMR-API-Referenz .

Überprüfen des Status

Überprüfen Sie die bereitgestellte Azure-Warteschlange auf den Exportstatus. Überwachen Von Ereignissen finden Sie weitere Informationen unter Ereignisse .

Die AMR-API exportiert Metadaten im bereitgestellten Manifestcontainer unter dem Ordner mit dem Namen JobID. Überprüfen Sie die Manifestdateien auf das Format und die Überprüfung der Metadaten.

Die AMR-API teilt ein Manifestpaket, das größer als 25 MB ist, pro Anforderung in mehrere Manifestdateien auf.

Bewährte Methode

DIE AMR-API ist leistungsstark. Stellen Sie eine gute Leistung sicher, um die Skalierung für große Migrationsprojekte zu erreichen.

Exportieren von Sicherheit und Berechtigungen auf oberster Ebene nach Möglichkeit

Das Exportieren von Sicherheit mit IncludeSecurity verbraucht mehr Ressourcen und verlangsamt den Export. Es ist schneller, diese Metadaten zuerst im Ordner der oberen Ebene zu exportieren und dann die untergeordneten Elemente ohne sie zu exportieren.

Metadatenexport für ein einzelnes Element

Verwenden Sie Microsoft Graph anstelle von AMR.

Ordner mit weniger als 10.000 Elementen

Verwenden Sie CreateSPAsyncReadJobWithMultiUrl , um die URLs mehrerer Ordner in einem einzelnen Exportauftrag zu kombinieren.

Ordner mit 10.000 bis 1 Million Elementen

Verwenden Sie CreateSPAsyncReadJob, und legen Sie readOptionIncludeDirectDescendantsOnly auf fest false. Dieser Wert ist die Standardeinstellung.

Geschachtelte Ordner mit über 1 Million Elementen

Planen Sie sorgfältig, wenn Sie Ordner in Aufträge unterteilen. Die Objektanzahl in Exportaufträgen ist der Hauptfaktor der Exportleistung.

In diesem Beispiel wird gezeigt, wie Metadaten aus geschachtelten Ordnern mit mehr als einer Million Elementen exportiert werden. Die AMR-API weist die höchste Leistung auf, wenn die Elementanzahl groß ist.

• Verwenden Sie CreateSPAsyncReadJob die -Methode an der Stamm-URL, z. B. www.contoso.com/my-resource-document, und legen Sie readOptionIncludeDirectDescendantsOnly auf fest true.
• Verwenden Sie SMTotalFileCount das -Attribut, um die Dateianzahl in Ordnern abzurufen.
• Verwenden Sie createSPAsyncReadJob die -Methode weiterhin auf Unterordnerebene in jedem der Unterordner, wenn der Ordner mehr als 10.000 Elemente enthält.
• Verwenden Sie CreateSPAsyncReadJobWithMultiUrl die -Methode, um Unterordner mit weniger als 10.000 Elementen zu kombinieren.

Leistung

DIE AMR-API verarbeitet Aufträge über einen Warteschlangenmechanismus mit vorkonfigurierten Workloadverwaltungseinstellungen. Die AMR-API verarbeitet die Aufträge auf Der Grundlage der bestmöglichen Leistung, ohne Vereinbarung zum Servicelevel (SLA) oder garantierter Leistung.

Im Labor getestete Leistungsbaseline

Wir haben die Leistung in der Lab-Einstellung getestet. Die AMR-API exportierte pro Sekunde etwa 400 Elemente pro Sekunde für jeweils 250-K-Objekte, im durchschnittlichen Fall. Die Spitzenleistung erreichte 700 Elemente pro Sekunde.

Es gibt mehrere Faktoren, die sich auf die reale Leistung auswirken. Hierzu gehören u. a.:

• Die Anzahl der elemente, die exportiert werden
• Implementierung der AMR-API
• Einschränkung

Optimieren der Migrationsleistung

Um eine optimale Leistung für Ihre Migrationsprojekte zu gewährleisten, ist es wichtig, sorgfältig zu planen, insbesondere bei umfangreichen Migrationen. Weitere Informationen zum Schätzen von Zeitspannen und zum Optimieren der Leistung finden Sie in unserem Leistungsleitfaden.

Ich sehe Drosselungsmeldungen

Um eine gute Benutzererfahrung für alle Microsoft 365-Kunden zu gewährleisten, verwendet SharePoint die Drosselung, um die SharePoint-Infrastruktur zu schützen. Vermeiden Sie eine Drosselung, indem Sie die Drosselungsanleitung befolgen.

Mandanten-zu-Mandant-Migrationen

AMR ist nicht für Szenarios vorgesehen, in denen Inhalte aus einem SharePoint-Mandanten in einen anderen verschoben werden. Diese Art der Migration erfordert die Verwendung vieler ressourcenintensiver Leseoptionen.This type of migration requires the use of many resource-heavy read options. Die lange Verarbeitungszeit dieser Leseoptionen verlangsamt die gesamte Migration erheblich.

Microsoft bietet in diesem Szenario keine Leistungsgarantie. Verwenden Sie nach Bedarf Graph oder CSOM.