Creación de reglas de transformación Recuperación de reglas de transformación Edición de reglas de transformación Formato de regla de transformación Ejemplos de reglas de transformación

Reglas de transformación en la conversión de esquemas de DMS

Las reglas de transformación le permiten personalizar la forma en que DMS Schema Conversion convierte los objetos de su base de datos, anulando las asignaciones de nombres y tipos de datos predeterminadas. Puede aplicar estas reglas a bases de datos, esquemas, tablas, vistas, columnas, valores devueltos por funciones, parámetros de rutina y variables locales.

Por ejemplo, suponga que tiene un conjunto de tablas en el esquema de origen denominado test_TABLE_NAME. Puede configurar una regla que cambie el prefijo test_ por el prefijo demo_ del esquema de destino.

Puede crear reglas de transformación que realicen las siguientes tareas:

Agregar, eliminar o reemplazar un prefijo
Agregar, eliminar o reemplazar un sufijo
Cambie el tipo de datos de una columna, el valor devuelto por la función, el parámetro de rutina o la variable local
Convierte el nombre del objeto a minúsculas o mayúsculas
Cambie el nombre de un objeto

Creación de reglas de transformación

La conversión de esquemas del DMS almacena las reglas de transformación como parte del proyecto de migración. Para definir las reglas de transformación, páselas como una cadena JSON que contenga un objeto con una rules matriz cuando cree o modifique un proyecto de migración. Cada elemento de la matriz representa un objeto de regla independiente. Un proyecto de migración admite hasta 512 reglas de transformación (128 KB como máximo).

La estructura de la matriz con las reglas de transformación es la siguiente:


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

Puede agregar varias reglas de transformación al proyecto. La conversión de esquemas del DMS aplica las reglas de transformación durante la conversión en el mismo orden en que las agregó.

Si varias reglas se dirigen al mismo objeto, el comportamiento depende del tipo de acción. Todas las reglas con diferentes tipos de acción entran en vigor. Por ejemplo, se aplican tanto una add-suffix regla como una regla. add-prefix Las reglas con el mismo tipo de acción se anulan entre sí y solo entra en vigor la última.

Para crear reglas de transformación, utilice uno de los métodos siguientes.

AWS Management Console

Para crear reglas de transformación mediante la consola

En la página Crear proyecto de migración, elija Agregar regla de transformación. Para obtener más información, consulte Creación de proyectos de migración.
En Rule target, elija el tipo de objetos de base de datos a los que se aplica esta regla. El asistente de consola admite schema y column apunta. table Para utilizar otros destinos, como database oview, utilice el editor JSON de la consola o la AWS CLI.
Para Esquema de origen, elija Escribir un esquema. A continuación, especifique los esquemas, tablas y columnas de origen a los que se aplica esta regla. Puede usar un nombre exacto para seleccionar un objeto o usar un patrón con el signo de porcentaje (%) como comodín para que coincida con cualquier número de caracteres.
Para Acción, elija la tarea que desee realizar.
En función de la acción de la regla, introduzca valores adicionales:
- add-prefixo add-suffix — Introduzca el texto que desee añadir.
- remove-prefixo remove-suffix — Introduzca el texto que desee eliminar.
- replace-prefixo replace-suffix — Introduzca el texto existente y el texto de reemplazo.
- rename— Introduzca el nuevo nombre del objeto.
- convert-uppercaseo convert-lowercase — No se requieren valores adicionales.
- change-data-type— Introduzca el nombre del tipo de datos de destino y, si lo desea, la precisión, la escala o la longitud.
Elija Agregar regla de transformación para agregar otra regla de transformación.

Cuando haya terminado de agregar reglas, elija Crear proyecto de migración.

AWS CLI

Para añadir reglas de transformación mediante la AWS CLI, utilice el --transformation-rules parámetro con uno de los siguientes comandos:

create-migration-project: al crear un nuevo proyecto de migración.
modify-migration-project: para un proyecto de migración existente.

El siguiente ejemplo agrega reglas de transformación a un proyecto de migración existente:


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

Para ejecutar este comando en una región de AWS específica, añada el --region parámetro, por ejemplo--region us-west-2.

Para editar, duplicar o eliminar las reglas de transformación existentes, consulteEdición de reglas de transformación.

Recuperación de reglas de transformación

Puede recuperar las reglas de transformación de un proyecto de migración de conversión de esquemas de DMS existente mediante la consola AWS de administración o la AWS CLI.

Edición de reglas de transformación

Para editar, añadir o eliminar reglas de transformación en su proyecto de migración, utilice uno de los siguientes métodos.

Formato de regla de transformación

Una regla de transformación utiliza campos de objetos JSON para definir cómo convertir un objeto de origen en su equivalente de destino. Cada tipo de regla usa un conjunto específico de campos. Incluya solo los campos que se apliquen a su tarea.

El siguiente objeto JSON describe una regla de transformación de conversión de esquemas de 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 ]
  } ]
}

En la siguiente tabla se describe cada parámetro.

Parámetro	Valores posibles	Description (Descripción)
`rule-type`	`transformation`	Un valor que aplica la regla a cada objeto especificado por el localizador de objetos. Para todas las reglas de transformación, establézcalo en`transformation`. Parámetro necesario.
`rule-id`	Un valor numérico (entero).	Un único valor numérico para identificar la regla. Parámetro necesario.
`rule-name`	Un valor alfanumérico.	Un nombre exclusivo para identificar la regla. Parámetro necesario.
`rule-action`	`add-prefix`, `remove-prefix`, `replace-prefix`, `add-suffix`, `remove-suffix`, `replace-suffix`, `convert-uppercase`, `convert-lowercase`, `rename`, `change-data-type`	La transformación que desea aplicar al objeto. Todas las acciones de las reglas de transformación distinguen entre mayúsculas y minúsculas. Operaciones con prefijos: `add-prefix`— Añadir un texto específico al principio de un nombre. `remove-prefix`— Eliminar un texto específico del principio de un nombre. `replace-prefix`— Sustituir un prefijo existente por uno nuevo. Operaciones con sufijos: `add-suffix`— Añadir un texto específico al final de un nombre. `remove-suffix`— Eliminar un texto específico del final de un nombre. `replace-suffix`— Sustituir un sufijo existente por uno nuevo. conversión de mayúsculas y minúsculas `convert-uppercase`— Convertir todos los caracteres de un nombre a mayúsculas. `convert-lowercase`— Convertir todos los caracteres de un nombre a minúsculas. Modificación directa: `rename`— Cambia el nombre por un valor especificado completamente nuevo. `change-data-type`— Modificar el tipo de datos de una columna o variable local por un tipo de datos diferente. Alcance: las operaciones de conversión de prefijos, sufijos, cambio de nombre y mayúsculas y minúsculas se pueden aplicar a esquemas, tablas y columnas. La `change-data-type` operación solo se aplica a las columnas, los valores de retorno de las funciones, los parámetros de rutina y las variables locales. Parámetro necesario.
`rule-target`	`database`, `schema`, `table`, `view`, `column`, `function result`, `routine parameter`, `local variable`	El tipo de objeto al que se aplicará la regla. `database`— Base de datos. `schema`— Esquema de base de datos. `table`— Tabla de base de datos. `view`— Vista de base de datos. `column`— Tabla de base de datos o columna de visualización. `function result`— Valor devuelto por la función. `routine parameter`— Parámetro de función o procedimiento almacenado. `local variable`— Variable local dentro del procedimiento o función almacenado. Parámetro necesario.
`object-locator`	Un objeto JSON.	Un objeto que identifica a qué objetos de la base de datos de origen se aplica la regla. Puede utilizar el signo de porcentaje (`%`) como comodín para todo o parte del valor de cada campo de `object-locator` objeto. El objeto contiene los siguientes campos de cadena: `database-name` `schema-name` `table-name` `column-name` `parent` `function-name` `procedure-name` `parameter-name` `local-variable-name` `type` `precision` `scale` `length` Todos los nombres de objetos, como los nombres de tablas o columnas, de las reglas de transformación distinguen mayúsculas de minúsculas. En las siguientes secciones se describe cada campo de objeto. Parámetro necesario.
`object-locator \| database-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El nombre de la base de datos de origen. Aplicable a los proveedores de bases de datos en los que la arquitectura de la base de datos se origina en la base de datos como contenedor de objetos de nivel superior. Por ejemplo: Microsoft SQL Server, SAP ASE. Campo de objeto JSON opcional.
`object-locator \| schema-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El nombre del esquema de la base de datos de origen. Campo de objeto JSON opcional.
`object-locator \| table-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El nombre de la tabla de la base de datos de origen. Campo de objeto JSON opcional.
`object-locator \| column-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El nombre de la columna de la tabla de la base de datos de origen. Campo de objeto JSON opcional.
`object-locator \| parent`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El nombre del objeto de la base de datos de origen que es el padre del objeto especificado, por ejemplo, para `function-name` o`procedure-name`. En las bases de datos de algunos proveedores, el objeto al que se aplica la regla puede estar subordinado y requerir la especificación de su objeto principal. Por ejemplo, las funciones empaquetadas en Oracle, donde el padre es el nombre del paquete. Campo de objeto JSON opcional.
`object-locator \| function-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El nombre de la función de la base de datos de origen. Campo de objeto JSON opcional.
`object-locator \| procedure-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	Nombre del procedimiento de la base de datos de origen. Campo de objeto JSON opcional.
`object-locator \| parameter-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	Nombre del parámetro de procedimiento o función de la base de datos de origen. Campo de objeto JSON opcional.
`object-locator \| local-variable-name`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El nombre de una variable local dentro de la función o el procedimiento de la base de datos de origen. Campo de objeto JSON opcional.
`object-locator \| type`	Un valor alfanumérico.	El nombre del tipo de datos de origen que debe coincidir. Utilice este campo para aplicar la regla únicamente a los objetos con un tipo de datos específico. Campo de objeto JSON opcional.
`object-locator \| precision`	Un valor numérico (entero).	La precisión del tipo de datos de origen que debe coincidir. Campo de objeto JSON opcional.
`object-locator \| scale`	Un valor numérico (entero).	La escala del tipo de datos de origen que debe coincidir. Campo de objeto JSON opcional.
`object-locator \| length`	Un valor numérico (entero).	La longitud del tipo de datos de origen que debe coincidir. Campo de objeto JSON opcional.
`value`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de destino.	El valor de texto utilizado por la acción de transformación. Para `add-prefix` y`add-suffix`, especifica el texto que se va a añadir. Para `remove-prefix` y`remove-suffix`, especifica el texto que se va a eliminar. Para `replace-prefix` y`replace-suffix`, especifica el texto de reemplazo. Para`rename`, especifica el nombre nuevo. Necesario para todas las acciones excepto `convert-uppercaseconvert-lowercase`, y`change-data-type`.
`old-value`	Un valor alfanumérico que sigue las reglas de nomenclatura de la base de datos de origen.	El valor existente que se va a buscar y reemplazar en el nombre del objeto. Necesario para acciones como `replace-prefix` y`replace-suffix`. Parámetro opcional.
`data-type`	Un objeto JSON.	Un objeto que describe las propiedades del tipo de datos de reemplazo cuando `rule-action` es`change-data-type`. El objeto contiene los siguientes campos: `type`: cadena `precision`: número `scale`: número `length`: número En las siguientes secciones se describe cada campo de objeto. Parámetro opcional.
`data-type \| type`	Un valor alfanumérico.	El nombre del tipo de datos de reemplazo para la columna de la base de datos de destino, si `rule-action` lo es`change-data-type`. Debe ser un tipo de datos de base de datos de destino válido. Campo de objeto JSON obligatorio.
`data-type \| precision`	Un valor numérico (entero).	La precisión del tipo de datos de reemplazo para la base de datos de destino, si `rule-action` es`change-data-type`. Campo de objeto JSON opcional.
`data-type \| scale`	Un valor numérico (entero).	La escala del tipo de datos de reemplazo para la base de datos de destino, si `rule-action` es`change-data-type`. Campo de objeto JSON opcional.
`data-type \| length`	Un valor numérico (entero).	La longitud del tipo de datos de reemplazo para la base de datos de destino, si `rule-action` es`change-data-type`. Campo de objeto JSON opcional.

Ejemplos de reglas de transformación

Los siguientes ejemplos muestran el valor JSON del --transformation-rules parámetro para distintos tipos de reglas: