Solução de problemas de migração de servidor de arquivos para OneDrive for Business: dados executivos com arquivos faltando

Ao migrar dados de servidor de arquivos para o OneDrive for Business, pastas de dados executivos às vezes chegam com arquivos faltando. Esse problema ocorre quando a ferramenta de migração ignora arquivos que excedem os limites de comprimento do caminho, possuem caracteres não suportados ou estão bloqueados por aplicativos abertos. Este artigo explica por que os arquivos desaparecem durante a migração e fornece métodos passo a passo para localizá-los e recuperá-los.

Por que os arquivos desaparecem durante a migração do servidor de arquivos para o OneDrive

A causa principal é que os dados do servidor de arquivos geralmente contêm caminhos de arquivo com mais de 260 caracteres, que é o comprimento máximo de caminho suportado pelo sistema de arquivos do Windows 10. Quando a Ferramenta de Migração do SharePoint ou qualquer outro agente de migração encontra um caminho de arquivo que excede esse limite, ele ignora o arquivo sem movê-lo e não relata a omissão por padrão. Além disso, arquivos com caracteres reservados como ~ " # % & : < > ? / \ { | } em seus nomes também são ignorados. Pastas de dados executivos tendem a ter subpastas profundamente aninhadas e nomes de arquivo descritivos longos, tornando-as especialmente propensas a essas violações de comprimento de caminho. Outra causa comum é que os arquivos estão bloqueados por um aplicativo aberto no servidor de origem durante a janela de migração, fazendo com que a ferramenta os trate como inacessíveis e os ignore.

Limites de comprimento de caminho no Windows 10 e no OneDrive

O Windows 10 tem um limite legado MAX_PATH de 260 caracteres para caminhos de arquivo. Esse limite se aplica ao caminho completo, incluindo a letra da unidade, nomes de pastas e o nome do arquivo. O OneDrive for Business sincroniza arquivos usando o sistema de arquivos do Windows, portanto, qualquer arquivo com um caminho maior que 260 caracteres não pode ser armazenado ou sincronizado. Ao migrar de um servidor de arquivos, a ferramenta de migração verifica o comprimento do caminho antes de copiar. Se o caminho exceder o limite, o arquivo é omitido da saída da migração.

Caracteres e tipos de arquivo não suportados

A Ferramenta de Migração do SharePoint bloqueia arquivos cujos nomes contenham caracteres que não são permitidos no OneDrive ou no SharePoint. Estes incluem ~ " # % & : < > ? / \ { | }. Arquivos com nomes terminados em ponto ou espaço também são ignorados. Pastas de dados executivos às vezes contêm arquivos com esses caracteres porque o sistema de arquivos do servidor de arquivos os permite. A ferramenta de migração registra essas omissões, mas não as exibe na visualização de resumo padrão.

Bloqueio de arquivos durante a migração

Se um arquivo estiver aberto em um aplicativo como Microsoft Excel ou Adobe Acrobat no servidor de origem no momento em que a ferramenta de migração tenta lê-lo, a ferramenta não consegue acessar o arquivo. A ferramenta trata o arquivo como indisponível e prossegue para o próximo item. Esta é uma condição transitória: se o arquivo for fechado antes da próxima passagem de verificação, ele será incluído. No entanto, em uma migração de passagem única, arquivos bloqueados são perdidos permanentemente.

Etapas para localizar e recuperar arquivos faltando após a migração

Use o procedimento a seguir para identificar cada arquivo ignorado e migrá-lo corretamente.

1. Execute o relatório de verificação da Ferramenta de Migração do SharePoint
   Abra a Ferramenta de Migração do SharePoint (SPMT) na máquina que realizou a migração. Clique na guia Relatórios. Selecione o trabalho de migração que processou a pasta de dados executivos. Clique em Baixar relatório de verificação. O relatório é um arquivo CSV que lista todos os arquivos que a ferramenta avaliou. Procure a coluna Status. Qualquer linha com um status diferente de Sucesso indica um arquivo ignorado. A coluna Mensagem de erro descreve o motivo.
2. Identifique arquivos com problemas de comprimento de caminho
   No relatório CSV, filtre a coluna Caminho de origem para caminhos com mais de 260 caracteres. Você pode usar o Excel ou um editor de texto com função de contagem de caracteres. Para cada arquivo, anote o caminho de origem completo. Esses arquivos devem ser renomeados para encurtar o caminho total ou movidos para uma estrutura de pastas mais rasa no servidor de origem antes de poder migrá-los.
3. Renomeie ou mova arquivos para encurtar caminhos
   No servidor de arquivos, navegue até cada arquivo identificado na etapa 2. Renomeie o arquivo para um nome mais curto ou mova o arquivo para uma pasta pai mais próxima da raiz. Certifique-se de que o novo caminho tenha menos de 260 caracteres. Após fazer a alteração, execute uma nova verificação do SPMT apenas nessa pasta. O arquivo agora deve aparecer com o status Pronto.
4. Remova caracteres não suportados dos nomes de arquivo
   Para arquivos cuja mensagem de erro mencione caracteres não suportados, renomeie o arquivo no servidor de origem para remover ou substituir o caractere. Por exemplo, substitua # por No e & por e. Evite usar pontos no meio do nome do arquivo. Após renomear, verifique novamente a pasta com o SPMT.
5. Ative o suporte a caminhos longos no Windows 10
   Na máquina que executa a ferramenta de migração, você pode ativar o suporte a caminhos longos modificando a Política de Grupo. Abra o Editor de Política de Grupo Local. Navegue até Configuração do Computador > Modelos Administrativos > Sistema > Sistema de Arquivos. Ative a política Habilitar caminhos longos do Win32. Reinicie a máquina. Isso permite que o SPMT lide com caminhos de até 32.767 caracteres. Observe que o OneDrive for Business ainda impõe o limite de 260 caracteres para arquivos sincronizados, portanto, isso ajuda apenas durante a etapa de migração.
6. Verifique arquivos bloqueados e agende uma segunda passagem
   Peça aos usuários executivos para fechar todos os arquivos no servidor de arquivos durante a janela de migração. Como alternativa, agende a migração para ocorrer fora do horário comercial, quando os arquivos não estiverem em uso. Depois de confirmar que nenhum arquivo está aberto, execute uma passagem de migração incremental na mesma pasta. O SPMT comparará a origem e o destino e migrará apenas os arquivos que estão faltando.
7. Verifique a contagem final de arquivos no OneDrive
   No OneDrive for Business, navegue até a pasta de destino. Clique com o botão direito na pasta e selecione Propriedades. Compare a contagem de arquivos com a pasta de origem no servidor de arquivos. Se os números coincidirem, a migração está completa. Caso contrário, repita as etapas 1 a 6 para os arquivos restantes.

Se os arquivos ainda estiverem faltando após a correção principal

Mesmo após seguir as etapas acima, alguns arquivos podem permanecer faltando devido a casos extremos que exigem atenção adicional.

OneDrive mostra um X vermelho em arquivos do Office compartilhados

Após a migração, alguns arquivos do Office podem exibir um X vermelho no File Explorer. Isso acontece quando o arquivo tem um conflito de coautoria ou um bloqueio obsoleto do servidor de arquivos original. Para corrigir, abra o arquivo diretamente do site do OneDrive. Clique no arquivo para abri-lo no aplicativo Office Online. Feche o arquivo. O X vermelho deve desaparecer em alguns minutos, à medida que o OneDrive sincroniza os metadados.

Arquivos estão presentes no OneDrive, mas não na pasta de sincronização local

Isso ocorre quando o usuário tem Arquivos Sob Demanda ativado e o arquivo ainda não foi baixado. O arquivo aparece como um espaço reservado apenas na nuvem. Para forçar o download, clique com o botão direito no arquivo no File Explorer e selecione Manter sempre neste dispositivo. O arquivo será baixado para o disco rígido local.

Ferramenta de migração relata sucesso, mas os arquivos não estão no OneDrive

Isso é causado por um problema de temporização em que a ferramenta de migração é concluída antes que o OneDrive termine de indexar os novos arquivos. Aguarde 15 minutos e atualize o site do OneDrive. Se os arquivos ainda não aparecerem, verifique o centro de administração do SharePoint em Migrações ativas para ver se há trabalhos travados. Retome o trabalho no centro de administração.

Ferramenta de Migração do SharePoint vs. Cópia Manual: Principais Diferenças para Dados Executivos

Item	Ferramenta de Migração do SharePoint (SPMT)	Cópia Manual via File Explorer
Descrição	Ferramenta automatizada que verifica, valida e migra arquivos com relatórios detalhados	Cópia por arrastar e soltar usando o Windows File Explorer ou Robocopy
Tratamento de comprimento de caminho	Relata caminhos com mais de 260 caracteres e os ignora; pode ser configurado para usar caminhos longos	Falha silenciosamente ou trunca nomes de arquivo; nenhum relatório de erro
Caracteres não suportados	Identifica e registra cada violação de caractere	Bloqueia a cópia com uma mensagem de erro genérica
Detecção de bloqueio de arquivo	Ignora arquivos bloqueados e registra a omissão	Falha com erro de acesso negado
Migração incremental	Suporta verificações delta para capturar arquivos ignorados anteriormente	Requer recópia manual de toda a pasta
Melhor para	Grandes conjuntos de dados executivos com estruturas de pastas complexas	Pastas pequenas com nomes simples e caminhos curtos

Esta tabela mostra que o SPMT é a escolha superior para dados executivos porque fornece relatórios de erro acionáveis e suporta passagens incrementais. A cópia manual é aceitável apenas para pastas com menos de 100 arquivos e sem preocupações com comprimento de caminho.

Agora você pode localizar todos os arquivos faltando da sua migração de dados executivos usando o relatório de verificação do SPMT. Após renomear caminhos longos e remover caracteres não suportados, execute uma migração incremental para trazer os arquivos faltando para o OneDrive. Para migrações futuras, ative a política de caminhos longos do Win32 na máquina de migração antes de iniciar a verificação para reduzir o número de arquivos ignorados.