PostgreSQL: como escolher entre índices B-tree, Hash, GiST, GIN e BRIN
A documentação oficial do PostgreSQL define seis tipos de índice, cada um pensado pra um padrão de consulta diferente. Veja o operador que cada um atende, quando ele vence e o CREATE INDEX pronto pra testar.
Este guia mostra qual índice escolher no PostgreSQL pra cada tipo de consulta: igualdade, intervalo, padrão de texto, array, dado espacial ou tabela gigante que só cresce. Os exemplos de CREATE INDEX seguem a sintaxe documentada pra versão 18, a atual (a documentação oficial de tipos de índice, fonte deste texto, foi atualizada em 12 de novembro de 2026 junto com o lançamento do PostgreSQL 18.7). A mesma lógica vale pras versões 17, 16, 15 e 14, que a documentação lista como suportadas.
Por padrão, CREATE INDEX sem nenhuma cláusula extra cria um índice B-tree. Os outros cinco tipos, Hash, GiST, SP-GiST, GIN e BRIN, só entram com USING seguido do nome: CREATE INDEX name ON table USING HASH (column). Escolher o tipo errado não quebra a consulta, mas deixa o planner sem opção de usar o índice, ou usando ele de um jeito caro.
B-tree: o padrão que resolve a maioria dos casos
B-tree atende <, <=, =, >=, >, além de construções equivalentes como BETWEEN, IN, IS NULL e IS NOT NULL. Também serve pra ORDER BY, porque a árvore já guarda os valores ordenados. É o índice certo pra chave estrangeira, campo de data usado em intervalo e qualquer coluna comparada com os operadores acima.
Um detalhe que passa batido: B-tree também cobre LIKE e ~ quando o padrão é uma constante ancorada no início da string, como col LIKE 'foo%', mas não col LIKE '%bar'. Fora do locale C, isso exige uma operator class especial (a documentação trata disso na seção de operator classes). ILIKE e ~* entram na mesma regra, só quando o padrão começa com caractere que maiúscula/minúscula não afeta.
-- PostgreSQL 18
CREATE TABLE orders (
id bigserial PRIMARY KEY,
customer_id integer NOT NULL,
status text NOT NULL,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX idx_orders_customer_id ON orders (customer_id);Com o índice criado, SELECT * FROM orders WHERE customer_id = 42 e SELECT * FROM orders WHERE created_at BETWEEN '2026-11-01' AND '2026-11-30' usam idx_orders_customer_id e um índice equivalente em created_at, respectivamente. Custo de escrita: moderado, cresce em log(n) com o tamanho da tabela, é o parâmetro de comparação pros outros tipos.
Hash: só serve pra igualdade
Hash guarda um código de 32 bits derivado do valor da coluna, então só atende o operador =. Ele não serve pra ORDER BY, pra intervalo nem pra LIKE: qualquer consulta que não seja igualdade pura ignora esse índice e cai em Seq Scan. É uma escolha de nicho, pra coluna que só é consultada por igualdade e nunca ordenada.
CREATE INDEX idx_orders_status_hash ON orders USING HASH (status);SELECT * FROM orders WHERE status = 'paid' usa esse índice; SELECT * FROM orders WHERE status > 'paid' ou ORDER BY status não usam. Na dúvida entre Hash e B-tree pra uma coluna só de igualdade, B-tree continua sendo a opção mais versátil, porque cobre o mesmo caso e ainda sobra pra intervalo e ordenação se a consulta mudar depois.
GiST: dado espacial e busca por vizinho mais próximo
GiST não é um índice único, é uma infraestrutura dentro da qual várias estratégias de indexação são implementadas. A distribuição padrão do PostgreSQL traz operator classes GiST pros tipos geométricos bidimensionais, e é esse conjunto que sustenta consultas de proximidade:
CREATE TABLE places (
id bigserial PRIMARY KEY,
name text NOT NULL,
location point NOT NULL
);
CREATE INDEX idx_places_location ON places USING GIST (location);Com o índice no lugar, a consulta de "vizinho mais próximo" do próprio exemplo da documentação funciona assim:
SELECT * FROM places
ORDER BY location <-> point '(101,456)'
LIMIT 10;Isso devolve os dez lugares mais próximos do ponto informado, e só é eficiente porque a operator class usada suporta operadores de ordenação (a documentação lista quais classes suportam isso na tabela de operator classes de GiST). Custo de escrita: mais alto que B-tree, porque a estrutura da árvore em GiST é balanceada e cada inserção pode reorganizar nós internos. A prima de GiST é SP-GiST, pensada pra estruturas não balanceadas como quadtree, k-d tree e trie (radix tree); vale olhar quando o dado tem padrão espacial muito irregular, tipo IP ou texto em prefixo.
GIN: quando a coluna guarda vários valores por linha
GIN é um índice invertido: em vez de uma entrada por linha, ele guarda uma entrada por valor componente. É o índice certo pra coluna array, jsonb ou full-text, onde cada linha carrega múltiplos valores e a consulta pergunta se um deles está presente. A operator class padrão pra array atende <@, @>, = e &&.
CREATE TABLE products (
id bigserial PRIMARY KEY,
name text NOT NULL,
tags text[] NOT NULL DEFAULT '{}'
);
CREATE INDEX idx_products_tags ON products USING GIN (tags);SELECT * FROM products WHERE tags @> ARRAY['eletrônicos'] usa idx_products_tags pra achar só os produtos que têm essa tag no array, sem varrer a tabela inteira. O custo de escrita é o mais alto da lista: cada insert ou update numa linha com array de dez elementos grava até dez entradas no índice, uma pra cada componente. Em tabela com muita escrita e array grande, isso pesa de verdade; vale medir antes de colocar GIN em coluna que muda com frequência.
BRIN: tabela gigante com ordem física previsível
BRIN (Block Range INdexes) guarda resumos sobre os valores de faixas consecutivas de blocos físicos da tabela, não um valor por linha. Funciona bem quando a coluna indexada está correlacionada com a ordem física das linhas, o caso clássico de uma tabela de log ou evento que só recebe insert, nunca update, e é lida por data. Pra tipo com ordem linear, o resumo guarda o mínimo e o máximo de cada faixa de blocos.
CREATE TABLE events (
id bigserial PRIMARY KEY,
created_at timestamptz NOT NULL,
payload jsonb
);
CREATE INDEX idx_events_created_at ON events USING BRIN (created_at);O ganho aparece no plano de execução. Numa tabela de eventos sem índice, filtrar por intervalo de data obriga o planner a varrer tudo:
EXPLAIN SELECT * FROM events
WHERE created_at >= '2026-11-01' AND created_at < '2026-11-08';Sem índice o plano mostra Seq Scan on events com Filter aplicado linha a linha. Com idx_events_created_at no lugar, o mesmo EXPLAIN passa a mostrar Bitmap Heap Scan on events com Recheck Cond e, abaixo, Bitmap Index Scan on idx_events_created_at: o planner usa o resumo pra descartar faixas de blocos inteiras antes de ler a tabela. Os números de custo variam conforme o volume de dados; o que muda de estrutura é esse salto de Seq Scan pra Bitmap Heap Scan via índice.
O trade-off de BRIN é esse mesmo acoplamento: se a tabela recebe muito update ou delete que bagunça a ordem física, ou se a coluna não tem correlação nenhuma com a ordem de inserção, o resumo por faixa fica impreciso e BRIN perde a vantagem. Em compensação, o custo de escrita e o tamanho em disco são os mais baixos entre os seis tipos, porque o índice guarda um resumo por faixa de blocos, não uma entrada por linha.
Os seis tipos lado a lado
| Tipo | Operadores típicos | Melhor caso | Custo de escrita |
|---|---|---|---|
| B-tree | < <= = >= >, BETWEEN, IN, IS NULL, ORDER BY | Chave estrangeira, data em intervalo, qualquer coluna comparável | Moderado |
| Hash | = | Igualdade pura, sem ordenação nem intervalo | Baixo a moderado |
| GiST | Depende da operator class (geometria, <-> pra vizinho mais próximo) | Dado espacial, busca de proximidade | Alto |
| SP-GiST | Depende da operator class (<< >> ~= <@ etc.) | Estrutura não balanceada: quadtree, k-d tree, trie | Alto |
| GIN | <@ @> = && | Array, jsonb, full-text: coluna com vários valores por linha | Muito alto |
| BRIN | Depende da operator class, tipicamente comparação com ordem linear | Tabela gigante, append-only, correlacionada com a ordem física | Muito baixo |
Próximo passo
A documentação oficial de tipos de índice, usada como base deste guia, segue direto pra Multicolumn Indexes (seção 11.3), que explica quando combinar colunas num único índice em vez de criar vários. As tabelas 65.1 a 65.4 da documentação listam as operator classes de cada tipo, o material pra decidir qual classe usar em GiST, SP-GiST, GIN e BRIN além dos exemplos padrão deste texto. Pra medir se o índice escolhido realmente está sendo usado, o caminho é EXPLAIN (ANALYZE, BUFFERS) na consulta real, comparando o plano antes e depois de criar o índice no ambiente de teste.
Fonte: PostgreSQL docs: Index Types
Este artigo foi escrito por Patrícia Guimarães. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.
Editora virtual de Banco de dados do Linha de Código. Cobre SQL de verdade — consulta, índice, transação, plano de execução — em PostgreSQL, MySQL, SQL Server, MongoDB e Redis, e a modelagem que evita o problema antes dele existir. Escreve para o desenvolvedor que também é o DBA da empresa.