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.
# Información general de los clústeres globales de Amazon DocumentDB
## ¿Qué es un clúster global?
Un clúster global consta de una región principal y hasta 10 regiones secundarias de solo lectura. Usted emite operaciones de escritura directamente en el clúster primario de la región primaria y Amazon DocumentDB replica automáticamente los datos en las regiones secundarias utilizando una infraestructura dedicada. La latencia suele ser inferior a un segundo.
## ¿Para qué sirven los clústeres globales?
+ **Recuperación de interrupciones en toda la región**: si se produce una interrupción en toda la región, puede convertir uno de los clústeres secundarios en un clúster primario en cuestión de minutos, con un objetivo de tiempo de recuperación (RTO) típico de menos de un minuto. El objetivo de punto de recuperación (RPO) suele medirse en segundos, pero depende del desfase existente en la red en el momento del fallo.
+ **Lecturas globales con latencia local** - Si tiene oficinas en todo el mundo, puede utilizar un clúster global para mantener actualizadas sus principales fuentes de información en la región principal. Las oficinas en sus otras regiones pueden acceder a la información en su propia región, con latencia local.
+ **Clústeres secundarios escalables** - Puede escalar los clústeres secundarios agregando más instancias de solo lectura a una región secundaria. El clúster secundario es de solo lectura, por lo que puede admitir hasta 16 instancias de réplica de solo lectura en lugar del límite habitual de 15 para un solo clúster.
+ **Replicación rápida de clústeres primarios a secundarios** - La replicación realizada por un clúster global tiene poco impacto en el performance en el clúster primario. Los recursos de las instancias de bases de datos están totalmente dedicados a servir a las cargas de trabajo de lectura y escritura de la aplicación.
## ¿Cuáles son las limitaciones actuales de los clústeres globales?
+ Los clústeres globales no son compatibles con Amazon DocumentDB v3.6.
+ Los clústeres globales se admiten en todos los tipos de instancias, excepto en db.t3, db.t4g y db.r4.
+ Los clústeres globales no están disponibles en las siguientes regiones: América del Sur (São Paulo), Europa (Milán), China (Pekín) y China (Ningxia).
+ La transición y la conmutación por error global no se admiten cuando las regiones tienen versiones de motor diferentes. Se admite la conmutación por error manual cuando existe una discordancia entre las versiones del motor.
+ Solo el clúster primario realiza operaciones de escritura. Los clientes que realizan operaciones de escritura se conectan al punto de conexión del clúster primario.
+ Puede tener un máximo de 10 regiones secundarias y una región principal para su clúster.
+ No se puede detener un clúster secundario. No se puede detener un clúster primario si tiene clústeres secundarios asociados. Solo se puede detener un clúster regional que no tenga clústeres secundarios.
+ Las réplicas conectadas al clúster secundario pueden reiniciarse en determinadas circunstancias. Si la instancia de la región primaria se reinicia o falla, las réplicas de la región secundaria también se reinician. El clúster no estará disponible hasta que todas las réplicas estén nuevamente sincronizadas con la instancia del escritor del clúster de base de datos principal. Este es el comportamiento esperado. Asegúrese de comprender los impactos en la base de datos global antes de realizar cambios en el clúster primario.
+ No se pueden utilizar flujos de cambios en clústeres secundarios.
**Topics**
+ [¿Qué es un clúster global?](#w2aac33b9b3)
+ [¿Para qué sirven los clústeres globales?](#w2aac33b9b5)
+ [¿Cuáles son las limitaciones actuales de los clústeres globales?](#w2aac33b9b7)
+ [Guía de inicio rápido](global-clusters.get-started.md)
+ [Administración de clústeres globales](global-clusters.manage.md)
+ [Conexión a clústeres globales](global-clusters-connect.md)
+ [Supervisión de clústeres globales](global-clusters-monitor.md)
+ [Recuperación ante desastres](global-clusters-disaster-recovery.md)
# Guía de inicio rápido: clústeres globales
**Topics**
+ [Configuración](#global-clusters.config)
+ [Creación de un clúster global](#global-clusters-create)
+ [Añadido de una región a un clúster global](#global-clusters.add-region)
+ [Uso de una instantánea](#global-clusters.snapshot)
## Configuración
El clúster global de Amazon DocumentDB abarca al menos dos. Regiones de AWS La región principal admite un clúster que tiene una instancia principal (de escritura) y hasta 15 instancias de réplica, mientras que la región secundaria ejecuta un clúster de solo lectura compuesto en su totalidad por un máximo de 16 instancias de réplica. Un clúster global puede tener hasta cinco regiones secundarias. La tabla muestra el máximo de clústeres, instancias y réplicas permitidos en clúster global.
| Description (Descripción) | Primario Región de AWS | Secundario Región de AWS |
| --- | --- | --- |
| Clústeres | 1 | 5 (máximo) |
| Instancias de escritor | 1 | 0 |
| Instancias de solo lectura (réplicas de Amazon DocumentDB), por clúster | 15 (máx.) | 16 (total) |
| Instancias de solo lectura (máximo permitido, dado el número real de Regiones secundarias) | 15 - s | s = número total de secundarios Regiones de AWS |
Los clústeres tienen los siguientes requisitos específicos:
+ **Requisitos de clase de instancia de base de datos**: solo puede usar las clases de instancia `db.r5` y `db.r6g`.
+ **Región de AWS requisitos**: el clúster principal debe estar en una región y al menos un clúster secundario debe estar en una región diferente de la misma cuenta. Puede crear hasta cinco clústeres secundarios (de solo lectura) y cada uno debe estar en una región diferente. En otras palabras, no puede haber dos clústeres en la misma región.
+ **Requisitos de nomenclatura**: los nombres que elija para cada uno de los clústeres deben ser únicos, en todas las regiones. No puede usar el mismo nombre para diferentes clústeres aunque estén en diferentes regiones.
## Creación de un clúster global de Amazon DocumentDB
¿Está preparado para compilar su primer clúster global? En esta sección, explicaremos cómo crear un clúster global completamente nuevo con nuevos clústeres e instancias de bases de datos, utilizando las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones.
### Usando el Consola de administración de AWS
1. En Consola de administración de AWS, vaya a **Amazon DocumentDB**.
1. Cuando llegue a la consola de Amazon DocumentDB, elija **Clústeres**.
![\[La página Clústeres de la consola de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Seleccione **Crear**.
![\[El botón Crear se muestra en la esquina superior derecha de la tabla Clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. Rellene la sección **Configuración** del formulario **Crear un clúster de Amazon DocumentDB** según corresponda:
+ **Identificador de clúster** puede escribir un identificador único para esta instancia o permitir que Amazon DocumentDB proporcione el identificador de la instancia basándose en el identificador del clúster.
+ Elija la versión del motor **4.0.0**
+ Clase de instancia: elija **db.r5.large**
+ Número de instancias: elija **3**.
![\[Formulario de opciones de configuración para crear un clúster de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. En la sección **Autenticación**, introduzca un nombre de usuario maestro y una contraseña maestra.
![\[Formulario de autenticación para especificar un nombre de usuario y una contraseña maestros para un nuevo clúster de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. Seleccione **Mostrar configuración avanzada**.
![\[Muestre el botón de configuración avanzada junto a los botones Cancelar y Crear clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. En la sección **Configuración de red**:
+ Mantenga las opciones predeterminadas para la **Nube privada virtual (VPC)** y el **Grupo de subredes**.
![\[Formulario de configuración de red en el que se muestran las opciones de VPC, grupo de subredes y grupos de seguridad de VPC. Los campos VPC y grupo de subredes tienen seleccionadas las opciones predeterminadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ Para los **grupos de seguridad de VPC**, la **(VPC) predeterminada** ya debería estar añadida.
![\[Formulario de configuración de red que en el que se muestra la VPC predeterminada ya añadida.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ Escriba `DocDB` en el campo **Grupos de seguridad de VPC** y seleccione **DocDB-Inbound (VFC)**.
![\[El VFC entrante de DocDB se selecciona en el menú desplegable de Grupos de seguridad de VPC.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. Para **las opciones de clúster** y **E ncryption-at-rest**, deje las selecciones predeterminadas.
![\[Agrupe las opciones y los Encryption-at-rest formularios con las opciones predeterminadas seleccionadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. Para **Copia de seguridad** y **Exportaciones de registros**, deje las selecciones predeterminadas.
![\[Copia de seguridad y formularios de exportación de registros con las opciones predeterminadas seleccionadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. Para **Mantenimiento**, **Etiquetas** y **Protección contra eliminación**, deje las selecciones predeterminadas.
![\[Formularios de mantenimiento, etiquetas y protección contra eliminación con las opciones predeterminadas seleccionadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Ahora haga clic en el botón que dice **Crear clúster**.
![\[El botón Crear clúster se muestra al final del proceso de creación del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### Uso del AWS CLI
Para crear un clúster regional de Amazon DocumentDB, llame a. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) El siguiente AWS CLI comando crea un clúster de Amazon DocumentDB denominado. `global-cluster-id` Para obtener más información sobre la protección contra eliminación, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md).
Además, `--engine-version` es un parámetro opcional que utiliza de forma predeterminada la última versión principal del motor. La versión predeterminada actual del motor es `5.0.0` (nota: Amazon DocumentDB 8.0 está disponible, pero debe especificarse explícitamente como`8.0.0`). Cuando se publiquen nuevas versiones principales del motor, la versión del motor predeterminada para `--engine-version` se actualizará para reflejar la última versión principal del motor. En consecuencia, para las cargas de trabajo de producción, y especialmente las que dependen de la creación de scripts, la automatización o CloudFormation las plantillas, le recomendamos que especifique de forma explícita la `--engine-version` versión principal prevista.
Si no se especifica un `db-subnet-group-name` o un `vpc-security-group-id`, Amazon DocumentDB utilizará el grupo de subredes y el grupo de seguridad de Amazon VPC predeterminados para la región determinada.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Para Windows:
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
La creación del clúster puede tardar varios minutos. Puede utilizar la Consola de administración de AWS o AWS CLI para supervisar el estado de su clúster. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**importante**
Al utilizar el AWS CLI para crear un clúster regional de Amazon DocumentDB, no se crea ninguna instancia. Por lo tanto, tendrá que crear de forma explícita una instancia principal y las instancias de réplica que necesite. Puede usar la consola o AWS CLI para crear las instancias. Para obtener más información, consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md) y [CreateDBCluster](API_CreateDBCluster.md) en la Referencia de la API de Amazon DocumentDB.
Una vez que su clúster regional esté disponible, puede añadir un clúster secundario en otra región con las siguientes instrucciones: [Añadir un Región de AWS a un clúster global de Amazon DocumentDB](#global-clusters.add-region). Cuando añada una región, su clúster regional se convierte en su clúster principal y tiene un nuevo clúster secundario en la región que ha elegido.
## Añadir un Región de AWS a un clúster global de Amazon DocumentDB
Un clúster global necesita al menos un clúster secundario en una región diferente a la del clúster principal, y puede añadir hasta cinco clústeres secundarios. Para cada clúster secundario que agregue, deberá reducir el número de réplicas permitidas al clúster principal en una. Por ejemplo, si su clúster global tiene cinco regiones secundarias, el clúster principal puede tener solamente 10 (en lugar de 15) réplicas. Para obtener más información, consulte [Requisitos de configuración de un clúster global de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### Uso del Consola de administración de AWS
1. Inicie sesión en la consola de Amazon DocumentDB Consola de administración de AWS y ábrala.
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
![\[La página Clústeres de la consola de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Elija el clúster al que desearía agregar un clúster secundario. Asegúrese de que el clúster es `Available`.
![\[Lista de clústeres regionales y globales en la que se muestra el estado de disponibilidad, con mydocdbglobalcluster resaltado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. Seleccione el menú desplegable **Acciones** y, a continuación, seleccione **Añadir región**.
![\[El menú desplegable Acciones de la interfaz Clústeres muestra la opción Añadir región.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. En la página **Añadir una Región de AWS**, seleccione la región secundaria. No puede elegir una región que ya tenga un clúster secundario para el mismo clúster global. Además, no puede ser la misma región que el clúster principal. Si es la primera región que va a añadir, también tendrá que especificar un identificador de clúster global de su elección.
![\[Elija una región secundaria mediante el menú desplegable del formulario Añadir un Región de AWS formulario.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. Complete los campos restantes para el clúster secundario en la nueva región, luego seleccione **Crear clúster**. Después de terminar de añadir la región, puede verla en la lista de **Clústeres** en la Consola de administración de AWS.
![\[Los pasos finales para añadir una región a un clúster, en los que se incluyen el formulario de configuración, la estimación del costo por hora y el botón Crear clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### Usando el AWS CLI
+ Utilice el comando `create-db-cluster` CLI con el nombre `(--global-cluster-identifier)` del clúster global. Para otros parámetros, haga lo siguiente:
+ Para `--region` ello, elija una región Región de AWS diferente a la de su región principal.
+ Elija valores específicos para los parámetros `--engine` y `--engine-version`.
+ En el caso de un clúster cifrado, especifique el principal Región de AWS como el `--source-region` de cifrado.
En el ejemplo siguiente se crea un nuevo clúster de Amazon DocumentDB y se adjunta al clúster global como clúster secundario de solo lectura. En el último paso, se agrega una instancia al nuevo clúster.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o Unix:
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Para Windows:
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Uso de una instantánea para el clúster global de Amazon DocumentDB
Puede restaurar una instantánea de un clúster de Amazon DocumentDB para utilizarla como punto de partida del clúster global. Para ello, debe restaurar la instantánea y crear un nuevo clúster. Servirá como el clúster principal de su clúster global. A continuación, añada otra región al clúster restaurado, convirtiéndolo así en clúster global.
# Administración de un clúster global de Amazon DocumentDB
Puede realizar la mayor parte de las operaciones de administración en los clústeres individuales que componen un clúster global. Cuando selecciona **Recursos relacionados con grupos** en la página **Clústeres** de la consola, verá el clúster primario y los clústeres secundarios agrupados bajo el objeto de clúster global asociado.
La pestaña **Configuración** de un clúster global muestra Regiones de AWS dónde se ejecutan los clústeres, la versión y el identificador del clúster global.
**Topics**
+ [Modificación de clústeres globales](#global-clusters.modify)
+ [Modificación de los parámetros](#global-clusters.modify-parameters)
+ [Eliminación de clústeres globales](#global-clusters.remove)
+ [Eliminación de clústeres globales](#global-clusters.delete)
+ [Clústeres sin periféricos](#global-clusters.headless)
## Modificación de un clúster global de Amazon DocumentDB
La página **Clústeres** de la Consola de administración de AWS lista incluye todos los clústeres globales y muestra el clúster principal y los clústeres secundarios de cada uno. El clúster global tiene sus propias opciones de configuración. Específicamente, tiene regiones de asociadas con sus clústeres principal y secundario.
Al realizar cambios en el clúster global, tiene la oportunidad de cancelar los cambios.
Al seleccionar Continue (Continuar), confirma los cambios.
## Modificación de los parámetros de un clúster global de Amazon DocumentDB
Puede configurar los grupos de parámetros de clúster independientemente para cada clúster dentro del clúster global. La mayoría de parámetros funcionan igual que para otros tipos de clústeres de Amazon DocumentDB. Se recomienda mantener la configuración coherente entre todos los clústeres de un clúster global. Esto ayuda a evitar cambios de comportamiento inesperados si se promueve un clúster secundario para que sea el principal.
Por ejemplo, utilice la misma configuración de zonas horarias y conjuntos de caracteres para evitar un comportamiento incoherente si un clúster diferente asume la función del clúster principal.
## Eliminación de un clúster global de Amazon DocumentDB
Hay varias situaciones en las que es posible que desee eliminar clústeres de su clúster global. Por ejemplo, es posible que desee quitar un clúster de un clúster global si el clúster principal se degrada o se aísla. A continuación, se convierte en un clúster provisionado independiente que podría utilizarse para crear un nuevo clúster global. Para obtener más información, consulte [Ejecución de una conmutación por error manual para un clúster global de Amazon DocumentDB](global-clusters-disaster-recovery.md#manual-failover).
También puede querer quitar clústeres porque desea eliminar un clúster global que ya no necesite. No puede eliminar el clúster global hasta después de eliminar (desasociar) todos los clústeres asociados y deje el principal para lo último. Para obtener más información, consulte [Eliminación de un clúster global de Amazon DocumentDB](#global-clusters.delete).
**nota**
Cuando un clúster se desasocia del clúster global, ya no se sincroniza con el principal. Se convierte en un clúster aprovisionado independiente con todas read/write las capacidades. Además, ya no está visible en la consola de Amazon DocumentDB. Solo está visible cuando selecciona la región de la consola en la que estaba ubicado el clúster.
Puede eliminar clústeres de su clúster global mediante la Consola de administración de AWS, la o la AWS CLI API de RDS.
------
#### [ Using the Consola de administración de AWS ]
1. Inicie sesión en la consola de Amazon DocumentDB Consola de administración de AWS y navegue hasta ella.
1. En el panel de navegación izquierdo, elija **Clústeres**.
![\[Imagen: cuadro de navegación de clústeres que muestra una lista de los enlaces de clústeres existentes y sus correspondientes enlaces de instancia.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Amplíe el clúster global para que pueda ver todos los clústeres secundarios. Seleccione los clústeres secundarios que desee eliminar. Selecciona **Acciones** y, en el menú desplegable, selecciona **Eliminar del mapa global**.
![\[Imagen: cuadro de navegación de clústeres que muestra la selección de un clúster secundario existente y resalta la acción “Eliminar de global”.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/remove-global.png)
1. Abra un mensaje para confirmar que desea separar el secundario del clúster global. Elija **Eliminar y promover** para quitar el clúster del clúster global.
![\[Imagen: mensaje Eliminar y promocionar.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/remove-promote.png)
El clúster ya no sirve como secundario y ya no está sincronizado con el clúster principal. Se trata de un clúster independiente con capacidad total read/write .
Tras eliminar o borrar todos los clústeres secundarios, podrá eliminar el clúster principal del mismo modo. No puede separar o quitar el clúster principal de un clúster global hasta después de quitar todos los clústeres secundarios. Es posible que el clúster global permanezca en la lista de clústeres, con cero regiones y AZs. Puede eliminar si ya no desea utilizar este clúster global.
------
#### [ Using the AWS CLI ]
Para eliminar un clúster de un clúster global, ejecute el comando CLI `remove-from-global-cluster` con los siguientes parámetros:
+ `--global-cluster-identifier`: nombre (identificador) del clúster global.
+ `--db-cluster-identifier`: nombre de cada clúster que se va a quitar del clúster global.
Los siguientes comandos eliminan un clúster secundario y, después, el clúster primario de un clúster global.
Para Linux, macOS o Unix:
```
aws docdb --region secondary_region \
remove-from-global-cluster \
--db-cluster-identifier secondary_cluster_ARN \
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region \
remove-from-global-cluster \
--db-cluster-identifier primary_cluster_ARN \
--global-cluster-identifier global_cluster_id
```
Repita el comando `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN`para cada región secundaria de su clúster global.
Para Windows:
```
aws docdb --region secondary_region ^
remove-from-global-cluster ^
--db-cluster-identifier secondary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region ^
remove-from-global-cluster ^
--db-cluster-identifier primary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
```
Repita el comando `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN`para cada región secundaria de su clúster global.
------
## Eliminación de un clúster global de Amazon DocumentDB
Para completar la eliminación de un clúster global, siga estos pasos:
+ Elimine todas las regiones secundarias del clúster global. Cada clúster se convierte en un clúster independiente. Consulte la sección anterior,[Eliminación de un clúster global de Amazon DocumentDB](#global-clusters.remove).
+ En cada clúster independiente, elimine todas las réplicas.
+ Elimine el clúster secundario del clúster global. Esto se convierte en un clúster independiente.
+ Desde el clúster principal, primero elimine todas las réplicas y, a continuación, elimine la instancia primaria. La eliminación de la instancia de escritor del clúster recién independiente también normalmente elimina el clúster y el clúster global.
------
#### [ Using the Consola de administración de AWS ]
1. Inicie sesión en la consola de Amazon DocumentDB Consola de administración de AWS y navegue hasta ella.
1. Elija **Clústeres** y busque el clúster global que desea eliminar.
![\[Imagen: cuadro de navegación de clústeres que muestra una lista de los enlaces de clústeres existentes y sus correspondientes enlaces de instancia.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Con el clúster global seleccionado, selecciona **Eliminar** en el menú **Acciones**.
![\[Imagen: cuadro de navegación de clústeres que muestra la selección de un clúster global y resalta la acción “Eliminar”.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)
Confirme que todos los demás clústeres se han borrado del clúster global. El clúster global debe mostrar cero regiones AZs y un tamaño igual a cero clústeres. Si el clúster global contiene clústeres, no puede eliminarla. Primero tendrá que seguir las instrucciones del paso anterior, **[Eliminación de un clúster global de Amazon DocumentDB](#global-clusters.remove)**.
------
#### [ Using the AWS CLI ]
Para eliminar un clúster global, ejecute el comando `delete-global-cluster` CLI con el nombre Región de AWS y el identificador del clúster global, como se muestra en el siguiente ejemplo.
Para Linux, macOS o Unix:
```
aws docdb --region primary_region delete-global-cluster \
--global-cluster-identifier global_cluster_id
```
Para Windows:
```
aws docdb --region primary_region delete-global-cluster ^
--global-cluster-identifier global_cluster_id
```
------
## Creación de un clúster de Amazon DocumentDB sin pantalla en una región secundaria
Si bien un clúster global de Amazon DocumentDB requiere al menos un clúster secundario Región de AWS distinto del principal, puede usar una configuración headless para el clúster secundario. Un clúster secundario de Amazon DocumentDB sin pantalla es uno sin una instancia. Este tipo de configuración puede reducir los gastos para un clúster global. En un clúster de Amazon DocumentDB, se desacoplan la informática y el almacenamiento. Sin la instancia, no se le cobrará por la informática, solo por almacenamiento. Si está configurado correctamente, el volumen de almacenamiento de un clúster secundario sin pantalla se mantiene sincronizado con el clúster principal.
Agregue el clúster secundario como lo hace normalmente al crear un clúster global de Amazon DocumentDB. Sin embargo, después de que el clúster principal comience la reproducción en el secundario, se elimina la instancia de solo lectura del clúster secundario. Ahora, este clúster secundario se considera “sin pantalla” porque ya no tiene una instancia. Sin embargo, el volumen de almacenamiento se mantiene sincronizado con el clúster principal de Amazon DocumentDB.
**importante**
Solo recomendamos los clústeres headless a los clientes que puedan tolerar errores en toda la región durante más de 15 minutos. Esto se debe a que, para recuperarse de un error en toda la región con un clúster secundario independiente, el usuario tendrá que crear una nueva instancia tras la conmutación por error. Una nueva instancia puede tardar entre 10 y 15 minutos en estar disponible.
### Cómo agregar un clúster secundario sin pantalla a su clúster global
1. Inicie sesión en la consola de [Amazon DocumentDB Consola de administración de AWS](https://console.aws.amazon.com/rds/) y ábrala.
1. En el panel de navegación izquierdo, elija **Clústeres**.
1. Elija el clúster global que necesita un clúster secundario. Asegúrese de que el clúster principal es.`Available`
1. En **Actions (Acciones)**, elija **Add region (Añadir región)**.
1. En la página **Añadir una región**, seleccione la región secundaria.
**nota**
No puede elegir una región que ya tenga un clúster secundario para el mismo clúster global. Además, no puede ser la misma región que el clúster principal.
1. Complete los campos restantes para el clúster secundario de en la nueva región de. Estas son las mismas opciones de configuración que para cualquier instancia de clúster.
1. Agregar región. Después de terminar de agregar la región al clúster global, puede verla en la lista de`Clusters` de la Consola de administración de AWS.
1. Compruebe el estado del clúster secundario y de su instancia de lectura antes de continuar, utilizando el Consola de administración de AWS o el AWS CLI. A continuación, se muestra un ejemplo de comando si usa la AWS CLI:
```
$ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
```
El estado de un clúster secundario recién agregado puede tardar varios minutos en cambiar de “creación en curso” a “disponible”. Cuando el clúster se encuentra disponible, puede eliminar la instancia de lector.
1. Seleccione la instancia de lector en el clúster secundario y, a continuación, elija **Eliminar**.
1. Después de eliminar la instancia de lector, el clúster secundario sigue siendo parte del clúster global. No debe tener ninguna instancia asociada con él.
**nota**
Puede utilizar este clúster secundario de Amazon DocumentDB sin pantalla para recuperar manualmente su clúster global de Amazon DocumentDB de una interrupción no planificada en la región principal si se produce una interrupción de este tipo.
# Conexión a un clúster global de Amazon DocumentDB
La forma de conectarse a un clúster global depende de si necesita escribir en el clúster o leer del clúster:
+ Para solicitudes o consultas de solo lectura, debe conectarse al punto de conexión del lector para el clúster en Región de AWS.
+ Para ejecutar instrucciones en lenguaje de manipulación de datos (DML) o lenguaje de definición de datos (DDL), conecte el punto de conexión del clúster para el clúster principal. Es posible que este punto final esté en un lugar diferente al de tu aplicación. Región de AWS
Cuando visualice un clúster global en la consola, podrá ver todos los puntos de conexión de uso general asociados a todos sus clústeres.
La forma de conectarse a un clúster global depende de si necesita escribir en la base de datos o leer de ella. Para las operaciones de DDL, DML y lectura que desee realizar desde la región principal, debe conectarse a su clúster primario. Le recomendamos que se conecte a su clúster primario utilizando el punto de conexión del clúster en modo de conjunto de réplicas, con una preferencia de lectura de `secondaryPreferred=true`. Esto redirigirá el tráfico de escritura a la instancia de escritor del clúster primario y el tráfico de lectura a la instancia de réplica del clúster primario.
Para el tráfico de solo lectura entre regiones, debe conectarse a uno de sus clústeres secundarios. Le recomendamos que se conecte a su clúster secundario mediante el punto de conexión del clúster en modo de conjunto de réplicas. Como todas las instancias son réplicas de solo lectura, no es necesario especificar una preferencia de lectura. Para minimizar la latencia, elija el punto de conexión del lector en su región o en la región que tenga más cerca.
# Supervisión de clústeres globales de Amazon DocumentDB
Amazon DocumentDB (compatible con MongoDB) se integra CloudWatch para que pueda recopilar y analizar las métricas operativas de sus clústeres. Puede supervisar estas métricas mediante la CloudWatch consola, la consola Amazon DocumentDB, AWS Command Line Interface (AWS CLI) o la CloudWatch API.
Para monitorear un clúster global, utilice las siguientes CloudWatch métricas.
| Métrica | Description (Descripción) |
| --- | --- |
| GlobalClusterReplicatedWriteIO | El número medio de I/O operaciones de escritura facturadas que se replican desde el volumen del clúster en el principal Región de AWS hasta el volumen del clúster en el secundario Región de AWS, y se informa a intervalos de 5 minutos. El número de réplicas de ReplicatedWriteIOs de cada región secundaria es el mismo que el número de VolumeWriteIOPs en región realizadas por la región principal. |
| GlobalClusterDataTransferBytes | La cantidad de datos transferidos del clúster principal Región de AWS al clúster secundario Región de AWS, medida en bytes. |
| GlobalClusterReplicationLag | La cantidad de retraso, en milisegundos, al replicar los eventos de cambio del clúster principal Región de AWS a un clúster secundario Región de AWS |
Para obtener más información sobre cómo ver estas métricas, consulta [Visualización de CloudWatch datos](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data).
# Recuperación ante desastres y clústeres globales de Amazon DocumentDB
**Topics**
+ [Ejecución de una conmutación por error administrada para un clúster global de Amazon DocumentDB](#managed-failover)
+ [Ejecución de una conmutación por error manual para un clúster global de Amazon DocumentDB](#manual-failover)
+ [Ejecución de una transición para un clúster global de Amazon DocumentDB](#global-cluster-switchover)
+ [Desbloqueo de una conmutación por error o una transición de clúster global](#unblocking-gc-so-fo)
Al utilizar un clúster global, puede recuperarse rápidamente de desastres como errores de región. La recuperación de desastres suele medirse mediante valores para RTO y RPO.
+ **Objetivo de tiempo de recuperación (RTO)** – El tiempo que tarda un sistema en volver a un estado operativo después de un desastre. En otras palabras, el RTO mide el tiempo de inactividad. Para un clúster global, RTO en minutos.
+ **Objetivo de punto de recuperación (RPO)** – La cantidad de datos que se pueden perder (medidos en el tiempo). Para un clúster global, el RPO suele medirse en segundos.
+ Para recuperarse de una interrupción imprevista, puede realizar una conmutación por error entre regiones en uno de los secundarios de su clúster global. Cuando su clúster global tenga varias regiones secundarias, asegúrese de separar todas las regiones secundarias que desea promover a primarias. Después, promocione una de esas regiones secundarias para que sea la nueva Región de AWS principal. Por último, creará nuevos clústeres en cada una de las demás regiones secundarias y adjuntará esos clústeres a su clúster global.
## Ejecución de una conmutación por error administrada para un clúster global de Amazon DocumentDB
Este enfoque tiene por objeto garantizar la continuidad empresarial en caso de que se produzca un verdadero desastre regional o una interrupción total del nivel de servicio.
Durante una conmutación por error administrada, el clúster principal se conmuta por error a la región secundaria que elija mientras se mantiene la topología de reproducción existente del clúster global de Amazon DocumentDB. El clúster secundario elegido promueve uno de sus nodos de solo de lectura al estado de escritor completo. Este paso permite que el clúster asuma el rol de clúster principal. La base de datos no estará disponible durante un breve periodo, mientras el clúster asume su nuevo rol. Los datos que no se replicaron del clúster principal anterior al clúster secundario elegido se pueden perder cuando este clúster secundario se convierta en el nuevo clúster principal. El volumen principal anterior hace todo lo posible por tomar una instantánea antes de sincronizarla con el nuevo volumen principal, de modo que los datos no replicados se conserven en la instantánea.
**nota**
Solo puede hacer una conmutación por error administrada del clúster entre regiones en un clúster global de Amazon DocumentDB si el clúster principal y todos los clústeres secundarios tienen las mismas versiones del motor. Si las versiones del motor no son compatibles, puede realizar la conmutación por error manualmente por medio de los pasos que se indican en [Ejecución de una conmutación por error manual para un clúster global de Amazon DocumentDB](#manual-failover).
Si las versiones del motor de la región no coinciden, se bloqueará la conmutación por error Compruebe si hay actualizaciones pendientes y aplíquelas para garantizar que todas las versiones de motores de la región coincidan y que la conmutación por error global del clúster esté desbloqueada. Para obtener más información, consulte [Desbloqueo de una conmutación por error o una transición de clúster global](#unblocking-gc-so-fo).
Para minimizar la pérdida de datos, le recomendamos que haga lo siguiente antes de utilizar esta característica:
+ Desconecte las aplicaciones para evitar que se envíen escrituras al clúster principal del clúster global de Amazon DocumentDB.
+ Compruebe los tiempos de retraso para todos los clústeres secundarios de Amazon DocumentDB. La elección de la región secundaria con el menor retraso de replicación puede minimizar la pérdida de datos con respecto a la región principal que actualmente presenta errores. Compruebe los tiempos de retraso de todos los clústeres secundarios de Amazon DocumentDB del clúster global consultando la `GlobalClusterReplicationLag` métrica en Amazon. CloudWatch Estas métricas muestran el retraso (en milisegundos) de la replicación a un clúster secundario con respecto al clúster principal.
Para obtener más información sobre CloudWatch las métricas de Amazon DocumentDB, consulte. [Métricas de Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
Durante una conmutación por error administrada, el clúster secundario elegido se promueve a su nuevo rol de clúster principal. Sin embargo, no hereda las diversas opciones de configuración del clúster principal. Una falta de coincidencia en la configuración puede provocar problemas de rendimiento, incompatibilidades de carga de trabajo y otros comportamientos anómalos. Para evitar estos problemas, recomendamos que se resuelvan las diferencias entre los clústeres globales de Amazon DocumentDB para lo siguiente:
+ **Configure un grupo de parámetros de clúster de Amazon DocumentDB para el nuevo clúster principal, si es necesario**: puede configurar los grupos de parámetros de clúster de Amazon DocumentDB de forma independiente para cada clúster del clúster global de Amazon DocumentDB. Por lo tanto, cuando se promueve un clúster secundario para que asuma el rol principal, su grupo de parámetros puede configurarse de manera diferente que para el principal. Si es así, modifique el grupo de parámetros del clúster secundario promocionado para que se ajuste a la configuración del clúster principal. Para aprender a hacerlo, consulte [Modificación de grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ **Configure las herramientas y opciones de monitoreo, como CloudWatch los eventos y las alarmas de Amazon**: configure el clúster promocionado con la misma capacidad de registro, alarmas, etc., según sea necesario para el clúster global. Al igual que con los grupos de parámetros, la configuración de estas características no se hereda del clúster principal durante el proceso de conmutación por error. Algunas CloudWatch métricas, como el retraso en la replicación, solo están disponibles para las regiones secundarias. Por lo tanto, una conmutación por error cambia la forma de ver esas métricas y configurar las alarmas en ellas, y podría requerir cambios en los paneles predefinidos. Para obtener más información sobre los clústeres de Amazon DocumentDB y la supervisión, consulte [Monitorización de Amazon DocumentDB](monitoring_docdb.md).
Por lo general, el clúster secundario elegido asume el rol principal en menos de un minuto. En cuanto el nodo de escritor de la nueva región principal esté disponible, podrá conectar sus aplicaciones a él y reanudar sus cargas de trabajo. Una vez que Amazon DocumentDB promueve el nuevo clúster principal, reconstruye automáticamente todos los clústeres regionales secundarios adicionales.
Como los clústeres globales de Amazon DocumentDB utilizan la replicación asíncrona, el retraso de la replicación en cada región secundaria puede variar. Amazon DocumentDB reconstruye estas regiones secundarias para que tengan exactamente los mismos point-in-time datos que el nuevo clúster de regiones principal. La duración de la tarea de reconstrucción completa puede tardar entre unos minutos y varias horas, según el tamaño del volumen de almacenamiento y la distancia entre las regiones. Cuando los clústeres de la región secundaria terminen de reconstruirse a partir de la nueva región principal, estarán disponibles para el acceso de lectura. Tan pronto como se promocione y esté disponible el nuevo escritor principal, el clúster de la nueva región principal podrá gestionar las operaciones de lectura y escritura del clúster global de Amazon DocumentDB.
Para restaurar la topología original del clúster global, Amazon DocumentDB supervisa la disponibilidad de la antigua región principal. Tan pronto como la región esté en buen estado y vuelva a estar disponible, Amazon DocumentDB volverá a agregarla automáticamente al clúster global como región secundaria. Antes de crear el nuevo volumen de almacenamiento en la antigua región principal, Amazon DocumentDB intenta tomar una instantánea del volumen de almacenamiento anterior en el punto en que se produjo el error. Lo hace para que pueda usarla para recuperar cualquiera de los datos perdidos. Si esta operación se realiza correctamente, Amazon DocumentDB coloca esta instantánea denominada «rds: docdb-unplanned-global-failover - name-of-old-primary -DB-Cluster-Timestamp» en la sección de instantáneas del. Consola de administración de AWS También puede ver esta instantánea en la información devuelta por la operación de la API `DescribeDBClusterSnapshots`.
**nota**
La instantánea del volumen de almacenamiento anterior es una instantánea del sistema que está sujeta al período de retención de la copia de seguridad configurado en el clúster principal anterior. Para conservar esta instantánea más allá del período de retención, puede copiarla para guardarla como una instantánea manual. Para obtener más información sobre la copia de instantáneas, incluido el precio, consulte [Copia de una instantánea de clúster](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot).
Una vez restaurada la topología original, puede conmutar por recuperación el clúster global a la región principal original mediante una operación de transición cuando sea más conveniente para su empresa y su carga de trabajo. Para ello, siga los pasos que se indican en [Ejecución de una transición para un clúster global de Amazon DocumentDB](#global-cluster-switchover).
Puede realizar una conmutación por error de su clúster global de Amazon DocumentDB mediante la Consola de administración de AWS, la o la AWS CLI API de Amazon DocumentDB.
------
#### [ Using the Consola de administración de AWS ]
**Ejecución de una conmutación por error administrada en el clúster global de Amazon DocumentDB**
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. Busque y elija el clúster global de Amazon DocumentDB que desea someter al proceso de conmutación por error.
![\[Imagen: tabla de clústeres con el clúster global seleccionado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. Elija **Transición o conmutación por error** en el menú **Acciones**.
1. En el cuadro de diálogo que aparece, seleccione **Conmutación por error** y, a continuación, elija el clúster secundario en la lista desplegable del campo **Nuevo clúster principal**.
![\[Imagen: cuadro de diálogo de transición o conmutación por error de clúster global.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. Escriba “confirmar” en el último campo. A continuación, seleccione **Confirm (Confirmar)**.
El estado del clúster principal cambia a “**Conmutación por error**”. Esta condición puede necesitar aproximadamente un minuto. Durante este tiempo, el estado del nuevo clúster principal muestra “**Modificando…**”. Una vez que se promocione el nuevo clúster principal, aparecerá como “**Disponible**” y podrá procesar transacciones de lectura y escritura. Las regiones secundarias, incluida la antigua principal, mostrarán el mensaje “**Resincronizando…**” mientras se vuelve a sincronizar con el nuevo clúster principal. Al igual que el nuevo clúster principal, solo podrá procesar transacciones una vez que su estado cambie a “**Disponible**”.
1. Cuando se complete, el clúster principal original se convierte en el clúster secundario. El clúster secundario seleccionado se convierte en el clúster principal.
![\[Imagen: tabla de clústeres que muestra el nuevo clúster principal.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Ejecución de una conmutación por error administrada en el clúster global de Amazon DocumentDB**
Ejecute el comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html) de la CLI para conmutar por error el clúster global de Amazon DocumentDB. Con el comando, pase valores para las siguientes opciones:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
En los siguientes ejemplos, sustituya cada uno por la información *user input placeholder* de su clúster.
Para Linux, macOS o Unix:
```
aws docdb failover-global-cluster \
--region region_of_selected_secondary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote \
--allow-data-loss
```
Para Windows:
```
aws docdb failover-global-cluster ^
--region region_of_selected_secondary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote ^
--allow-data-loss
```
------
## Ejecución de una conmutación por error manual para un clúster global de Amazon DocumentDB
Si un clúster completo de uno Región de AWS deja de estar disponible, puedes promover otro clúster del clúster global para que tenga esa read/write capacidad.
Puede activar manualmente el mecanismo de conmutación por error del clúster global si un clúster de una Región de AWS diferente es una mejor opción para ser el clúster primario. Por ejemplo, puede aumentar la capacidad de uno de esos clústeres secundarios y promoverlo para que sea el clúster principal. O bien, el equilibrio de la actividad entre ellos Regiones de AWS podría cambiar, por lo que cambiar el clúster principal a otro Región de AWS podría reducir la latencia de las operaciones de escritura.
El siguiente procedimiento describe qué hacer para promocionar uno de los clústeres secundarios de un clúster global de Amazon DocumentDB.
Para promover un clúster secundario:
1. Tras la interrupción, deje de emitir sentencias DML y otras operaciones de escritura en el Región de AWS clúster principal.
1. Identifique un clúster de un secundario Región de AWS para usarlo como un nuevo clúster principal. Si tiene dos (o más) secundarios Regiones de AWS en su clúster global, elija el clúster secundario que tenga el menor tiempo de retraso.
1. Desconecte el clúster secundario del clúster global elegido.
Al eliminar un clúster secundario de un clúster global, se detiene inmediatamente la replicación del clúster principal a este secundario y se convierte en un clúster aprovisionado independiente con todas read/write las capacidades. Todavía está disponible cualquier otro clúster secundario asociado con el clúster primario de la región con la interrupción y puede aceptar llamadas desde la aplicación. También consumen recursos. Dado que está recreando el clúster global, para evitar problemas de split-brain y otros problemas, elimine los otros clústeres secundarios antes de crear el nuevo clúster en los pasos que se indican a continuación.
Para obtener más información sobre los pasos para desasociar clústeres, consulte [Eliminación de un clúster global de Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove).
1. Este clúster se convierte en el clúster primario de un nuevo clúster global cuando comienza a agregarle regiones, en el siguiente paso.
1. Agregue un elemento Región de AWS al clúster. Al hacerlo, comienza el proceso de reproducción de clúster principal a secundario.
1. Agregue más Regiones de AWS según sea necesario para volver a crear la topología necesaria para respaldar su aplicación. Asegúrese de que las escrituras de la aplicación se envían al clúster correcto antes, durante y después de realizar cambios como estos, para evitar incoherencias de datos entre los clústeres en el clúster global (problemas de split-brain).
1. Cuando se haya resuelto la interrupción y esté listo para asignar su Región de AWS original como clúster primario de nuevo, realice los mismos pasos en orden inverso.
1. Elimine uno de los clústeres secundarios del clúster global. Esto le permitirá atender read/write el tráfico.
1. Redirija todo el tráfico de escritura del clúster primario en la Región de AWS original.
1. Agregue un Región de AWS para configurar uno o más clústeres secundarios de la Región de AWS misma manera que antes.
Los clústeres globales de Amazon DocumentDB se pueden administrar mediante AWS SDKs, lo que le permite crear soluciones para automatizar el proceso de conmutación por error de clústeres globales para casos de uso de recuperación ante desastres y planificación de la continuidad empresarial. Una de estas soluciones está disponible para nuestros clientes con las licencias de Apache 2.0 y se puede acceder a ella desde nuestro repositorio de herramientas [aquí](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation). Esta solución aprovecha Amazon Route 53 para la administración de puntos finales y proporciona AWS Lambda funciones que se pueden activar en función de los eventos apropiados.
## Ejecución de una transición para un clúster global de Amazon DocumentDB
Al utilizar las transiciones, puede cambiar la región del clúster principal de forma rutinaria. Este enfoque está destinado a situaciones controladas, como el mantenimiento operativo y otros procedimientos operativos planificados.
Existen tres casos de uso frecuentes en los que se utilizan las transiciones:
+ Para los requisitos de “rotación regional” impuestos a sectores específicos. Por ejemplo, es posible que los reglamentos de los servicios financieros exijan que los sistemas de nivel 0 se cambien a una región diferente durante varios meses para garantizar que los procedimientos de recuperación ante desastres se ensayen con cierta asiduidad.
+ Para aplicaciones «follow-the-sun» multirregionales. Por ejemplo, es posible que una empresa desee ofrecer escrituras con menor latencia en diferentes regiones en función del horario laboral en distintas zonas horarias.
+ Como zero-data-loss método para volver a la región principal original tras una conmutación por error.
**nota**
Las transiciones están diseñadas para utilizarse en un clúster global de Amazon DocumentDB en buen estado. Para la recuperación de una interrupción no programada, siga el procedimiento correspondiente en [Ejecución de una conmutación por error manual para un clúster global de Amazon DocumentDB](#manual-failover).
Para realizar una transición, todas las regiones secundarias deben ejecutar la misma versión del motor que la versión principal. Si las versiones del motor de la región no coinciden, se bloqueará la transición. Compruebe si hay actualizaciones pendientes y aplíquelas para garantizar que todas las versiones de motores de la región coincidan y que la transición global del clúster esté desbloqueada. Para obtener más información, consulte [Desbloqueo de una conmutación por error o una transición de clúster global](#unblocking-gc-so-fo).
Durante una transición, Amazon DocumentDB cambia el clúster principal a la región secundaria que elija a la vez que mantiene la topología de replicación existente del clúster global. Antes de iniciar el proceso de transición, Amazon DocumentDB espera a que todos los clústeres de regiones secundarias estén completamente sincronizados con el clúster de la región principal. A continuación, el clúster de bases de datos de la región principal se convierte en un clúster de solo lectura y el clúster secundario que elija promueve uno de sus nodos de solo lectura a estado de escritor completo. Al convertir este nodo en escritor, el clúster secundario puede asumir el rol de clúster principal. Dado que todos los clústeres secundarios se sincronizaron con el principal al principio del proceso, el nuevo principal continúa las operaciones para el clúster global de Amazon DocumentDB sin perder ningún dato. La base de datos no estará disponible durante un breve periodo, mientras los clústeres principales y secundarios seleccionados asumen nuevas funciones.
Para optimizar la disponibilidad de las aplicaciones, se recomienda hacer lo siguiente antes de utilizar esta característica:
+ Lleve a cabo esta operación durante los horarios menos concurridos o en otro momento cuando las escrituras en el clúster principal sean mínimas.
+ Desconecte las aplicaciones para evitar que se envíen escrituras al clúster principal del clúster global de Amazon DocumentDB.
+ Compruebe los tiempos de retraso de todos los clústeres secundarios de Amazon DocumentDB del clúster global consultando la `GlobalClusterReplicationLag` métrica en Amazon. CloudWatch Esta métrica muestra el retraso (en milisegundos) de la replicación a un clúster secundario con respecto al clúster principal. Este valor es directamente proporcional al tiempo que tarda Amazon DocumentDB en completar la transición. Por lo tanto, cuanto mayor sea el valor de retraso, más tiempo llevará la transición.
Para obtener más información sobre CloudWatch las métricas de Amazon DocumentDB, consulte. [Métricas de Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
Durante una transición, el clúster secundario de base de datos elegido se promueve a su nuevo rol de clúster principal. Sin embargo, no hereda las diversas opciones de configuración del clúster principal de base de datos. Una falta de coincidencia en la configuración puede provocar problemas de rendimiento, incompatibilidades de carga de trabajo y otros comportamientos anómalos. Para evitar estos problemas, recomendamos que se resuelvan las diferencias entre los clústeres globales de Amazon DocumentDB para lo siguiente:
+ **Configure un grupo de parámetros de clúster de base de datos de Amazon DocumentDB para el nuevo clúster principal, si es necesario**: puede configurar los grupos de parámetros de clúster de Amazon DocumentDB de forma independiente para cada clúster del clúster global de Amazon DocumentDB. Esto significa que cuando se promueve un clúster secundario de base de datos para asumir el rol principal, su grupo de parámetros puede configurarse de manera diferente que para el principal. Si es así, modifique el grupo de parámetros del clúster secundario de base de datos promocionado para que se ajuste a la configuración del clúster principal. Para saber cómo hacerlo, consulte [Administración de los grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups.md).
+ **Configure las herramientas y opciones de supervisión, como Amazon CloudWatch Events y las alarmas**: configure el clúster promocionado con la misma capacidad de registro, alarmas, etc., según sea necesario para el clúster global. Al igual que con los grupos de parámetros, la configuración de estas características no se hereda del clúster principal durante el proceso de transición. Algunas CloudWatch métricas, como el retraso en la replicación, solo están disponibles para las regiones principales. Por lo tanto, una transición cambia la forma de ver esas métricas y configurar las alarmas en ellas, y podría requerir cambios en los paneles predefinidos. Para obtener más información, consulte [Monitorización de Amazon DocumentDB](monitoring_docdb.md).
**nota**
Por lo general, la transición de rol puede tardar varios minutos.
Cuando finaliza el proceso de transición, el clúster de Amazon DocumentDB promocionado puede manejar operaciones de escritura para el clúster global.
Puede cambiar su clúster global de Amazon DocumentDB mediante Consola de administración de AWS o: AWS CLI
------
#### [ Using the Consola de administración de AWS ]
**Ejecución de una transición en un clúster global de Amazon DocumentDB**
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. Busque y elija el clúster global de Amazon DocumentDB que desea someter al proceso de transición.
![\[Imagen: tabla de clústeres con el clúster global seleccionado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. Elija **Transición o conmutación por error** en el menú **Acciones**.
1. En el cuadro de diálogo que aparece, seleccione **Transición** y, a continuación, elija el clúster secundario en la lista desplegable del campo **Nuevo clúster principal**.
![\[Imagen: diálogo de cambio de clúster con el clúster secundario seleccionado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. Elija **Confirmar**.
El estado del clúster principal cambia a “**Transición**”. Esta condición puede necesitar aproximadamente tres minutos. Durante este tiempo, el estado de todos los clústeres regionales muestra “**Modificando...**”. Una vez que las regiones se sincronicen y se promocione el nuevo clúster principal, aparecerá como “**Disponible**” en todos los campos de estado y podrá procesar transacciones.
1. Cuando se complete, el clúster principal original se convierte en el clúster secundario. El clúster secundario seleccionado se convierte en el clúster principal.
![\[Imagen: tabla de clústeres que muestra el nuevo clúster principal.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Ejecución de una transición en un clúster global de Amazon DocumentDB**
Utilice el comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html) de la CLI para hacer la transición del clúster global de Amazon DocumentDB. Con el comando, pase valores para las siguientes opciones:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
En los siguientes ejemplos, sustituya cada uno por la información *user input placeholder* de su clúster.
Para Linux, macOS o Unix:
```
aws docdb switchover-global-cluster \
--region region_of_primary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote
```
Para Windows:
```
aws docdb switchover-global-cluster ^
--region region_of_primary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote
```
------
## Desbloqueo de una conmutación por error o una transición de clúster global
Las transiciones y las conmutaciones por error de clústeres globales se bloquean cuando no todos los clústeres regionales del clúster global están en la misma versión del motor. Si las versiones no coinciden, es posible que aparezca este error como respuesta cuando llama una transición o una conmutación por error: el clúster de base de datos de destino especificado ejecuta una versión de motor con un nivel de parche diferente al del clúster de base de datos de origen. Le recomendamos que aplique de forma rutinaria las últimas versiones del motor para asegurarse de que está ejecutando las actualizaciones más recientes y así mantener sus clústeres globales en buen estado.
Para resolver este error, actualice primero todas las regiones secundarias y, después, la región principal a la misma versión de motor aplicando las medidas de mantenimiento pendientes. Para ver las acciones de mantenimiento pendientes y aplicar los cambios necesarios para corregir el problema, siga las instrucciones de una de las siguientes pestañas:
------
#### [ Using the Consola de administración de AWS ]
Para desbloquear una transición o conmutación por error de clúster global, debe determinar si hay acciones de mantenimiento pendientes para sus clústeres y aplicarlas. Siga estos pasos para ver y aplicar las acciones de mantenimiento:
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. En la tabla **Clústeres**, localice el clúster global en la columna de **Identificador de clúster**. En su clúster global, anote cada clúster secundario y el clúster principal del clúster global en cuestión, y realice los siguientes pasos para cada uno.
1. Para cada clúster secundario:
1. Si hay una actualización disponible para el clúster, se indicará con la palabra **Disponible**, **Obligatorio** o **Siguiente período** en la columna **Mantenimiento**.
1. Para realizar una acción, elija el clúster para mostrar sus detalles y, a continuación, seleccione **Mantenimiento y copias de seguridad**. Aparecerán los elementos de **mantenimiento pendientes**.
1. En **Descripción**, si indica que hay una «Nueva actualización de mantenimiento disponible», selecciónela y, a continuación, elija **Aplicar ahora**.
1. Para su clúster principal:
1. Si hay una actualización disponible para el clúster, se indicará con la palabra **Disponible**, **Obligatorio** o **Siguiente período** en la columna **Mantenimiento**.
1. Para realizar una acción, elija el clúster para mostrar sus detalles y, a continuación, seleccione **Mantenimiento y copias de seguridad**. Aparecerán los elementos de **mantenimiento pendientes**.
1. En **Descripción**, si indica que hay una «Nueva actualización de mantenimiento disponible», selecciónela y, a continuación, elija **Aplicar ahora**.
------
#### [ Using the AWS CLI ]
Para desbloquear una transición o conmutación por error de clúster global, debe determinar si hay acciones de mantenimiento pendientes para el clúster y aplicarlas. Siga estos pasos para ver y aplicar las acciones de mantenimiento primero en los clústeres secundarios y, después, en el clúster principal del clúster global:
1. Primero ejecute lo siguiente en el clúster regional de cada región secundaria y, a continuación, en el clúster regional de la región principal.
1. Ejecute el comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) de la CLI con la opción `--resource-identifier` para determinar si hay acciones de mantenimiento disponibles para su clúster regional de Amazon DocumentDB.
En los siguientes ejemplos, sustituya cada uno por la información *user input placeholder* de su clúster.
Para Linux, macOS o Unix:
```
aws docdb describe-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Para Windows:
```
aws docdb describe-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
El resultado tendrá un aspecto parecido al siguiente:
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2025-04-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2025-06-18T03:01:00Z",
"AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
"OptInStatus": "pending"
}
]
}
]
}
```
1. Si es necesaria una acción de mantenimiento, ejecute el comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html) de la CLI con las siguientes opciones:
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
En los ejemplos siguientes, sustituya cada uno *user input placeholder* por la información de su clúster.
Para Linux, macOS o Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
--apply-action system-update \
--opt-in-type immediate \
--region us-east-1
```
Para Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
--apply-action system-update ^
--opt-in-type immediate ^
--region us-east-1
```
1. Una vez finalizada la acción de mantenimiento, vuelva a ejecutar el comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) para asegurarse de que no haya otras acciones pendientes para el clúster.
El resultado que desea es:
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
Para desbloquear una transición o conmutación por error de clúster global, debe determinar si hay acciones de mantenimiento pendientes para el clúster y aplicarlas. Utilice lo siguiente APIs para ver y aplicar las acciones de mantenimiento:
1. Primero ejecute lo siguiente en el clúster regional de cada región secundaria y, a continuación, en el clúster regional de la región principal.
1. Llame a la API de [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html) para determinar si hay acciones de mantenimiento disponibles para su clúster global de Amazon DocumentDB.
1. Para aplicar cualquier cambio, llame a la API de [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html).
------