Criar regras de transformação Recuperando regras de transformação Editar regras de transformação Formato da regra de transformação Exemplos de regras de transformação

Regras de transformação na conversão do esquema DMS

As regras de transformação permitem que você personalize como a Conversão de Esquema do DMS converte seus objetos de banco de dados, substituindo a nomenclatura padrão e os mapeamentos de tipo de dados. Você pode aplicar essas regras a bancos de dados, esquemas, tabelas, visualizações, colunas, valores de retorno de funções, parâmetros de rotina e variáveis locais.

Por exemplo, suponha que você tenha um conjunto de tabelas no esquema de origem chamado test_TABLE_NAME. É possível configurar uma regra que altera o prefixo test_ para o prefixo demo_ no esquema de destino.

É possível criar regras de transformação que executam as seguintes tarefas:

Adicionar, remover ou substituir um prefixo
Adicionar, remover ou substituir um sufixo
Alterar o tipo de dados de uma coluna, valor de retorno da função, parâmetro de rotina ou variável local
Converter o nome do objeto em minúsculas ou maiúsculas
Renomear um objeto

Criar regras de transformação

A DMS Schema Conversion armazena regras de transformação como parte do projeto de migração. Para definir regras de transformação, passe-as como uma string JSON que contém um objeto com uma rules matriz ao criar ou modificar um projeto de migração. Cada elemento na matriz representa um objeto de regra separado. Um projeto de migração oferece suporte a até 512 regras de transformação (máximo de 128 KB).

A estrutura da matriz com regras de transformação é a seguinte:


{
  "rules": [
    {
      Rule object 1
    },
    {
      Rule object 2
    },
    ...
    {
      Rule object N
    }
  ]
}

É possível adicionar várias regras de transformação no projeto. A DMS Schema Conversion aplica as regras de transformação durante a conversão na mesma ordem em que são adicionadas.

Se várias regras tiverem como alvo o mesmo objeto, o comportamento dependerá do tipo de ação. Todas as regras com diferentes tipos de ação entram em vigor. Por exemplo, uma add-prefix regra e uma add-suffix regra se aplicam. Regras com o mesmo tipo de ação se substituem e somente a última entra em vigor.

Para criar regras de transformação, use um dos métodos a seguir.

AWS Management Console

Para criar regras de transformação usando o console

Na página Criar projeto de migração, escolha Adicionar regra de transformação. Para obter mais informações, consulte Criar projetos de migração.
Em Destino da regra, escolha o tipo de objetos de banco de dados aos quais essa regra se aplica. O assistente do console oferece suporte schema table e column alvos. Para usar outros destinos, como database ouview, use o editor JSON no console ou na AWS CLI.
Em Esquema de origem, escolha Inserir um esquema. Em seguida, especifique os esquemas, tabelas e colunas de origem aos quais essa regra se aplica. Você pode usar um nome exato para selecionar um objeto ou usar um padrão com o sinal de porcentagem (%) como curinga para corresponder a qualquer número de caracteres.
Em Ação, escolha a tarefa a ser executada.
Dependendo da ação da regra, insira valores adicionais:
- add-prefixou add-suffix — Insira o texto a ser adicionado.
- remove-prefixou remove-suffix — Insira o texto a ser removido.
- replace-prefixou replace-suffix — Insira o texto existente e o texto substituto.
- rename— Insira o novo nome para o objeto.
- convert-uppercaseou convert-lowercase — Não são necessários valores adicionais.
- change-data-type— Insira o nome do tipo de dados de destino e, opcionalmente, a precisão, a escala ou o comprimento.
Escolha Adicionar regra de transformação para adicionar outra regra de transformação.

Ao concluir a adição de regras, escolha Criar projeto de migração.

AWS CLI

Para adicionar regras de transformação usando a AWS CLI, use o --transformation-rules parâmetro com um dos seguintes comandos:

create-migration-project — Ao criar um novo projeto de migração.
modify-migration-project — Para um projeto de migração existente.

O exemplo a seguir adiciona regras de transformação a um projeto de migração existente:


aws dms modify-migration-project \
  --migration-project-identifier migration_project_arn \
  --transformation-rules 'json_rules'

Para executar esse comando em uma região específica da AWS, adicione o --region parâmetro, por exemplo--region us-west-2.

Para editar, duplicar ou remover as regras de transformação existentes, consulteEditar regras de transformação.

Recuperando regras de transformação

Você pode recuperar as regras de transformação de um projeto existente de migração do DMS Schema Conversion usando o AWS Management Console ou a CLI. AWS

Editar regras de transformação

Para editar, adicionar ou remover regras de transformação em seu projeto de migração, use um dos métodos a seguir.

Formato da regra de transformação

Uma regra de transformação usa campos de objeto JSON para definir como converter um objeto de origem em seu equivalente de destino. Cada tipo de regra usa um conjunto específico de campos. Inclua somente os campos que se aplicam à sua tarefa.

O objeto JSON a seguir descreve uma regra de transformação de conversão de esquema do DMS:


{
  "rule-type": "transformation",
  "rule-id": rule_id,
  "rule-name": "rule_name",
  "rule-action": "rule_action",
  "rule-target": "rule_target",
  "object-locator": {
    [ "database-name": "database_name", ]
    [ "schema-name": "schema_name", ]
    [ "table-name": "table_name", ]
    [ "column-name": "column_name", ]
    [ "parent": "parent_name", ]
    [ "function-name": "function_name", ]
    [ "procedure-name": "procedure_name", ]
    [ "parameter-name": "parameter_name", ]
    [ "local-variable-name": "local_variable_name", ]
    [ "type": "source_data_type", ]
    [ "precision": source_precision, ]
    [ "scale": source_scale, ]
    [ "length": source_length ]
  },
  [ "value": "rule_value", ]
  [ "old-value": "rule_old_value", ]
  [ "data-type": {
    "type": "data_type_name",
    [ "precision": data_type_precision, ]
    [ "scale": data_type_scale, ]
    [ "length": data_type_length ]
  } ]
}

A tabela a seguir descreve cada parâmetro.

Parâmetro	Possíveis valores	Description
`rule-type`	`transformation`	Um valor que aplica a regra a cada objeto especificado pelo localizador de objetos. Para todas as regras de transformação, defina isso como`transformation`. Parâmetro necessário.
`rule-id`	Um valor numérico (inteiro).	Um valor numérico exclusivo para identificar a regra. Parâmetro necessário.
`rule-name`	Um valor alfanumérico.	Um nome exclusivo para identificar a regra. Parâmetro necessário.
`rule-action`	`add-prefix`, `remove-prefix`, `replace-prefix`, `add-suffix`, `remove-suffix`, `replace-suffix`, `convert-uppercase`, `convert-lowercase`, `rename`, `change-data-type`	A transformação que você quer aplicar ao objeto. Todas as ações de regra de transformação diferenciam maiúsculas e minúsculas. Operações de prefixo: `add-prefix`— Adicione um texto específico ao início de um nome. `remove-prefix`— Remover um texto especificado do início de um nome. `replace-prefix`— Substitua um prefixo existente por um novo. Operações de sufixo: `add-suffix`— Adicione um texto específico ao final de um nome. `remove-suffix`— Remover um texto especificado do final de um nome. `replace-suffix`— Substitua um sufixo existente por um novo. Conversão de casos: `convert-uppercase`— Converta todos os caracteres de um nome em maiúsculas. `convert-lowercase`— Converta todos os caracteres de um nome em minúsculas. Modificação direta: `rename`— Altere o nome para um valor especificado completamente novo. `change-data-type`— Modifique o tipo de dados de uma coluna ou variável local para um tipo de dados diferente. Escopo: operações de prefixo, sufixo, renomeação e conversão de maiúsculas e minúsculas podem ser aplicadas a esquemas, tabelas e colunas. A `change-data-type` operação se aplica somente a colunas, valores de retorno de funções, parâmetros de rotina e variáveis locais. Parâmetro necessário.
`rule-target`	`database`, `schema`, `table`, `view`, `column`, `function result`, `routine parameter`, `local variable`	O tipo de objeto ao qual a regra será aplicada. `database`— Banco de dados. `schema`— Esquema do banco de dados. `table`— Tabela do banco de dados. `view`— Visualização do banco de dados. `column`— Tabela do banco de dados ou coluna de visualização. `function result`— Valor de retorno da função. `routine parameter`— Procedimento armazenado ou parâmetro de função. `local variable`— Variável local dentro do procedimento ou função armazenada. Parâmetro necessário.
`object-locator`	Um objeto JSON.	Um objeto que identifica a quais objetos do banco de dados de origem a regra se aplica. Você pode usar o sinal de porcentagem (`%`) como um curinga para todo ou parte do valor em cada campo do `object-locator` objeto. O objeto contém os seguintes campos de string: `database-name` `schema-name` `table-name` `column-name` `parent` `function-name` `procedure-name` `parameter-name` `local-variable-name` `type` `precision` `scale` `length` Todos os nomes de objetos, como nomes de tabelas ou colunas, nas regras de transformação diferenciam maiúsculas de minúsculas. As seções a seguir descrevem cada campo do objeto. Parâmetro necessário.
`object-locator \| database-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome do banco de dados de origem. Aplicável para fornecedores de banco de dados em que a arquitetura do banco de dados se origina do banco de dados como o contêiner de objetos de nível superior. Por exemplo: Microsoft SQL Server, SAP ASE. Campo de objeto JSON opcional.
`object-locator \| schema-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome do esquema do banco de dados de origem. Campo de objeto JSON opcional.
`object-locator \| table-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome da tabela do banco de dados de origem. Campo de objeto JSON opcional.
`object-locator \| column-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome da coluna da tabela do banco de dados de origem. Campo de objeto JSON opcional.
`object-locator \| parent`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome do objeto do banco de dados de origem que é o pai do objeto especificado, por exemplo, para o `function-name` ou`procedure-name`. Em bancos de dados de alguns fornecedores, o objeto ao qual a regra é aplicada pode estar subordinado e exigir a especificação de seu pai. Por exemplo, funções empacotadas no Oracle, em que o pai é o nome do pacote. Campo de objeto JSON opcional.
`object-locator \| function-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome da função do banco de dados de origem. Campo de objeto JSON opcional.
`object-locator \| procedure-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome do procedimento do banco de dados de origem. Campo de objeto JSON opcional.
`object-locator \| parameter-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome da função do banco de dados de origem ou do parâmetro do procedimento. Campo de objeto JSON opcional.
`object-locator \| local-variable-name`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O nome de uma variável local na função ou procedimento do banco de dados de origem. Campo de objeto JSON opcional.
`object-locator \| type`	Um valor alfanumérico.	O nome do tipo de dados de origem a ser correspondente. Use esse campo para aplicar a regra somente a objetos com um tipo de dados específico. Campo de objeto JSON opcional.
`object-locator \| precision`	Um valor numérico (inteiro).	A precisão do tipo de dados de origem a ser correspondente. Campo de objeto JSON opcional.
`object-locator \| scale`	Um valor numérico (inteiro).	A escala do tipo de dados de origem a ser correspondente. Campo de objeto JSON opcional.
`object-locator \| length`	Um valor numérico (inteiro).	O comprimento do tipo de dados de origem a ser correspondente. Campo de objeto JSON opcional.
`value`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de destino.	O valor do texto usado pela ação de transformação. Para `add-prefix` e`add-suffix`, especifica o texto a ser adicionado. Para `remove-prefix` e`remove-suffix`, especifica o texto a ser removido. Para `replace-prefix` e`replace-suffix`, especifica o texto de substituição. Para`rename`, especifica o novo nome. Obrigatório para todas as ações `convert-uppercaseconvert-lowercase`, exceto, `change-data-type` e.
`old-value`	Um valor alfanumérico que segue as regras de nomenclatura do banco de dados de origem.	O valor existente a ser encontrado e substituído no nome do objeto. Necessário para ações como `replace-prefix` `replace-suffix` e. Parâmetro opcional.
`data-type`	Um objeto JSON.	Um objeto que descreve as propriedades do tipo de dados de substituição quando `rule-action` é`change-data-type`. O objeto contém os campos a seguir. `type`: seqüência `precision`: número `scale`: número `length`: número As seções a seguir descrevem cada campo do objeto. Parâmetro opcional.
`data-type \| type`	Um valor alfanumérico.	O nome do tipo de dados de substituição para a coluna do banco de dados de destino, se `rule-action` for`change-data-type`. Deve ser um tipo de dados de banco de dados de destino válido. Campo de objeto JSON obrigatório.
`data-type \| precision`	Um valor numérico (inteiro).	A precisão do tipo de dados de substituição para o banco de dados de destino, se `rule-action` for`change-data-type`. Campo de objeto JSON opcional.
`data-type \| scale`	Um valor numérico (inteiro).	A escala do tipo de dados de substituição para o banco de dados de destino, se `rule-action` for`change-data-type`. Campo de objeto JSON opcional.
`data-type \| length`	Um valor numérico (inteiro).	O tamanho do tipo de dados de substituição para o banco de dados de destino, se `rule-action` for`change-data-type`. Campo de objeto JSON opcional.

Exemplos de regras de transformação

Os exemplos a seguir mostram o valor JSON do --transformation-rules parâmetro para diferentes tipos de regras: