Síntomas
Al ejecutar una Insane mode migration to Microsoft 365, recibes uno de estos mensajes de error en uno o varios de tus elementos:
This item was not copied due to a fatal error on item '{0}' at the source. Fix the error or skip the item to complete the copy.
This item was not copied due to a fatal error on an item at the source. Fix the error or skip the item to complete the copy.
This item was not copied due to a fatal error on an other item. Check for items with error in this report.
Código de error
AZ-034-213
AZ-048-368
Detalles
Comprender cómo funciona Insane mode con un destino de Microsoft 365 es esencial para identificar la causa de un error fatal en ShareGate Migrate.
En Insane mode, ShareGate Migrate usa la API de migración de Microsoft para delegar el proceso de transferencia de datos. Así es como funciona:
Tu contenido se empaqueta:
ShareGate Migrate agrupa tu contenido de origen en paquetes.
Cada paquete contiene varios archivos, según su tamaño y otros factores.
Se crea un paquete de manifiesto que incluye metadatos y otros datos de configuración.
Los paquetes se cargan en un almacenamiento temporal de Azure dentro de tu inquilino de Microsoft 365.
Microsoft 365 importa el contenido desde Azure:
Microsoft importa los datos desde el almacenamiento de Azure a tu destino de SharePoint Online.
Este proceso de importación es gestionado completamente por los servidores de Microsoft.
Qué causa un error fatal
Los errores fatales ocurren durante la importación, cuando Microsoft 365 transfiere tu contenido desde el almacenamiento de Azure a SharePoint.
Puedes encontrar un error fatal si:
Más de 100 archivos de un paquete no logran importarse debido a otros errores.
A menudo se trata de errores recurrentes relacionados con el límite de permisos únicos de una lista o con errores en muchas versiones.
Uno o más archivos corruptos impiden que Microsoft complete la importación.
Cuando esto ocurre:
Microsoft 365 detiene toda la importación de ese paquete.
Verás un mensaje de error fatal en tu informe de migración para cada archivo restante del paquete afectado.
Solución de problemas
Para encontrar la causa raíz del error fatal, revisa tu informe de migración en busca de errores recurrentes en la lista o biblioteca afectada.
Para inspeccionar el informe de migración, puedes exportarlo como XLSX y aprovechar las opciones de filtrado de Excel.
En Excel, puedes identificar qué lista o biblioteca se ve afectada por un error fatal y filtrar el informe para encontrar otros errores en esa lista o biblioteca que podrían haberlo causado.
Consejo: Consulta Tips and tricks to review your migration report in Excel para aprender a filtrar tu informe de manera eficaz.
Si encuentras errores que causaron el error fatal, busca la columna Help links en el informe. Debería dirigirte a artículos que pueden ayudarte a resolverlos.
Los errores recurrentes suelen resolverse ajustando tus Copy options, mapeos, o el origen o destino.
Hay un error en particular que vale la pena buscar, especialmente si estás migrando desde un file share:
Límite de permisos únicos superado
Las listas y bibliotecas de SharePoint Online tienen un límite de 50 000 elementos con permisos únicos. Cuando alcanzas ese límite, cualquier elemento posterior devuelve un error, que puede llegar rápidamente a 100 y provocar un error fatal en el paquete que se está importando.
Esta es la causa más común de los errores fatales. Suele ocurrir al migrar desde un file share, cuando la app aplica permisos únicos a cada elemento para reproducir los permisos del origen.
También puede ocurrir al migrar a una lista de SharePoint Online que está cerca de su límite de permisos únicos.
Si encuentras errores recurrentes sobre permisos únicos o personalizados, puedes:
Importar tus elementos sin sus permisos personalizados desactivando Custom Permissions en tus copy options, si no necesitas conservar esos permisos.
Importar tu contenido en varias bibliotecas para reducir la cantidad total de permisos únicos.
Consejo: Antes de importar tus documentos sin sus permisos únicos, puedes crear nuevos permisos para tu biblioteca de destino o crear algunas carpetas con permisos personalizados que tus documentos heredarán para administrar quién puede acceder a ellos.
Otras causas
Si no encuentras otros errores ni errores recurrentes que puedan haber causado el error fatal en tu informe de migración, es posible que tengas un archivo corrupto, o que el error fatal dificulte identificar su causa.
En estos casos, puedes usar Normal mode como herramienta de solución de problemas, ya que ese modo copia tu contenido directamente en el destino de SharePoint, sin pasar por el almacenamiento de Azure y evitando errores fatales.
Intenta copiar la lista o el contenido afectado en Normal mode y revisa el informe de migración en busca de problemas con tu contenido. Si encuentras un archivo que no se copia porque está corrupto, puedes intentar eliminarlo de tu origen u omitirlo durante la migración posterior en Insane mode.
Nota: No recomendamos usar Normal mode de forma extensiva para migraciones a Microsoft 365, a fin de evitar la limitación de solicitudes (throttling) y otros posibles problemas de rendimiento.
Este artículo fue traducido con inteligencia artificial. En caso de duda, consulta la versión original en inglés.