Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de Amazon DocumentDB como destino para AWS Database Migration Service

Para obtener información sobre las versiones de Amazon DocumentDB (compatibles con MongoDB) compatibles, consulte. AWS DMS Objetivos para AWS DMS Puede usar AWS DMS para migrar datos a Amazon DocumentDB (con compatibilidad con MongoDB) desde cualquiera de los motores de datos de origen compatibles con AWS DMS . El motor de origen puede estar en un servicio AWS gestionado como Amazon RDS, Aurora o Amazon S3. O bien, el motor puede estar en una base de datos autogestionada, como MongoDB que se ejecuta en EC2 Amazon o de forma local.

Puede utilizarlos AWS DMS para replicar los datos de origen en bases de datos, colecciones o documentos de Amazon DocumentDB.

MongoDB almacena los datos en un formato JSON binario (BSON). AWS DMS admite todos los tipos de datos BSON compatibles con Amazon DocumentDB. Para obtener una lista de estos tipos de datos, consulte APIsMongoDB, operaciones y tipos de datos compatibles en la Guía para desarrolladores de Amazon DocumentDB.

Si el punto final de origen es una base de datos relacional, AWS DMS asigna los objetos de la base de datos a Amazon DocumentDB de la siguiente manera:

Si el punto de conexión de origen es Amazon S3, los objetos de Amazon DocumentDB resultantes se corresponden con reglas de asignación de AWS DMS para Amazon S3. Considere, por ejemplo, el siguiente URI.

s3://mybucket/hr/employee

En este caso, AWS DMS asigne los objetos mybucket a Amazon DocumentDB de la siguiente manera:

Para obtener más información sobre las reglas de asignación de Amazon S3, consulte Uso de Amazon S3 como fuente de AWS DMS.

Para obtener información adicional sobre cómo trabajar con Amazon DocumentDB como destino AWS DMS, consulte las siguientes secciones:

Asignación de datos desde un origen a un destino de Amazon DocumentDB

AWS DMS lee los registros del punto final de origen y crea documentos JSON en función de los datos que lee. Para cada documento JSON, AWS DMS debe determinar un _id campo que actúe como identificador único. A continuación, escribe el documento JSON en una recopilación de Amazon DocumentDB, con el campo _id como clave principal.

Datos de origen que están en una sola columna

Si los datos de origen constan de una única columna, deben ser del tipo cadena. (Según el motor de origen, el tipo de datos real puede ser VARCHAR, NVARCHAR, TEXT, LOB, CLOB o similar). AWS DMS asume que los datos son un documento JSON válido y los replica en Amazon DocumentDB tal cual.

Si el documento JSON resultante contiene un campo llamado _id, entonces se utiliza ese campo como el _id único en Amazon DocumentDB.

Si JSON no contiene un campo _id, Amazon DocumentDB genera un valor de _id automáticamente.

Datos de origen que están en varias columnas

Si los datos de origen constan de varias columnas, crea un documento JSON a partir de todas estas columnas. AWS DMS Para determinar el _id campo del documento, AWS DMS proceda de la siguiente manera:

Forzar un tipo de datos en el punto de enlace de destino

AWS DMS puede modificar las estructuras de datos cuando escribe en un punto final de destino de Amazon DocumentDB. Puede solicitar estos cambios modificando los nombres de las columnas y las tablas en el punto de enlace de origen o proporcionando reglas de transformación que se apliquen cuando se ejecute una tarea.

Uso de un documento JSON anidado (json_ prefix)

Para forzar un tipo de datos, puede incluir el prefijo json_ en el nombre de la columna de origen (por ejemplo, json_columnName) manualmente o mediante una transformación. En este caso, la columna se crea como un documento JSON anidado dentro del documento de destino, en lugar de como un campo de cadena.

Suponga, por ejemplo, que desea migrar el siguiente documento desde un punto de enlace de origen de MongoDB.

{
    "_id": "1", 
    "FirstName": "John", 
    "LastName": "Doe",
    "ContactDetails": "{"Home": {"Address": "Boston","Phone": "1111111"},"Work": { "Address": "Boston", "Phone": "2222222222"}}"
}

Si no fuerza ningún tipo de datos de origen, el documento ContactDetails incrustado se migra como una cadena.

{
    "_id": "1", 
    "FirstName": "John", 
    "LastName": "Doe",
    "ContactDetails": "{\"Home\": {\"Address\": \"Boston\",\"Phone\": \"1111111\"},\"Work\": { \"Address\": \"Boston\", \"Phone\": \"2222222222\"}}"
}

Sin embargo, puede añadir una regla de transformación para obligar a que ContactDetails sea un objeto JSON. Suponga, por ejemplo, que el nombre original de la columna de origen es ContactDetails. Para utilizar el tipo de datos como JSON anidado, es necesario cambiar el nombre de la columna situada en el punto final de origen a «json_ContactDetails», ya sea añadiendo el prefijo «*json_*» a la fuente de forma manual o mediante reglas de transformación. Por ejemplo, puede usar la siguiente regla de transformación:

{
    "rules": [
    {
    "rule-type": "transformation",
    "rule-id": "1",
    "rule-name": "1",
    "rule-target": "column",
    "object-locator": {
    "schema-name": "%",
    "table-name": "%",
    "column-name": "ContactDetails"
     },
    "rule-action": "rename",
    "value": "json_ContactDetails",
    "old-value": null
    }
    ]
}
                    

AWS DMS replica el campo como JSON anidado, de la siguiente manera. ContactDetails

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",
    "ContactDetails": {
        "Home": {
            "Address": "Boston",
            "Phone": "1111111111"
        },
        "Work": {
            "Address": "Boston",
            "Phone": "2222222222"
        }
    }
}

Uso de una matriz JSON (array_ prefix)

Para forzar un tipo de datos, puede incluir el prefijo array_ en el nombre de la columna (por ejemplo, array_columnName) manualmente o mediante una transformación. En este caso, AWS DMS considera la columna como una matriz JSON y la crea como tal en el documento de destino.

Suponga que desea migrar el siguiente documento desde un punto de enlace de origen de MongoDB.

{
    "_id" : "1",
    "FirstName": "John",
    "LastName": "Doe",

    "ContactAddresses": ["Boston", "New York"],
            
    "ContactPhoneNumbers": ["1111111111", "2222222222"]
}

Si no fuerza ningún tipo de datos de origen, el documento ContactDetails incrustado se migra como una cadena.

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",

    "ContactAddresses": "[\"Boston\", \"New York\"]",
            
    "ContactPhoneNumbers": "[\"1111111111\", \"2222222222\"]"

}                

Sin embargo, puede añadir reglas de transformación para imponer el tipo de datos de matriz JSON a ContactAddress y ContactPhoneNumbers, tal y como se muestra en la siguiente tabla.

AWS DMS se replica ContactAddress y de la ContactPhoneNumbers siguiente manera.

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",
    "ContactAddresses": [
        "Boston",
        "New York"
    ],
    "ContactPhoneNumbers": [
        "1111111111",
        "2222222222"
    ]
}             

Conexión a Amazon DocumentDB mediante TLS

De forma predeterminada, un clúster de Amazon DocumentDB recién creado solo acepta conexiones seguras mediante la seguridad de la capa de transporte (TLS). Cuando TLS está habilitado, cada conexión a Amazon DocumentDB requiere una clave pública.

Puede recuperar la clave pública de Amazon DocumentDB descargando el archivo desde un bucket de Amazon S3 AWS alojado. rds-combined-ca-bundle.pem Para obtener más información acerca de la descarga de este archivo, consulte Cifrado de conexiones mediante TLS en la Guía para desarrolladores de Amazon DocumentDB

Tras descargar este archivo.pem, puede importar la clave pública que contiene tal y AWS DMS como se describe a continuación.

AWS Management Console

AWS CLI

Utilice el comando aws dms import-certificate, tal y como se muestra en el ejemplo siguiente.

aws dms import-certificate \
    --certificate-identifier docdb-cert \
    --certificate-pem file://./rds-combined-ca-bundle.pem

Al crear un punto final de AWS DMS destino, proporcione el identificador del certificado (por ejemplo,docdb-cert). A continuación, establezca el parámetro de modo de SSL en verify-full.

Conexión a los clústeres elásticos de Amazon DocumentDB como destino

En AWS DMS las versiones 3.4.7 y posteriores, puede crear un punto final de destino de Amazon DocumentDB como un clúster elástico. Si crea el punto de conexión de destino como un clúster elástico, debe adjuntar un certificado SSL nuevo al punto de conexión del clúster elástico de Amazon DocumentDB, ya que el certificado SSL existente no funcionará.

El nuevo certificado SSL del archivo SFSRootCAG2.pem descargado ahora está adjunto al punto de conexión del clúster elástico de Amazon DocumentDB.

Replicación continua con Amazon DocumentDB como destino

Si la replicación continua (captura de datos de cambios, CDC) está habilitada para Amazon DocumentDB como objetivo, las versiones 3.5.0 y superiores de AWS DMS proporcionan una mejora del rendimiento veinte veces mayor que las versiones anteriores. En versiones anteriores, en AWS DMS las que se gestionaban hasta 250 registros por segundo, AWS DMS ahora se procesan de forma eficiente más de 5000 registros por segundo. AWS DMS también garantiza que los documentos de Amazon DocumentDB permanezcan sincronizados con la fuente. Al crear o actualizar un registro fuente, primero AWS DMS debe determinar qué registro de Amazon DocumentDB se ve afectado de la siguiente manera:

Cuando se crea un registro de origen nuevo, AWS DMS escribe el documento correspondiente en Amazon DocumentDB. Si se actualiza un registro de origen existente, AWS DMS actualiza los campos correspondientes del documento de destino en Amazon DocumentDB. Los campos que existen en el documento de destino pero no en el registro de origen se mantienen tal cual están.

Cuando se elimina un registro de origen, AWS DMS elimina el documento correspondiente de Amazon DocumentDB.

Cambios estructurales (DDL) en el origen

Con la replicación continua, todos los cambios realizados en las estructuras de datos de origen (como tablas, columnas, etc.) se propagan a los elementos correspondientes en Amazon DocumentDB. En las bases de datos relacionales, estos cambios se inician con instrucciones del lenguaje de definición de datos (DDL). Puede ver cómo AWS DMS se propagan estos cambios a Amazon DocumentDB en la siguiente tabla.

Limitaciones para usar Amazon DocumentDB como destino

Se aplican las siguientes limitaciones cuando se utiliza Amazon DocumentDB como destino para: AWS DMS

Uso de la configuración de puntos de conexión con Amazon DocumentDB como destino

Puede utilizar la configuración de punto de conexión para configurar la base de datos de destino de Amazon DocumentDB de forma similar al uso de atributos de conexión adicionales. Los ajustes se especifican al crear el punto final de destino mediante la AWS DMS consola o mediante el create-endpoint comando de AWS CLI, con la sintaxis --doc-db-settings '{"EndpointSetting": "value", ...}' JSON.

La siguiente tabla muestra la configuración de punto de conexión que puede utilizar con Amazon DocumentDB como destino.

Tipos de datos de destino de Amazon DocumentDB

En la siguiente tabla, puede encontrar los tipos de datos de destino de Amazon DocumentDB que se admiten cuando se utiliza AWS DMS y el mapeo predeterminado a partir de los tipos de datos de AWS DMS. Para obtener más información sobre los tipos de datos de AWS DMS, consulte. Tipos de datos de AWS Database Migration Service