Skill de Segurança de Migração

-- Monitoramento de bloqueio (executar durante a migração de staging)
SELECT pid, wait_event_type, wait_event, state, left(query, 80)
FROM pg_stat_activity
WHERE datname = current_database() AND pid <> pg_backend_pid();
 
SELECT l.mode, c.relname, a.query
FROM pg_locks l
JOIN pg_class c ON c.oid = l.relation
JOIN pg_stat_activity a ON a.pid = l.pid
WHERE NOT l.granted;

## Pontuação de risco (resumo)
| DDL | Risco padrão | Padrão mais seguro |
|-----|--------------|---------------|
| CREATE INDEX | ALTO em >1M linhas | CREATE INDEX CONCURRENTLY |
| ADD COLUMN NOT NULL sem default | ALTO | adicionar nullable → preencher → SET NOT NULL |
| ALTER TYPE | ALTO | expandir-contrair + nova coluna |
| DROP COLUMN | MÉDIO | expandir-contrair, depreciar primeiro |
| ADD FK inline | ALTO | ADD NOT VALID → VALIDATE CONSTRAINT |

ALTER TABLE orders ADD COLUMN priority text NOT NULL DEFAULT 'normal';
CREATE INDEX idx_orders_priority ON orders (priority);

## Risco de bloqueio: ALTO
 
### Constatações
1. `CREATE INDEX` sem CONCURRENTLY obtém ShareLock, bloqueia escritas na tabela grande de orders
2. `ADD COLUMN ... DEFAULT` é apenas metadados no PG 11+ para default estático - OK
3. A construção do índice é o principal bloqueador (~45M linhas)
 
### Migração mais segura (arquivos separados)
-- V20260709_1__orders_priority_column.sql
ALTER TABLE orders ADD COLUMN IF NOT EXISTS priority text NOT NULL DEFAULT 'normal';
 
-- V20260709_2__orders_priority_index.sql (executar na janela de alteração)
CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_orders_priority ON orders (priority);

-- Rollback
DROP INDEX CONCURRENTLY IF EXISTS idx_orders_priority;
ALTER TABLE orders DROP COLUMN IF EXISTS priority;

SELECT c.relname, c.reltuples::bigint AS est_rows
FROM pg_class c
JOIN pg_namespace n ON n.oid = c.relnamespace
WHERE n.nspname = 'public' AND c.relname = 'orders';

-- CONCURRENTLY não pode ser executado dentro do bloco de transação do flyway
-- Use o padrão flyway outOfOrder + executeInTransaction=false conforme a documentação do runner
CREATE INDEX CONCURRENTLY idx_orders_priority ON orders (priority);