Regras de Migração¶

Regras de migração são um tipo de regra executada quando uma versão do Vinyl é instalada em um servidor. As regras de migração são configuradas na área Business SQL da camada Business Logic.

Regras de migração são usadas para manipular ou limpar dados em um aplicativo existente e também para migrar dados após realizar uma alteração de esquema. As regras de migração permitem que um usuário modifique um banco de dados usando as ações Cram, Delete, Insert ou Update. As regras de migração são definidas de forma semelhante a uma regra CRUD e executadas no ambiente de desenvolvimento. As regras de migração (ao contrário das regras CRUD) são adicionadas às etapas de gerenciamento de alterações que são executadas em ordem ao enviar um LP para um novo ambiente. O Vinyl registra a regra e a executa durante uma atualização.

As regras de migração devem ser específicas para uma Execução. Se você precisar executar regras de migração semelhantes duas vezes, a prática recomendada é criar uma nova regra para a segunda execução. Quando você Executa uma Regra de Migração (ou seja, clica no botão Executar para uma Regra de Migração), o Vinyl tira um instantâneo da Regra e a incorpora no conjunto de alterações. Nada será adicionado ao conjunto de alterações até que a regra de migração seja executada. Após a execução da regra, a regra de migração pode ser excluída.

Tutorial de Regras de Migração¶

Notas Importantes Sobre Regras de Migração¶

As regras de migração não suportam Enum
XP CRUD não é compatível com regras de migração
Os dados não podem ser migrados de/para colunas criptografadas usando uma regra de migração. Os desenvolvedores devem usar regras de negócios CRUD para mover dados de/para colunas criptografadas.
Atualmente não é possível modificar uma regra CRUD para torná-la uma regra de migração. Se você fizer isso, não disparará.

Ações de Regras de Migração¶

A Ação selecionada para uma Regra de Migração é baseada no que a Regra pretende fazer. As opções de ação são:

Cram – insere registros distintos/únicos com base nos campos marcados como Chaves Primárias
Excluir – exclui colunas de uma tabela
Inserir – cria colunas dentro de uma tabela
Atualizar – atualiza colunas dentro de uma tabela

Crie uma Regra de Migração para Cram Data¶

Navegue até App Workbench > Regras
Confirme se a fonte de dados do aplicativo selecionada é onde você deseja adicionar a regra
Clique em + Regra
Atribua um Nome para a regra de migração. Por exemplo: EventDate (Migração EventDate)
Selecione Migração como objetivo
Defina a ação como Cram
Defina Target para a tabela a ser atualizada. Por exemplo: EventDate
Clique em Salvar
Clique em + Tabelas e traga a tabela Target. Por exemplo: EventDate
No painel Colunas adicione na Chave Primária, a Expressão para descrever o que está sendo atualizado, junto com o Destino que é a Coluna de destino para a Expressão
Dependendo da sua regra, você pode precisar de lógica adicional definida
Clique em Validar e verifique se as informações estão conforme o esperado (sem erros)

Crie uma Regra de Migração para Excluir Dados¶

Navegue até App Workbench > Regras
Confirme se a fonte de dados do aplicativo selecionada é onde você deseja adicionar a regra
Clique em + Regra
Atribua um Nome para a regra de migração. Por exemplo: Contato (Excluir contatos órfãos)
Selecione Migração como objetivo
Defina a ação para Excluir
Defina Target para a tabela a ser atualizada. Por exemplo: Contato
Clique em Salvar
Clique em + Tabela e traga a tabela Target
No painel Colunas adicione na Chave Primária, a Expressão para descrever o que está sendo atualizado, junto com o Destino que é a Coluna de destino da Expressão.

Importante

A Chave Primária deve ser mapeada com um Destino para que as Regras de Exclusão funcionem, ou então a Regra excluirá tudo na Tabela.
Clique em Validar e verifique se as informações estão conforme o esperado (sem erros)

Crie uma Regra de Migração para Inserir Dados¶

Regras de migração com o tipo de ação Inserir podem criar novas colunas em uma tabela. Todos os campos obrigatórios da Tabela onde uma nova Coluna está sendo criada devem ser mapeados a partir da Tabela de origem.

Navegue até App Workbench > Regras
Confirme se a fonte de dados do aplicativo selecionada é onde você deseja adicionar a regra
Clique em + Regra
Atribua um Nome para a regra de migração. Por exemplo: Sessão (Inserir Sessão)
Selecione Migração como objetivo
Defina a ação para Inserir
Defina Target para a tabela a ser atualizada. Por exemplo: Sessão
Clique em Salvar
Clique em + Tabela e traga a tabela Target
No painel Colunas insira a Expressão para descrever o que está sendo inserido, junto com o Destino que é a Coluna de destino da Expressão
Clique em Validar e verifique se as informações estão conforme o esperado (sem erros)

Crie uma Regra de Migração para Atualizar Dados¶

Navegue até App Workbench > Regras
Confirme se a fonte de dados do aplicativo selecionada é onde você deseja adicionar a regra
Clique em + Regra
Atribua um Nome para a regra de migração. Por exemplo: Alcance (Migração AuditID)
Selecione Migração como objetivo
Defina a ação para Atualizar
Defina Target para a tabela a ser atualizada. Por exemplo: Alcance
Clique em Salvar
Clique em + Tabela e traga a tabela Target
No painel Colunas adicione na Chave Primária, a Expressão para descrever o que está sendo atualizado, junto com o Destino que é a Coluna de destino para a Expressão
Clique em Validar e verifique se as informações estão conforme o esperado (sem erros)