Você abre uma biblioteca de documentos do SharePoint e a página leva muitos segundos para exibir os arquivos. O spinner do navegador fica girando e você não consegue editar ou baixar itens rapidamente. Esse problema geralmente acontece porque a exibição está tentando carregar muitos itens, colunas complexas ou valores de metadados grandes de uma só vez. Este artigo explica as principais causas para uma exibição lenta de biblioteca de documentos e as configurações específicas que você pode ajustar para acelerar o tempo de carregamento.
Principais conclusões: Acelerando uma exibição lenta de biblioteca de documentos
- Configurações da biblioteca > Limite de limitação (5000 itens): Quando uma exibição excede 5000 itens, o SharePoint limita a consulta e a página carrega lentamente.
- Formatação da exibição > Agrupar ou classificar por colunas indexadas: Agrupar ou classificar por uma coluna sem índice força uma varredura completa da biblioteca.
- Tipos de coluna > Colunas de escolha, pesquisa ou pessoa/grupo: Essas colunas exigem viagens extras ao servidor para resolver nomes de exibição e valores.
Por que uma exibição de biblioteca de documentos carrega lentamente
Uma exibição de biblioteca de documentos é uma consulta salva que busca itens do banco de dados de conteúdo e os renderiza no navegador. Quando a exibição carrega lentamente, a causa raiz é quase sempre uma de três coisas: a consulta retorna muitos itens, a consulta usa colunas não indexadas para classificação ou filtragem, ou a exibição inclui colunas que exigem pesquisas caras. O SharePoint tem um limite de exibição de lista de 5000 itens para usuários padrão. Se a exibição exceder esse número, o servidor limita a consulta e retorna apenas resultados parciais após um atraso. Mesmo que o número total de itens esteja abaixo de 5000, uma exibição que agrupa por uma coluna sem índice força o SQL Server a escanear cada linha. Da mesma forma, colunas como Pessoa ou Grupo, Pesquisa e Metadados Gerenciados armazenam IDs internos e precisam resolver nomes de exibição por meio de consultas adicionais. Cada coluna resolvida adiciona milissegundos e, com centenas de linhas, o atraso se torna segundos.
O limite de 5000 itens da exibição de lista
O SharePoint Server e o SharePoint Online impõem um limite de exibição de lista de 5000 itens por consulta. Esse limite protege o banco de dados de conteúdo de varreduras grandes que poderiam desacelerar outros usuários. Quando uma exibição tenta carregar mais de 5000 itens, o SharePoint retorna um erro ou uma resposta limitada. O usuário vê uma página parcialmente carregada ou uma mensagem de que a exibição não pode ser exibida. A solução é criar colunas indexadas e usar filtros que limitem o conjunto de resultados a menos de 5000 itens.
Colunas não indexadas usadas para classificação ou filtragem
Quando você classifica ou filtra uma exibição por uma coluna que não possui índice, o SharePoint não pode usar um índice de banco de dados para localizar os itens. Em vez disso, ele precisa escanear toda a biblioteca. Para bibliotecas com muitos itens, essa varredura causa um atraso perceptível. Índices são necessários em qualquer coluna usada na exibição padrão para classificação, filtragem ou agrupamento. Sem um índice, a exibição sempre terá desempenho ruim à medida que a biblioteca cresce.
Tipos de coluna caros
Certos tipos de coluna exigem processamento adicional no servidor. Colunas Pessoa ou Grupo armazenam um ID de usuário e precisam consultar o Active Directory ou Azure AD para exibir o nome de exibição. Colunas de pesquisa recuperam um valor de outra lista, adicionando uma segunda consulta. Colunas de Metadados Gerenciados resolvem IDs de termos para rótulos. Cada uma dessas colunas aumenta o tempo de carregamento por linha. Uma exibição com dez colunas Pessoa e 200 linhas disparará mais de 2000 consultas adicionais.
Etapas para diagnosticar e corrigir uma exibição lenta de biblioteca de documentos
Siga estas etapas em ordem. Cada etapa aborda uma causa diferente. Após cada alteração, teste o tempo de carregamento da exibição.
- Verifique o número total de itens na biblioteca
Abra a biblioteca de documentos. Na parte inferior da página, procure a contagem de itens. Se a contagem estiver acima de 5000, a exibição será limitada. Crie uma nova exibição que filtre por uma coluna de data ou uma coluna de escolha para reduzir o número de itens exibidos. Use o índice da coluna para tornar o filtro eficiente. - Adicione um índice à coluna usada para classificação
Vá para Configurações da biblioteca > Colunas indexadas. Clique em Criar um novo índice. Selecione a coluna pela qual a exibição padrão é classificada, como Modificado ou Criado. Clique em Criar. Após a criação do índice, a consulta de classificação usa o índice em vez de escanear a biblioteca. - Adicione um índice à coluna usada para filtragem
Se a exibição tiver um filtro (por exemplo, Status igual a Ativo), a coluna do filtro deve ter um índice. Repita o mesmo processo em Configurações da biblioteca > Colunas indexadas. Crie um índice na coluna do filtro. Sem um índice, o filtro ainda escaneia todos os itens. - Remova o agrupamento em colunas não indexadas
Se a exibição usar Agrupar por, a coluna agrupada deve ter um índice. Se a coluna não tiver um índice, remova o agrupamento ou substitua-o por um filtro. Para remover o agrupamento, edite a exibição e defina Agrupar por como Nenhum. - Substitua colunas caras por colunas de texto simples
Identifique colunas do tipo Pessoa ou Grupo, Pesquisa ou Metadados Gerenciados. Se essas colunas não forem essenciais para a exibição padrão, remova-as da exibição. Para fazer isso, edite a exibição e desmarque a caixa de seleção ao lado do nome da coluna. Se a coluna for necessária, considere usar uma coluna calculada que armazene o valor de texto em vez do ID de pesquisa. - Limite o número de itens por página
Edite a exibição. Na seção Limite de itens, defina o número de itens a serem exibidos como 30 ou 50. Marque a caixa para limitar o número total de itens retornados. Essa configuração impede que a exibição carregue milhares de linhas de uma só vez. - Crie uma nova exibição com apenas as colunas essenciais
Vá para Configurações da biblioteca > Exibições > Criar uma nova exibição. Escolha um tipo de exibição padrão. Adicione apenas as colunas necessárias. Defina um filtro em uma coluna indexada. Defina a classificação em uma coluna indexada. Defina o limite de itens como 30. Teste a nova exibição. Se carregar rapidamente, torne-a a exibição padrão.
Se a exibição da biblioteca de documentos ainda estiver lenta após a correção principal
A exibição carrega lentamente apenas para determinados usuários
Isso geralmente significa que um usuário tem permissões exclusivas ou é membro de muitos grupos do SharePoint. Quando um usuário tem permissões exclusivas, o SharePoint precisa avaliar a segurança de cada item individualmente. Verifique se a biblioteca tem herança de permissões quebrada. Vá para Configurações da biblioteca > Permissões para esta biblioteca de documentos. Se a herança estiver quebrada, restaure a herança e conceda permissões no nível da biblioteca em vez do nível do item.
A exibição carrega lentamente apenas no navegador, mas não no SharePoint Designer
O navegador renderiza todas as colunas e formatação no lado do cliente. Se a exibição usar formatação personalizada ou JavaScript, o tempo de renderização aumenta. Edite a exibição e remova qualquer formatação JSON ou formatação condicional. Teste a exibição após remover a formatação.
A exibição carrega lentamente após adicionar uma nova coluna
A nova coluna pode ser uma coluna de pesquisa ou metadados gerenciados que dispara consultas extras. Remova a coluna da exibição. Se a exibição acelerar, o tipo de coluna é a causa. Substitua a coluna por uma coluna de texto simples que os usuários preencham manualmente.
A exibição carrega lentamente na experiência moderna, mas não na experiência clássica
A experiência moderna usa renderização no lado do cliente e pode baixar recursos adicionais. Mude temporariamente a biblioteca para a experiência clássica. Vá para Configurações da biblioteca > Configurações avançadas. Em Experiência de lista, escolha Experiência clássica. Se a exibição carregar mais rápido, a experiência moderna é o gargalo. Você pode manter a biblioteca no modo clássico ou reduzir o número de colunas na exibição moderna.
| Item | Antes da correção | Depois da correção |
|---|---|---|
| Número de itens na exibição | 6000 itens | Filtrado para 200 itens |
| Índice da coluna de classificação | Sem índice em Modificado | Índice em Modificado |
| Índice da coluna de filtro | Sem índice em Status | Índice em Status |
| Colunas caras | 3 colunas Pessoa na exibição | 0 colunas Pessoa na exibição |
| Limite de itens por página | 100 itens | 30 itens |
Agora você pode diagnosticar e corrigir uma exibição lenta de biblioteca de documentos verificando a contagem de itens, adicionando índices e removendo colunas caras. Comece criando um índice na coluna pela qual você classifica. Em seguida, reduza o número de colunas na exibição. Se a exibição ainda carregar lentamente, verifique permissões exclusivas ou formatação personalizada. Para bibliotecas muito grandes, use uma exibição filtrada que retorne menos de 5000 itens sempre.