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 sitable-name se refiere únicamente a tablas, vistas o ambas 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 de datos de cambio y carga completa (CDC), configure al menos una full-load-only tarea para cargar sus vistas. No todos los terminales de destino aceptan las vistas como fuente de replicación, incluso a plena carga (por ejemplo, Amazon OpenSearch Service). Compruebe las limitaciones de su terminal 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 caracteres comodín que puede utilizar, consulteComodín en el mapeo de tablas. Así, puede hacer coincidir estos elementos: Una sola tabla, vista o colección en un único esquema Una sola tabla, vista o colección en algunos o todos los esquemas Algunas o todas las tablas y vistas en un único esquema o colecciones en una única base de datos Algunas o todas las tablas y vistas de algunos o todos los esquemas o colecciones de 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 SAP Adaptive Server Enterprise (ASE) MySQL AURORA AURORA Serverless 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. Las fuentes compatibles para las bases de datos que contienen colecciones 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 tablaloadfirst (con prioridad 2) se inicializa antes que la tablaloadsecond.

{
"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-orderes aplicable a la inicialización de tablas. La carga de una tabla sucesiva no esperará a que se complete la carga de una tabla anterior siMaxFullLoadSubTasks 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"
        }
    ]
}