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 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. aviso Las reglas de selección del DMS distinguen mayúsculas de minúsculas. Sin embargo, el resultado de la selección también depende de la configuración de la base de datos de punto final de origen. Si el punto final de origen está configurado como insensible a mayúsculas y minúsculas, no importa el número de mayúsculas y minúsculas del valor del localizador de objetos. Asegúrese de que se utilicen los identificadores de objeto correctos en las reglas de selección del DMS en un punto final 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, y 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 loadfirst tabla antes de continuar con ella. 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"
        }
    ]
}