// Referência de erro do PostgreSQL

PostgreSQL 54000: limite do programa excedido

Um limite de implementação rígido foi atingido, na maioria das vezes um valor grande demais para uma entrada de índice B-tree, ou colunas ou argumentos de função demais.

SQLSTATE
54000
Nome
program_limit_exceeded
Categoria
Limite de Programa Excedido
Mensagem de erro
index row size 3200 exceeds btree version 4 maximum 2704 for index "documents_body_idx"
DETAIL:  Index row references tuple (12,3) in relation "documents".
HINT:  Values larger than 1/3 of a buffer page cannot be indexed.
Consider a function index of an MD5 hash of the value, or use full text indexing.

O que significa

54000 (program_limit_exceeded) é gerado quando uma instrução esbarra em um dos limites fixos do PostgreSQL. O mais conhecido é o tamanho da entrada da B-tree: um valor indexado precisa caber em cerca de um terço de uma página de 8 kB (2704 bytes nos índices B-tree atuais), então um índice único em uma coluna de texto longo falha quando chega um valor grande.

Outros limites nesta classe incluem no máximo 1600 colunas por tabela, 100 argumentos por função e 1664 entradas em uma lista de seleção.

Causas comuns

  • Um índice B-tree (frequentemente de uma UNIQUE restrição) em uma coluna de texto, JSON ou bytea que pode conter valores grandes.
  • Uma consulta gerada com milhares de colunas ou expressões.
  • Chamar uma função com mais de 100 argumentos, por exemplo, uma muito ampla json_build_object.

Como corrigir

  1. Indexar um hash do valor em vez do valor em si; isso ainda reforça a unicidade para fins práticos.

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. Para pesquisar dentro de textos longos, use busca em texto completo ou índices de trigramas em vez de um índice B-tree.

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. Para dados muito largos, armazene atributos em menos colunas (jsonb), e construir objetos a partir de linhas (to_jsonb(t)) em vez de passar centenas de argumentos.

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.