13. Projetos de banco de dados SQL

Alterar tabelas diretamente pode deixar um banco funcionando sem que a equipe consiga reconstruir sua estrutura em outro ambiente. Projetos SQL representam o esquema como código e permitem comparar o estado desejado com o destino, apoiando revisão e implantação controlada.

Modelo declarativo e artefato

Um projeto SQL descreve objetos do banco por definições. A compilação valida o modelo dentro das capacidades da ferramenta e pode produzir um artefato DACPAC usado pelo DacFx. Essa representação permite versionar tabelas, views e outros objetos suportados, mantendo sua evolução no histórico.

O modelo declarativo descreve o estado desejado. A publicação calcula mudanças em relação ao banco existente. Por isso, o mesmo artefato pode gerar scripts diferentes em destinos com estados diferentes. A revisão deve considerar o destino real, especialmente operações que removem colunas ou alteram estruturas com dados.

Compare duas bases: uma já possui uma coluna e a outra ainda não. O mesmo modelo desejado exige operações diferentes para levá-las ao estado final. É por isso que publicação diferencial não deve ser confundida com executar sempre um script fixo de criação. O artefato descreve o alvo; o plano depende do estado encontrado. Antes de produção, revise o diferencial contra um ambiente representativo e identifique alterações destrutivas, dependências e permissões necessárias.

Esquema não é conteúdo das tabelas

Versionar definições não exporta automaticamente todas as linhas. Dados estáticos necessários à aplicação podem exigir scripts de pós-implantação ou outro processo controlado. O script deve ser idempotente quando puder executar novamente: inserir o mesmo catálogo sem verificar chaves pode produzir duplicidade.

Configurações de banco e propriedades excluídas do mecanismo de integração também precisam de gestão separada. O fato de uma opção existir no banco não garante que será representada e transportada pelo projeto. Documente o que é aplicado pelo modelo e o que exige configuração posterior suportada.