Limite de Exibição de Lista Bloqueia uma Exibição Filtrada: Causas e Soluções
🔍 WiseChecker

Limite de Exibição de Lista Bloqueia uma Exibição Filtrada: Causas e Soluções

Ao abrir uma exibição de lista do SharePoint que deveria mostrar apenas alguns itens, mas exibe uma mensagem de erro ou resultado vazio, o limite de exibição da lista provavelmente está bloqueando a visualização. Isso acontece porque o SharePoint impõe um limite de 5.000 itens por exibição para listas e bibliotecas no SharePoint Server e SharePoint Online. O limite impede que consultas examinem mais de 5.000 itens de uma vez, mesmo que a exibição seja filtrada para retornar menos itens. Este artigo explica por que o limite bloqueia exibições filtradas e fornece soluções práticas para restaurar o acesso aos seus dados.

Principais Conclusões: Limite de Exibição de Lista e Exibições Filtradas

  • Configurações da Lista > Configurações Avançadas > Limite de Exibição de Lista: Controla o número máximo de itens que uma consulta pode examinar; o padrão é 5.000.
  • Colunas indexadas + Exibições filtradas: Adicionar um índice à coluna usada no filtro permite que a consulta examine apenas os itens correspondentes, ignorando o limite.
  • Central de Administração do SharePoint > Serviço de Conteúdo > Limite de Exibição de Lista: Permite aumentar o limite para coleções de sites específicas ou definir um limite maior para consultas do modelo de objeto.

ADVERTISEMENT

Por que o Limite de Exibição de Lista Bloqueia uma Exibição Filtrada

O limite de exibição de lista é uma proteção de desempenho do SharePoint. Ele impede consultas que examinariam mais de 5.000 itens em uma única operação. Quando uma exibição aplica um filtro, o SharePoint precisa avaliar cada item da lista para determinar se corresponde à condição do filtro. Se a lista contiver mais de 5.000 itens no total, a consulta falha porque a varredura excederia o limite, mesmo que o conjunto de resultados filtrados seja pequeno.

O detalhe técnico principal é que o SharePoint usa a coluna indexada no filtro para limitar a varredura. Se a coluna do filtro não estiver indexada, o SharePoint examina cada item sequencialmente. Quando a lista ultrapassa 5.000 itens, essa varredura completa é bloqueada. É por isso que uma exibição filtrada que funcionava quando a lista era pequena quebra assim que a lista excede 5.000 itens. A mensagem de erro que você vê depende do cliente: no navegador, você pode ver “A operação tentada é proibida porque excede o limite de exibição da lista”, enquanto no SharePoint Designer você pode receber uma falha genérica de consulta.

Outro cenário comum é quando a exibição usa um filtro em uma coluna que tem um índice, mas o filtro não é um operador suportado. Por exemplo, filtros usando “contém” ou “começa com” em uma coluna de texto exigem uma varredura completa mesmo que a coluna esteja indexada. Nesse caso, o limite ainda bloqueia a exibição. Entender essas duas causas raiz — falta de índice e operadores de filtro não suportados — é essencial para selecionar a solução correta.

Soluções para Corrigir uma Exibição Filtrada Bloqueada pelo Limite

Use os métodos a seguir em ordem de preferência. Comece com a solução mais simples, que é adicionar um índice à coluna filtrada. Se isso não funcionar, passe para o próximo método.

  1. Adicionar um índice à coluna filtrada
    Vá para Configurações da Lista > Colunas Indexadas > Criar um Novo Índice. Selecione a coluna usada no filtro da exibição e clique em Criar. Se o filtro usar várias colunas, crie um índice em cada coluna usada no filtro. Após a criação do índice, a consulta examina apenas os itens que correspondem ao filtro, ignorando o limite de varredura de 5.000 itens.
  2. Alterar o filtro para usar uma coluna indexada
    Se a coluna do filtro atual não puder ser indexada (por exemplo, uma coluna calculada ou uma coluna com tipo de dados não suportado), modifique a exibição para filtrar por uma coluna diferente que possa ser indexada. Por exemplo, se a exibição filtra por “Título contém X”, altere o filtro para “ID maior que 0” e adicione um segundo filtro na coluna indexada. Isso força o SharePoint a usar o índice.
  3. Aumentar o limite de exibição de lista na Central de Administração do SharePoint
    No SharePoint Online, vá para a Central de Administração do SharePoint > Serviços de Conteúdo > Limite de Exibição de Lista. Você pode aumentar o limite até 50.000 para consultas do modelo de objeto. Essa alteração se aplica a todos os sites do locatário. No SharePoint Server local, aumente o limite na Administração Central > Gerenciamento de Aplicativos Web > Configurações Gerais. Aumentar o limite é uma solução temporária, pois a lista pode continuar crescendo.
  4. Criar uma nova exibição com filtro de intervalo de datas
    Se a lista tiver uma coluna de data (como Criado ou Modificado), crie uma exibição que filtre por um intervalo de datas. Adicione um índice na coluna de data. Por exemplo, filtre “Criado é maior que [Hoje]-30” para limitar os itens aos últimos 30 dias. O SharePoint usa o índice de data para examinar apenas os itens correspondentes.
  5. Dividir a lista em várias listas menores
    Se a lista exceder regularmente 5.000 itens e você não puder evitar varreduras completas, divida os dados em listas separadas por ano, departamento ou categoria. Crie uma exibição personalizada ou uma coluna de pesquisa para conectar as listas. Esta é a solução mais permanente, mas requer reestruturação dos dados.

ADVERTISEMENT

Se a Exibição Filtrada Ainda Falhar Após Adicionar um Índice

Adicionar um índice não garante que a exibição funcionará se o filtro usar um operador não suportado. Os problemas a seguir são comuns.

Filtro usa “contém” ou “começa com” em uma coluna de texto

Esses operadores exigem uma varredura completa mesmo em uma coluna indexada. Altere o filtro para “é igual a” ou “é exatamente” se possível. Se você precisar de correspondência parcial, use uma coluna de pesquisa com um conjunto de termos de metadados gerenciados.

Filtro usa várias colunas, mas apenas uma está indexada

O SharePoint pode usar apenas um índice por consulta. Se a exibição tiver filtros em duas colunas, indexe a coluna com a maior seletividade (a coluna que reduz o conjunto de resultados ao máximo). Alternativamente, combine as duas colunas em uma única coluna calculada e indexe essa coluna calculada.

Valor do filtro é uma coluna do tipo usuário ou grupo

Colunas de usuário e grupo podem ser indexadas, mas o filtro deve usar o operador “é igual a”. Se você usar “é igual a [Eu]”, o SharePoint resolve o usuário atual no momento da consulta. Isso funciona com um índice na coluna de usuário. Se o filtro usar “contém” para um grupo, ele falhará. Mude para uma coluna Seletor de Pessoas com seleção de um único usuário e indexe essa coluna.

Exibição ainda mostra resultado vazio ou erro no SharePoint Designer

O SharePoint Designer usa um mecanismo de consulta diferente, mais sensível ao limite. Se a exibição funcionar no navegador, mas não no SharePoint Designer, crie uma nova exibição no navegador e use-a no fluxo de trabalho ou na fonte de dados. Não modifique a exibição no SharePoint Designer.

Filtro Indexado vs. Aumento do Limite: Principais Diferenças

Item Filtro Indexado Aumento do Limite
Implementação Adicionar índice na coluna filtrada nas configurações da lista Alterar o limite na Central de Administração ou Administração Central
Efeito no desempenho Consultas examinam apenas itens correspondentes, melhorando a velocidade Consultas examinam até 20.000 ou 50.000 itens, reduzindo o desempenho
Permanência Permanente enquanto o índice existir Temporário; a lista pode ultrapassar o limite maior
Operadores de filtro suportados Apenas “é igual a”, “não é igual a”, “maior que”, “menor que” Todos os operadores de filtro, mas apenas dentro do limite
Escopo administrativo Por lista ou biblioteca Por aplicativo web (local) ou locatário (online)

Agora você entende por que o limite de exibição de lista bloqueia exibições filtradas e como contorná-lo. Comece adicionando um índice à coluna filtrada e alterando o operador do filtro para “é igual a” se necessário. Se a lista continuar crescendo além de 5.000 itens, considere dividir os dados em várias listas. Para casos avançados, aumente o limite temporariamente na Central de Administração do SharePoint. A solução de longo prazo mais confiável é projetar exibições que sempre usem colunas indexadas com operadores suportados.

ADVERTISEMENT