Migração de servidor de arquivos para OneDrive for Business perde arquivos em fusões: Guia de correção

Durante uma fusão ou aquisição, as equipes de TI frequentemente migram dados de servidores de arquivos para o OneDrive for Business. Um padrão de falha comum é que alguns arquivos não aparecem nas bibliotecas do OneDrive de destino após a ferramenta de migração relatar sucesso. Esse problema geralmente ocorre devido a conflitos de nomes de arquivos, limites de tamanho de caminho ou problemas de herança de permissão que a ferramenta de migração não resolve automaticamente. Este artigo explica por que os arquivos são perdidos durante uma migração de fusão e fornece uma correção passo a passo para localizar e transferir esses itens ausentes.

Por que as migrações de servidor de arquivos para o OneDrive perdem arquivos durante fusões

Ao usar a Ferramenta de Migração do SharePoint ou uma ferramenta de terceiros para mover dados do servidor de arquivos para o OneDrive for Business, a ferramenta verifica a estrutura de pastas de origem e faz upload de cada arquivo para a biblioteca de destino. Durante uma fusão, o ambiente de origem geralmente contém dados de vários domínios legados, servidores de arquivos e convenções de nomenclatura. A ferramenta de migração aplica um conjunto de regras para determinar quais arquivos podem ser movidos e quais devem ser ignorados.

A causa raiz dos arquivos ausentes é quase sempre uma das três condições a seguir:

Restrições de nome de arquivo e tamanho do caminho

O OneDrive for Business e o SharePoint Online impõem um tamanho máximo de caminho de arquivo de 400 caracteres. Se um arquivo no servidor de origem tiver um caminho maior que 400 caracteres, a ferramenta de migração o ignora sem um aviso claro. Os dados de fusão geralmente incluem estruturas de pastas profundamente aninhadas de várias empresas, que excedem facilmente esse limite.

Conflitos de caracteres em nomes de arquivos

Os servidores de arquivos Windows permitem certos caracteres que o OneDrive não aceita. Os caracteres " : < > ? / \ | são ilegais no SharePoint e no OneDrive. Arquivos que contêm esses caracteres em seus nomes são ignorados pela ferramenta de migração. Os dados de fusão frequentemente incluem arquivos com caracteres especiais de sistemas legados.

Conflitos de permissão e bloqueio

Se um arquivo estiver aberto ou bloqueado por outro usuário ou processo durante a verificação da migração, a ferramenta não pode ler o arquivo e o omite. Durante uma fusão, várias equipes de TI podem estar acessando o mesmo servidor de arquivos simultaneamente, aumentando a chance de bloqueios de arquivos.

Etapas para localizar e migrar arquivos ausentes

Siga estas etapas em ordem para identificar cada arquivo que foi perdido e migrá-lo com sucesso para o OneDrive for Business.

1. Gerar o relatório de falhas da migração
   Abra a Ferramenta de Migração do SharePoint. Clique no nome do trabalho de migração usado para a fusão. Selecione Exibir Relatórios e depois Relatório de Falhas. Baixe o arquivo CSV. Este arquivo lista cada arquivo que falhou na migração e o código de erro específico para cada falha.
2. Identificar arquivos com caminhos longos
   Abra o relatório de falhas CSV no Excel. Classifique pela coluna ErrorCode. Procure pelo código de erro SPO_FailedPathLengthLimit. Esses arquivos têm caminhos que excedem 400 caracteres. Copie o caminho de origem completo para cada arquivo.
3. Encurtar caminhos de arquivos no servidor de origem
   No servidor de arquivos de origem, mova os arquivos com caminhos longos para uma estrutura de pastas mais curta. Por exemplo, mova \\ServidorA\Dados\Dept\Projeto\Sub\Arquivo.docx para \\ServidorA\Dados\Arquivo.docx. Não renomeie o arquivo em si, a menos que o nome contenha caracteres ilegais.
4. Corrigir caracteres ilegais em nomes de arquivos
   No relatório de falhas, procure pelo código de erro SPO_FailedIllegalCharacter. Abra a pasta de origem no Windows File Explorer. Renomeie cada arquivo para remover os caracteres ilegais. Substitua " : < > ? / \ | por um sublinhado ou hífen.
5. Pausar a sincronização do OneDrive em todas as máquinas de destino
   Em cada computador de usuário que sincroniza a biblioteca do OneDrive de destino, clique com o botão direito no ícone do OneDrive na bandeja do sistema e selecione Pausar sincronização. Escolha 2 horas. Isso evita bloqueios de arquivos durante a nova tentativa de migração.
6. Criar um novo trabalho de migração para os arquivos corrigidos
   Na Ferramenta de Migração do SharePoint, clique em Nova Migração. Selecione Compartilhamento de Arquivos como origem. Navegue até a pasta que agora contém os arquivos corrigidos. Defina o destino para a mesma biblioteca do OneDrive usada no trabalho original.
7. Executar o trabalho de migração e verificar
   Inicie o novo trabalho de migração. Após a conclusão, abra o relatório de falhas novamente. Confirme que a contagem de erros é zero. Abra a biblioteca do OneDrive de destino em um navegador da web e verifique se os arquivos aparecem.

Se o OneDrive ainda tiver arquivos ausentes após a correção principal

Se o relatório de falhas não mostrar erros, mas os arquivos ainda estiverem ausentes da biblioteca do OneDrive de destino, verifique os seguintes cenários.

Arquivos foram migrados, mas sobrescritos por conflitos de sincronização

Quando dois arquivos com o mesmo nome são migrados de pastas de origem diferentes, apenas o último escrito sobrevive. A ferramenta de migração não mescla o conteúdo dos arquivos. Para recuperar o arquivo sobrescrito, abra a biblioteca do OneDrive em um navegador da web, clique no nome do arquivo e selecione Histórico de Versões. Procure pela versão anterior que foi migrada primeiro. Restaure-a se necessário.

Arquivos existiam em vários locais de origem, mas apenas uma cópia foi transferida

Se o mesmo arquivo estava presente em duas pastas de origem diferentes e ambas foram mapeadas para a mesma biblioteca de destino, a ferramenta de migração deduplica pelo nome do arquivo. A segunda cópia é ignorada. Para preservar ambas as cópias, renomeie uma versão na origem antes de tentar a migração novamente.

Arquivos foram excluídos pela política do locatário

Seu locatário do Microsoft 365 pode ter políticas de bloqueio de tipos de arquivo para o OneDrive. Tipos bloqueados comuns incluem .exe, .ps1, .vbs e .zip. Abra o centro de administração do Microsoft 365, vá para Configurações > Configurações da organização > OneDrive e verifique a lista Bloquear tipos de arquivo. Se um tipo de arquivo ausente estiver listado, remova-o da lista de bloqueio ou altere a extensão do arquivo antes da migração.

Item	Ferramenta de Migração do SharePoint	Arrastar e Soltar Manual
Relatório de erros	Produz um CSV detalhado de falhas com códigos de erro	Nenhum relatório de erros; arquivos são ignorados silenciosamente
Tratamento de tamanho de caminho	Ignora arquivos com mais de 400 caracteres; sem correção automática	Ignora arquivos com mais de 400 caracteres; sem correção automática
Processamento em lote	Suporta milhares de arquivos em um único trabalho	Upload manual por arquivo; impraticável para fusões
Migração de permissões	Copia permissões NTFS para o SharePoint se habilitado	Redefine permissões para as configurações padrão da biblioteca

Após concluir as etapas acima, você pode identificar e migrar todos os arquivos que foram perdidos durante a migração original do servidor de arquivos para o OneDrive na fusão. Execute o relatório de falhas novamente após a nova tentativa para confirmar zero erros. Como dica avançada, ative a opção Preservar histórico de versões de arquivos nas configurações da Ferramenta de Migração do SharePoint antes da nova tentativa para capturar versões anteriores de arquivos sobrescritos.