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.

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.
rule-name	Un valor alfanumérico.	Un nombre exclusivo para identificar la regla.
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 captura completa y de cambios de datos (CDC), configure al menos una full-load-only tarea para cargar las vistas. No todos los puntos finales de destino aceptan vistas como fuente de replicación, ni siquiera a plena carga (por ejemplo, Amazon OpenSearch Service). Compruebe las limitaciones del punto de conexión de destino.	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 AURORA sin servidor 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

El siguiente ejemplo migra dos tablas. La tabla loadfirst (con prioridad 1) se inicializa antes que la tabla. loadsecond

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

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"
        }
    ]
}