Reglas y acciones de selección - AWS Database Migration Service

Reglas y acciones de selección

Si utiliza la correspondencia de tablas, vistas y esquemas puede especificar con qué tablas o esquemas desea trabajar mediante el uso de reglas de selección y acciones. Para las reglas de correspondencia de tablas utilice el tipo de regla de selección; puede aplicar los valores siguientes.

aviso

No incluya ningún dato confidencial en estas reglas.

Parámetro Valores posibles Descripción
rule-type selection Una regla de selección. Defina al menos una regla de selección cuando especifique un mapeo de tablas.
rule-id Un valor numérico. Un único valor numérico para identificar la regla. Si crea la regla con la consola, esta última crea el valor de forma automática.
rule-name Un valor alfanumérico. Un nombre exclusivo para identificar la regla. Si crea la regla con la consola, esta última crea el valor de forma automática.
rule-action include, exclude, explicit Un valor que incluye o excluye el objeto u objetos seleccionados por la regla. Si se especifica explicit, puede seleccionar e incluir solo un objeto que corresponde a una tabla y esquema especificados de forma explícita.
object-locator Un objeto con los siguientes parámetros:

  • schema-name: el nombre del esquema.

  • table-name: el nombre de la tabla.

  • (Opcional) table-type: table | view | all , para indicar si table-name se refiere solo a tablas, vistas o tablas y vistas. El valor predeterminado es table.

    AWS DMS carga vistas solo en una tarea de carga completa. Si solo tiene tareas de carga completa y captura de datos de cambios (CDC), configure al menos una tarea de solo carga completa para cargar las vistas.

    No todos los puntos de conexión de destino aceptan las vistas como origen de replicación, ni siquiera a carga completa (por ejemplo, Amazon OpenSearch Service). Compruebe las limitaciones del punto de conexión de destino.

aviso

Las reglas de selección de DMS distinguen entre mayúsculas y minúsculas. Sin embargo, el resultado de la selección también depende de la configuración de la base de datos de punto de conexión de origen. Si el punto de conexión de origen se configura de manera que no distinga entre mayúsculas y minúsculas, no importa si el valor del localizador de objetos está en mayúsculas o minúsculas. Asegúrese de que se utilicen los identificadores de objeto correctos en las reglas de selección de DMS en un punto de conexión que no distinga mayúsculas de minúsculas.

El nombre de cada esquema y tabla o vista a la que se aplica la regla. También puede especificar si una regla incluye solo tablas, solo vistas o ambas tablas y vistas. Si la rule-action es include o bien exclude, puede utilizar el signo de porcentaje "%" como comodín para todo o parte del valor del parámetro schema-name y table-name. Para obtener información sobre otros comodines que puede utilizar, consulte Comodines en la asignación de tablas. Así, puede hacer coincidir estos elementos:

  • Una única tabla, vista o recopilación en un solo esquema

  • Una única tabla, vista o recopilación en algunos o todos los esquemas

  • Algunas o todas las tablas y vistas en un solo esquema o recopilaciones en una sola base de datos

  • Algunas o todas las tablas y vistas en algunos o todos los esquemas o recopilaciones en algunas o todas las bases de datos

Si la rule-action es explicit, solo puede especificar el nombre exacto de una tabla o vista única y su esquema (sin comodines).

Los orígenes admitidos para las vistas incluyen:

  • Oracle

  • Microsoft SQL Server

  • PostgreSQL

  • IBM Db2 LUW

  • IBM Db2 z/OS

  • SAP Adaptive Server Enterprise (ASE)

  • MySQL

  • AURORA MySQL

  • MariaDB

nota

AWS DMS nunca carga una vista de origen en una vista de destino. Una vista de origen se carga en una tabla equivalente en el destino con el mismo nombre que la vista en el origen.

Los orígenes compatibles para las bases de datos que contienen recopilaciones incluyen:

  • MongoDB

  • Amazon DocumentDB
load-order Un número entero. El valor máximo es 2,147,483,647. La prioridad para cargar tablas y vistas. Las tablas y vistas con valores más altos se cargan primero.
filters Una matriz de objetos. Uno o más objetos para filtrar el origen. Especifique parámetros de objetos para filtrar en una única columna en el origen. Especifique varios objetos para filtrar en varias columnas. Para obtener más información, consulte Uso de filtros de origen.
ejemplo Migrar todas las tablas de un esquema

El siguiente ejemplo migra todas las tablas desde un esquema denominado Test en el origen al punto de enlace de destino.

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "Test",
                "table-name": "%"
            },
            "rule-action": "include"
        }
    ]
}
ejemplo Migrar algunas tablas de un esquema

En el siguiente ejemplo, se migran todas las tablas excepto aquellas que comienzan con DMS desde un esquema llamado Test en el origen hasta el punto de enlace de destino.

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "Test",
                "table-name": "%"
            },
            "rule-action": "include"
        },
        {
            "rule-type": "selection",
            "rule-id": "2",
            "rule-name": "2",
            "object-locator": {
                "schema-name": "Test",
                "table-name": "DMS%"
            },
            "rule-action": "exclude"
        }
    ]
}
ejemplo Migrar una única tabla especificada de un solo esquema

El siguiente ejemplo migra la tabla Customer desde el esquema NewCust en el origen al punto de enlace de destino.

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "NewCust",
                "table-name": "Customer"
            },
            "rule-action": "explicit"
        }
    ]
}
nota

Puede seleccionar de forma explícita en varias tablas y esquemas especificando varias reglas de selección.

ejemplo Migrar tablas en un orden establecido

Las tablas y vistas se migran según sus valores de orden de carga. Además, los valores más altos tienen prioridad en la secuencia de migración. En el siguiente ejemplo, se migran dos tablas: loadfirst con un valor de prioridad de 2 y loadsecond con un valor de prioridad de 1. La tarea de migración procesaría primero la tabla loadfirst antes de continuar con la tabla loadsecond. Este mecanismo de priorización garantiza que se respeten las dependencias entre los objetos de la base de datos durante el proceso de migración.

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "Test",
                "table-name": "loadsecond"
            },
            "rule-action": "include",
            "load-order": "1"
        },
        {
            "rule-type": "selection",
            "rule-id": "2",
            "rule-name": "2",
            "object-locator": {
                "schema-name": "Test",
                "table-name": "loadfirst"
            },
            "rule-action": "include",
            "load-order": "2"
        }
    ]
}
nota

load-order es aplicable para la inicialización de tablas. La carga de una tabla sucesiva no esperará a que se complete la carga de la tabla anterior si MaxFullLoadSubTasks es superior a 1.

ejemplo Migrar algunas vistas de un esquema

En el siguiente ejemplo se migran algunas vistas de un esquema denominado Test en el origen a tablas equivalentes en el destino.

{
   "rules": [
        {
           "rule-type": "selection",
           "rule-id": "2",
           "rule-name": "2",
           "object-locator": {
               "schema-name": "Test",
               "table-name": "view_DMS%",
               "table-type": "view"
            },
           "rule-action": "include"
        }
    ]
}
ejemplo Migrar todas las tablas y vistas de un esquema

En el siguiente ejemplo se migran todas las tablas y vistas de un esquema denominado report en el origen a tablas equivalentes en el destino.

{
   "rules": [
        {
           "rule-type": "selection",
           "rule-id": "3",
           "rule-name": "3",
           "object-locator": {
               "schema-name": "report",
               "table-name": "%",
               "table-type": "all"
            },
           "rule-action": "include"
        }
    ]
}