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.
# Migración a Amazon DocumentDB sin servidor
**Topics**
+ [Migración de los clústeres de DocumentDB existentes a sistemas sin servidor](#w2aac41c19b5)
+ [Migración de MongoDB a DocumentDB sin servidor](#w2aac41c19b7)
## Migración de los clústeres de DocumentDB existentes a sistemas sin servidor
### Actualización de la versión del motor de un clúster
Si el clúster aprovisionado ejecuta una versión de motor inferior que no admite DocumentDB sin servidor, primero debe actualizar el clúster a una versión de motor compatible. Para obtener más información, consulte [Actualización local de la versión principal Amazon DocumentDB](docdb-mvu.md).
### Migración de un clúster aprovisionado a DocumentDB sin servidor
Para cambiar un clúster aprovisionado para que utilice DocumentDB sin servidor, siga estos pasos:
1. Compruebe si es preciso actualizar la versión del motor del clúster aprovisionado para usarla con DocumentDB sin servidor. Consulte [Requisitos y limitaciones de DocumentDB sin servidor](docdb-serverless-limitations.md).
**nota**
Si el clúster aprovisionado ejecuta una versión de motor que no está disponible para DocumentDB sin servidor, actualice la versión del motor del clúster: Consulte [Actualización local de la versión principal Amazon DocumentDB](docdb-mvu.md).
1. Defina la configuración de escalado del clúster. Para obtener más información sobre cómo elegir la configuración de escalado, consulte [Selección del rango de capacidad de escalado para un clúster de DocumentDB sin servidor](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Para modificar la configuración de escalado de un clúster, consulte [Visualización y modificación de la configuración del rango de capacidad de escalado de un clúster](docdb-serverless-managing.md#docdb-serverless-range-config).
1. Configure cualquier otra propiedad del clúster para tener en cuenta los requisitos y las limitaciones de DocumentDB sin servidor de [Requisitos y limitaciones de DocumentDB sin servidor](docdb-serverless-limitations.md).
1. Añada una o varias instancias de DocumentDB sin servidor al clúster. Siga el procedimiento indicado en [Añadido de una instancia de Amazon DocumentDB sin servidor](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance).
**nota**
En algunos casos, es posible que ya tenga una o más instancias de lectura aprovisionadas en el clúster. De ser así, puede optar por convertir uno de los lectores en una instancia de DocumentDB sin servidor en lugar de crear una nueva instancia. Para ello, siga el procedimiento en [Cambio de la clase de una instancia](db-instance-classes.md#db-instance-class-changing).
1. (Opcional) Realice una operación de conmutación por error para convertir una instancia de DocumentDB sin servidor en un clúster de escritura. Consulte [Conmutación por error a Amazon DocumentDB](failover.md).
1. (Opcional) Convierta las instancias de Amazon DocumentDB aprovisionadas en instancias de DocumentDB sin servidor (consulte [Cambio de la clase de una instancia](db-instance-classes.md#db-instance-class-changing)) o elimínelas del clúster (consulte [Eliminación de una instancia de Amazon DocumentDB](db-instance-delete.md)).
------
#### [ Using the Consola de administración de AWS ]
El siguiente ejemplo de Consola de administración de AWS configuración muestra el proceso de migración mediante un clúster aprovisionado de Amazon DocumentDB que ejecuta Amazon DocumentDB 5.0.0, que no requiere una actualización de la versión del motor para empezar a utilizar DocumentDB serverless. El clúster se denomina `sample` y comienza con tres instancias aprovisionadas llamadas `sample`, `sample2` y `sample3`. En este ejemplo, estas tres instancias se sustituirán por tres instancias sin servidor.
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
Aparece la tabla **Clústeres**.
1. En la tabla **Clústeres**, seleccione la casilla de verificación del clúster al que desea añadir una instancia sin servidor.
1. Elija **Actions (Acciones)** y después **Add instances (Añadir instancias)**.
1. En el cuadro de diálogo **Añadir instancias**, seleccione **Sin servidor** en la sección **Clase de instancias de base de datos** para cada nueva instancia sin servidor que desee crear.
1. En **Ajustes de capacidad sin servidor**, defina la configuración de escalado en función de la descripción de la capacidad del cuadro de diálogo.
1. (Opcional) Para añadir otra instancia, elija **Añadir instancia**. Siga añadiendo instancias hasta alcanzar el número deseado de instancias nuevas.
En este ejemplo, se crean tres nuevas instancias sin servidor.
1. Seleccione **Crear**.
La creación de una instancia puede tardar varios minutos. Puede usar la consola o la para ver el estado de la instancia AWS CLI . Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
1. Volviendo a la tabla **Clústeres**, seleccione las casillas de verificación de las tres instancias aprovisionadas originales.
1. Elija **Acciones** y, a continuación, elija **Eliminar**.
Durante la eliminación, se realiza automáticamente una conmutación por error para convertir a una de las instancias restantes en la instancia de escritura. Transcurridos unos minutos, se completa el proceso de eliminación. El clúster existente ahora contiene tres instancias de DocumentDB sin servidor (tal y como se define en la columna **Tamaño**).
------
#### [ Using the AWS CLI ]
El siguiente ejemplo de AWS CLI configuración muestra el proceso de migración mediante un clúster aprovisionado de Amazon DocumentDB que ejecuta Amazon DocumentDB 5.0.0, que no requiere una actualización de la versión del motor para empezar a utilizar DocumentDB serverless. El clúster se denomina `sample` y comienza con tres instancias aprovisionadas llamadas `sample`, `sample2` y `sample3`. En este ejemplo, estas tres instancias se sustituirán por tres instancias sin servidor. El clúster comienza se llama `sample-cluster` y empieza con dos instancias aprovisionadas llamadas `sample-provisioned-instance-1` y `sample-provisioned-instance-2`, una instancia de escritura y una de lectura.
En el siguiente ejemplo, sustituya cada uno por su propia información o *user input placeholder* parámetros de configuración.
Utilice `aws docdb describe-db-clusters` para determinar el estado de un clúster. El siguiente código busca el estado del clúster `sample-cluster` y muestra los resultados en una tabla:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Añada la configuración de escalado del clúster:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16
```
Añada las instancias sin servidor. En este ejemplo, se añaden las nuevas instancias sin servidor denominadas `sample-serverless-instance-1` y `sample-serverless-instance-2`:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-1 \
--db-instance-class db.serverless \
--engine docdb
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-2 \
--db-instance-class db.serverless \
--engine docdb
```
Introduzca lo siguiente para esperar a que las instancias sin servidor estén disponibles antes de continuar:
```
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-1
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-2
```
Realice una conmutación por error para que la nueva instancia de `sample-serverless-instance-1` sea el nuevo clúster de escritura:
```
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-1
```
La conmutación por error tarda unos segundos en completarse, tras lo cual sample-serverless-instance -1 pasa a ser el grabador del clúster. Verifíquelo con la siguiente entrada:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | False | 1 |
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Por último, elimine las instancias aprovisionadas originales:
```
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-1
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-2
```
------
## Migración de MongoDB a DocumentDB sin servidor
Puede migrar sus bases de datos de MongoDB a DocumentDB sin servidor, igual que con elementos de Amazon DocumentDB aprovisionados. Para obtener más información, consulte [Migración a Amazon DocumentDB](docdb-migration.md).