Habilidades database-migration
🗄️

database-migration

Seguro 🌐 Acesso à rede⚙️ Comandos externos

Planejar migrações de banco de dados com segurança de rollback

Também disponível em: Doyajin174,CleanExpo

Migrações de banco de dados podem quebrar produção se apressadas. Esta habilidade fornece padrões comprovados para alterações seguras de esquema, transformações de dados e rollbacks no Sequelize, TypeORM e Prisma.

Suporta: Claude Codex Code(CC)
📊 70 Adequado
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "database-migration". Provide a zero downtime plan to rename users.name to users.full_name

Resultado esperado:

  • Fase 1: Adicionar nova coluna full_name ao lado da coluna name existente
  • Fase 2: Implantar código que grava em ambas as colunas simultaneamente
  • Fase 3: Executar backfill para copiar valores de name para full_name em lotes
  • Fase 4: Alternar leituras da aplicação para usar a coluna full_name
  • Fase 5: Após verificação, remover a coluna name antiga em implantação separada

A utilizar "database-migration". Create a checkpoint-based rollback strategy for migrating a full_address field

Resultado esperado:

  • Criar tabela de backup com CREATE TABLE AS SELECT antes da migração
  • Executar migração em pequenos lotes com verificação após cada lote
  • Em caso de falha, restaurar usando DROP TABLE e CREATE TABLE AS SELECT do backup
  • Remover tabela de backup após verificação bem-sucedida

Auditoria de Segurança

Seguro
v4 • 1/17/2026

The static analyzer flagged 42 potential issues, but all are false positives. SKILL.md contains only documentation and code examples for database migration patterns. The 'weak cryptographic algorithm' findings were triggered by text patterns in documentation describing migration operations. The 'Ruby/shell backtick execution' findings misidentified command-line comments as shell execution. No actual executable code, credential access, or network exfiltration patterns exist. This is static instructional content only.

2
Arquivos analisados
603
Linhas analisadas
2
achados
4
Total de auditorias
Auditado por: claude Ver Histórico de Auditoria →

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
87
Conteúdo
22
Comunidade
100
Segurança
91
Conformidade com especificações

O Que Você Pode Construir

Implantação com zero tempo de inatividade

Planejar migrações graduais que mantêm a aplicação disponível durante alterações de schema com estratégias de implantação blue-green.

Transformação de dados

Projetar backfills seguros e refatorações de colunas com opções de rollback baseadas em pontos de verificação para grandes conjuntos de dados.

Estratégia de migração ORM

Comparar abordagens de migração ao alternar entre Sequelize, TypeORM e Prisma com considerações de compatibilidade.

Tente Estes Prompts

Plano de migração básico
Criar um plano de migração seguro para adicionar uma coluna status não nula com valor padrão no Sequelize, incluindo etapas de rollback e considerações de backfill de dados.
Renomeação com zero tempo de inatividade
Delimitar um processo com zero tempo de inatividade para renomear users.name para users.full_name com implantação gradual, estratégia de backfill e etapas de limpeza.
Alteração entre bancos de dados
Mostrar uma abordagem de migração que lida com diferenças de tipo JSON entre MySQL e PostgreSQL no TypeORM com lógica condicional.
Estratégia de rollback avançada
Projetar uma estratégia de rollback baseada em pontos de verificação para uma migração de dados que divide o campo full_address em componentes de rua, cidade, estado e CEP.

Melhores Práticas

  • Sempre fornecer uma etapa de rollback para cada migração com métodos down() adequados
  • Testar migrações em dados de staging que espelham produção antes da implantação
  • Usar alterações de schema pequenas e incrementais em vez de migrações monolíticas grandes

Evitar

  • Removendo colunas antes de verificar backfill de dados e compatibilidade da aplicação
  • Executando grandes migrações sem limites de transação ou planos de rollback
  • Ignorando tratamento de valores NULL e impactos de restrições de chave estrangeira durante transformações

Perguntas Frequentes

Quais ORMs são suportados?
A habilidade inclui exemplos abrangentes para Sequelize, TypeORM e Prisma com padrões de migração para cada um.
Há limites de tamanho para migrações?
Sem limites de tamanho, mas a habilidade recomenda fazer batching de migrações de dados grandes e usar abordagens baseadas em pontos de verificação para milhões de linhas.
Posso integrar isso com pipelines CI?
Sim, os padrões de migração podem ser incorporados em workflows CI/CD com testes adequados e procedimentos de rollback.
Ele acessa meu banco de dados ou segredos?
Não, isso é conteúdo de orientação estática sem acesso a dados, chamadas de rede ou capacidades de manipulação de credenciais.
E se uma migração falhar no meio da execução?
Use os padrões baseados em transações para rollback automático, ou estratégias baseadas em pontos de verificação para recuperação manual de backups.
Como se compara a ferramentas de migração?
Ele fornece padrões arquiteturais e melhores práticas em vez de execução automatizada, complementando ferramentas como Flyway ou Liquibase.

Detalhes do Desenvolvedor

Estrutura de arquivos

📄 SKILL.md