O monitoramento que faltou não é complicado. pg_sequences mostra o último valor e o máximo de cada sequência, mas o percentual sozinho não basta: 40% pode significar dez anos ou dez dias. O script abaixo guarda uma foto diária de todas as sequências, calcula o consumo por dia e os dias restantes e, na mesma execução, lista sequências com tipo diferente da coluna que alimentam e chaves estrangeiras com tipo diferente da chave referenciada.
// monitorar-sequencias.js
// node monitorar-sequencias.js (rodar 1x por dia; sai com código 1 se houver risco)
import pg from 'pg';
const LIMITE_PCT = 75;
const LIMITE_DIAS = 90;
const client = new pg.Client({ connectionString: process.env.DATABASE_URL });
// Cada execução guarda uma foto de todas as sequências para calcular o consumo diário.
const SQL_FOTO = `
CREATE TABLE IF NOT EXISTS monitor_sequencias (
capturado_em timestamptz NOT NULL DEFAULT now(),
sequencia text NOT NULL,
ultimo_valor bigint NOT NULL
);
INSERT INTO monitor_sequencias (sequencia, ultimo_valor)
SELECT format('%I.%I', schemaname, sequencename), last_value
FROM pg_sequences
WHERE last_value IS NOT NULL`;
// Percentual usado e consumo por dia, comparando com a foto de ~1 dia atrás.
const SQL_CONSUMO = `
WITH atual AS (
SELECT format('%I.%I', schemaname, sequencename) AS sequencia,
data_type::text AS tipo, last_value, max_value
FROM pg_sequences
WHERE last_value IS NOT NULL AND increment_by > 0
),
anterior AS (
SELECT DISTINCT ON (sequencia) sequencia, capturado_em, ultimo_valor
FROM monitor_sequencias
WHERE capturado_em BETWEEN now() - interval '8 days' AND now() - interval '20 hours'
ORDER BY sequencia, capturado_em DESC
)
SELECT a.sequencia, a.tipo,
a.last_value::text AS ultimo, a.max_value::text AS maximo,
round(100.0 * a.last_value / a.max_value, 2)::float8 AS pct,
round((a.last_value - p.ultimo_valor)
/ (extract(epoch FROM now() - p.capturado_em) / 86400))::float8 AS por_dia
FROM atual a
LEFT JOIN anterior p USING (sequencia)
ORDER BY pct DESC`;
// Sequência de tipo diferente da coluna que ela alimenta (serial migrado pela metade).
const SQL_SEQUENCIA_X_COLUNA = `
SELECT d.refobjid::regclass::text AS tabela, a.attname AS coluna,
format_type(a.atttypid, a.atttypmod) AS tipo_coluna,
s.seqrelid::regclass::text AS sequencia,
s.seqtypid::regtype::text AS tipo_sequencia
FROM pg_sequence s
JOIN pg_depend d ON d.objid = s.seqrelid
AND d.classid = 'pg_class'::regclass
AND d.refclassid = 'pg_class'::regclass
AND d.deptype IN ('a', 'i')
JOIN pg_attribute a ON a.attrelid = d.refobjid AND a.attnum = d.refobjsubid
WHERE s.seqtypid <> a.atttypid`;
// Chave estrangeira com tipo diferente da chave que ela referencia.
const SQL_FK_DESALINHADA = `
SELECT con.conname AS fk,
con.conrelid::regclass::text || '.' || af.attname AS coluna_filha,
format_type(af.atttypid, af.atttypmod) AS tipo_filha,
con.confrelid::regclass::text || '.' || ap.attname AS coluna_pai,
format_type(ap.atttypid, ap.atttypmod) AS tipo_pai
FROM pg_constraint con
CROSS JOIN LATERAL unnest(con.conkey, con.confkey) AS k(filha, pai)
JOIN pg_attribute af ON af.attrelid = con.conrelid AND af.attnum = k.filha
JOIN pg_attribute ap ON ap.attrelid = con.confrelid AND ap.attnum = k.pai
WHERE con.contype = 'f' AND af.atttypid <> ap.atttypid`;
async function main() {
await client.connect();
try {
await client.query(SQL_FOTO);
const { rows: sequencias } = await client.query(SQL_CONSUMO);
const relatorio = sequencias.map((s) => {
const restante = Number(s.maximo) - Number(s.ultimo);
// Sem foto anterior ainda: só o percentual vale nesta execução.
const dias = s.por_dia > 0 ? Math.floor(restante / s.por_dia) : null;
const risco = s.pct >= LIMITE_PCT || (dias !== null && dias <= LIMITE_DIAS);
return { ...s, dias_restantes: dias, risco };
});
console.table(relatorio.filter((s) => s.risco || s.pct >= 10));
const { rows: desalinhadas } = await client.query(SQL_SEQUENCIA_X_COLUNA);
const { rows: fks } = await client.query(SQL_FK_DESALINHADA);
if (desalinhadas.length) console.table(desalinhadas);
if (fks.length) console.table(fks);
if (relatorio.some((s) => s.risco) || desalinhadas.length || fks.length) {
process.exitCode = 1;
}
} finally {
await client.end();
}
}
main().catch((erro) => {
console.error(erro);
process.exit(1);
});
- Rode uma vez por dia, no agendador que já existir, e trate o código de saída 1 como alerta. Um limite de 90 dias dá tempo de planejar a migração sem pressa.
- pg_sequences só mostra last_value para sequências em que o usuário tem permissão de leitura. Rode com um papel que tenha USAGE ou SELECT em todas, ou o relatório fica incompleto sem avisar.
- Mudança brusca de consumo é sinal tão importante quanto o percentual. Comparar o por_dia com a média da semana anterior teria apontado o deploy de setembro no dia seguinte.
- As duas checagens de tipo valem como teste de migração: rodar o script no CI contra um banco migrado impede que um serial ou uma FK em integer passem despercebidos.