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.
Clonación de un volumen de clúster de base de datos de Amazon DocumentDB
Con la clonación de Amazon DocumentDB, puede crear un nuevo clúster que utilice el mismo volumen de clúster de Amazon DocumentDB y tenga los mismos datos que el original. El proceso está diseñado para ser rápido y rentable. El nuevo clúster con su volumen de datos asociado se conoce como clon. La creación de un clon es más rápido y más eficiente en el espacio que copiar físicamente los datos mediante una técnica diferente, como la restauración de una instantánea.
Amazon DocumentDB admite la creación de un clon aprovisionado de Amazon DocumentDB a partir de un clúster de Amazon DocumentDB aprovisionado. Cuando crea un clon con una configuración de implementación diferente a la de origen, el clon se crea con la versión secundaria más reciente del motor de base de datos Amazon DocumentDB.
Cuando crea clones a partir de sus clústeres de Amazon DocumentDB, los clones se crean en su cuenta, la misma cuenta que posee AWS el clúster de Amazon DocumentDB de origen.
Información general de la clonación de Amazon DocumentDB
Amazon DocumentDB utiliza un copy-on-write protocolo para crear un clon. Este mecanismo utiliza un espacio adicional mínimo para crear un clon inicial. Cuando se crea el clon por primera vez, Amazon DocumentDB guarda una sola copia de los datos que utiliza el clúster de base de datos de Amazon DocumentDB de origen y el nuevo clúster de base de datos de Amazon DocumentDB (clonado). El almacenamiento adicional solo se asigna cuando el clúster de base de datos de Amazon DocumentDB de origen o el clon del clúster de base de datos de Amazon DocumentDB realizan cambios en los datos (en el volumen de almacenamiento de Amazon DocumentDB). Para obtener más información sobre el copy-on-write protocolo, consulteCómo funciona la clonación de Amazon DocumentDB.
La clonación de Amazon DocumentDB es especialmente útil para configurar rápidamente entornos de prueba mediante sus datos de producción, sin riesgo de corrupción de datos. Puede utilizar clones para muchos tipos de aplicaciones de corta duración, como las siguientes:
-
Experimente con cambios potenciales (por ejemplo, cambios de esquema y cambios de grupo de parámetros) para evaluar todos los impactos.
-
Realice operaciones intensivas de carga de trabajo, como exportar datos o ejecutar consultas analíticas en el clon.
-
Cree una copia del clúster de base de datos de producción para desarrollo, pruebas u otros fines.
Puede crear más de un clon desde el mismo clúster de base de datos de Amazon DocumentDB. También puede crear varios clones desde otro clon.
Tras crear un clon de Amazon DocumentDB, puede configurar las instancias de Amazon DocumentDB de forma diferente a la del clúster de Amazon DocumentDB de origen. Por ejemplo, es posible que no necesite un clon con fines de desarrollo para cumplir con los mismos requisitos de alta disponibilidad que el clúster de base de datos Amazon DocumentDB de producción de origen. En este caso, puede configurar el clon con una única instancia de base de datos de Amazon DocumentDB en lugar de las múltiples instancias de base de datos utilizadas por el clúster de base de datos de Amazon DocumentDB.
Cuando termine de utilizar el clon para realizar pruebas, desarrollo u otros fines, puede eliminarlo.
Limitaciones de la clonación de Amazon DocumentDB
La clonación de Amazon DocumentDB tiene las siguientes limitaciones:
-
Puede crear tantos clones como desee, hasta el número máximo de clústeres de base de datos permitido en la Región de AWS. No obstante, después de crear 15 clones, el siguiente es una copia completa. La operación de clonación actúa como una point-in-time recuperación.
-
No puede crear un clon en una AWS región diferente del clúster de Amazon DocumentDB de origen.
-
No se puede crear un clon desde un clúster de base de datos de Amazon DocumentDB que no tiene instancias de base de datos. Solo se pueden clonar clústeres de base de datos de Amazon DocumentDB que tengan al menos una instancia de base de datos.
-
Puede crear un clon en una nube privada virtual (VPC) diferente a la del clúster de Amazon DocumentDB. Si lo hace, las subredes VPCs deben asignarse a las mismas zonas de disponibilidad.
Cómo funciona la clonación de Amazon DocumentDB
La clonación de Amazon DocumentDB funciona en la capa de almacenamiento de un clúster de Amazon DocumentDB. Utiliza un copy-on-writeprotocolo que es rápido y ahorra espacio en cuanto al soporte duradero subyacente que soporta el volumen de almacenamiento de Amazon DocumentDB. Puede obtener más información sobre volúmenes de clúster de Amazon DocumentDB en Administración de clústeres de Amazon DocumentDB.
Comprensión del protocolo copy-on-write
Un clúster de Amazon DocumentDB almacena datos en páginas en el volumen de almacenamiento de Amazon DocumentDB subyacente.
Por ejemplo, en el siguiente diagrama puede encontrar un clúster de base de datos de Amazon DocumentDB (A) que tiene cuatro páginas de datos, 1, 2, 3 y 4. Imagine que un clon, B, se crea desde del clúster de base de datos de Amazon DocumentDB. Cuando se crea el clon, no se copian datos. Más bien, el clon apunta al mismo conjunto de páginas que el clúster de base de datos de Amazon DocumentDB de origen.
Cuando se crea el clon, generalmente no se necesita almacenamiento adicional. El copy-on-write protocolo utiliza el mismo segmento en el medio de almacenamiento físico que el segmento de origen. Solo se requiere almacenamiento adicional si la capacidad del segmento de origen no es suficiente para todo el segmento de clones. Si ese es el caso, el segmento de origen se copia en otro dispositivo físico.
En los siguientes diagramas, puede encontrar un ejemplo del copy-on-write protocolo en acción que utiliza el mismo clúster A y su clon, B, como se muestra anteriormente. Supongamos que realiza un cambio en su clúster de base de datos de Amazon DocumentDB (A) que da lugar a un cambio en los datos almacenados en la página 1. En lugar de escribir en la página original 1, Amazon DocumentDB crea una nueva página 1 [A]. El volumen del clúster de base de datos de Amazon DocumentDB para el clúster (A) ahora apunta a la página 1 [A], 2, 3 y 4, mientras que el clon (B) sigue haciendo referencia a las páginas originales.
En el clon, se realiza un cambio en la página 4 del volumen de almacenamiento. En lugar de escribir en la página original 4, Amazon DocumentDB crea una nueva página 4 [B]. El clon ahora apunta a las páginas 1, 2, 3 y a la página 4 [B], mientras que el clúster (A) continúa apuntando a 1 [A], 2, 3 y 4.
A medida que se producen más cambios a lo largo del tiempo en el clon y el volumen del clúster de base de datos de Amazon DocumentDB de origen, necesitará cada vez más almacenamiento para capturar y almacenar los cambios.
Eliminación de un volumen del clúster de origen
Cuando elimina un volumen del clúster de origen que tiene uno o más clones asociados, los clones no se ven afectados. Los clones siguen apuntando a las páginas que antes pertenecían al volumen del clúster de origen.
Creación de un clon de Amazon DocumentDB
Puede crear un clon en la misma AWS cuenta que el clúster de Amazon DocumentDB de origen. Para ello, puede utilizar los procedimientos siguientes AWS Management Console o AWS CLI los siguientes.
Al utilizar la clonación de Amazon DocumentDB, puede crear un clon de clúster de Amazon DocumentDB aprovisionado a partir de un clúster de Amazon DocumentDB aprovisionado.
- Using the AWS Management Console
-
El siguiente procedimiento describe cómo clonar un clúster de Amazon DocumentDB usando la AWS Management Console.
Crear un clon con los AWS Management Console resultados de un clúster de Amazon DocumentDB con una instancia de Amazon DocumentDB.
Estas instrucciones se aplican a los clústeres de bases de datos que pertenecen a la misma AWS cuenta que está creando el clon. El clúster de base de datos debe ser propiedad de la misma AWS cuenta, ya que Amazon DocumentDB no admite la clonación entre cuentas.
Para crear un clon de un clúster de base de datos propiedad de su AWS cuenta mediante el AWS Management Console
Inicie sesión en la consola AWS Management Console de Amazon DocumentDB y ábrala en https://console.aws.amazon.com/docdb.
En el panel de navegación, seleccione Clusters (Clústeres).
Elija su clúster de base de datos de Amazon DocumentDB de la lista y para Acciones, elija Crear clon.
Se abre la página Crear clon, donde puede configurar un Identificador de clúster y una Clase de instancia, y otras opciones para el clon del clúster de Amazon DocumentDB.
En la sección Settings, realice lo siguiente:
Para el identificador de clúster de base de datos, ingrese el nombre que desea dar a su clúster de base de datos de Amazon DocumentDB clonado.
Para la Configuración de instancias, seleccione una Clase de instancia adecuada para su clúster clonado de Amazon DocumentDB.
-
En cuanto a la configuración de red, elija un grupo de subredes para su caso de uso y los grupos de VPC seguridad asociados.
-
En el caso de E ncryption-at-rest, si el clúster de origen (el clúster que se está clonando) tiene activado el cifrado, el clúster clonado también debe tenerlo activado. Si se da este escenario, las opciones de Habilitar el cifrado aparecen atenuadas (deshabilitadas), pero con la opción Habilitar el cifrado seleccionada. Por el contrario, si el clúster de origen no tiene el cifrado habilitado, están disponibles las opciones de Habilitar el cifrado y puede elegir habilitar o deshabilitar el cifrado.
-
Complete la nueva configuración del clon del clúster seleccionando el tipo de registros que desea exportar (opcional), introduciendo un puerto específico utilizado para conectarse al clúster y habilitando la protección contra la eliminación accidental del clúster (esta opción está habilitada de forma predeterminada).
Termine de ingresar todos los ajustes para su clon de clúster de base de datos de Amazon DocumentDB. Para obtener más información sobre la configuración del clúster y de la instancia de base de datos de Amazon DocumentDB, consulte Administración de clústeres de Amazon DocumentDB.
-
Seleccione Crear clon para lanzar el clon de Amazon DocumentDB del clúster de Amazon DocumentDB que haya elegido.
Cuando se crea el clon, aparece junto con los otros clústeres de base de datos de Amazon DocumentDB en la sección Bases de datos de la consola y muestra su estado actual. Su clon está listo para utilizar cuando su estado es Available (Disponible).
- Using the AWS CLI
-
El uso de AWS CLI para clonar el clúster de Amazon DocumentDB implica un par de pasos.
El restore-db-cluster-to-point-in-time
AWS CLI comando que utiliza da como resultado un clúster de Amazon DocumentDB vacío con 0 instancias de Amazon DocumentDB. Es decir, el comando restaura solo el clúster de base de datos de Amazon DocumentDB, no las instancias de base de datos de dicho clúster. Lo hace por separado después de que el clon está disponible. Los dos pasos en el proceso son los siguientes:
Cree el clon mediante el comando restore-db-cluster-to- point-in-timeCLI. Los parámetros que utiliza con este comando controlan el tipo de capacidad y otros detalles del clúster vacío (clon) de base de datos de Amazon DocumentDB que se está creando.
Cree la instancia de Amazon DocumentDB para el clon mediante el create-db-instanceCLIcomando para volver a crear la instancia de Amazon DocumentDB en el clúster de Amazon DocumentDB restaurado.
Los comandos siguientes asumen que AWS CLI está configurado con su AWS región como predeterminada. Este enfoque le ahorra pasar el nombre de --region
en cada uno de los comandos. Para obtener más información, consulte Configuración de la AWS CLI. También puede especificarlo --region
en cada uno de los CLI comandos siguientes.
Creación del clon
Los parámetros específicos que se pasan al restore-db-cluster-to-point-in-time
CLI comando varían. Lo que pase dependerá del tipo de clon que desea crear.
Utilice el siguiente procedimiento para crear un clon de Amazon DocumentDB aprovisionado a partir de un clúster de Amazon DocumentDB aprovisionado.
Creación de un clon del mismo modo de motor que el clúster de base de datos de Amazon DocumentDB de origen
El siguiente ejemplo crea un clon del clúster de denominado my-clone
desde un clúster denominado my-source-cluster
.
Para Linux, macOS o Unix:
aws docdb restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier my-source-cluster
\
--db-cluster-identifier my-clone
\
--restore-type copy-on-write \
--use-latest-restorable-time
Para Windows:
aws docdb restore-db-cluster-to-point-in-time ^
--source-db-cluster-identifier my-source-cluster
^
--db-cluster-identifier my-clone
^
--restore-type copy-on-write ^
--use-latest-restorable-time
El comando devuelve el JSON objeto que contiene los detalles del clon. Compruebe que su clúster de base de datos clonado está disponible antes de intentar crear la instancia de base de datos para su clon. Para obtener más información, consulte Comprobar el estado y obtener detalles del clon a continuación:
Comprobación del estado y obtención de detalles del clon
Puede utilizar el siguiente comando para verificar el estado del clúster de base de datos vacío recién creado.
$
aws docdb describe-db-clusters --db-cluster-identifier my-clone
--query '*[].[Status]' --output text
O bien, puede obtener el estado y los demás valores que necesita para crear la instancia de base de datos para el clon mediante la siguiente AWS CLI consulta:
Para Linux, macOS o Unix:
aws docdb describe-db-clusters --db-cluster-identifier my-clone
\
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
Para Windows:
aws docdb describe-db-clusters --db-cluster-identifier my-clone
^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
Esta consulta devuelve un resultado similar al siguiente:
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
Creación de la instancia de Amazon DocumentDB para su clon
Utilice el create-db-instanceCLIcomando para crear la instancia de base de datos para el clon.
El parámetro --db-instance-class
se utiliza sólo para clústeres de base de datos aprovisionados de Amazon DocumentDB.
Para Linux, macOS o Unix:
aws docdb create-db-instance \
--db-instance-identifier my-new-db
\
--db-cluster-identifier my-clone
\
--db-instance-class db.r5.4xlarge \
--engine docdb
Para Windows:
aws docdb create-db-instance ^
--db-instance-identifier my-new-db
^
--db-cluster-identifier my-clone
^
--db-instance-class db.r5.4xlarge ^
--engine docdb
Parámetros para utilizar durante la clonación
En la siguiente tabla se resumen los diversos parámetros utilizados con restore-db-cluster-to-point-in-time
para clonar clústeres de base de datos de Amazon DocumentDB.
Parámetro |
Descripción |
--source-db-cluster-identifier |
Utilice el nombre del clúster de base de datos de Amazon DocumentDB de origen que desea clonar. |
--db-cluster-identifier |
Elija un nombre significativo para su clon. Asigne un nombre a su clon con el comando
restore-db-cluster-to-point-in-time . A continuación, pase este nombre al comando create-db-instance . |
—restore-type |
Especifique copy-on-write como el --restore-type para crear un clon del clúster de base de datos de origen en lugar de restaurar el clúster de base de datos de Amazon DocumentDB de origen. |
--use-latest-restorable-time |
Este valor apunta a los datos de volumen restaurables más recientes para el clon. |