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 acerca de las versiones de Amazon DocumentDB (con compatibilidad con MongoDB) que AWS DMS admite, consulte 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 administrado por AWS como Amazon RDS, Aurora o Amazon S3. O el motor puede estar en una base de datos autoadministrada, como MongoDB ejecutándose en Amazon EC2 o en las instalaciones.

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

MongoDB almacena los datos en 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 API, operaciones y tipos de datos de MongoDB admitidos en la Guía para desarrolladores de Amazon DocumentDB..

Si el punto de conexión de origen es una base de datos relacional, AWS DMS asigna 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 asigna los objetos de mybucket a Amazon DocumentDB tal y como se indica a continuación:

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 más información sobre cómo trabajar con Amazon DocumentDB como destino para AWS DMS, consulte las secciones siguientes:

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

AWS DMS lee los registros del punto de enlace de origen y crea documentos JSON en función de los datos que lee. Para cada documento JSON, AWS DMS debe determinar un campo _id que actúe como un 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. (En función del motor de origen, el tipo de datos real puede ser VARCHAR, NVARCHAR, TEXTO, LOB, CLOB o similar). AWS DMS presupone que los datos son un documento JSON válido y replica los datos en Amazon DocumentDB tal como están.

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, AWS DMS crea un documento JSON a partir de todas estas columnas. Para determinar el campo _id del documento, AWS DMS procede 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 de conexión 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 forzar el tipo de datos como JSON anidado, es necesario cambiar el nombre de la columna situada en el punto de conexión de origen a “json_ContactDetails”, agregando 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 ContactDetails como JSON anidado, de la siguiente manera.

{
    "_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 replica ContactAddress y ContactPhoneNumbers de la manera siguiente.

{
    "_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 para Amazon DocumentDB descargando el archivo, rds-combined-ca-bundle.pem, desde un bucket de Amazon S3 alojado en AWS. 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

Después de descargar este archivo .pem, puede importar la clave pública que contiene en 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

Cuando cree un punto de enlace de destino de AWS DMS, proporcione el identificador de 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 las versiones 3.4.7 y superiores de AWS DMS, puede crear un punto de conexión 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 de 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 cambio, 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, AWS DMS gestiona hasta 250 registros por segundo, AWS DMS ahora gestiona aproximadamente 5000 registros por segundo. AWS DMS también garantiza que los documentos de Amazon DocumentDB permanecen sincronizados con el origen. Cuando se crea o actualiza un registro de origen, AWS DMS debe determinar primero qué registro de Amazon DocumentDB resultará afectado mediante el siguiente procedimiento:

Cuando se crea un nuevo registro de origen, AWS DMS escribe un documento correspondiente en Amazon DocumentDB. Si se actualiza un registro de origen existente, AWS DMS actualiza los campos correspondientes del documento de destino de 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 propaga estos cambios a Amazon DocumentDB en la siguiente tabla.

Limitaciones para usar Amazon DocumentDB como destino

Al utilizar Amazon DocumentDB como destino de AWS DMS se aplican las siguientes restricciones:

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. Se especifican los ajustes cuando se crea el punto de conexión de destino mediante la consola de AWS DMS o mediante el comando create-endpoint en la AWS CLI, con la sintaxis JSON --doc-db-settings '{"EndpointSetting": "value", ...}'.

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 tabla siguiente, puede encontrar los tipos de datos de destino de Amazon DocumentDB que se admiten cuando se utiliza AWS DMS y la asignación predeterminada 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.