Ao sincronizar uma biblioteca compartilhada no OneDrive, o status de sincronização pode exibir “Pendente” por horas ou até dias, especialmente se a biblioteca contiver dezenas de milhares de arquivos. Esse problema ocorre porque o mecanismo de sincronização do OneDrive tem um limite interno no número de itens que pode processar em uma única relação de sincronização. Este artigo explica os limites técnicos que causam o estado pendente, fornece um checklist passo a passo para administradores resolverem o problema e lista padrões de falha relacionados que você pode encontrar com bibliotecas grandes.
Principais conclusões: Resolvendo sincronização pendente para bibliotecas compartilhadas grandes
- Limite de 300.000 itens por biblioteca no OneDrive: A sincronização para e exibe “Pendente” quando a biblioteca excede esse limite; reduzir a contagem de itens resolve o problema.
- Limite de exibição de lista do SharePoint de 5.000 itens: Pastas grandes ou colunas de metadados que excedem esse limite fazem a sincronização travar; dividir pastas ou adicionar colunas indexadas corrige o problema.
- Central de administração do OneDrive > Sincronização > Bloqueio de tipo de arquivo: Bloquear tipos de arquivo grandes como .zip ou .iso reduz o número de arquivos que precisam ser processados, acelerando a sincronização para bibliotecas grandes.
Por que a sincronização de biblioteca compartilhada fica pendente para bibliotecas grandes
O cliente de sincronização do OneDrive usa o índice de pesquisa do SharePoint para descobrir alterações em uma biblioteca. Quando uma biblioteca contém mais de 300.000 itens em todas as pastas, o cliente de sincronização não consegue enumerar a lista completa de arquivos dentro do intervalo de tempo que aloca. O mecanismo de sincronização então entra em um estado pendente enquanto tenta repetidamente a operação de enumeração.
Um segundo fator técnico é o limite de exibição de lista do SharePoint de 5.000 itens. Se qualquer pasta única ou exibição de metadados na biblioteca exceder 5.000 itens, o cliente de sincronização não consegue recuperar o conteúdo da pasta. Isso faz com que a sincronização pare nessa pasta específica, e toda a sincronização da biblioteca aparece como pendente.
Um terceiro fator é o número de relações de sincronização por usuário. O OneDrive permite no máximo 5 bibliotecas compartilhadas sincronizadas simultaneamente. Quando um usuário já sincroniza várias bibliotecas, adicionar uma biblioteca grande ultrapassa a capacidade de sincronização simultânea do cliente, levando a um estado pendente.
Checklist do administrador: etapas para corrigir sincronização pendente para bibliotecas grandes
- Verifique a contagem de itens da biblioteca
Abra a Central de administração do SharePoint > Sites ativos. Selecione o site que contém a biblioteca. Vá para Conteúdo do site > nome da biblioteca. Na parte inferior da página da biblioteca, procure a contagem de itens. Se a contagem exceder 300.000, a biblioteca é muito grande para sincronização. Reduza a contagem de itens arquivando arquivos mais antigos em uma biblioteca separada ou movendo arquivos para um site diferente. - Divida a biblioteca em várias bibliotecas menores
Crie uma nova biblioteca de documentos no mesmo site. Mova arquivos por ano, departamento ou projeto para a nova biblioteca. Cada biblioteca deve permanecer abaixo de 300.000 itens. Após a movimentação, peça ao usuário para sincronizar a nova biblioteca em vez da original. - Verifique as contagens de itens de pasta em relação ao limite de 5.000 itens
Abra a biblioteca no SharePoint. Classifique por pasta. Expanda cada pasta e verifique a contagem de itens na parte inferior da exibição da pasta. Qualquer pasta com mais de 5.000 itens fará a sincronização travar. Crie subpastas dentro dessa pasta para que cada subpasta fique abaixo de 5.000 itens. - Adicione colunas indexadas à biblioteca
Vá para Configurações da biblioteca > Colunas indexadas. Adicione colunas que os usuários usam comumente para classificar ou filtrar, como “Modificado” ou “Criado”. Colunas indexadas ajudam o cliente de sincronização a consultar a biblioteca sem atingir o limite de exibição de 5.000 itens. - Reduza o número de bibliotecas sincronizadas por usuário
Abra a Central de administração do OneDrive > Sincronização. Em “Limitar sincronização a bibliotecas compartilhadas específicas”, defina o número máximo de bibliotecas que um usuário pode sincronizar. Oriente os usuários a parar de sincronizar bibliotecas que não precisam mais. Vá para Configurações do OneDrive > Conta > Parar sincronização na biblioteca não utilizada. - Bloqueie tipos de arquivo grandes da sincronização
Na Central de administração do OneDrive > Sincronização > Bloqueio de tipo de arquivo, adicione extensões de arquivo como .zip, .iso, .psd e .mov. Bloquear esses tipos de arquivo impede que o cliente de sincronização os baixe, o que reduz a contagem total de itens que precisam ser processados. - Redefina o cliente de sincronização do OneDrive
Pressione a tecla Windows + R, digiteonedrive.exe /resete pressione Enter. Aguarde 2 minutos. Pressione a tecla Windows + R novamente, digiteonedrive.exee pressione Enter. Isso limpa o cache local e força uma ressincronização completa. Use esta etapa somente após reduzir o tamanho da biblioteca, caso contrário o estado pendente retornará. - Ative relatórios de integridade de sincronização na central de administração
Vá para Central de administração do OneDrive > Integridade > Integridade da sincronização. Ative “Relatórios de integridade da sincronização”. Esses relatórios mostram quais usuários têm bibliotecas que excedem os limites de sincronização. Use os relatórios para identificar proativamente bibliotecas grandes antes que os usuários relatem problemas de sincronização pendente.
Se o OneDrive ainda mostrar Pendente após a correção principal
OneDrive mostra “Pendente” para uma biblioteca recém-criada
Uma nova biblioteca pode mostrar pendente se o índice de pesquisa do SharePoint não terminou de rastreá-la. Aguarde 24 horas para a conclusão do índice. Se o estado pendente persistir, peça ao proprietário do site para executar uma solicitação de índice manual: vá para Configurações da biblioteca > Configurações avançadas > Reindexar biblioteca de documentos. Isso aciona um rastreamento completo em até 2 horas.
A sincronização do OneDrive para em uma porcentagem específica e mostra pendente
Isso indica que um arquivo ou pasta está bloqueando a sincronização. Abra o OneDrive > Exibir problemas de sincronização. Procure arquivos com nomes com mais de 400 caracteres, caminhos com mais de 400 caracteres ou arquivos que contenham caracteres inválidos como " : < > ? / \ |. Renomeie ou exclua o arquivo problemático. Em seguida, pause e retome a sincronização no ícone do OneDrive na barra de tarefas.
OneDrive mostra pendente para uma biblioteca que sincronizava bem antes
A biblioteca pode ter crescido além do limite de 300.000 itens devido a novos uploads de arquivos. Verifique a contagem de itens da biblioteca novamente. Se a contagem estiver próxima do limite, peça aos usuários para parar de enviar novos arquivos até que você arquive os arquivos mais antigos. Como alternativa, crie uma nova biblioteca e mova os arquivos mais antigos para lá.
OneDrive mostra pendente em uma biblioteca compartilhada, mas não no OneDrive do usuário
Bibliotecas compartilhadas usam uma relação de sincronização separada. Cada relação consome memória e recursos de processamento. Se o usuário sincronizar 4 ou 5 bibliotecas compartilhadas, o cliente pode não ter recursos suficientes para processar uma biblioteca grande. Peça ao usuário para parar de sincronizar uma ou duas bibliotecas compartilhadas. Em seguida, reinicie o OneDrive no ícone da barra de tarefas.
Comportamento da sincronização de biblioteca compartilhada do OneDrive: biblioteca grande vs. pequena
| Item | Biblioteca grande (mais de 300.000 itens) | Biblioteca pequena (menos de 100.000 itens) |
|---|---|---|
| Tempo de inicialização da sincronização | Mostra pendente por 30 minutos a 24 horas | Conclui em até 5 minutos |
| Método de enumeração de arquivos | Depende do índice de pesquisa do SharePoint; pode falhar se o índice estiver desatualizado | Usa consulta direta à lista; conclui rapidamente |
| Risco de limite de exibição de pasta | Alto; qualquer pasta com 5.000+ itens bloqueia a sincronização | Baixo; pastas raramente excedem 5.000 itens |
| Intervenção do administrador necessária | Sim; é necessário reduzir a contagem de itens ou dividir a biblioteca | Não; a sincronização funciona sem alterações |
| Visibilidade no relatório de integridade da sincronização | Dispara alerta nos relatórios de integridade da sincronização | Não dispara alerta |
Agora você pode identificar por que a sincronização de uma biblioteca compartilhada fica pendente e aplicar a correção correta com base no tamanho da biblioteca. Comece verificando a contagem de itens da biblioteca na Central de administração do SharePoint. Se a contagem exceder 300.000, divida a biblioteca em bibliotecas menores. Para pastas que excedem 5.000 itens, adicione colunas indexadas ou crie subpastas. Ative relatórios de integridade da sincronização na Central de administração do OneDrive para detectar bibliotecas grandes antes que os usuários relatem problemas. Como dica avançada, configure uma política de retenção no Centro de conformidade do Microsoft 365 para arquivar automaticamente arquivos com mais de 5 anos em uma biblioteca separada, mantendo a biblioteca ativa abaixo do limite de 300.000 itens.