O hotfix do mesmo dia foi trocar SELECT * por uma lista de colunas na listagem. Isso resolveu o p95, mas deixava a armadilha armada para a próxima consulta escrita com pressa ou para o ORM que seleciona todos os campos por padrão. A correção definitiva tirou o histórico da linha principal: as mensagens viraram linhas de uma tabela própria, e o que a listagem precisa, como última mensagem e total de mensagens, virou coluna pequena mantida na escrita.
// conversas-repositorio.js
import pg from 'pg';
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
// Listagem: só as colunas da tela, nenhuma delas vai para o TOAST.
export async function listarConversas(tenantId, { antesDe = null, limite = 50 } = {}) {
const { rows } = await pool.query(
`SELECT id, contato_nome, status, ultima_mensagem, total_mensagens, atualizado_em
FROM conversas
WHERE tenant_id = $1
AND ($2::timestamptz IS NULL OR atualizado_em < $2::timestamptz)
ORDER BY atualizado_em DESC
LIMIT $3`,
[tenantId, antesDe, limite],
);
return rows;
}
// Detalhe: as mensagens vêm paginadas da tabela própria, nunca a conversa inteira.
export async function listarMensagens(tenantId, conversaId, { limite = 100 } = {}) {
const { rows } = await pool.query(
`SELECT m.id, m.autor, m.texto, m.enviada_em
FROM mensagens m
JOIN conversas c ON c.id = m.conversa_id
WHERE c.tenant_id = $1
AND m.conversa_id = $2
ORDER BY m.enviada_em DESC, m.id DESC
LIMIT $3`,
[tenantId, conversaId, limite],
);
return rows.reverse();
}
// Escrita: uma linha nova por mensagem e colunas derivadas atualizadas na mesma transação.
export async function registrarMensagem(conversaId, { autor, texto, enviadaEm, metadados = {} }) {
const client = await pool.connect();
try {
await client.query('BEGIN');
// Trava a linha da conversa: duas mensagens simultâneas não perdem incremento.
const atualizada = await client.query(
`UPDATE conversas
SET total_mensagens = total_mensagens + 1,
ultima_mensagem = left($2, 280),
atualizado_em = greatest(atualizado_em, $3::timestamptz)
WHERE id = $1`,
[conversaId, texto, enviadaEm],
);
if (atualizada.rowCount === 0) {
throw new Error('conversa inexistente: ' + conversaId);
}
const { rows } = await client.query(
`INSERT INTO mensagens (conversa_id, autor, texto, enviada_em, metadados)
VALUES ($1, $2, $3, $4, $5)
RETURNING id`,
[conversaId, autor, texto, enviadaEm, metadados],
);
await client.query('COMMIT');
return rows[0].id;
} catch (err) {
await client.query('ROLLBACK');
throw err;
} finally {
client.release();
}
}
A migração não precisa de janela. A tabela nova é criada vazia, a aplicação passa a gravar mensagens novas só nela e a tela de detalhe lê das duas fontes enquanto o backfill não termina. O backfill anda por faixas de id, e cada lote copia, soma ao contador e anula o historico no mesmo comando, o que o torna seguro para rodar de novo depois de uma falha.
-- Mensagens viram linhas: cada escrita grava só a mensagem nova.
CREATE TABLE mensagens (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
conversa_id bigint NOT NULL REFERENCES conversas (id) ON DELETE CASCADE,
autor text NOT NULL,
texto text NOT NULL,
enviada_em timestamptz NOT NULL,
metadados jsonb NOT NULL DEFAULT '{}'
);
CREATE INDEX mensagens_conversa_enviada_idx ON mensagens (conversa_id, enviada_em, id);
-- Instantâneo desde o PostgreSQL 11: não reescreve a tabela.
ALTER TABLE conversas ADD COLUMN total_mensagens integer NOT NULL DEFAULT 0;
-- Backfill por faixa de id, uma transação por lote. Repita avançando 20 mil ids por vez.
-- Copia, soma ao contador e anula o historico no mesmo comando: rodar de novo não duplica.
WITH lote AS (
SELECT id, historico
FROM conversas
WHERE id > 0 AND id <= 20000
AND historico IS NOT NULL
FOR UPDATE
), copiadas AS (
INSERT INTO mensagens (conversa_id, autor, texto, enviada_em, metadados)
SELECT l.id,
coalesce(m->>'autor', 'desconhecido'),
coalesce(m->>'texto', ''),
(m->>'enviada_em')::timestamptz,
m - 'autor' - 'texto' - 'enviada_em'
FROM lote l
CROSS JOIN LATERAL jsonb_array_elements(l.historico->'mensagens') AS m
)
UPDATE conversas c
SET total_mensagens = c.total_mensagens + jsonb_array_length(l.historico->'mensagens'),
historico = NULL
FROM lote l
WHERE c.id = l.id;
-- Depois de todos os lotes: o vacuum torna o espaço do TOAST reutilizável.
VACUUM (VERBOSE) conversas;
-- DROP COLUMN é só metadado e não devolve espaço ao sistema operacional;
-- para encolher os arquivos, pg_repack ou VACUUM FULL numa janela de manutenção.
ALTER TABLE conversas DROP COLUMN historico;
| Opção | Ganho na leitura | Custo | Quando usar |
|---|
| Lista explícita de colunas | Imediato nas consultas corrigidas | Disciplina em todo código novo; o ORM precisa de select ou omit | Sempre, como primeiro passo |
| Tabela 1:1 para a coluna grande | SELECT * volta a ser barato | Join quando o conteúdo é necessário | Documento grande lido raramente e escrito inteiro |
| Tabela 1:N no lugar de array jsonb | Leitura paginada do detalhe | Migração de dados e mais linhas | Lista que cresce com o tempo: mensagens, eventos, anexos |
| Coluna derivada mantida na escrita | Listagem sem tocar no documento | Código de escrita precisa manter a coluna | Campos que a listagem mostra ou filtra |
| Coluna gerada STORED a partir do jsonb | Igual à derivada, sem código na aplicação | ADD COLUMN reescreve a tabela com lock exclusivo | Tabelas pequenas ou criadas já com a coluna |