Introducción a la API de lectura asincrónica de metadatos (AMR) de SharePoint

La API de lectura asincrónica de metadatos (AMR) de SharePoint exporta de forma asincrónica metadatos de SharePoint y OneDrive.

Use la API de AMR para exportar metadatos desde SharePoint, para la migración incremental y la validación posterior a la migración.

AMR está diseñado exclusivamente para escenarios de importación. Presenta una escalabilidad deficiente al controlar las solicitudes de metadatos, permisos o versiones. No se pueden proporcionar garantías de rendimiento para el uso de AMR en escenarios de exportación de datos, como migraciones entre inquilinos.

Novedades

Enero de 2024

Reformateamos este documento para aportar claridad y corregir errores.

Introducción a los pasos de exportación

Exporte metadatos desde SharePoint en tres pasos:

Aprovisionamiento de los contenedores de destino y la cola

Use ProvisionMigrationContainers el método para aprovisionar los contenedores. Consulte Uso de contenedores de Azure Blob Storage y colas de Azure con Migration API para obtener más información. También puede usar sus propios contenedores y colas si es necesario.

Uso CreateSPAsyncReadJob del método para iniciar la exportación

Use CreateSPAsyncReadJob el método para exportar metadatos desde una sola dirección URL o CreateSPAsyncReadJobWithMultiUrl desde varias direcciones URL si es necesario. Consulte Referencia de LA API de AMR para obtener más información.

Obtenga actualizaciones incrementales con ChangeToken la característica .

Ambos métodos devuelven el identificador de trabajo, que se puede usar para realizar un seguimiento del estado de exportación.

Consulte Referencia de LA API de AMR para obtener más información.

Comprobación del estado

Compruebe el estado de exportación de la cola de Azure proporcionada. Supervise los eventos como se muestra en Eventos para obtener más información.

LA API de AMR exporta metadatos en el contenedor de manifiesto proporcionado, en la carpeta denominada por JobID. Compruebe archivos de manifiesto para obtener el formato y la validación de los metadatos.

LA API de AMR divide el paquete de manifiesto de más de 25 MB en varios archivos de manifiesto por solicitud.

Procedimiento recomendado

LA API de AMR es eficaz. Garantizar un buen rendimiento para lograr la escala de proyectos de migración de gran tamaño.

Exportación de seguridad y permisos en el nivel superior si es posible

La exportación de seguridad con IncludeSecurity consume más recursos y ralentiza la exportación. Es más rápido exportar estos metadatos en la carpeta de nivel superior primero y, a continuación, exportar los elementos secundarios sin ellos.

Exportación de metadatos en un solo elemento

Use Microsoft Graph en lugar de AMR.

Carpetas con menos de 10 000 elementos

Use CreateSPAsyncReadJobWithMultiUrl para combinar las direcciones URL de varias carpetas en un único trabajo de exportación.

Carpetas con entre 10 000 y 1 millón de elementos

Use CreateSPAsyncReadJoby establezca readOptionIncludeDirectDescendantsOnlyfalseen . Este valor es la configuración predeterminada.

Carpetas anidadas con más de 1 millón de elementos

Planee cuidadosamente al dividir carpetas en trabajos. El recuento de objetos en los trabajos de exportación es el factor principal del rendimiento de la exportación.

En este ejemplo se muestra cómo exportar metadatos de carpetas anidadas con más de un millón de elementos. LA API de AMR tiene el mayor rendimiento cuando el número de elementos es grande.

• Use CreateSPAsyncReadJob el método en la dirección URL raíz, por ejemplo: www.contoso.com/my-resource-document, y establezca readOptionIncludeDirectDescendantsOnlytrueen .
• Use SMTotalFileCount el atributo para obtener el recuento de archivos en carpetas.
• Siga usando createSPAsyncReadJob el método en el nivel de subcarpeta, en cada una de las subcarpetas, si la carpeta tiene más de 10 000 elementos.
• Use CreateSPAsyncReadJobWithMultiUrl el método , combinando subcarpetas con menos de 10 000 elementos.

Rendimiento

LA API de AMR procesa trabajos a través de un mecanismo de cola con la configuración preconfigurada de administración de cargas de trabajo. LA API de AMR procesa los trabajos de la mejor manera posible, sin contrato de nivel de servicio (SLA) ni rendimiento garantizado.

Línea base de rendimiento probada en laboratorio

Hemos probado el rendimiento en la configuración de laboratorio. LA API de AMR exportó unos 400 elementos por segundo por cada objeto de 250 K, en el caso promedio. El rendimiento máximo alcanzó los 700 elementos por segundo.

Hay varios factores que afectan al rendimiento de la vida real. Entre estos factores se incluyen:

• Número de elementos que se exportan
• La forma en que se implementa la API de AMR
• Limitación

Optimización del rendimiento de la migración

Con el fin de garantizar un rendimiento óptimo para los proyectos de migración, es importante planear cuidadosamente, especialmente cuando se trata de migraciones a gran escala. Para obtener más información sobre cómo calcular intervalos de tiempo y optimizar el rendimiento, consulte nuestra guía de rendimiento.

Veo mensajes de limitación

Para garantizar una buena experiencia de usuario para todos los clientes de Microsoft 365, SharePoint usa la limitación para proteger la infraestructura de SharePoint. Evite limitarse siguiendo las instrucciones de limitación.

Migraciones de inquilino a inquilino

AMR no está pensado para escenarios en los que el contenido de un inquilino de SharePoint se mueve a otro. Este tipo de migración requiere el uso de muchas opciones de lectura con muchos recursos. El largo tiempo de procesamiento de estas opciones de lectura ralentiza considerablemente la migración general.

Microsoft no proporciona ninguna garantía de rendimiento en este escenario. Use Graph o CSOM según sea necesario.