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. # Administración de recursos de Amazon DocumentDB En estas secciones se describen los distintos componentes y sus tareas relacionadas para administrar la implementación de Amazon DocumentDB (con compatibilidad con MongoDB). **Topics** + [Información general sobre las tareas operativas](operational_tasks.md) + [Clústeres globales](global-clusters.md) + [Administración de clústeres de](db-clusters.md) + [Administración de instancias](db-instances.md) + [Administración de grupos de subredes](document-db-subnet-groups.md) + [Alta disponibilidad y replicación](replication.md) + [Administrar índices](managing-indexes.md) + [Administración de la compresión de documentos](doc-compression.md) + [Administración de la compresión basada en diccionarios](dict-compression.md) + [Administración de eventos](managing-events.md) + [Elección de regiones y zonas de disponibilidad](regions-and-azs.md) + [Administración de grupos de parámetros de clúster](cluster_parameter_groups.md) + [Descripción de puntos de conexión](endpoints.md) + [Descripción de Amazon DocumentDB ARNs](documentdb-arns.md) + [Etiquetado de recursos](tagging.md) + [Mantenimiento de Amazon DocumentDB](db-instance-maintain.md) + [Descripción de los roles vinculados a servicios](service-linked-roles.md) + [Uso de flujos de cambios](change_streams.md) + [Uso de la intercalación](collation.md) + [Uso de vistas](views.md) + [Uso de AWS Lambda con flujos de cambios](using-lambda.md) # Información general sobre las tareas operativas de Amazon DocumentDB En esta sección se explican las tareas operativas de un clúster de Amazon DocumentDB y cómo llevar a cabo estas tareas mediante la AWS CLI. **Topics** + [Agregación de una réplica a un clúster de Amazon DocumentDB](#operational_tasks-add_replica) + [Descripción de clústeres e instancias](#operational_tasks-list_clusters_and_instances) + [Creación de una instantánea de un clúster](#operational_tasks-creating_snapshot) + [Restauración a partir de una instantánea](#operational_tasks-restore_from_snapshot) + [Eliminación de una instancia de un clúster](#operational_tasks-remove_instance_from_cluster) + [Eliminación de un clúster](#operational_tasks-delete_cluster) ## Agregación de una réplica a un clúster de Amazon DocumentDB Después de crear la instancia principal de su clúster de Amazon DocumentDB, puede añadir una o varias *réplicas*. Una réplica es una instancia de solo lectura que tiene dos finalidades: + **Escalabilidad**: si tiene gran cantidad de clientes que deben obtener acceso simultáneamente, puede agregar más réplicas para escalar la lectura. + **Alta disponibilidad**: si se produce un error en la instancia primaria, Amazon DocumentDB automáticamente realiza una conmutación por error a una instancia de réplica y la designa como nuevo nodo primario. Si se produce un error en una réplica, otras instancias del clúster pueden seguir atendiendo las solicitudes hasta que se consigue recuperar el nodo defectuoso. Cada clúster de Amazon DocumentDB puede admitir hasta 15 réplicas. **nota** Para disfrutar de la máxima tolerancia a errores, debe implementar réplicas en zonas de disponibilidad distintas. Esta configuración garantiza que el clúster de Amazon DocumentDB continúe funcionando aunque una zona de disponibilidad completa deje de estar disponible. En el ejemplo siguiente de la AWS CLI, se muestra cómo añadir una nueva réplica. El parámetro `--availability-zone` coloca la réplica en la zona de disponibilidad especificada ``` aws docdb create-db-instance \ --db-instance-identifier sample-instance \ --db-cluster-identifier sample-cluster \ --engine docdb \ --db-instance-class db.r5.large \ --availability-zone us-east-1a ``` ## Descripción de clústeres e instancias En el siguiente ejemplo de la AWS CLI se enumeran todos los clústeres de Amazon DocumentDB de una región. Para ciertas características de administración, como la administración del ciclo de vida de clúster y de instancia, Amazon DocumentDB aprovecha la tecnología operativa que se comparte con Amazon RDS. El parámetro de filtro `filterName=engine,Values=docdb` devuelve solo clústeres de Amazon DocumentDB. Para obtener más información sobre cómo describir y modificar clústeres, consulte [Ciclo de vida del clúster de Amazon DocumentDB](db-cluster-life-cycle.md). ``` aws docdb describe-db-clusters --filter Name=engine,Values=docdb ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBClusters": [ { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-1", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-2", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-3", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... } ] } ``` En el siguiente ejemplo de la AWS CLI se muestran las instancias de un clúster de Amazon DocumentDB. Para obtener más información sobre cómo describir y modificar clústeres, consulte [Ciclo de vida de instancia de Amazon DocumentDB](db-instance-life-cycle.md). ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]' ``` El resultado es similar al siguiente. En este resultado hay dos instancias. La instancia principal es `sample-instance-1` (`"IsClusterWriter": true`). También hay una instancia de réplica, `sample-instance2` (`"IsClusterWriter: false"`). ``` [ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-cluster-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ] ``` ## Creación de una instantánea de un clúster Una *instantánea de clúster* es una copia de seguridad completa de los datos del clúster de Amazon DocumentDB. Cuando la instantánea se está creando, Amazon DocumentDB lee los datos directamente del volumen del clúster. Por este motivo, puede crear una instantánea aunque el clúster no tenga instancias en ejecución en ese momento. La cantidad de tiempo que tarda en crearse una instantánea depende del tamaño del volumen del clúster. Amazon DocumentDB admite copias de seguridad automáticas, que se realizan a diario durante el período de copia de seguridad preferido, es decir, un período de 30 minutos durante el día. En el siguiente ejemplo de la AWS CLI se muestra cómo ver el periodo de copia de seguridad del clúster: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].PreferredBackupWindow' ``` El resultado muestra el periodo de copia de seguridad (en UTC): ``` [ "00:18-00:48" ] ``` Puede definir el periodo de copia de seguridad cuando cree el clúster de Amazon DocumentDB. También puede cambiar el periodo de copia de seguridad, tal y como se muestra en el siguiente ejemplo: Si no define un periodo de copia de seguridad, Amazon DocumentDB asigna uno automáticamente a su clúster. ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --preferred-backup-window "02:00-02:30" ``` Además de copias de seguridad automáticas, puede crear manualmente una instantánea del clúster en cualquier momento. Cuando cree la instantánea, especifique el clúster del que desea hacer una copia de seguridad y un nombre único para la instantánea, de forma que pueda realizar la restauración desde ella en otro momento. El ejemplo de la AWS CLI siguiente muestra cómo crear una instantánea de los datos. ``` aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` ## Restauración a partir de una instantánea Puede restaurar una instantánea de clúster en un nuevo clúster de Amazon DocumentDB. Para ello, proporcione el nombre de la instantánea y el nombre de un nuevo clúster. No puede restaurar desde una instantánea a un clúster existente; en su lugar, Amazon DocumentDB crea un nuevo clúster al restaurar y, a continuación, lo rellena con los datos de su instantánea. El siguiente ejemplo muestra todas las instantáneas de un clúster `sample-cluster`. ``` aws docdb describe-db-cluster-snapshots \ --db-cluster-identifier sample-cluster \ --query 'DBClusterSnapshots[*].[DBClusterSnapshotIdentifier,SnapshotType,Status]' ``` El resultado es similar al siguiente. Una instantánea manual es aquella que se crea manualmente, mientras que una instantánea automatizada la crea Amazon DocumentDB dentro del periodo de copia de seguridad del clúster. ``` [ "sample-cluster-snapshot", "manual", "available" ], [ "rds:sample-cluster", "automated", "available" ] ] ``` En el siguiente ejemplo se muestra cómo restaurar un clúster de Amazon DocumentDB a partir de una instantánea. ``` aws docdb restore-db-cluster-from-snapshot \ --engine docdb \ --db-cluster-identifier new-sample-cluster \ --snapshot-identifier sample-cluster-snapshot ``` El nuevo clúster no tiene instancias asociadas; por lo tanto, si desea interactuar con el clúster, debe añadirle una instancia. ``` aws docdb create-db-instance \ --db-instance-identifier new-sample-instance \ --db-instance-class db.r5.large \ --engine docdb \ --db-cluster-identifier new-sample-cluster ``` Puede utilizar las siguientes operaciones de la AWS CLI para monitorizar el progreso de creación del clúster y de la instancia. Cuando el clúster y la instancia tengan estados disponibles, podrá conectarse al punto de conexión del nuevo clúster y obtener acceso a sus datos. ``` aws docdb describe-db-clusters \ --db-cluster-identifier new-sample-cluster \ --query 'DBClusters[*].[Status,Endpoint]' ``` ``` aws docdb describe-db-instances \ --db-instance-identifier new-sample-instance \ --query 'DBInstances[*].[DBInstanceStatus]' ``` ## Eliminación de una instancia de un clúster Amazon DocumentDB almacena todos los datos en el volumen del clúster. Los datos se conservan en ese volumen de clúster, incluso si elimina todas las instancias del clúster. Si necesita obtener acceso a los datos de nuevo, puede añadir una instancia a la clúster en cualquier momento y reanudar el trabajo donde lo dejó. En el siguiente ejemplo se muestra cómo eliminar una instancia de su clúster de Amazon DocumentDB. ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance ``` ## Eliminación de un clúster Para poder eliminar un clúster de Amazon DocumentDB, primero debe eliminar todas sus instancias. En el siguiente ejemplo de la AWS CLI, se devuelve información acerca de las instancias de un clúster. Si esta operación devuelve algún identificador de instancia, tendrá que eliminar cada una de esas instancias. Para obtener más información, consulte [Eliminación de una instancia de un clúster](#operational_tasks-remove_instance_from_cluster). ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterMembers[*].DBInstanceIdentifier' ``` Cuando no queden más instancias, puede eliminar el clúster. En ese momento, debe elegir una de las siguientes opciones: + **Cree una instantánea final**: capture todos los datos del clúster en una instantánea para poder volver a crear una nueva instancia con esos datos más adelante. El siguiente ejemplo le muestra cómo hacerlo: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-snapshot ``` + **Omita la instantánea final**: descarte permanentemente todos los datos del clúster. Esta operación no se puede deshacer. El siguiente ejemplo le muestra cómo hacerlo: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot ``` # 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). ------ # Administración de clústeres de Amazon DocumentDB Para administrar un clúster de Amazon DocumentDB, debe disponer de una política de IAM con los permisos del plano de control de Amazon DocumentDB. Estos permisos le permiten crear, modificar y eliminar clústeres e instancias. La política `AmazonDocDBFullAccess` proporciona todos los permisos necesarios para administrar un clúster de Amazon DocumentDB. Los siguientes temas muestran cómo realizar diversas tareas cuando se trabaja con clústeres de Amazon DocumentDB, incluida la creación, eliminación, modificación, conexión y consulta de clústeres. **Topics** + [Descripción de clúster](db-clusters-understanding.md) + [Configuración del clúster](db-cluster-parameters.md) + [Configuración de almacenamiento en clústeres](db-cluster-storage-configs.md) + [Determinación del estado de un clúster](db-cluster-status.md) + [Ciclo de vida del clúster](db-cluster-life-cycle.md) + [Escalado de clústeres](db-cluster-manage-performance.md) + [Clonación de un volumen de clúster](db-cluster-cloning.md) + [Información general de tolerancia a errores para un clúster](db-cluster-fault-tolerance.md) # Descripción de clúster Amazon DocumentDB divide la capacidad informática y de almacenamiento, y descarga la replicación de datos y las copias de seguridad en el volumen del clúster. Un volumen de clúster proporciona una capa de almacenamiento duradera, fiable y altamente disponible que replica los datos de seis formas distintas entre tres zonas de disponibilidad. Las réplicas permiten una mayor disponibilidad de los datos y del escalado de lectura. Cada clúster se puede escalar verticalmente hasta 15 réplicas. | Nombre | Description (Descripción) | Operaciones de API (Verbos) | | --- | --- | --- | | Clúster | Se compone de una o varias instancias y de un volumen de almacenamiento del clúster que administra los datos para esas instancias. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` | | Instancia | La lectura y escritura de los datos en el volumen de almacenamiento del clúster se realiza a través de las instancias. En cualquier clúster, hay dos tipos de instancias: principal y de réplica. Un clúster siempre tiene una instancia principal y puede tener 0-15 réplicas. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` | | Volumen del clúster | Un volumen de almacenamiento de base de datos virtual que abarca tres zonas de disponibilidad, de modo que cada una de estas zonas tenga dos copias de los datos del clúster. | N/A | | Instancia principal | Admite operaciones de lectura y escritura, y realiza todas las modificaciones de los datos en el volumen del clúster. Cada clúster tiene una instancia principal. | N/A | | Instancia de réplica | Solo admite operaciones de lectura. Cada clúster de Amazon DocumentDB puede tener hasta 15 instancias de réplica, además de la instancia principal. Varias réplicas distribuyen la carga de trabajo real. Al colocar las réplicas en distintas zonas de disponibilidad, también puede aumentar la disponibilidad de la base de datos. | N/A | | Punto de conexión de clúster | Un punto de conexión de un clúster de Amazon DocumentDB que se conecta a la instancia principal actual del clúster. Cada clúster de Amazon DocumentDB tiene un punto de conexión de clúster y una instancia principal. | N/A | | Punto de conexión del lector | Un punto de conexión de un clúster de Amazon DocumentDB que se conecta a una de las réplicas disponibles de ese clúster. Cada clúster de base de datos de Amazon DocumentDB tiene un punto de conexión del lector. Si hay más de una réplica, el punto de conexión del lector dirige cada solicitud de conexión a una de las réplicas de Amazon DocumentDB. | N/A | | Punto de conexión de instancia | Un punto de conexión de una instancia de un clúster de Amazon DocumentDB que se conecta a una instancia específica. Cada instancia de un clúster de base de datos, independientemente del tipo de instancia, tiene su propio punto de conexión de instancia único. | N/A | # Configuración del clúster de Amazon DocumentDB Al crear o modificar un clúster, es importante saber qué parámetros son inmutables y cuáles se pueden modificar una vez creado el clúster. La siguiente tabla muestra todas las configuraciones o parámetros que son específicos en un clúster. Tal y como se indica en la tabla; algunos de ellos se pueden modificar y otros no. **nota** Esta configuración no debe confundirse con los grupos de parámetros de clúster de Amazon DocumentDB y sus parámetros. Para obtener más información acerca de los grupos de parámetros de clúster, consulte [Administración de los grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups.md). | Parámetro | Modificable | Notas | | --- | --- | --- | | DBClusterIdentifier | Sí | Restricciones en la nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) | | Engine | No | Debe ser docdb. | | BackupRetentionPeriod | Sí | Debe estar comprendido entre [1-35] días. | | DBClusterParameterGroupName | Sí | Restricciones en la nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) | | DBSubnetGroupName | No | Una vez creado un clúster, no puede modificar la subred del clúster. | | EngineVersion | No | El valor puede ser 5.0.0 (predeterminado), 4.0.0 o 3.6.0. | | KmsKeyId | No | Si decide cifrar el clúster, no podrá cambiar la AWS KMS clave que utilizó para cifrarlo. | | MasterUsername | No | Una vez creado un clúster, no puede modificar el `MasterUsername`. Restricciones en la nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) | | MasterUserPassword | Sí | Restricciones: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-parameters.html) | | Port | Sí | El número de puerto se aplica a todas las instancias del clúster. | | PreferredBackupWindow | Sí | | | PreferredMaintenanceWindow | Sí | | | StorageEncrypted | No | Si elige cifrar el clúster, no se puede descifrar. | | StorageType | Sí | Tipo de almacenamiento para el clúster de DB: estándar (`standard`) u optimizado para E/S (`iopt1`). Valor predeterminado: `standard` Este parámetro se puede configurar con `CreateDBCluster` y. `ModifyDBCluster` Para obtener más información, consulte [Configuraciones de almacenamiento en clústeres de Amazon DocumentDB](db-cluster-storage-configs.md). | | Tags | Sí | | | VpcSecurityGroupIds | No | Una vez creado un clúster, no puede modificar la VPC en la que reside el clúster. | # Configuraciones de almacenamiento en clústeres de Amazon DocumentDB A partir de Amazon DocumentDB 5.0, los clústeres basados en instancias admiten dos tipos de configuraciones de almacenamiento: + **Almacenamiento estándar de Amazon DocumentDB**: diseñado para clientes con un consumo bajo a moderado I/O . Si espera que sus I/O costes sean inferiores al 25% del total de su clúster de Amazon DocumentDB, esta opción puede ser ideal para usted. Con la configuración de almacenamiento estándar de Amazon DocumentDB, se le facturará de pay-per-request I/O forma independiente a los cargos de instancia y almacenamiento. Esto significa que su facturación puede variar de un ciclo a otro en función del uso. La configuración está diseñada para adaptarse a las I/O demandas fluctuantes de su aplicación. + **Almacenamiento optimizado para E/S de Amazon DocumentDB**: diseñado para clientes que priorizan la previsibilidad de los precios o que tienen aplicaciones intensivas. I/O Las I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/O operaciones, que garantizan costos predecibles en cada ciclo de facturación. La configuración estabiliza los costos y, al mismo tiempo, mejora el rendimiento. Puede cambiar los clústeres de bases de datos existentes una vez cada 30 días a Amazon DocumentDB: I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O optimizados y se puede realizar un seguimiento con el `describe-db-clusters` comando mediante la página de configuración del Consola de administración de AWS clúster AWS CLI o a través de ella. Puede crear un nuevo clúster de bases de datos que incluya la configuración optimizada para E/S de Amazon DocumentDB o convertir los clústeres de bases de datos existentes con unos pocos clics en el [Consola de administración de AWS](https://console.aws.amazon.com/docdb/), un solo cambio de parámetro en [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) o mediante. [AWS SDKs](https://aws.amazon.com/developer/tools/) No es necesario interrumpir ni reiniciar las instancias durante o después de modificar la configuración de almacenamiento. ![\[Imagen: tabla en la que se describen las diferencias entre el almacenamiento estándar y el almacenamiento optimizado de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/io-diagram-1.png) ## Creación de un clúster con optimización de E/S ------ #### [ Using the Consola de administración de AWS ] Cómo crear o modificar un clúster optimizado para E/S mediante la Consola de administración de AWS: 1. En la consola de administración de Amazon DocumentDB, en **Clústeres**, elija **Crear** o seleccione el clúster, elija **Acciones** y, a continuación, elija **Modificar**. 1. Si va a crear un clúster nuevo, asegúrese de elegir **Clúster basado en instancias** en la sección **Tipo de clúster** (esta es la opción predeterminada). ![\[Imagen: captura de pantalla de la consola con las opciones de tipo de clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-cluster/cc-type.png) 1. En la sección **Configuración**, en **Configuración del almacenamiento en clúster**, elija **Amazon DocumentDB optimizado para E/S**. ![\[Imagen: captura de pantalla de la consola con las opciones de configuración de almacenamiento en clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/storage-config-1.png) 1. Complete la creación o modificación del clúster y elija **Crear clúster** o **Modificar clúster**. Para ver el proceso completo de creación de un clúster, consulte [Crear un clúster y una instancia principal mediante Consola de administración de AWS](db-cluster-create.md#db-cluster-create-con). Para ver el proceso completo de modificación de un clúster, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md). ------ #### [ Using the AWS CLI ] Cómo crear un clúster optimizado para E/S mediante la AWS CLI: En los siguientes ejemplos, sustituya cada uno por su *user input placeholder* propia información. Para Linux, macOS o Unix: ``` aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --engine-version 5.0.0 \ --storage-type iopt1 \ --deletion-protection \ --master-username username \ --master-user-password password ``` Para Windows: ``` aws docdb create-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine docdb ^ --engine-version 5.0.0 ^ --storage-type iopt1 ^ --deletion-protection ^ --master-username username ^ --master-user-password password ``` ------ ## Análisis de costos para determinar la configuración del almacenamiento Con Amazon DocumentDB, tiene la flexibilidad de elegir la configuración de almacenamiento para cada clúster de bases de datos que tenga. Para asignar correctamente sus clústeres entre la opción estándar y optimizada para E/S, puede hacer un seguimiento de los costos de Amazon DocumentDB por clústeres. Para ello, puede agregar etiquetas a los clústeres existentes, habilitar el etiquetado de asignación de costos en el [panel de Administración de facturación y costos de AWS](https://aws.amazon.com/pricing/) y analizar los costos de un clúster determinado en el [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/). Para obtener información sobre el análisis de costos, consulte nuestro blog [Using cost allocation tags](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/). # Determinación del estado de un clúster Para determinar el estado de un clúster, utilice la tecla Consola de administración de AWS o AWS CLI. ------ #### [ Using the Consola de administración de AWS ] Utilice el siguiente procedimiento para ver el estado del clúster de Amazon DocumentDB mediante el Consola de administración de AWS 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 columna **Cluster identifier (Identificador de clúster)**, busque el nombre del clúster que le interese. A continuación, para encontrar el estado del clúster, consulte en esa fila la columna **Status (Estado)**, tal y como se muestra a continuación. ![\[Captura de pantalla de página del clúster que muestra el estado activo de sample-cluster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-status-con.png) ------ #### [ Using the AWS CLI ] Utilice la operación `describe-db-clusters` para ver el estado del clúster de Amazon DocumentDB mediante la AWS CLI. El siguiente código busca el estado del clúster `sample-cluster`. Para Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,Status]' ``` Para Windows: ``` aws docdb describe-db-clusters ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterIdentifier,Status]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "sample-cluster", "available" ] ] ``` ------ # Ciclo de vida del clúster de Amazon DocumentDB El ciclo de vida de un clúster de Amazon DocumentDB incluye crear, describir, modificar y eliminar el clúster. En esta sección se proporciona información sobre cómo realizar estos procesos. **Topics** + [creación de un clúster](db-cluster-create.md) + [Descripción de los clústeres](db-cluster-view-details.md) + [Modificación de un clúster](db-cluster-modify.md) + [Determinación de las tareas de mantenimiento pendientes](db-cluster-determine-pending-maintenance.md) + [Parche para actualizar la versión del motor de un clúster](db-cluster-version-upgrade.md) + [Detención e inicio de un clúster](db-cluster-stop-start.md) + [Eliminación de un clúster](db-cluster-delete.md) # Creación de un clúster de Amazon DocumentDB Un clúster de Amazon DocumentDB consta de instancias y de un volumen de clúster que representa los datos del clúster. El volumen de clúster se replica de seis formas en tres zonas de disponibilidad como un único volumen virtual. El clúster contiene una instancia principal y, opcionalmente, hasta 15 instancias de réplica. En las siguientes secciones se muestra cómo crear un clúster de Amazon DocumentDB utilizando el Consola de administración de AWS o el. AWS CLI A continuación, puede añadir instancias de réplica al clúster. Si utiliza la consola para crear el clúster de Amazon DocumentDB, se crea automáticamente una instancia principal al mismo tiempo. Si lo usa AWS CLI para crear su clúster de Amazon DocumentDB, una vez que el estado del clúster esté *disponible*, debe crear la instancia principal para ese clúster. ## Requisitos previos A continuación, se describen los requisitos previos para crear un clúster de Amazon DocumentDB. Si no tiene uno Cuenta de AWS, complete los siguientes pasos para crearlo. **Para suscribirte a una Cuenta de AWS** 1. Abrir [https://portal.aws.amazon.com/billing/registro](https://portal.aws.amazon.com/billing/signup). 1. Siga las instrucciones que se le indiquen. Parte del procedimiento de registro consiste en recibir una llamada telefónica o mensaje de texto e indicar un código de verificación en el teclado del teléfono. Cuando te registras en un Cuenta de AWS, *Usuario raíz de la cuenta de AWS*se crea un. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, asigne acceso administrativo a un usuario y utilice únicamente el usuario raíz para realizar [Tareas que requieren acceso de usuario raíz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). ### Requisitos previos de VPC Solo puede crear un clúster de Amazon DocumentDB en una instancia de Amazon Virtual Private Cloud (Amazon VPC). Amazon VPC debe tener como mínimo una subred en al menos dos de las zonas de disponibilidad para que la use con un clúster de base de datos de Amazon DocumentDB. Mediante la distribución de las instancias del clúster en las zonas de disponibilidad, se garantiza que habrá instancias disponibles en el clúster en el caso improbable de que se produzca un error en una zona. ### Requisitos previos de la subred Al crear un clúster de Amazon DocumentDB, debe elegir una VPC y el grupo de subredes correspondiente dentro de la VPC para lanzar el clúster. Las subredes determinan la zona de disponibilidad y el rango de direcciones IP de esa zona de disponibilidad que se quieran utilizar para lanzar una instancia. Para los fines de esta exposición, usaremos los términos *subred* y *zona de disponibilidad* indistintamente. Un grupo de subredes es un conjunto de subredes (o zonas de disponibilidad). Un grupo de subredes le permite especificar las zonas de disponibilidad que desea utilizar para lanzar instancias de Amazon DocumentDB. Por ejemplo, para ofrecer un alto nivel de disponibilidad en un clúster con tres instancias, se recomienda que cada una de dichas instancias esté aprovisionada en una zona de disponibilidad distinta. De esa forma, si una de las zonas de disponibilidad deja de funcionar, solo se verá afectada una sola instancia. Las instancias de Amazon DocumentDB actualmente pueden aprovisionarse en hasta tres zonas de disponibilidad. Aunque un grupo de subredes tenga más de tres subredes, solo podrá utilizar tres de esas subredes para crear un clúster de Amazon DocumentDB. Por ello, es aconsejable que al crear un grupo de subredes solo elija las tres subredes en las que desee implementar las instancias. En el Este de EE. UU. (Norte de Virginia), el grupo de subredes puede tener seis subredes (o zonas de disponibilidad). Sin embargo, cuando se aprovisione un clúster de Amazon DocumentDB, Amazon DocumentDB elige tres de estas zonas de disponibilidad que utiliza para aprovisionar instancias. Por ejemplo, supongamos que al crear un clúster, Amazon DocumentDB elige las zonas de disponibilidad \$11A, 1B y 1C\$1. Si intenta crear una instancia en la zona de disponibilidad \$11D\$1, la llamada a la API no funcionará correctamente. Sin embargo, si decide crear una instancia sin especificar la zona de disponibilidad concreta, Amazon DocumentDB elegirá una zona de disponibilidad por usted. Amazon DocumentDB utiliza un algoritmo para equilibrar la carga de las instancias en las zonas de disponibilidad para ayudarle a obtener una alta disponibilidad. Por ejemplo, si se aprovisionan tres instancias, de forma predeterminada se repartirán entre tres zonas de disponibilidad en lugar de aprovisionar todas ellas en una única zona de disponibilidad. **Recomendaciones:** + A menos que tenga un motivo específico, cree siempre un grupo de subredes con tres subredes. De esta forma, se asegurará de que los clústeres con tres o más instancias puedan lograr una mayor disponibilidad, debido a que las instancias se aprovisionarán en tres zonas de disponibilidad distintas. + Reparta siempre las instancias en varias zonas de disponibilidad para lograr una alta disponibilidad. Nunca ponga todas las instancias de un clúster en una única zona de disponibilidad. + Debido a que pueden producirse eventos de conmutación por error en cualquier momento, no debe dar por hecho que una instancia principal o las instancias de réplica siempre están en una zona de disponibilidad determinada. ### Requisitos previos adicionales A continuación se indican algunos requisitos adicionales para crear un clúster de Amazon DocumentDB: + Si se va a conectar AWS mediante credenciales AWS Identity and Access Management (IAM), su cuenta de IAM debe tener políticas de IAM que concedan los permisos necesarios para realizar las operaciones de Amazon DocumentDB. Si utiliza una cuenta de IAM para acceder a la consola de Amazon DocumentDB, primero debe iniciar sesión en ella con su cuenta Consola de administración de AWS de IAM. [A continuación, vaya a la consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) + Si desea adaptar los parámetros de configuración a un clúster, debe especificar un grupo de parámetros de clúster y un grupo de parámetros con la configuración de parámetros necesaria. Para obtener información acerca de cómo crear o modificar un grupo de parámetros de clúster o un grupo de parámetros de base de datos, consulte [Administración de los grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups.md). + Debe determinar el número de TCP/IP puerto que desea especificar para el clúster. Los firewalls de algunas compañías bloquean las conexiones a estos puertos predeterminados para Amazon DocumentDB. Si el firewall de su compañía bloquea el puerto predeterminado, elija otro puerto para el clúster. Todas las instancias de un clúster usan el mismo puerto. ## Crear un clúster y una instancia principal mediante Consola de administración de AWS Los siguientes procedimientos describen cómo se usa la consola para lanzar un clúster de Amazon DocumentDB con una o varias instancias. ### Creación de un clúster: uso de la configuración predeterminada **Para crear un clúster con instancias que utilicen la configuración predeterminada, utilice la Consola de administración de AWS** 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. Si desea crear su clúster en una región que no Región de AWS sea EE. UU. Este (Virginia del Norte), elija la región de la lista que aparece en la sección superior derecha de la consola. 1. En el panel de navegación, elija **Clusters (Clústeres)** y, a continuación, elija **Create (Crear)**. **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. 1. En la página **Crear clúster de Amazon DocumentDB**, complete el panel de **Configuración**. 1. **Identificador de clúster**: acepte el nombre que ha proporcionado Amazon DocumentDB o introduzca un nombre para el clúster; por ejemplo, **sample-cluster**. Restricciones en cuanto a la nomenclatura de los clústeres: + Debe tener [1-63] letras, números o guiones. + El primer carácter debe ser una letra. + No puede terminar con un guion ni contener dos guiones consecutivos. + Debe ser único para todos los clústeres de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS 1. **Versión del motor**: acepte la versión 5.0.0 del motor predeterminada o, si lo desea, elija la 8.0.0, 4.0.0 o 3.6.0. 1. **Clase de instancia**: puede aceptar la `db.r5.large` predeterminada o elegir una en la lista desplegable. 1. **Número de instancias**: en la lista, elija el número de instancias que desee crear cuando se restaure el clúster. La primera es la instancia principal, todas las demás instancias son instancias de réplica de solo lectura. Puede añadir y eliminar instancias más adelante si las necesita. De forma predeterminada, un clúster de Amazon DocumentDB se lanzará con tres instancias (una principal y dos réplicas). 1. Complete la sección **Configuración del almacenamiento en clúster**. Elija **Amazon DocumentDB estándar** (predeterminado) o **Amazon DocumentDB optimizado para E/S**. Para obtener más información, consulte [Configuraciones de almacenamiento en clústeres de Amazon DocumentDB](db-cluster-storage-configs.md). 1. Rellene el panel **Authentication (Autenticación)**. 1. **Nombre de usuario**: ingrese un nombre para el usuario principal. Para iniciar sesión en el clúster, debe utilizar el nombre de usuario principal. Restricciones de denominación de usuario principal: + La longitud es de [1-63] caracteres alfanuméricos. + El primer carácter debe ser una letra. + No puede ser una palabra reservada por el motor de base de datos. 1. Seleccione una de las siguientes opciones de contraseña: + **Administrado en AWS Secrets Manager**: elija esta opción si desea administrar automáticamente la contraseña de AWS Secrets Manager su usuario principal. Si elige esta opción, configure la clave de KMS. Para ello, cree la suya propia o utilice una clave creada por Secrets Manager. + **Autoadministrado**: elija esta opción si desea autoadministrar la contraseña de su usuario principal. Si elige esta opción, introduzca una contraseña para el usuario principal y confírmela. Para iniciar sesión en el clúster, debe utilizar la contraseña del usuario principal. Restricciones para la contraseña: + La longitud es de [8-100] caracteres ASCII imprimibles. + Se puede utilizar cualquier carácter ASCII imprimible, excepto los siguientes: + **/** (barra inclinada) + **"** (comillas dobles) + **@** (símbolo de arroba) 1. En la parte inferior de la pantalla, elija una de las opciones siguientes: + Para crear el clúster ahora, elija **Create cluster (Crear clúster)**. + Si no desea crear el clúster, elija **Cancel (Cancelar)**. + Para configurar el clúster antes de crearlo, elija **Show additional configurations (Mostrar configuraciones adicionales)** y, a continuación, continúe en [Creación de un clúster: configuraciones adicionales](#db-cluster-create-con-additional-configs). Las configuraciones que aparecen en **Additional Configurations (Configuraciones adicionales)** son las siguientes: + **Configuración de red**: el valor predeterminado es utilizar el grupo de seguridad de VPC `default`. + **Opciones de clúster**: de forma predeterminada, se utilizan el puerto 27017 y el grupo de parámetros predeterminado. + **Cifrado**: el valor predeterminado es habilitar el cifrado con la clave `(default) aws/rds`. **importante** Después de que se cifra un clúster, no es posible descifrarlo. + **Copia de seguridad**: el valor predeterminado es conservar las copias de seguridad durante 1 día y dejar que Amazon DocumentDB seleccione el periodo de copia de seguridad. + **Exportaciones de registros**: el valor predeterminado es no exportar los registros de auditoría a los CloudWatch registros. + **Mantenimiento**: de forma predeterminada, Amazon DocumentDB elige el período de mantenimiento. + **Protección contra la eliminación**: proteja sus clústeres contra la eliminación accidental. El valor predeterminado para el clúster creado con la consola es *enabled* (habilitado). Si acepta los valores predeterminados ahora, podrá cambiar la mayoría de ellos más adelante modificando el clúster. 1. Habilite la conexión entrante del grupo de seguridad de su clúster. Si no ha cambiado la configuración predeterminada de su clúster, ha creado un clúster mediante el grupo de seguridad predeterminado para la VPC predeterminada en una región en concreto. Para conectarse a Amazon DocumentDB, tiene que habilitar las conexiones entrantes en el puerto 27017 (o el puerto que prefiera) para el grupo de seguridad de su clúster. **Cómo añadir una conexión entrante al grupo de seguridad de su clúster** 1. Inicie sesión en la consola Amazon EC2 Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 1. En la sección **Resources (Recursos)** de la ventana principal, seleccione **Security groups (Grupos de seguridad)**. ![\[Imagen: lista de recursos que destaca la opción de enlace a los grupos de seguridad.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png) 1. En la lista de grupos de seguridad, localice el grupo de seguridad que utilizó para crear el clúster (lo más probable es que fuera el grupo de seguridad *predeterminado*) y seleccione la casilla situada a la izquierda del nombre del grupo de seguridad. ![\[Imagen: lista de grupos de seguridad que destaca un grupo de seguridad con la casilla seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png) 1. En el menú **Actions** (Acciones), elija **Edit inbound rules** (Editar reglas entrantes) y, a continuación, seleccione o especifica las restricciones de las reglas. 1. **Tipo**: en la lista, elija el protocolo para abrir al tráfico de la red. 1. **Protocolo**: en la lista, elija el tipo de protocolo. 1. **Intervalo de puertos**: para una regla personalizada, introduzca un número de puerto o un intervalo de puertos. Asegúrese de que el número de puerto o el rango de puertos incluye el puerto que especificó cuando creó el clúster (predeterminado: 27017). 1. **Origen**: especifica el tráfico que puede llegar a su instancia. En la lista, elija el origen del tráfico. Si selecciona **Custom (Personalizado)**, especifique una única dirección IP o un rango de direcciones IP en notación CIDR (p. ej., 203.0.113.5/32). 1. **Descripción**: escriba una descripción para la regla. 1. Cuando finalice la creación de la regla, seleccione **Save (Guardar)**. ### Creación de un clúster: configuraciones adicionales Si desea aceptar los valores predeterminados para el clúster, puede omitir los pasos que se describen a continuación y elegir **Create cluster (Crear clúster)**. 1. Rellene el panel **Network settings (Configuración de red)**. ![\[Captura de pantalla que muestra el panel de configuración de red y los pasos para ajustar la configuración de la red.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png) 1. **Nube privada virtual (VPC):** en la lista, elija la Amazon VPC en la que desea lanzar este clúster. 1. **Grupo de subredes**: en la lista, elija el grupo de subredes que desea utilizar para este clúster. 1. **Grupos de seguridad de VPC**: en la lista, elija el grupo de seguridad para el clúster. 1. Rellene el panel **Cluster options (Opciones de clúster)**. ![\[Captura de pantalla que muestra el panel de opciones de clúster con los pasos para ajustar la configuración del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png) 1. **Puerto de base de datos**: utilice las flechas arriba y abajo para configurar el TCP/IP puerto que utilizarán las aplicaciones para conectarse a la instancia. 1. **Grupo de parámetros de clúster**: en la lista de grupos de parámetros, elija el grupo de parámetros de clúster para este clúster. 1. Rellene el panel **Encryption (Cifrado)**. ![\[Captura de pantalla del panel de cifrado con los pasos para configurar el cifrado del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/encrypt-at-rest.png) 1. **E ncryption-at-rest**: elija una de las siguientes opciones: + **Habilitar el cifrado**: de manera predeterminada. Se cifran todos los datos en reposo. Si decide cifrar los datos, no puede deshacer esta acción. + **Deshabilitar cifrado**: los datos no se cifran. 1. **AWS Clave KMS**: solo está disponible si está cifrando sus datos. En la lista, elija la clave que desee utilizar para cifrar los datos de este clúster. El valor predeterminado es `(default) aws/rds`. Si ha elegido, **Enter a key ARN (Escribir un ARN de clave)**, tendrá que introducir un nombre de recurso de Amazon (ARN) para la clave. 1. Rellene el panel **Backup (Copia de seguridad)**. ![\[Captura de pantalla del panel de copia de seguridad con los pasos para configurar el periodo de copia de seguridad del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png) 1. **Periodo de retención de copias de seguridad**: en la lista, elija el número de días que se deben conservar las copias de seguridad automáticas de este clúster antes de eliminarlas. 1. **Periodo de copia de seguridad**: especifique la hora del día en que Amazon DocumentDB debe hacer las copias de seguridad de este clúster y la duración de las mismas. 1. **Hora de inicio**: en la primera lista, elija la hora de inicio (UTC) para las copias de seguridad automáticas. En la segunda lista, elija el minuto de la hora en que desea que comiencen las copias de seguridad automáticas. 1. **Duración**: en la lista, elija el número de horas que se deben asignar para crear las copias de seguridad automáticas. 1. Complete el panel de **exportaciones de registros** seleccionando los tipos de registros que desea exportar a CloudWatch Logs. ![\[Captura de pantalla del panel de exportaciones de registros con los pasos para configurar el registro de DML del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png) + **Registros de auditoría**: seleccione esta opción para permitir la exportación de registros de auditoría a Amazon CloudWatch Logs. Si selecciona **Audit logs (Registros de auditoría)**, debe habilitar `audit_logs` en el grupo de parámetros personalizado del clúster. Para obtener más información, consulte [Auditoría de eventos de Amazon DocumentDB](event-auditing.md). + **Registros del generador de perfiles**: seleccione esta opción para permitir la exportación de los registros del generador de perfiles de operaciones a Amazon Logs. CloudWatch Si selecciona **Profiler logs (Registros del generador de perfiles)**, también debe modificar los siguientes parámetros en el grupo de parámetros personalizado del clúster: + `profiler` establezca en `enabled`. + `profiler_threshold_ms` establezca en un valor `[0-INT_MAX]` para definir el umbral para las operaciones de creación de perfiles. + `profiler_sampling_rate` establezca en un valor `[0.0-1.0]` para establecer el porcentaje de operaciones lentas en el perfil. Para obtener más información, consulte [Creación de perfiles de operaciones en Amazon DocumentDB](profiling.md). 1. Rellene el panel **Maintenance (Mantenimiento)**. ![\[Captura de pantalla del panel de mantenimiento con los pasos para configurar el periodo de mantenimiento del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png) 1. Elija una de las opciones siguientes. + **Seleccionar periodo**: permite especificar el día de la semana y la hora de inicio UTC en que Amazon DocumentDB debe realizar el mantenimiento del clúster y la duración de esta operación. 1. **Día de inicio**: en la lista, elija el día de la semana en que debe iniciarse el mantenimiento del clúster. 1. **Hora de inicio**: en las listas, elija la hora UTC y el minuto UTC en que debe iniciarse el mantenimiento. 1. **Duración**: en la lista, elija el tiempo que se debe asignar para mantenimiento del clúster. Si el mantenimiento no puede finalizar en el tiempo especificado, el proceso de mantenimiento continuará pasado ese tiempo hasta que finalice. + **Sin preferencia**: Amazon DocumentDB selecciona el día de la semana, la hora de inicio y la duración para realizar el mantenimiento. 1. Si desea añadir una o más etiquetas a este clúster, complete el panel **Tags** (Etiquetas). ![\[Captura de pantalla de la casilla de verificación Enable deletion protection (Habilitar la protección contra eliminación), que está seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png) Para cada etiqueta que desee añadir al clúster, repita los pasos siguientes. Puede disponer de hasta 10 en un clúster. 1. Elija **Add tags** (Añadir etiquetas). 1. Escriba la **clave** de la etiqueta. 1. Si lo desea, escriba el **valor** de la etiqueta. Para quitar una etiqueta, elija **Remove tag** (Eliminar etiqueta). 1. La **protección contra eliminación** se habilita de forma predeterminada cuando crea un clúster mediante la consola. Para deshabilitar la protección contra eliminación, desactive **Habilitar la protección contra eliminación**. Cuando esté habilitada, la protección contra eliminación evitará que se elimine un clúster. Para quitar un clúster protegido contra eliminación, en primer lugar debe modificar el clúster para deshabilitar la protección contra eliminación. ![\[Captura de pantalla de la casilla de verificación Enable deletion protection (Habilitar la protección contra eliminación), que está seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png) 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). 1. Para crear el clúster, elija **Create cluster** (Crear clúster). De lo contrario, seleccione **Cancelar**. ## Creación de un clúster mediante AWS CLI Los siguientes procedimientos describen cómo utilizarlos AWS CLI para lanzar un clúster de Amazon DocumentDB y crear una réplica de Amazon DocumentDB. **Parameters** + **--db-cluster-identifier**: obligatorio. Una cadena en minúsculas que identifica este clúster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-create.html) + **--engine**: obligatorio. Debe ser **docdb**. + **--deletion-protection \$1 --no-deletion-protection**: opcional. Cuando la protección contra eliminación esté habilitada, evitará que se elimine un clúster. Cuando se utiliza AWS CLI, la configuración predeterminada es desactivar la protección contra la eliminación. 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). + **--storage-type standard \$1 iopt1**: opcional. Predeterminado: **standard**. Configuración de almacenamiento en clústeres. Los valores válidos son `standard` (estándar) o `iopt1` (optimizado para E/S). + **--master-username**: obligatorio. El nombre de usuario que se utiliza para autenticar al usuario. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-create.html) + **--master-user-password**: opcional. La contraseña de usuario que se utiliza para autenticar al usuario. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-cluster-create.html) + **--manage-master-user-password**: opcional. Amazon DocumentDB genera la contraseña del usuario maestro y la administra durante todo su ciclo de vida en Secrets Manager. Para ver otros parámetros, consulte [CreateDBCluster](API_CreateDBCluster.md). **Para lanzar un clúster de Amazon DocumentDB mediante AWS CLI** Para crear un clúster de Amazon DocumentDB, llame a. `create-db-cluster` AWS CLI El siguiente AWS CLI comando crea un clúster de Amazon DocumentDB denominado `sample-cluster` con la protección de eliminación habilitada. 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 de forma explícita). 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 versión principal `--engine-version` prevista. **nota** 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 Linux, macOS o Unix: ``` aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --engine-version 5.0.0 \ --deletion-protection \ --master-username masteruser \ --master-user-password password ``` Para Windows: ``` aws docdb create-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine docdb ^ --engine-version 5.0.0 ^ --deletion-protection ^ --master-username masteruser ^ --master-user-password password ``` 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": "5.0.0", "MasterUsername": "masteruser", "BackupRetentionPeriod": 1, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "DBClusterIdentifier": "sample-cluster", "MultiAZ": false, "DBClusterParameterGroup": "default.docdb5.0", "PreferredBackupWindow": "09:12-09:42", "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY", "PreferredMaintenanceWindow": "tue:04:17-tue:04:47", "Port": 27017, "Status": "creating", "ReaderEndpoint": "sample-cluster.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": "sample-cluster.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** Cuando se utiliza AWS CLI para crear un clúster 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). Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html) en la *Referencia de la API de Amazon DocumentDB*. # Descripción de los clústeres de Amazon DocumentDB Puede utilizar la consola de administración de Amazon DocumentDB o la AWS CLI para ver detalles como los puntos de conexión, los grupos de seguridad y los grupos de parámetros relacionados con sus clústeres de Amazon DocumentDB. VPCs Para obtener más información, consulte los siguientes temas: + [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md) + [Búsqueda de puntos de conexión de un clúster](db-cluster-endpoints-find.md) ------ #### [ Using the Consola de administración de AWS ] Use el siguiente procedimiento para ver los detalles de un clúster de Amazon DocumentDB especificado mediante la consola. 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)**. **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. 1. En la lista de clústeres, elija el nombre del clúster cuyos detalles desea ver. La información sobre el clúster está organizada en las siguientes agrupaciones: + **Resumen**: información general sobre el clúster, incluida la versión del motor, el estado del clúster, el mantenimiento pendiente y el estado de su grupo de parámetros. + **Conectividad y seguridad**: la sección **Conectar** muestra los puntos de conexión para conectarse a este clúster con el intérprete de comandos de mongo o con una aplicación. La sección **Grupos de seguridad** muestra los grupos de seguridad asociados a este clúster y su ID de VPC y descripciones. + **Configuración** la sección **Detalles del clúster** muestra detalles sobre el clúster, incluidos el nombre de recurso de Amazon (ARN), el punto de conexión y el grupo de parámetros de clúster. También muestra la información de copia de seguridad del clúster, los detalles de mantenimiento y la configuración de seguridad y red. La sección **Instancias del clúster** muestra las instancias que pertenecen a este clúster con el rol de cada instancia y el estado del grupo de parámetros del clúster. + **Supervisión**: las métricas de Amazon CloudWatch Logs de este clúster. Para obtener más información, consulte [Supervisión de Amazon DocumentDB con CloudWatch](cloud_watch.md). + **Eventos y etiquetas**: en la sección de **eventos recientes** se enumeran los eventos recientes de este clúster. Amazon DocumentDB mantiene un registro de los eventos relacionados con los clústeres, las instancias, las instantáneas, los grupos de seguridad y los grupos de parámetros de clúster. Esta información incluye la fecha, la hora y el mensaje asociados a cada evento. La sección **Etiquetas** muestra las etiquetas asociadas a este clúster. ------ #### [ Using the AWS CLI ] Para ver los detalles de sus clústeres de Amazon DocumentDB mediante el AWS CLI, utilice el `describe-db-clusters` comando tal y como se muestra en los ejemplos siguientes. Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html) en la *Referencia de la API para administración de recursos de Amazon DocumentDB*. **nota** Para ciertas características de administración, como la administración del ciclo de vida de clúster y de instancia, Amazon DocumentDB aprovecha la tecnología operativa que se comparte con Amazon RDS. El parámetro de filtro `filterName=engine,Values=docdb` devuelve solo clústeres de Amazon DocumentDB. **Example** **Ejemplo 1: enumerar todos los clústeres de Amazon DocumentDB** El AWS CLI código siguiente muestra los detalles de todos los clústeres de Amazon DocumentDB de una región. ``` aws docdb describe-db-clusters --filter Name=engine,Values=docdb ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBClusters": [ { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-1", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-2", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-3", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... } ] } ``` **Example** **Ejemplo 2: mostrar todos los detalles de un clúster de Amazon DocumentDB especificado** En el AWS CLI código siguiente se enumeran los detalles del clúster`sample-cluster`. Para Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster ``` Para Windows: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBClusters": [ { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1c", "us-east-1a", "us-east-1d" ], "BackupRetentionPeriod": 2, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00", "Endpoint": "sample-cluster.node.us-east-1.amazon.com", "ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "5.0.0", "LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00", "Port": 27017, "MasterUsername": "chimeraAdmin", "PreferredBackupWindow": "22:22-22:52", "PreferredMaintenanceWindow": "sun:03:01-sun:03:31", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-9084c2ec", "Status": "active" } ], "HostedZoneId": "Z06853723JYKYBXTJ49RB", "StorageEncrypted": false, "DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [], "TagList": [], "StorageType": "iopt1", "AutoMinorVersionUpgrade": false, "NetworkType": "IPV4", "IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00" } ] } ``` **Example** **Ejemplo 3:** mostrar detalles específicos de un clúster de Amazon DocumentDB Para enumerar un subconjunto de los detalles de los clústeres mediante el AWS CLI, añada un elemento `--query` que especifique los miembros del clúster que se van a enumerar en la `describe-db-clusters` operación. El parámetro de `--db-cluster-identifier` es el identificador del clúster concreto del que desea mostrar los detalles. Para obtener más información sobre consultas, consulte [Cómo filtrar la salida con la opción `--query`](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter) en la *Guía de usuario de AWS Command Line Interface *. En el siguiente ejemplo de la se muestran las instancias de un clúster de Amazon DocumentDB. Para Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]' ``` Para Windows: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterMembers]' ``` La salida de esta operación será similar a lo que se indica a continuación. ``` [ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ] ``` ------ # Modificación de un clúster de Amazon DocumentDB Para modificar un clúster, el clúster debe tener el estado *available (disponible)*. No puede modificar un clúster que está detenido. Si el clúster está detenido, inicie primero el clúster, espere a que el clúster *esté disponible* y, a continuación, realice las modificaciones deseadas. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md). ------ #### [ Using the Consola de administración de AWS ] Utilice el siguiente procedimiento para modificar un clúster de Amazon DocumentDB específico mediante la consola. **Modificación de un clúster 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)**. **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. 1. Especifique el clúster que desee modificar seleccionando el botón situado a la izquierda del nombre del clúster. 1. Elija **Actions (Acciones)** y después **Modify (Modificar)**. 1. En el panel **Modify Cluster: (Modificar clúster: **, realice los cambios que desee. Puede realizar cambios en las siguientes áreas: + **Especificaciones del clúster**: nombre del clúster, grupos de seguridad y administración de credenciales. + **Configuración del almacenamiento en clúster**: el modo de almacenamiento de datos del clúster. Elija entre configuración estándar u optimizada para E/S. + **Opciones del clúster**: el grupo de parámetros y el puerto del clúster. + **Copia de seguridad**: el período de copia de seguridad y de retención de la copia de seguridad del clúster. + **Exportación de registros**: permite habilitar o deshabilitar los registros de auditoría o perfiles de exportación. + **Mantenimiento**: permite establecer la ventana de mantenimiento del clúster. + **Protección de eliminación**: permite habilitar o deshabilitar la protección de eliminación en el clúster. La protección contra eliminación está habilitada de forma predeterminada. 1. Cuando haya terminado, elija **Continuar** para ver un resumen de los cambios. 1. Si está satisfecho con los cambios, puede elegir **Modificar clúster** para modificar el clúster. También puede elegir **Atrás** o **Cancelar** para editar o cancelar los cambios, respectivamente. Los cambios pueden tardar unos minutos en aplicarse. Solo se puede usar el clúster cuando su estado sea *available (disponible)*. Puede monitorizar el estado del clúster mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md). ------ #### [ Using the AWS CLI ] Utilice la operación `modify-db-cluster` para modificar el clúster especificado mediante la AWS CLI. Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html) en la *Referencia de la API de Amazon DocumentDB*. **Parameters** + **--db-cluster-identifier**: obligatorio. El identificador del clúster de Amazon DocumentDB que va a modificar. + **--backup-retention-period**: opcional. El número de días durante los que se retienen las copias de seguridad automatizadas. Los valores válidos están comprendidos entre 1 y 35. + **--storage-type**: opcional. Configuración de almacenamiento en clústeres. Los valores válidos son `standard` (estándar) o `iopt1` (optimizado para E/S). + **--db-cluster-parameter-group-name**: opcional. El nombre del grupo de parámetros de clúster que se va a usar para el clúster. + **--manage-master-user-password**: opcional. Amazon DocumentDB genera la contraseña del usuario maestro y la administra durante todo su ciclo de vida en Secrets Manager. + **--rotate-master-user-password**: opcional. Secrets Manager genera una nueva versión de secreto para el secreto existente. La nueva versión del secreto contiene la nueva contraseña de usuario principal. Amazon DocumentDB cambia la contraseña del usuario principal para el clúster para que coincida con la contraseña de la nueva versión del secreto. Debe especificar la opción **--apply-immediately** cuando rota la contraseña principal. + **--master-user-password**: opcional. La nueva contraseña del usuario de la base de datos principal. Restricciones para la contraseña: + La longitud es de 8 a 100 caracteres ASCII imprimibles. + Se puede utilizar cualquier carácter ASCII imprimible, excepto los siguientes: + **/** (barra inclinada) + **"** (comillas dobles) + **@** (símbolo de arroba) + **--new-db-cluster-identifier**: opcional. El nuevo identificador del clúster cuando se cambia el nombre de un clúster. Este valor se almacena como una cadena en minúsculas. Restricciones en la nomenclatura: + Debe tener [1-63] letras, números o guiones. + El primer carácter debe ser una letra. + No puede terminar con un guion ni contener dos guiones consecutivos. + Debe ser único para todos los clústeres de Amazon RDS, Amazon Neptune y Amazon DocumentDB por región. Cuenta de AWS + **--preferred-backup-window**: opcional. El intervalo de tiempo diario (en Tiempo Universal Coordinado [UTC]) durante el cual se crean copias de seguridad automatizadas. + Formato: `hh24:mm-hh24:mm` + **--preferred-maintenance-window**: opcional. El intervalo de tiempo semanal (en UTC) durante el cual puede llevarse a cabo el mantenimiento del sistema. + Formato: `ddd:hh24:mm-ddd:hh24:mm` + Días válidos: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri` y `Sat`. + **--deletion-protection** o **--no-deletion-protection**: opcional. Si la protección contra eliminación se debe habilitar en este clúster. La protección contra eliminación evita que el clúster se elimine accidentalmente hasta que se modifique para deshabilitar la protección contra eliminación. Para obtener más información, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md). + **--apply-immediately** o **--no-apply-immediately**: utilice `--apply-immediately` para aplicar los cambios inmediatamente. Utilice `--no-apply-immediately` para aplicar el cambio durante el próximo periodo de mantenimiento de su clúster. **Example** El siguiente código cambia el periodo de retención de copia de seguridad del clúster `sample-cluster`. Para Linux, macOS o Unix: ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --apply-immediately \ --backup-retention-period 7 ``` Para Windows: ``` aws docdb modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --apply-immediately ^ --backup-retention-period 7 ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBCluster": { "BackupRetentionPeriod": 7, "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE", "Status": "available", "DBClusterMembers": [ { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster-instance", "IsClusterWriter": true } ], "ReadReplicaIdentifiers": [], "AvailabilityZones": [ "us-east-1b", "us-east-1c", "us-east-1a" ], "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "PreferredMaintenanceWindow": "sat:09:51-sat:10:21", "EarliestRestorableTime": "2018-06-17T00:06:19.374Z", "StorageEncrypted": false, "MultiAZ": false, "AssociatedRoles": [], "MasterUsername": "", "DBClusterIdentifier": "sample-cluster", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "HostedZoneId": "Z2SUY0A1719RZT", "LatestRestorableTime": "2018-06-18T21:17:05.737Z", "AllocatedStorage": 1, "Port": 27017, "Engine": "docdb", "DBClusterParameterGroup": "default.docdb3.4", "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBSubnetGroup": "default", "PreferredBackupWindow": "00:00-00:30", "EngineVersion": "3.4", "ClusterCreateTime": "2018-06-06T19:25:47.991Z", "IAMDatabaseAuthenticationEnabled": false } } ``` Los cambios pueden tardar unos minutos en aplicarse. Solo se puede usar el clúster cuando su estado sea *available (disponible)*. Puede monitorizar el estado del clúster mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md). ------ # Determinación de las tareas de mantenimiento pendientes Para saber si tiene la versión del motor de Amazon DocumentDB más reciente, determine si hay pendientes tareas de mantenimiento del clúster. ------ #### [ Using the Consola de administración de AWS ] Puede usarlo Consola de administración de AWS para determinar si un clúster tiene tareas pendientes 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)**. **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. 1. Localice la columna **Maintenance (Mantenimiento)** para determinar si un clúster tiene tareas de mantenimiento pendientes. ![\[Captura de pantalla de la consola en la que se muestra el campo de mantenimiento de clústeres de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png) **None (Ninguno)** indica que el clúster está ejecutando la versión más reciente del motor. **Available (Disponible)** indica que el clúster tiene pendientes tareas de mantenimiento, lo que podría significar que es necesario realizar una actualización del motor. 1. Si el clúster tiene pendientes tareas de mantenimiento, continúe con los pasos que se indican en [Actualización de un parche a la versión del motor de un clúster](db-cluster-version-upgrade.md). ------ #### [ Using the AWS CLI ] Puede utilizarla AWS CLI para determinar si un clúster tiene la última versión del motor mediante la `describe-pending-maintenance-actions` operación con los siguientes parámetros. **Parameters** + **--resource-identifier**: opcional. El ARN del recurso (clúster). Si este parámetro se omite, se enumeran las operaciones de mantenimiento pendientes de todos los clústeres. + **--region**: opcional. La región de AWS en la que desea ejecutar esta operación, por ejemplo, `us-east-1`. **Example** Para Linux, macOS o Unix: ``` aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \ --region us-east-1 ``` Para Windows: ``` aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^ --region us-east-1 ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Description": "New feature", "Action": "db-upgrade", "ForcedApplyDate": "2019-02-25T21:46:00Z", "AutoAppliedAfterDate": "2019-02-25T07:41:00Z", "CurrentApplyDate": "2019-02-25T07:41:00Z" } ] } ] } ``` Si el clúster tiene pendientes tareas de mantenimiento, continúe con los pasos que se indican en [Actualización de un parche a la versión del motor de un clúster](db-cluster-version-upgrade.md). ------ # Actualización de un parche a la versión del motor de un clúster En esta sección, explicaremos cómo implementar una actualización de parche mediante el Consola de administración de AWS o el AWS CLI. Una actualización de parche es una actualización dentro de la misma versión del motor (por ejemplo, la actualización de una versión del motor 3.6 a una versión del motor 3.6 más reciente). Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del clúster. Para determinar si el motor necesita una actualización, consulte [Determinación de las tareas de mantenimiento pendientes](db-cluster-determine-pending-maintenance.md). Tenga en cuenta que, al aplicar la actualización, su clúster sufrirá algún tiempo de inactividad. **nota** Si está intentando actualizar desde una versión principal del motor a otra, como de la 3.6 a la 5.0, consulte [Actualización local de la versión principal Amazon DocumentDB](docdb-mvu.md) o [Actualización del clúster de Amazon DocumentDB mediante AWS Database Migration Service](docdb-migration.versions.md). Una actualización local de la versión principal solo admite docdb 5.0 como versión del motor de destino. Existen dos requisitos de configuración para obtener las actualizaciones de parches más recientes para la versión del motor de un clúster: + El estado del clúster debe ser *disponible*. + El clúster debe estar ejecutando una versión del motor más antigua. ------ #### [ Using the Consola de administración de AWS ] El siguiente procedimiento actualiza los parches de la versión del motor de su clúster a la versión más reciente con la consola. Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del clúster. 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)**. En la lista de clústeres, elija el botón situado a la izquierda del clúster que desee actualizar. El estado del clúster debe ser *disponible*. **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. 1. En el menú **Actions (Acciones)**, elija una de las opciones siguientes. Estas opciones de menú solo se pueden seleccionar si en el clúster elegido no se está ejecutando la última versión del motor. ![\[Imagen: acciones de actualización de Amazon DocumentDB\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-upgrade-action.png) + **Actualizar ahora**: inicia inmediatamente el proceso de actualización. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor. + **Actualizar en el siguiente periodo**: inicia el proceso de actualización durante el próximo periodo de mantenimiento del clúster. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor. 1. Cuando se abra la ventana de confirmación, seleccione una de las siguientes opciones: + **Actualizar**: para actualizar el clúster a la última versión del motor de acuerdo con el plan elegido en el paso anterior. + **Cancelar**: para cancelar la actualización del motor del clúster y continuar con la versión actual del motor del clúster. ------ #### [ Using the AWS CLI ] Puede aplicar actualizaciones de parches a su clúster mediante la `apply-pending-maintenance-action` operación AWS CLI y con los siguientes parámetros. **Parameters** + **--resource-identifier**: obligatorio. El ARN del clúster de Amazon DocumentDB que va a actualizar. + **--apply-action**: obligatorio. Se permiten los siguientes valores. Para actualizar la versión de su motor de clúster, utilice `db-upgrade`. + **db-upgrade** + **system-update** + **--opt-in-type**: obligatorio. Se permiten los siguientes valores. + `immediate`: aplicar inmediatamente la acción de mantenimiento. + `next-maintenance`: aplicar la operación de mantenimiento durante el siguiente período de mantenimiento. + `undo-opt-in`: cancelar todas las solicitudes de alta `next-maintenance` existentes. **Example** En el siguiente ejemplo se actualiza la versión del motor de `sample-cluster` a la versión 4.0.0. Para Linux, macOS o Unix: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \ --apply-action db-upgrade \ --opt-in-type immediate ``` Para Windows: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^ --apply-action db-upgrade ^ --opt-in-type immediate ``` El resultado de esta operación será similar a lo que se indica a continuación: ``` { "ResourcePendingMaintenanceActions": { "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38", "PendingMaintenanceActionDetails": [ { "CurrentApplyDate": "2019-02-20T20:57:06.904Z", "Description": "Bug fixes", "ForcedApplyDate": "2019-02-25T21:46:00Z", "OptInStatus": "immediate", "Action": "db-upgrade", "AutoAppliedAfterDate": "2019-02-25T07:41:00Z" } ] } } ``` ------ # Detención e inicio de un clúster de bases de datos de Amazon DocumentDB La detención e inicio de los clústeres de Amazon DocumentDB puede ayudarle a administrar los costos de entornos de desarrollo y pruebas. En lugar de crear y eliminar clústeres y las instancias cada vez que utilice Amazon DocumentDB, puede detener temporalmente todas las instancias en el clúster cuando ya no son necesarias. A continuación, puede iniciarlos de nuevo cuando reanude sus pruebas. **Topics** + [Información general de detención e inicio de un clúster](#db-cluster-stop-start-overview) + [Operaciones que puede llevar a cabo en un clúster detenido](#db-cluster-stopped-operations) ## Información general de detención e inicio de un clúster Durante los periodos en los que no necesite un clúster de Amazon DocumentDB, puede detener todas las instancias de ese clúster a la vez. A continuación, puede volver a iniciar el clúster en cualquier momento que necesite usarlo. El inicio y la detención simplifican los procesos de configuración y eliminación de clústeres usados para desarrollo, pruebas o actividades similares que no requieren disponibilidad continua. Puede detener e iniciar un clúster con Consola de administración de AWS o AWS CLI con una sola acción, independientemente del número de instancias que haya en el clúster. Aunque el clúster se detenga, el volumen de almacenamiento del clúster permanece sin cambios. Solo se le cobrará el almacenamiento, las instantáneas manuales y el almacenamiento de la copia de seguridad automática dentro de su intervalo de retención especificado. No se le cobrarán las horas de ninguna instancia. Después de siete días, Amazon DocumentDB vuelve a iniciar automáticamente el clúster de base de datos para asegurarse de llevar a cabo las actualizaciones de mantenimiento necesarias. Cuando el clúster comience después de siete días, se le comenzará a cobrar las instancias en el clúster de nuevo. Cuando el clúster se detenga, no podrá consultar el volumen de almacenamiento, ya que la consulta requiere que las instancias estén disponibles. Cuando se detiene un clúster de Amazon DocumentDB, ni el clúster ni sus instancias se pueden modificar en modo alguno. Esto incluye añadir o eliminar instancias o eliminar el clúster. ------ #### [ Using the Consola de administración de AWS ] El procedimiento siguiente le muestra cómo detener un clúster con una o varias instancias en un estado disponible o iniciar un clúster detenido. **Detención o inicio de un clúster 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)**. **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. 1. En la lista de clústeres, elija el botón situado a la izquierda del nombre del clúster que quiera detener o iniciar. 1. Elija **Actions** (Acciones) y, a continuación, elija la acción que desea realizar en el clúster. + Si desea detener el clúster y el clúster está disponible: 1. Elija **Detener**. ![\[Imagen: detención de un clúster\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-stop.png) Para evitar la activación del mecanismo de conmutación por error, la operación de detención para primero las instancias de réplica y, a continuación, la instancia principal. 1. En el cuadro de diálogo de confirmación, acepte que desea detener el clúster seleccionado **Stop cluster** (Detener clúster) o mantenga el clúster en ejecución mediante **Cancel** (Cancelar). ![\[Imagen: inicio de un clúster\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png) + Si desea iniciar el clúster y este se detiene, seleccione **Start** (Iniciar). ![\[Imagen: inicio de un clúster\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-start.png) 1. Monitorice el estado del clúster y sus instancias. Si ha iniciado el clúster, podrá volver a utilizar el clúster cuando este y sus instancias estén *disponibles*. Para obtener más información, consulte [Determinación del estado de un clúster](db-cluster-status.md). ![\[Imagen: estado de los clústeres detenidos e iniciados\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png) ------ #### [ Using the AWS CLI ] Los siguientes ejemplos de código le muestras cómo detener un clúster con una o varias instancias en un estado disponible o iniciar un clúster detenido. Para detener un clúster con una o más instancias disponibles mediante el AWS CLI, utilice la operación. `stop-db-cluster` Para iniciar un clúster detenido, utilice la operación `start-db-cluster`. En ambas operaciones se utiliza el parámetro `--db-cluster-identifier`. **Parámetro** + **--db-cluster-identifier**: obligatorio. El nombre del clúster que detener e iniciar. **Example — Para detener un clúster mediante el AWS CLI** El siguiente código detiene el clúster `sample-cluster`. El clúster debe tener una o más instancias en un estado disponible. Para Linux, macOS o Unix: ``` aws docdb stop-db-cluster \ --db-cluster-identifier sample-cluster ``` Para Windows: ``` aws docdb stop-db-cluster ^ --db-cluster-identifier sample-cluster ``` **Example — Para iniciar un clúster mediante el AWS CLI** El siguiente código inicia el clúster `sample-cluster`. El clúster debe estar detenido actualmente. Para Linux, macOS o Unix: ``` aws docdb start-db-cluster \ --db-cluster-identifier sample-cluster ``` Para Windows: ``` aws docdb start-db-cluster ^ --db-cluster-identifier sample-cluster ``` ------ ## Operaciones que puede llevar a cabo en un clúster detenido Mientras un clúster de Amazon DocumentDB esté detenido, puede realizar una point-in-time restauración en cualquier punto dentro del período de retención de copias de seguridad automatizado especificado. Para obtener más información sobre cómo realizar una point-in-time restauración, consulte[Restauración a un momento dado](backup_restore-point_in_time_recovery.md). No se puede modificar la configuración de un clúster de Amazon DocumentDB ni de ninguna de sus instancias mientras el clúster esté detenido. Tampoco puede añadir ni quitar instancias del clúster, ni eliminar el clúster si todavía tiene alguna instancia asociada. Debe iniciar el clúster antes de realizar cualquier tarea administrativa de ese tipo. Amazon DocumentDB aplica cualquier mantenimiento programado a su clúster detenido solo después de que se vuelva a iniciar. Después de siete días, Amazon DocumentDB inicia automáticamente un clúster detenido para que no se quede demasiado rezagado en su estado de mantenimiento. Cuando el clúster se reinicie, se le comenzará a cobrar las instancias en el clúster de nuevo. Cuando un clúster está detenido, Amazon DocumentDB no realiza los copias de seguridad automatizadas ni amplía el período de retención de copia de seguridad. # Eliminación de un clúster de Amazon DocumentDB Puede eliminar un clúster de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para eliminar un clúster, el clúster debe tener el estado *disponible* y no debe tener ninguna instancia asociada a él. Si el clúster está detenido, inicie primero el clúster, espere a que el clúster esté *disponible*, y, a continuación, elimine el clúster. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md). ## Protección contra eliminación Para proteger su clúster contra la eliminación accidental, puede habilitar la *protección contra eliminación*. La protección contra eliminación se habilita de forma predeterminada cuando crea un clúster mediante la consola. Sin embargo, la protección contra eliminación está deshabilitada de forma predeterminada si crea un clúster con la AWS CLI. Amazon DocumentDB aplica la protección contra eliminación para un clúster si realiza la operación de eliminación mediante la consola o la AWS CLI. Si la protección contra eliminación está habilitada, no podrá eliminar un clúster. Para eliminar un clúster con la protección contra eliminación habilitada, primero debe modificar el clúster y deshabilitar la protección contra eliminación. Cuando use la consola con la protección contra eliminación habilitada en un clúster, no podrá eliminar la última instancia del clúster, ya que también se eliminará el clúster. Puede eliminar la última instancia de un clúster con protección contra eliminación con la AWS CLI. Sin embargo, el propio clúster sigue existiendo y se conservan los datos. Puede acceder a los datos mediante la creación de nuevas instancias para el clúster. Para obtener más información sobre cómo habilitar y deshabilitar la protección contra eliminación, consulte: + [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md) + [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md) ------ #### [ Using the Consola de administración de AWS ] Para eliminar un clúster mediante el Consola de administración de AWS, la protección de eliminación debe estar deshabilitada. **Para determinar si un clúster tiene habilitada la protección contra eliminación, realice el siguiente procedimiento:** 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)**. **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. 1. Tenga en cuenta que en el cuadro de navegación de clústeres, la columna **Identificador de clústeres** muestra tanto los clústeres como las instancias. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla. ![\[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/clusters.png) 1. Elija el nombre del clúster y seleccione la pestaña **Configuración**. En la sección **Detalles del clúster** busque **Protección contra eliminación**. Si la protección contra eliminación está habilitada, modifique el clúster para deshabilitar la protección contra eliminación. Para obtener más información sobre la modificación de un clúster, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md). Una vez que se deshabilite la **protección contra eliminación**, podrá eliminar el clúster. **Para eliminar un clúster:** 1. En el panel de navegación, seleccione **Clusters (Clústeres)**. 1. Determine si el clúster tiene alguna instancia; para ello, compruebe la columna **Identificador de clústeres** para determinar si aparecen las instancias enumeradas a continuación. Para poder eliminar un clúster, debe eliminar todas sus instancias. Para obtener más información, consulte [Eliminación de una instancia de Amazon DocumentDB](db-instance-delete.md). 1. Si su clúster dispone de instancias, realice uno de los siguientes pasos. + Si el clúster no tiene instancias, seleccione el botón situado a la izquierda del nombre del clúster y elija **Acciones**. En el menú desplegable, seleccione **Eliminar**. Complete el cuadro de diálogo **Delete ** (Eliminar ) y, a continuación, elija **Delete** (Eliminar). + Si el clúster tiene una o varias instancias, haga lo siguiente: 1. En el panel de navegación, seleccione **Clusters (Clústeres)**. 1. Elimine cada una de las instancias del clúster. Para ello, seleccione la casilla de verificación situada a la izquierda del nombre del clúster. Seleccione **Acciones** y, a continuación, elija **Eliminar**. Complete el cuadro de diálogo **Delete ** (Eliminar ) y, a continuación, elija **Delete** (Eliminar). Cuando elimine la última instancia, el clúster también se eliminará. Para obtener más información sobre la eliminación de instancias, consulte [Eliminación de una instancia de Amazon DocumentDB](db-instance-delete.md). La eliminación del clúster puede tardar varios minutos. Para monitorizar el estado del clúster, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md). ------ #### [ Using the AWS CLI ] No puede eliminar un clúster que tenga instancias asociadas. Para determinar qué instancias están asociadas al clúster, ejecute el comando `describe-db-clusters` y elimine todas las instancias del clúster. A continuación, si es necesario, deshabilite la protección contra eliminación de su clúster y, por último, elimine el clúster. 1. **En primer lugar, elimine todas las instancias del clúster.** Para determinar qué instancias necesita eliminar, ejecute el siguiente comando. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "sample-cluster", [ "sample-instance-1", "sample-instance-2" ] ] ] ``` Si el clúster que desea eliminar tiene instancias, elimínelas como se muestra a continuación. ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance ``` 1. **En segundo lugar, deshabilite la protección contra eliminación.** El uso de AWS CLI para eliminar todas las instancias de un clúster no elimina el clúster. También debe eliminar el clúster, pero puede hacerlo solo si se deshabilita la protección contra eliminación. Para determinar si el clúster tiene la protección contra eliminación habilitada, ejecute el siguiente comando. **sugerencia** Para ver el estado de la protección contra eliminación de todos los clústeres de Amazon DocumentDB, omita el parámetro `--db-cluster-identifier`. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]' ``` La salida de esta operación será similar a lo que se indica a continuación. ``` [ [ "sample-cluster", "true" ] ] ``` Si el clúster tiene la protección contra eliminación habilitada, modifique el clúster y deshabilite la protección contra eliminación. Para deshabilitar la protección contra eliminación en el clúster, ejecute el siguiente comando. ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --no-deletion-protection \ --apply-immediately ``` 1. **Por último, elimine el clúster.** Una vez que la protección contra eliminación esté deshabilitada, podrá eliminar el clúster. Para eliminar un clúster, utilice la operación `delete-db-cluster` con los siguientes parámetros. + **--db-cluster-identifier**: obligatorio. El identificador del clúster que desee eliminar. + **--final-db-snapshot-identifier**: opcional. Si desea una instantánea final, debe incluir este parámetro con un nombre para la instantánea final. Debe incluir `--final-db-snapshot-identifier` o `--skip-final-snapshot`. Restricciones en la nomenclatura: + Debe tener [1-63] letras, números o guiones. + El primer carácter debe ser una letra. + No puede terminar con un guion ni contener dos guiones consecutivos. + Debe ser único para todos los clústeres de Amazon RDS, Amazon Neptune y Amazon DocumentDB por región. Cuenta de AWS + **--skip-final-snapshot**: opcional. Use este parámetro solo si no desea realizar una instantánea final antes de eliminar el clúster. El comportamiento predeterminado es realizar una instantánea final. Debe incluir `--final-db-snapshot-identifier` o `--skip-final-snapshot`. El siguiente AWS CLI código elimina el clúster `sample-cluster` con una instantánea final. La operación genera un error si hay las instancias asociadas al clúster o si está habilitada la protección contra eliminación. **Example** Para Linux, macOS o Unix: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-final-snapshot ``` Para Windows: ``` aws docdb delete-db-cluster ^ --db-cluster-identifier sample-cluster ^ --final-db-snapshot-identifier sample-cluster-final-snapshot ``` **Example** El siguiente AWS CLI código elimina el clúster `sample-cluster` sin tomar una instantánea final. Para Linux, macOS o Unix: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot ``` Para Windows: ``` aws docdb delete-db-cluster ^ --db-cluster-identifier sample-cluster ^ --skip-final-snapshot ``` El resultado de la operación `delete-db-cluster` es el clúster que se va a eliminar. La eliminación del clúster puede tardar varios minutos. Para monitorizar el estado del clúster, consulte [Monitorización del estado de un clúster](monitoring_docdb-cluster_status.md). ------ # Escalado de clústeres de Amazon DocumentDB Amazon DocumentDB le permite escalar el almacenamiento y la computación en los clústeres en función de sus necesidades. En esta sección se describe cómo puede utilizar el escalado de almacenamiento, el escalado de instancia y el escalado de lectura para administrar el rendimiento y el escalado de los clústeres e instancias de Amazon DocumentDB. **Topics** + [Escalado del almacenamiento](#db-cluster-manage-scaling-storage) + [Escalado de instancia](#db-cluster-manage-scaling-instance) + [Escalado de lectura](#db-cluster-manage-scaling-reads) + [Escalado de escritura](#db-cluster-manage-scaling-writes) ## Escalado del almacenamiento El almacenamiento de Amazon DocumentDB se escala automáticamente con los datos del volumen de clúster. A medida que crecen los datos, el almacenamiento del volumen de clúster aumenta en incrementos de 10 GiB hasta un máximo de 128 TiB. ## Escalado de instancia Puede escalar el clúster de base de datos de Amazon DocumentDB como considere necesario modificando la clase de instancia de base de datos para cada instancia de base de datos del clúster de base de datos. Amazon DocumentDB admite varias clases de instancias que están optimizadas para Amazon DocumentDB. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md). ## Escalado de lectura Puede realizar el escalado de lectura de su clúster de Amazon DocumentDB creando un máximo de 15 réplicas de Amazon DocumentDB en el clúster. Cada réplica de Amazon DocumentDB devuelve los mismos datos del volumen de clúster con un retardo de réplica mínimo, normalmente menos de 100 milisegundos una vez que la instancia principal ha escrito una actualización. A medida que el tráfico de lectura aumenta, puede crear réplicas de Amazon DocumentDB adicionales y conectarlas directamente para distribuir la carga de lectura del clúster de base de datos. Las réplicas de Amazon DocumentDB no tienen que ser de la misma clase de instancia de base de datos que la instancia principal. Para obtener más información, consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md). Para escalar las lecturas con Amazon DocumentDB, recomendamos que se conecte al clúster como conjunto de réplicas y distribuya las lecturas a las instancias de réplica mediante las funciones integradas de preferencias de lectura del controlador. Para obtener más información, consulte [Conexión a Amazon DocumentDB como conjunto de réplicas](connect-to-replica-set.md). ## Escalado de escritura Puede escalar la capacidad de escritura en el clúster de Amazon DocumentDB aumentando el tamaño de la instancia principal del clúster. En esta sección se proporcionan dos métodos para escalar la instancia principal del clúster en función de sus necesidades. La primera opción busca minimizar el impacto de la aplicación, pero requiere completar más pasos. La segunda opción optimiza la simplicidad ya que tiene menos pasos, pero conlleva el inconveniente de tener más impacto potencial en la aplicación. En función de la aplicación, puede elegir cuál de los enfoques siguientes es el mejor en su caso. Para obtener más información sobre los tamaños y costos de instancias disponibles, consulte la página [Precios de Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/). 1. **Optimizar para obtener una alta disponibilidad y rendimiento**: si se conecta al clúster en el [modo de conjunto de réplicas](connect-to-replica-set.md) (recomendado), puede utilizar el siguiente proceso para minimizar el impacto en la aplicación al escalar la instancia principal. Este método minimiza el impacto porque mantiene el clúster en alta disponibilidad o por encima de ella y los destinos de escalado de lectura se agregan al clúster como instancias, en lugar de actualizarse en su lugar. 1. Agregue una o varias réplicas del tipo de instancia mayor al clúster (consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md)). Se recomienda que todas las réplicas sean del mismo tipo de instancia o mayor que la principal. Esto evita una reducción involuntaria en el rendimiento de escritura al conmutar por error a un tipo de instancia más pequeño. Para la mayoría de los clientes, esto significa duplicar temporalmente el número de instancias de su clúster y, a continuación, eliminar las réplicas más pequeñas después de completar el escalado. 1. Establezca el nivel de conmutación por error en todas las réplicas nuevas en prioridad cero, garantizando que una réplica del tipo de instancia más pequeño tenga la prioridad de conmutación por error más alta. Para obtener más información, consulte [Control del destino de la conmutación por error](failover.md#failover-target_control). 1. Inicie una conmutación por error manual, que promoverá una de las nuevas réplicas para que sea la instancia principal. Para obtener más información, consulte [Prueba de conmutación por error](failover.md#failover-testing). **nota** Esto incurrirá en \$130 segundos de tiempo de inactividad para el clúster. Por favor, planifique en consecuencia. 1. Elimine todas las réplicas de un tipo de instancia menor que la nueva instancia principal del clúster. 1. Vuelva a establecer el nivel de conmutación por error de todas las instancias en la misma prioridad (normalmente, esto significa volver a establecerlas en 1). Como ejemplo, suponga que tiene un clúster que contiene actualmente tres instancias `r5.large` (una principal y dos réplicas) y desea escalar a un tipo de instancia `r5.xlarge`. Para ello, primero agregaría tres instancias de réplica `r5.xlarge` al clúster y, a continuación, establecería el nivel de conmutación por error de las nuevas réplicas `r5.xlarge` en cero. A continuación, iniciaría una conmutación por error manual (entendiendo que su aplicación experimentará \$130 segundos de tiempo de inactividad). Una vez completada la conmutación por error, eliminaría las tres instancias `r5.large` del clúster, dejando el clúster escalado a instancias `r5.xlarge`. Para ayudar a optimizar los costos, las instancias de Amazon DocumentDB se facturan en incrementos de un segundo con un cargo mínimo de 10 minutos a partir de la implementación de un cambio de estado que se pueda facturar, como la creación, la modificación o la eliminación de una instancia. Para obtener más información, consulte [Optimización de costos](best_practices.md#best_practices-cost_optimization) en la documentación de prácticas recomendadas. 1. **Optimizar la simplicidad**: este enfoque optimiza la simplicidad. No expande ni contrae el clúster, pero podría reducir temporalmente la capacidad de lectura. Es posible que al cambiar la clase de instancia de una réplica, la instancia deje de atender las solicitudes durante un breve período de tiempo, desde unos pocos segundos a menos de 30 segundos. Si se conecta al clúster en el [modo de conjunto de réplicas](connect-to-replica-set.md) (recomendado), esto reduciría su capacidad de lectura en una réplica (por ejemplo, hasta el 66 % de la capacidad en un clúster de 3 nodos o el 75 % de la capacidad en un clúster de 4 nodos, etc.) durante la operación de escalado. 1. Escale una de las instancias de réplica del clúster. Para obtener más información, consulte [Administración de clases de instancias](db-instance-classes.md). 1. Espere hasta que la instancia esté disponible (consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md)). **nota** Esto incurrirá en \$130 segundos de tiempo de inactividad para el clúster. Por favor, planifique en consecuencia. 1. Continúe ejecutando los pasos 1 y 2 hasta que se hayan escalado todas las instancias de réplicas, una por una. 1. Iniciar una conmutación por error manual. Esto promoverá una de las réplicas para que sea la instancia principal. Para obtener más información, consulte [Conmutación por error a Amazon DocumentDB](failover.md). **nota** Esto provocará un tiempo de inactividad de hasta 30 segundos para el clúster, aunque suele llevar menos tiempo. Por favor, planifique en consecuencia. 1. Escale la anterior instancia principal (que ahora es una réplica). # 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. **Topics** + [Información general de la clonación de Amazon DocumentDB](#db-cloning-overview) + [Limitaciones de la clonación de Amazon DocumentDB](#db-cloning-limitations) + [Cómo funciona la clonación de Amazon DocumentDB](#db-how-db-cloning-works) + [Creación de un clon de Amazon DocumentDB](#db-creating-db-clone) ## 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, consulte[Cómo funciona la clonación de Amazon DocumentDB](#db-how-db-cloning-works). 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. + Se puede crear un clon en una nube privada virtual (VPC) diferente de la del clúster de base de datos de Amazon DocumentDB. Si lo hace, las subredes del mismo 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-write*protocolo 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](db-clusters.md). **Topics** + [Comprensión del protocolo copy-on-write](#db-copy-on-write-protocol) + [Eliminación de un volumen del clúster de origen](#db-deleting-source-cluster-volume) ### 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. ![\[Volumen del clúster de Amazon DocumentDB con 4 páginas para clúster de origen, A y clon, B\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png) 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. ![\[Volumen del clúster de base de datos de origen de Amazon DocumentDB y su clon, ambos con cambios.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png) 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. ![\[Volumen del clúster de base de datos de origen de Amazon DocumentDB y su clon, ambos con cambios.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png) 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 Consola de administración de AWS 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 Consola de administración de AWS ] El siguiente procedimiento describe cómo clonar un clúster de Amazon DocumentDB usando la Consola de administración de AWS. Crear un clon con los Consola de administración de AWS 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 que sea propiedad de su AWS cuenta mediante el Consola de administración de AWS** 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. Elija su clúster de base de datos de Amazon DocumentDB de la lista y para **Acciones**, elija **Crear clon**. ![\[La creación de un clon comienza seleccionando su clúster de base de datos de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png) 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. 1. En la sección **Settings**, realice lo siguiente: 1. 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. 1. Para la **Configuración de instancias**, seleccione una **Clase de instancia** adecuada para su clúster clonado de Amazon DocumentDB. ![\[La creación de un clon comienza seleccionando su clúster de Amazon DocumentDB y especificando el tamaño de la instancia de base de datos.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png) 1. En la **Configuración de red**, elija un **Grupo de subredes** para su caso de uso y los grupos de seguridad de VPC asociados. 1. En el caso de **E ncryption-at-rest**, si el clúster de origen (el clúster que se está clonando) tiene el cifrado activado, el clúster clonado también debe tener el cifrado 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. ![\[Especifique la configuración de red y cifrado para el clon del clúster de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png) 1. 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). ![\[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.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png) 1. 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](db-clusters.md). 1. 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: 1. Cree el clon mediante el comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. 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. 1. Cree la instancia de Amazon DocumentDB para el clon mediante el comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). También puede especificar la `--region` en cada uno de los comandos de la CLI que siguen. **Topics** **Creación del clon** Los parámetros específicos que se pasan al comando `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` de la CLI 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** + Utilice el comando `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` de la CLI y especifique los valores para los siguientes parámetros: + `--db-cluster-identifier`: elija un nombre significativo para su clon. Se asigna un nombre al clon cuando se utiliza el comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. + `--restore-type`: utilice `copy-on-write` para crear un clon del clúster de base de datos de origen. Sin este parámetro, `restore-db-cluster-to-point-in-time` restaura el clúster de base de datos de Amazon DocumentDB en lugar de crear un clon. El valor predeterminado para `restore-type` es `full-copy`. + `--source-db-cluster-identifier`: utilice el nombre del clúster de base de datos de Amazon DocumentDB de origen que desea clonar. + `--use-latest-restorable-time`: este valor apunta a los datos de volumen restaurables más recientes para el clon. Este parámetro es obligatorio para `restore-type copy-on-write`, pero no se puede utilizar `restore-to-time parameter` con él. 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 objeto JSON que contiene 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 comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI 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 | Description (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. | ------ # Información general de la tolerancia a errores de clúster de Amazon DocumentDB Los clústeres de Amazon DocumentDB ofrecen tolerancia a errores por diseño. El volumen de cada clúster abarca varias zonas de disponibilidad en una sola Región de AWS, y cada zona de disponibilidad contiene una copia de los datos del volumen del clúster. Esta funcionalidad significa que el clúster puede tolerar un error de una zona de disponibilidad sin perder datos y con tan solo una interrupción breve del servicio. Si se produce un error en la instancia principal de un clúster de base de datos, Amazon DocumentDB realiza automáticamente una conmutación por error a una nueva instancia principal de una de las dos formas siguientes: + Promocionando una réplica de Amazon DocumentDB existente a la nueva instancia principal elegida en función de la configuración del nivel de promoción de cada réplica y, a continuación, creando una que sustituya a la anterior principal. Una conmutación por error a la instancia de réplica suele tardar menos de 30 segundos. Las operaciones de lectura y escritura pueden sufrir breves interrupciones durante este período. Para aumentar la disponibilidad de su clúster de base de datos, es recomendable que cree al menos una o varias réplicas de Amazon DocumentDB en dos o más zonas de disponibilidad diferentes. + Creando una nueva instancia principal. Esto solo ocurre si no tiene una instancia de réplica en el clúster y puede tardar unos minutos en completarse. Si el clúster tiene una o varias réplicas de Amazon DocumentDB, se promueve una réplica de Amazon DocumentDB a instancia principal durante un evento de error. Un evento de error provoca una interrupción breve durante la cual las operaciones de lectura y escritura generan errores con una excepción. Sin embargo, el servicio se suele restaurar en menos de 120 segundos y, en muchos casos, en menos de 60 segundos. Para aumentar la disponibilidad de su clúster de base de datos, es recomendable que cree al menos una o varias réplicas de Amazon DocumentDB en dos o más zonas de disponibilidad diferentes. Puede personalizar el orden en que se promueven las réplicas de Amazon DocumentDB a instancia principal tras un error mediante la asignación de una prioridad a cada réplica. Las prioridades van desde 0 para la prioridad más alta hasta 15 para la más baja. Si la instancia principal experimenta un error, la réplica de Amazon DocumentDB que tenga la máxima prioridad pasará a ser la instancia principal. Puede modificar la prioridad de una réplica de Amazon DocumentDB en cualquier momento. Al modificar la prioridad, no se activa una conmutación por error. Puede usar la operación `modify-db-instance` con el parámetro `--promotion-tier`. Para obtener más información acerca de cómo personalizar la prioridad de conmutación por error de una instancia, consulte [Conmutación por error a Amazon DocumentDB](failover.md). Puede haber más de una réplica de Amazon DocumentDB con la misma prioridad, lo que genera niveles de promoción. Si dos o más réplicas de Amazon DocumentDB comparten la misma prioridad, pasará a ser la instancia principal la réplica que tiene un tamaño mayor. Si dos o más réplicas de Amazon DocumentDB tienen la misma prioridad y el mismo tamaño, se promueve una réplica arbitraria del mismo nivel de promoción. Si el clúster no contiene ninguna réplica de Amazon DocumentDB, la instancia principal se vuelve a crear durante un evento de error. Un evento de error provoca una interrupción durante la cual las operaciones de lectura y escritura generan errores con una excepción. El servicio se restaura cuando se crea la nueva instancia principal, un proceso que normalmente dura menos de 10 minutos. Promover una réplica de Amazon DocumentDB a instancia principal es mucho más rápido que crear una nueva instancia principal. # Administración de instancias de Amazon DocumentDB Los siguientes temas proporcionan información que le ayudarán a administrar sus instancias de Amazon DocumentDB. Incluyen detalles sobre las clases y los estados de instancias, y cómo crear, eliminar y modificar una instancia. **Topics** + [Determinación del estado de una instancia](#db-instance-status) + [Ciclo de vida de la instancia](db-instance-life-cycle.md) + [Administración de clases de instancias](db-instance-classes.md) + [Instancias respaldadas por NVMe](db-instance-nvme.md) ## Determinación del estado de una instancia Para ver los estados válidos de las instancias, su significado y saber cómo determinar el estado de las instancias, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). # Ciclo de vida de instancia de Amazon DocumentDB El ciclo de vida de una instancia Amazon DocumentDB comprende su creación, modificación, mantenimiento y actualización, ejecución de copias de seguridad y restauraciones, reinicio, actualización y eliminación. En esta sección se proporciona información sobre cómo realizar estos procesos. **Topics** + [Adición de una instancia](db-instance-add.md) + [Descripción de instancias](db-instance-view-details.md) + [Modificación de una instancia](db-instance-modify.md) + [Reinicio de una instancia](db-instance-reboot.md) + [Eliminación de una instancia](db-instance-delete.md) Puede crear una nueva instancia de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para añadir una instancia a un clúster, el clúster debe tener un estado *disponible*. No puede añadir una instancia a un clúster que está detenido. Si el clúster está detenido, inicie primero el clúster, espere a que el clúster esté *disponible* y, a continuación, añada una instancia. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md). **nota** Si crea un clúster de Amazon DocumentDB mediante la consola, se crea automáticamente una instancia al mismo tiempo. Si desea crear instancias adicionales, utilice uno de los siguientes procedimientos. # Agregación de una instancia de Amazon DocumentDB a un clúster ------ #### [ Using the Consola de administración de AWS ] El siguiente procedimiento permite crear una instancia de su clúster mediante la consola 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)**. **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. 1. Para elegir el clúster al que desea añadir una instancia, seleccione el botón situado a la izquierda del nombre del clúster. 1. Elija **Actions (Acciones)** y después **Add instances (Añadir instancias)**. 1. En la página **Add instance to (Añadir instancia a)**, repita los pasos que se describen a continuación para cada instancia que desee añadir al clúster. Puede tener un máximo de 15. 1. **Instance identifier**: 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. Restricciones en cuanto a la nomenclatura de las instancias: + Debe tener [1-63] letras, números o guiones. + El primer carácter debe ser una letra. + No puede terminar con un guion ni contener dos guiones consecutivos. + Debe ser único para todas las instancias de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS 1. **Clase de instancia**: en la lista desplegable, elija el tipo de instancia que desea para esta instancia. 1. **Capa de promoción**: en la lista, elija la capa de promoción de la instancia, o bien elija *Sin preferencia* para permitir que Amazon DocumentDB establezca la capa de promoción de la instancia. Un número menor indica una mayor prioridad. Para obtener más información, consulte [Control del destino de la conmutación por error](failover.md#failover-target_control). 1. Para añadir más instancias, elija **Add additional instances (Agregar instancias adicionales)** y repita los pasos a, b y c. 1. Finalizar la operación. + Para añadir las instancias a su clúster, seleccione **Create (Crear)**. + Para cancelar la operación, elija **Cancel (Cancelar)**. La creación de una instancia puede tardar varios minutos. Puede usar la consola o ver el AWS CLI estado de la instancia. Para obtener más información, consulte [Monitorización del estado de una instancia](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Usa la `create-db-instance` AWS CLI operación con los siguientes parámetros para crear la instancia principal del clúster. + **--db-instance-class**: obligatorio. La capacidad de memoria e informática de la instancia (por ejemplo, `db.m4.large`). No todas las clases de instancia están disponibles en todas las Regiones de AWS. + **--db-instance-identifier**: obligatorio. Una cadena que identifica la instancia. Restricciones en cuanto a la nomenclatura de las instancias: + Debe tener [1-63] letras, números o guiones. + El primer carácter debe ser una letra. + No puede terminar con un guion ni contener dos guiones consecutivos. + Debe ser único para todas las instancias de Amazon RDS, Neptune y Amazon DocumentDB por región. Cuenta de AWS + **--engine**: obligatorio. Debe ser `docdb`. + **--availability-zone**: opcional. La zona de disponibilidad en la que desea crear esta instancia. Use este parámetro para colocar sus instancias en diferentes zonas de disponibilidad con el fin de aumentar la tolerancia a errores. Para obtener más información, consulte [Alta disponibilidad y replicación de Amazon DocumentDB](replication.md). + **--promotion-tier**: opcional. El nivel de prioridad de conmutación por error de esta instancia. Debe ser un número comprendido entre 0 y 15; un número menor indica una mayor prioridad. Para obtener más información, consulte [Control del destino de la conmutación por error](failover.md#failover-target_control). 1. **En primer lugar, determine en qué zonas de disponibilidad puede crear la instancia. ** Si desea especificar la zona de disponibilidad, antes de crear la instancia, ejecute el siguiente comando para determinar en qué zonas de disponibilidad están disponibles para el clúster de Amazon DocumentDB. Para Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` Para Windows: ``` aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` La salida de esta operación será similar a lo que se indica a continuación. ``` [ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] ``` 1. **En segundo lugar, determine qué clases de instancias puede crear en su región. ** Para determinar qué clases de instancias tiene a su disposición en su región, ejecute el siguiente comando. En el resultado, elija una clase de instancia para la instancia que desea agregar al clúster de Amazon DocumentDB. Para Linux, macOS o Unix: ``` aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` Para Windows: ``` aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` La salida de esta operación será similar a lo que se indica a continuación. ``` [ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] ``` 1. **Agregar una instancia a su clúster de Amazon DocumentDB.** Para agregar una instancia al clúster de Amazon DocumentDB, ejecute el siguiente comando. Para Linux, macOS o Unix: ``` aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdb ``` Para Windows: ``` aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdb ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2" } } ``` La creación de la instancia puede tardar varios minutos. Puede usar la consola o ver el AWS CLI estado de la instancia. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Descripción de las instancias de Amazon DocumentDB Puede utilizar la consola de administración de Amazon DocumentDB o la AWS CLI para ver detalles como los puntos de conexión, los grupos de seguridad, la autoridad de certificación y los grupos VPCs de parámetros relacionados con sus instancias de Amazon DocumentDB. ------ #### [ Using the Consola de administración de AWS ] Para ver los detalles de las instancias mediante la Consola de administración de AWS, siga los pasos que se indican a continuación. 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)**. **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. 1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla. ![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png) 1. En la lista de instancias, elija el nombre de la instancia cuyos detalles desea ver. La información sobre la instancia se organiza en los siguientes grupos: + **Resumen**: información general sobre la instancia, incluida la versión del motor, la clase, el estado y cualquier mantenimiento pendiente. + **Conectividad y seguridad**: la sección **Conectar** enumera los puntos de conexión para conectarse a esta instancia con el intérprete de comandos de mongo o con una aplicación. La sección **Grupos de seguridad** muestra los grupos de seguridad asociados a esta instancia y su ID de VPC y descripciones. + **Configuración**: la sección **Detalles** muestra las configuraciones y el estado de la instancia, incluidos el nombre de recurso de Amazon (ARN), el punto de conexión, el rol, la clase y la entidad de certificación de la instancia. También enumera la seguridad y la configuración de red de la instancia, así como la información de copia de seguridad. La sección **Detalles del clúster** muestra los detalles del clúster al que pertenece esta instancia. La sección **Instancias del clúster** muestra todas las instancias que pertenecen al clúster con el rol de cada instancia y el estado del grupo de parámetros del clúster. **nota** Puede modificar el clúster asociado a la instancia seleccionando **Modificar** junto al encabezado **Detalles del clúster**. Para obtener más información, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md). + **Supervisión**: CloudWatch registra las métricas de esta instancia. Para obtener más información, consulte [Supervisión de Amazon DocumentDB con CloudWatch](cloud_watch.md). + **Eventos y etiquetas**: la sección de **eventos recientes** muestra los eventos recientes de esta instancia. Amazon DocumentDB mantiene un registro de los eventos relacionados con los clústeres, las instancias, las instantáneas, los grupos de seguridad y los grupos de parámetros de clúster. Esta información incluye la fecha, la hora y el mensaje asociados a cada evento. La sección **Etiquetas** muestra las etiquetas asociadas a este clúster. Para obtener más información, consulte [Etiquetado de recursos de Amazon DocumentDB](tagging.md). ------ #### [ Using the AWS CLI ] Para ver los detalles de sus instancias de Amazon DocumentDB mediante el AWS CLI, utilice el `describe-db-clusters` comando tal y como se muestra en los ejemplos siguientes. Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html) en la *Referencia de la API para administración de recursos de Amazon DocumentDB*. **nota** Para ciertas características de administración, como la administración del ciclo de vida de clúster y de instancia, Amazon DocumentDB aprovecha la tecnología operativa que se comparte con Amazon RDS. El parámetro de filtro `filterName=engine,Values=docdb` devuelve solo clústeres de Amazon DocumentDB. 1. **Enumere todas las instancias de Amazon DocumentDB.** En el siguiente AWS CLI código se enumeran los detalles de todas las instancias de Amazon DocumentDB de una región. Para Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` Para Windows: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` 1. **Enumeración de todos los detalles de una instancia de Amazon DocumentDB especificada** El siguiente código enumera los detalles de `sample-cluster-instance`. Incluir el parámetro `--db-instance-identifier` con el nombre de una instancia restringe la salida a la información sobre esa instancia en particular. Para Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` Para Windows: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` El resultado de esta operación será similar a lo que se indica a continuación: ``` { "DBInstances": [ { "DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM", "DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "DBInstanceClass": "db.r5.large", "DBInstanceStatus": "creating", "AutoMinorVersionUpgrade": true, "PreferredMaintenanceWindow": "fri:09:32-fri:10:02", "BackupRetentionPeriod": 1, "StorageEncrypted": true, "DBClusterIdentifier": "sample-cluster", "EngineVersion": "3.6.0", "AvailabilityZone": "us-east-1a", "Engine": "docdb", "PromotionTier": 2, "DBInstanceIdentifier": "sample-cluster-instance", "PreferredBackupWindow": "00:00-00:30", "PubliclyAccessible": false, "DBSubnetGroup": { "DBSubnetGroupName": "default", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-b3806e8f", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-29ab1025", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete" }, "PendingModifiedValues": {}, "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b" } ] } ``` ------ # Modificación de una instancia de base de datos de Amazon DocumentDB Puede modificar su instancia de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para modificar una instancia, la instancia debe tener el estado *disponible*. No puede modificar una instancia detenida. Si el clúster está detenido, inicie primero el clúster, espere a que la instancia esté *disponible* y, a continuación, realice las modificaciones deseadas. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md). ------ #### [ Using the Consola de administración de AWS ] Complete los pasos que se indican a continuación para modificar una instancia de Amazon DocumentDB específica mediante la consola. 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)**. **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. 1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla. ![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png) 1. Marque la casilla de verificación situada a la izquierda de la instancia que desea modificar. 1. Elija **Actions (Acciones)** y después **Modify (Modificar)**. 1. En el panel **Modificar instancia: **, realice los cambios que desee. Puede hacer los siguientes cambios: + **Especificaciones de instancia**: el identificador y la clase de la instancia. Restricciones de nombres del identificador de instancia: + **Identificador de instancia**: introduzca un nombre que sea único para todas las instancias de su propiedad Cuenta de AWS en la región actual. El identificador de instancia debe contener [1-63] caracteres alfanuméricos o guiones, tener una letra como primer carácter y no puede terminar con un guion ni contener dos guiones consecutivos. + **Clase de instancia**: en el menú desplegable, seleccione una clase de instancia para su instancia de Amazon DocumentDB. Para obtener más información, consulte [Administración de clases de instancias](db-instance-classes.md). + **Autoridad de certificación**: certificado de servidor para esta instancia. Para obtener más información, consulte [Actualización de los certificados TLS de Amazon DocumentDB](ca_cert_rotation.md). + **Conmutación por error**: durante la conmutación por error, la instancia con el nivel de promoción más alto se promoverá a primaria. Para obtener más información, consulte [Conmutación por error a Amazon DocumentDB](failover.md). + **Mantenimiento **: la ventana de mantenimiento en la que se aplican las modificaciones o revisiones pendientes a las instancias del clúster. 1. Cuando haya terminado, elija **Continuar** para ver un resumen de los cambios. 1. Después de verificar los cambios, puede aplicarlos inmediatamente o durante el siguiente período de mantenimiento en **Scheduling of modifications (Programación de modificaciones)**. Seleccione **Modify instance (Modificar instancia)** para guardar los cambios. Como alternativa, puede elegir **Cancel (Cancelar)** para descartar los cambios. Los cambios pueden tardar unos minutos en aplicarse. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede monitorizar el estado de la instancia mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Para modificar una instancia específica de Amazon DocumentDB mediante el AWS CLI, utilice el `modify-db-instance` con los siguientes parámetros. Para obtener más información, consulte [Modificar DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). El siguiente código modifica la clase de instancia a `db.r5.large` para la instancia `sample-instance`. **Parameters** + **--db-instance-identifier**: obligatorio. El identificador de la instancia que se va a modificar. + **--db-instance-class**: opcional. La nueva capacidad de memoria e informática de la instancia (por ejemplo, `db.r5.large`). No todas las clases de instancia están disponibles en todas las Regiones de AWS. Si modifica la clase de la instancia se produce una interrupción durante el cambio. El cambio se aplica durante la siguiente ventana de mantenimiento, a menos que `ApplyImmediately` se especifique como verdadera para esta solicitud. + **--apply-immediately** o **--no-apply-immediately**: opcional. Especifica si esta modificación debe aplicarse inmediatamente o esperar hasta el próximo periodo de mantenimiento. Si se omite este parámetro, la modificación se realiza durante el siguiente período de mantenimiento. **Example** Para Linux, macOS o Unix: ``` aws docdb modify-db-instance \ --db-instance-identifier sample-instance \ --db-instance-class db.r5.large \ --apply-immediately ``` Para Windows: ``` aws docdb modify-db-instance ^ --db-instance-identifier sample-instance ^ --db-instance-class db.r5.large ^ --apply-immediately ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBInstances": [ { "DBInstanceIdentifier": "sample-instance-1", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "modifying", "Endpoint": { "Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-01-10T22:18:55.921Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1a", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:10:57-sun:11:27", "PendingModifiedValues": { "DBInstanceClass": "db.r5.large" }, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1", "EnabledCloudwatchLogsExports": [ "profiler" ] } ] } ``` Las modificaciones pueden tardar unos minutos en aplicarse. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede supervisar el estado de la instancia mediante la tecla Consola de administración de AWS o AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Reinicio de la instancia de Amazon DocumentDB Es posible que en algún momento necesite reiniciar su instancia de Amazon DocumentDB, normalmente por razones de mantenimiento. Si realiza determinados cambios, como cambiar el grupo de parámetros de clúster asociado a un clúster, debe reiniciar las instancias del clúster para que los cambios surtan efecto. Puede reiniciar una instancia específica mediante el Consola de administración de AWS o el AWS CLI. Cuando se reinicia una instancia, se reinicia el servicio del motor de base de datos. Al reiniciar una instancia, se produce una interrupción momentánea, durante la cual su estado se establece en `rebooting`. Cuando finaliza el reinicio, se crea un evento de Amazon DocumentDB. El reinicio de una instancia no produce una conmutación por error. Para realizar la conmutación por error de un clúster de Amazon DocumentDB, utilice Consola de administración de AWS la operación o AWS CLI . `failover-db-cluster` Para obtener más información, consulte [Conmutación por error a Amazon DocumentDB](failover.md). No puede reiniciar su instancia si no tiene el estado *disponible*. La base de datos puede no estar disponible por varias razones, como una modificación solicitada anteriormente o una acción durante un periodo de mantenimiento. Para obtener más información acerca de los estados de las instancias, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the Consola de administración de AWS ] El siguiente procedimiento reinicia una instancia especificada mediante la consola. 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)**. **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. 1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla. ![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png) 1. Marque la casilla de verificación situada a la izquierda de la instancia que desea reiniciar. 1. Elija **Actions (Acciones)**, después **Reboot (Reiniciar)** y, por último, **Reboot (Reiniciar)** para confirmar el reinicio. El reinicio de la instancia puede tardar unos minutos. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede monitorizar el estado de la instancia mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Para reiniciar una instancia de Amazon DocumentDB, utilice la operación `reboot-db-instance` con el parámetro `--db-instance-identifier`. Este parámetro especifica el identificador de la instancia que se va a reiniciar. El siguiente código reinicia la instancia `sample-instance`. **Example** Para Linux, macOS o Unix: ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-instance ``` Para Windows: ``` aws docdb reboot-db-instance ^ --db-instance-identifier sample-instance ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "rebooting", "Endpoint": { "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` El reinicio de la instancia puede tardar unos minutos. Solo puede usar la instancia cuando su estado sea *available (disponible)*. Puede monitorizar el estado de la instancia mediante la consola o la AWS CLI. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Eliminación de una instancia de Amazon DocumentDB Puede eliminar su instancia de Amazon DocumentDB mediante el Consola de administración de AWS o el. AWS CLI Para eliminar una instancia, la instancia debe estar en el estado *disponible*. No puede eliminar una instancia detenida. Si el clúster de Amazon DocumentDB que contiene la instancia está detenido, inicie primero el clúster, espere a que la instancia esté *disponible* y, a continuación, elimine la instancia. Para obtener más información, consulte [Detención e inicio de un clúster de bases de datos de Amazon DocumentDB](db-cluster-stop-start.md). **nota** Amazon DocumentDB almacena todos los datos en el volumen del clúster. Los datos se conservan en ese volumen de clúster, incluso si elimina todas las instancias del clúster. Si necesita obtener acceso a los datos de nuevo, puede agregar una instancia al clúster en cualquier momento y reanudar el trabajo donde lo dejó. ------ #### [ Using the Consola de administración de AWS ] El siguiente procedimiento elimina una instancia de Amazon DocumentDB especificada mediante la consola. 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)**. **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. 1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla. ![\[Tabla de clústeres en la que se muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png) 1. Marque la casilla de verificación situada a la izquierda de la instancia que desea eliminar. 1. Seleccione **Acciones** y, a continuación, elija **Eliminar**. 1. Si va a eliminar la última instancia del clúster: + **Create final cluster snapshot? (¿Crear instantánea de clúster final?)** Elija **Sí** si desea crear una instantánea final antes de eliminar el clúster. En caso contrario, elija **No**. + **Nombre de la instantánea final**: si ha decidido crear una instantánea final, escriba el identificador de la instantánea de clúster o de la nueva instantánea de clúster que se ha creado. + **Delete instance? (¿Eliminar ?)** Escriba la frase **Eliminar clúster completo** en el campo para confirmar la eliminación. 1. Si no va a eliminar la última instancia del clúster: + **Delete instance? (¿Eliminar ?)** Escriba la frase **Eliminarme** en el campo para confirmar la eliminación. 1. Seleccione **Delete (Eliminar)** para eliminar la instancia. La eliminación de una instancia tarda varios minutos. Para monitorear el estado de una instancia, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] El siguiente procedimiento elimina una instancia de Amazon DocumentDB mediante la AWS CLI. 1. **En primer lugar, determine cuántas instancias hay en el clúster de Amazon DocumentDB:** Para determinar cuántas instancias hay en el clúster, ejecute el comando `describe-db-clusters` de la siguiente manera. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ``` La salida de esta operación será similar a lo que se indica a continuación. ``` [ [ "sample-cluster", [ "sample-instance-1", "sample-instance-2" ] ] ] ``` 1. **Si hay más de una instancia en el clúster de Amazon DocumentDB:** Para eliminar una instancia de Amazon DocumentDB especificada, utilice el comando `delete-db-instance` con el parámetro `--db-instance-identifier`, como se muestra a continuación. La eliminación de una instancia tarda varios minutos. Para monitorear el estado de una instancia, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-instance_status.md). ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance-2 ``` La salida de esta operación será similar a lo que se indica a continuación. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "deleting", "Endpoint": { "Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` 1. **Si la instancia que desea eliminar es la última instancia del clúster de Amazon DocumentDB: ** Si elimina la última instancia de un clúster de Amazon DocumentDB, también elimina ese clúster, así como las instantáneas automáticas y las copias de seguridad continuas asociadas a ese clúster. Para eliminar la última instancia del clúster, puede eliminar el clúster y, si lo desea, crear una instantánea final. Para obtener más información, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md). ------ ## Protección contra eliminación Al eliminar la última instancia de un clúster de Amazon DocumentDB, también se eliminará el clúster, así como las instantáneas automáticas y las copias de seguridad continuas asociadas a ese clúster. Amazon DocumentDB aplica la protección contra la eliminación de un clúster, independientemente de si realiza la operación de eliminación con o con. Consola de administración de AWS AWS CLI Si la protección contra eliminación está habilitada, no podrá eliminar un clúster. Para eliminar un clúster con la protección contra eliminación habilitada, primero debe modificar el clúster y deshabilitar la protección contra eliminación. Para obtener más información, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md). # Administración de clases de instancias La clase de instancia de base de datos determina la capacidad de cómputo y de memoria de una instancia de Amazon DocumentDB (compatible con MongoDB). La clase de instancia que necesita depende de la potencia de procesamiento y de los requisitos de memoria. Amazon DocumentDB admite las familias de clases de instancias R4, R5, R6G, R8G, T3 y T4G. Se trata de clases de instancias de la generación actual que se han optimizado para las aplicaciones que hacen un uso intensivo de la memoria. Para conocer las especificaciones de estas clases, consulte [Especificaciones de clases de instancias](#db-instance-class-specs). **Topics** + [Determinación de la clase de una instancia](#db-instance-class-determining) + [Cambio de la clase de una instancia](#db-instance-class-changing) + [Clases de instancias admitidas por región](#db-instance-classes-by-region) + [Especificaciones de clases de instancias](#db-instance-class-specs) ## Determinación de la clase de una instancia Para determinar la clase de una instancia, puedes usar la `describe-db-instances` AWS CLI operación Consola de administración de AWS o. ------ #### [ Using the Consola de administración de AWS ] Para determinar la clase de instancia de las instancias del clúster, complete los siguientes pasos en la consola. 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. Para encontrar la instancia que le interesa, elija **Clústeres** en el panel de navegación. **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. 1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla. ![\[Tabla de clústeres en la que se muestra cómo se anida una instancia en un clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png) 1. En la lista de instancias, expande el clúster para encontrar las instancias que le interesan. Encuentre la instancia que desee. A continuación, fíjese en la columna **Tamaño** de la fila correspondiente a la instancia. En la imagen siguiente, la clase de la instancia `robo3t` es `db.r5.4xlarge`. ![\[Lista de instancias de la tabla de clústeres con la columna Tamaño, en la que se muestra el tipo de instancia.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/instance-class.png) ------ #### [ Using the AWS CLI ] Para determinar la clase de una instancia mediante el AWS CLI, utilice la `describe-db-instances` operación con los siguientes parámetros. + **--db-instance-identifier**— Opcional. Especifica la instancia para la que desea encontrar la clase de instancia. Si se omite este parámetro, `describe-db-instances` devuelve una descripción para un máximo de 100 instancias. + **--query**: opcional. Especifica los miembros de la instancia que se van a incluir en los resultados. Si se omite este parámetro, se devuelven todos los miembros de la instancia. **Example** En el siguiente ejemplo se busca el nombre y la clase de la instancia para la instancia `sample-instance-1`. Para Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \ --db-instance-identifier sample-instance-1 ``` Para Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^ --db-instance-identifier sample-instance-1 ``` La salida de esta operación será similar a lo que se indica a continuación. ``` [ [ "sample-instance-1", "db.r5.large" ] ``` **Example** En el siguiente ejemplo se busca el nombre y la clase de la instancia para un máximo de 100 instancias de Amazon DocumentDB. Para Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \ --filter Name=engine,Values=docdb ``` Para Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^ --filter Name=engine,Values=docdb ``` La salida de esta operación será similar a lo que se indica a continuación. ``` [ [ "sample-instance-1", "db.r5.large" ], [ "sample-instance-2", "db.r5.large" ], [ "sample-instance-3", "db.r5.4xlarge" ], [ "sample-instance-4", "db.r5.4xlarge" ] ] ``` Para obtener más información, consulte [Descripción de las instancias de Amazon DocumentDB](db-instance-view-details.md). ------ ## Cambio de la clase de una instancia Puede cambiar la clase de instancia de su instancia mediante el Consola de administración de AWS o el AWS CLI. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md). ## Clases de instancias admitidas por región Amazon DocumentDB admite las siguientes clases de instancia: + `R8G`—Instancias optimizadas para memoria de última generación equipadas con procesadores AWS Graviton4 basados en ARM, que ofrecen un rendimiento hasta un 30% superior al de las instancias R6G. + `R6G`—Instancias optimizadas para memoria equipadas con procesadores AWS Graviton2 basados en ARM que ofrecen un rendimiento hasta un 30% superior al de las instancias R5 a un coste un 5% menor. + `R6GD`—Instancias R6G optimizadas para memoria con almacenamiento local no volátil en unidades de estado sólido (SSD) basadas en memoria express () no volátil para datos efímeros. NVMe + `R5`: instancias optimizadas para memoria que ofrecen un rendimiento hasta un 100 % superior al de las instancias R4 por el mismo coste de instancia. + `R4`: instancias optimizadas para memoria de generación anterior. + `T4G`—Un tipo de instancia de uso general, de última generación, con capacidad de ráfaga y bajo coste, equipada con procesadores AWS Graviton2 basados en ARM, que proporciona un nivel básico de rendimiento de la CPU, con una relación precio-rendimiento hasta un 35% superior a la de las instancias T3 y es ideal para ejecutar aplicaciones con un uso moderado de la CPU que sufren picos temporales de uso. + `T3`: tipo de instancia de uso general y ampliables que proporcionan un nivel básico de rendimiento de la CPU con posibilidad de ampliar el uso de la CPU en cualquier momento durante el tiempo que sea necesario. Para conocer las especificaciones detalladas de las clases de instancias, consulte [Especificaciones de clases de instancias](#db-instance-class-specs). **nota** El almacenamiento optimizado para E/S solo está disponible en las versiones 5.0 y 8.0 del motor (clústeres basados en instancias). Una clase de instancia determinada se podría admitir o no en una región determinada. En la siguiente tabla, se especifica qué clases de instancias admite Amazon DocumentDB en cada región. **Clases de instancias admitidas por región** | | Clases de instancia | Region | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Sin servidor | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Este de EE. UU. (Ohio) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible | | Este de EE. UU. (Norte de Virginia) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible | | Oeste de EE. UU. (Oregón) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible | | África (Ciudad del Cabo) | | | Soportado | Soportado | | Soportado | Soportado | compatible | | América del Sur (São Paulo) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Asia-Pacífico (Hong Kong) | | | Soportado | Soportado | | Soportado | Soportado | compatible | | Asia-Pacífico (Hyderabad) | | | Soportado | Soportado | | Soportado | Soportado | compatible | | Asia-Pacífico (Malasia) | | | Soportado | | | Soportado | compatible | | | Asia-Pacífico (Mumbai) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Asia-Pacífico (Osaka) | | Soportado | Soportado | Soportado | | Soportado | compatible | | | Asia-Pacífico (Seúl) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Asia-Pacífico (Sídney) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Asia-Pacífico (Yakarta) | Soportado | Soportado | Soportado | Soportado | | Soportado | compatible | | | Asia-Pacífico (Melbourne) | | | Soportado | Soportado | | Soportado | compatible | | | Asia-Pacífico (Singapur) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Asia-Pacífico (Tailandia) | | | Soportado | | | Soportado | compatible | | | Asia-Pacífico (Tokio) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Canadá (centro) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Europa (Fráncfort) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Europa (Zúrich) | | Soportado | Soportado | Soportado | | Soportado | compatible | | | Europa (Irlanda) | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | Soportado | compatible | | Europa (Londres) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Europa (Milán) | | | Soportado | Soportado | | Soportado | Soportado | compatible | | Europa (París) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Europa (España) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | Europa (Estocolmo) | Soportado | Soportado | Soportado | Soportado | | Soportado | compatible | | | México (centro) | | | Soportado | | | Soportado | compatible | | | Medio Oriente (EAU) | | | Soportado | Soportado | | Soportado | Soportado | compatible | | China (Pekín) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | China (Ningxia) | | | Soportado | Soportado | | Soportado | Soportado | compatible | | Israel (Tel Aviv) | | | Soportado | Soportado | | Soportado | Soportado | compatible | | AWS GovCloud (EE. UU.-Oeste) | Soportado | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | | AWS GovCloud (EE. UU.-Este) | | Soportado | Soportado | Soportado | | Soportado | Soportado | compatible | ## Especificaciones de clases de instancias La siguiente tabla proporciona información detallada de las clases de instancias de Amazon DocumentDB, incluidos los tipos de instancias que se admiten en cada clase. Puede encontrar explicaciones sobre cada columna de la tabla debajo de la tabla. | Clase de instancia | CPU virtuales1 | Memoria (GiB)2 | NVMe Caché SSD por niveles (GiB) 3 | Temperatura máxima de almacenamiento (GiB) 4 | Ancho de banda de base/con ampliación (Gbps)5 | Motores compatibles6 | | --- | --- | --- | --- | --- | --- | --- | | R8G: clase de instancia optimizada para memoria de la generación actual basada en Graviton4 R8G es la familia de instancias más reciente (Graviton4) y solo está disponible en las versiones de motor 5.0 y 8.0. Los tamaños db.r8g.24xlarge y db.r8g.48xlarge aún no están disponibles. | | db.r8g.large | 2 | 16 | - | 30 | 0,937/12,5 | 5.0.0 y 8.0.0 | | db.r8g.xlarge | 4 | 32 | - | 60 | 1,875/12,5 | 5.0.0 y 8.0.0 | | db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75/15,0 | 5.0.0 y 8.0.0 | | db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5/15,0 | 5.0.0 y 8.0.0 | | db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 y 8.0.0 | | db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 y 8.0.0 | | db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 y 8.0.0 | | R6G: clase de instancia optimizada para memoria de la generación actual basada en Graviton2 | | db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0 y 8.0.0 | | db.r6g.xlarge | 4 | 32 | - | 63 | 1.25/10 | 4.0.0, 5.0.0 y 8.0.0 | | db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5/10 | 4.0.0, 5.0.0 y 8.0.0 | | db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0/10 | 4.0.0, 5.0.0 y 8.0.0 | | db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0 y 8.0.0 | | db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0 y 8.0.0 | | db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0 y 8.0.0 | | R6GD: clase de instancia respaldada por la generación NVMe actual basada en Graviton2 | | db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1.25/10 | 5.0.0 y 8.0.0 | | db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2,5/ 10 | 5.0.0 y 8.0.0 | | db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5,0/ 10 | 5.0.0 y 8.0.0 | | db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 y 8.0.0 | | db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 y 8.0.0 | | db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 y 8.0.0 | | R5: clases de instancia optimizada para memoria de generación anterior | | db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | db.r5.xlarge | 4 | 32 | - | 62 | 1.25/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | db.r5.2xlarge | 8 | 64 | - | 124 | 2.5/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | db.r5.4xlarge | 16 | 128 | - | 249 | 5.0/10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | R4: clases de instancia optimizada para memoria de generación anterior Las instancias R4 solo se admiten en la versión 3.6 del motor. Tenga en cuenta que Amazon DocumentDB 3.6 finalizará el soporte estándar el 30 de marzo de 2026. Extended Support (de pago) está disponible hasta marzo de 2029. | | db.r4.large | 2 | 15,25 | - | 30 | 0.75/10 | Solo 3.6.0 | | db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | Solo 3.6.0 | | db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/10 | Solo 3.6.0 | | db.r4.4xlarge | 16 | 122 | - | 240 | 5,0 /10 | Solo 3.6.0 | | db.r4.8xlarge | 32 | 244 | - | 480 | 10 | Solo 3.6.0 | | db.r4.16xlarge | 64 | 488 | - | 960 | 25 | Solo 3.6.0 | | T4G: clases de instancia de rendimiento ampliable de última generación basadas en Graviton2 Las instancias de la serie T se ejecutan en modo de ráfaga de CPU ilimitada. El uso de ráfagas por encima de la línea base se factura de forma adicional. No se admite en clústeres globales. | | db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/ 5 | 4.0.0, 5.0.0 y 8.0.0 | | T3: clases de instancia de rendimiento ampliable de generación anterior | | db.t3.medium | 2 | 4 | - | 7.5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0 y 8.0.0 | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/db-instance-classes.html) | # Instancias respaldadas por NVMe Las instancias respaldadas por NVMe ofrecen un rendimiento de consultas hasta 7 veces más rápido para aplicaciones con conjuntos de datos grandes que superan la memoria de una instancia normal. Estas instancias aprovechan el almacenamiento local en unidades de estado sólido (SSD) basado en memoria rápida no volátil (NVMe) disponible en las instancias r6gd para almacenar datos efímeros, lo que reduce el acceso al almacenamiento en red y mejora la latencia de lectura y el rendimiento. El espacio de la SSD local se divide en dos secciones: + **Caché por niveles**: aproximadamente el 73 % de la SSD local se asigna como caché de base de datos, lo que permite al sistema almacenar hasta cinco veces más páginas de base de datos que la memoria principal por sí sola. La SSD local actúa como caché de segundo nivel, mientras que la caché del búfer en memoria existente sigue siendo la caché de primer nivel. La consulta accede solamente al almacenamiento externo si se produce un error tanto en la caché de búfer como en la de la SSD. + **Almacenamiento temporal**: el 27 % restante se reserva para el almacenamiento temporal no persistente de archivos, que se utiliza para consultas complejas que implican ordenaciones u operaciones con consumo intensivo de recursos, como la compilación de índices. En instancias normales, el espacio temporal se encuentra en un volumen de Amazon Elastic Block Store (EBS). El almacenamiento temporal alojado localmente en la SSD reduce hasta dos veces la latencia de las consultas que implican ordenaciones y acelera las operaciones con consumo intensivo de recursos, como la compilación de índices. Los detalles sobre el tipo de instancias respaldadas por NVMe compatibles y sus especificaciones se encuentran en [Especificaciones de clases de instancias](db-instance-classes.md#db-instance-class-specs). **Topics** + [Casos de uso recomendados para instancias respaldadas por NVMe](#nvme-use-cases) + [Uso de instancias respaldadas por NVMe con Amazon DocumentDB](#using-nvme) + [Supervisión de instancias respaldadas por NVMe](#monitoring-nvme) ## Casos de uso recomendados para instancias respaldadas por NVMe Le recomendamos utilizar instancias respaldadas por NVMe en las siguientes situaciones: + **Cargas de trabajo de lectura intensiva**: si su carga de trabajo es de lectura intensiva y su conjunto de datos es más grande que la caché del búfer, lo que se refleja en métricas bajas de `BufferCacheHitRatio` y métricas altas de `ReadIOPS`, las instancias respaldadas por NVMe pueden ofrecer ventajas de rendimiento. + **Cargas de trabajo con actualización intensiva**: si su carga de trabajo es de actualizaciones intensivas y la recopilación de elementos no utilizados no puede mantener el ritmo debido a la latencia de lectura en el almacenamiento de red, las instancias respaldadas por NVMe podrían ayudar a mitigar el problema. Las instancias respaldadas por NVMe pueden ser beneficiosas en varios casos de uso, entre los que se incluyen los siguientes: + **Aplicaciones a escala de Internet**: las aplicaciones como el procesamiento de pagos, la facturación y el comercio electrónico con Acuerdos de nivel de servicio (SLA) de rendimiento estrictos pueden aprovechar las ventajas de rendimiento de las instancias respaldadas por NVMe. + **Paneles de informes en tiempo real**: los paneles que ejecutan cientos de consultas para la recopilación de métricas/datos pueden beneficiarse de la baja latencia y el alto rendimiento de las instancias respaldadas por NVMe. + **Aplicaciones de IA generativa**: las aplicaciones que utilizan la búsqueda vectorial para encontrar vecinos exactos o más cercanos entre millones de incrustaciones vectoriales pueden aprovechar el alto rendimiento de las instancias respaldadas por NVMe. ## Uso de instancias respaldadas por NVMe con Amazon DocumentDB Cómo usar instancias de Amazon DocumentDB respaldadas por NVMe: + Cree un clúster de Amazon DocumentDB y añada una de las clases de instancia respaldadas por NVMe. Para obtener más información, consulte [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md). + Como alternativa, modifique un clúster de Amazon DocumentDB existente para utilizar una de las clases de instancia respaldadas por NVMe. Para obtener más información, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md). Para comprobar la disponibilidad de las instancias respaldadas por NVMe en diferentes regiones de AWS, consulte [Clases de instancias admitidas por región](db-instance-classes.md#db-instance-classes-by-region). Si desea volver a cambiar de una instancia respaldada por NVMe a una instancia normal, modifique la clase de instancia de base de datos de su instancia de Amazon DocumentDB por una clase de instancia similar sin el almacenamiento de NVMe. Por ejemplo, si la clase de instancia actual es «db.r6gd.4xlarge», elija «db.r6g.4xlarge» para volver atrás. Para obtener más información, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md). ## Supervisión de instancias respaldadas por NVMe Además de las métricas de instancia normales disponibles en Amazon CloudWatch, las instancias respaldadas por NVMe emiten métricas adicionales específicas para el almacenamiento en SSD basado en NVMe, las IOPS y el rendimiento. ``` NVMeStorageCacheHitRatio FreeNVMeStorage ReadIOPSNVMeStorage ReadLatencyNVMeStorage ReadThroughputNVMeStorage WriteIOPSNVMeStorage WriteLatencyNVMeStorage WriteThroughputNVMeStorage ``` Para obtener más información acerca de estas métricas, consulte [NVMe-métricas de instancias respaldadas](cloud_watch.md#nvme-metrics) # Administración de grupos de subredes de Amazon DocumentDB Una nube privada virtual (VPC) es una red virtual dedicada para su Cuenta de AWS. Esta infraestructura en la nube está aislada lógicamente de otras redes virtuales de la nube de AWS. Puede lanzar sus recursos de AWS como por ejemplo clústeres de Amazon DocumentDB en su VPC de Amazon. Puede especificar un intervalo de direcciones IP para la VPC, añadir subredes, asociar grupos de seguridad y configurar tablas de ruteo. Una subred es un rango de direcciones IP en su VPC de Amazon. Puede lanzar recursos de AWS en una subred especificada. Utilice una subred *pública* para los recursos que deben conectarse a Internet. Utilice una subred *privada* para los recursos que no dispondrán de conexión a Internet. Para obtener más información sobre subredes públicas y privadas, consulte [Conceptos básicos de VPC y subredes](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-subnet-basics) en la *Guía de usuario de la Nube privada virtual de Amazon*. Un grupo de subredes de base de datos es una colección de subredes que se crean en una VPC y que después se asignan a los clústeres. Un grupo de subredes le permite especificar una VPC determinada a la hora de crear clústeres. Si utiliza el grupo de subredes `default`, este abarca todas las subredes de la VPC. Cada grupo de subredes de base de datos debe tener subredes como mínimo en dos zonas de disponibilidad de una región de determinada. Cuando crea un clúster de base de datos en una VPC, debe elegir un grupo de subredes de base de datos. Amazon DocumentDB utiliza ese grupo de subredes de base de datos y su zona de disponibilidad preferida para seleccionar una subred y una dirección IP dentro de esa subred con el fin de asociarla al clúster. Si se produce un error en la instancia principal, Amazon DocumentDB puede promover una instancia de réplica correspondiente para que se convierta en la nueva instancia principal. A continuación, puede crear una nueva instancia de réplica utilizando una dirección IP de la subred en la que se encontraba la instancia principal anterior. Cuando Amazon DocumentDB crea una instancia en una VPC, asigna una interfaz de red al clúster utilizando la dirección IP seleccionada del grupo de subredes de base de datos. Recomendamos que utilice el nombre de DNS, ya que la dirección IP subyacente puede cambiar durante la conmutación por error. Para obtener más información, consulte [Puntos de conexión de Amazon DocumentDB](how-it-works.md#how-it-works.endpoints). Para obtener información sobre la creación de su propia VPC y sus subredes, consulte [Uso de VPC y subredes](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) en la *Guía del usuario de la nube privada virtual de Amazon*. **Topics** + [Creación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-create.md) + [Descripción de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-describe.md) + [Modificación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-modify.md) + [Eliminación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-delete.md) # Creación de un grupo de subredes de Amazon DocumentDB Al crear un clúster de Amazon DocumentDB, debe elegir una VPC de Amazon y el grupo de subredes correspondiente dentro de la VPC de Amazon para lanzar el clúster. Las subredes determinan la zona de disponibilidad y el rango de direcciones IP de la zona de disponibilidad que se deben utilizar para lanzar una instancia. Un subgrupo de subredes es un determinado grupo de subredes (o AZ) que le permite especificar las zonas de disponibilidad que desea utilizar para lanzar instancias de Amazon DocumentDB. Por ejemplo, en un clúster con tres instancias, se recomienda que cada una de dichas instancias esté aprovisionada en una zona de disponibilidad (AZ) distinta, al hacerlo, optimiza la alta disponibilidad. De esa forma, si una de las AZ falla, solo se verá afectada una sola instancia. Actualmente, las instancias de Amazon DocumentDB pueden aprovisionarse en hasta tres zonas de disponibilidad. Aunque un grupo de subredes tenga más de tres subredes, solo podrá utilizar tres de esas subredes para crear un clúster de Amazon DocumentDB. Por ello, es recomendable que al crear un grupo de subredes solo elija las tres subredes en las que desee implementar las instancias. Por ejemplo: se crea un clúster y Amazon DocumentDB elige las AZ \$11A, 1B y 1C\$1. Si intenta crear una instancia en la AZ \$11D\$1, la llamada a la API no funcionará correctamente. Sin embargo, si decide crear una instancia sin especificar la zona de disponibilidad concreta, Amazon DocumentDB elegirá una zona de disponibilidad por usted. Amazon DocumentDB utiliza un algoritmo para equilibrar la carga de las instancias en las AZ para ayudarle a obtener una alta disponibilidad. Si se aprovisionan tres instancias, de forma predeterminada se repartirán entre tres zonas de disponibilidad en lugar de aprovisionar todas ellas en una única AZ. Prácticas recomendadas + A menos que tenga un motivo específico, cree siempre un grupo de subredes con tres subredes. Lo anterior asegurará que los clústeres con tres o más instancias podrán lograr una mayor disponibilidad, debido a que las instancias se aprovisionarán en tres zonas de disponibilidad. + Reparta siempre las instancias en varias zonas de disponibilidad para lograr una alta disponibilidad. Nunca ponga todas las instancias de un clúster en una única zona de disponibilidad. + Debido a que pueden producirse eventos de conmutación por error en cualquier momento, no debe dar por hecho que una instancia principal o las instancias de réplica siempre estarán en una AZ determinada. ## Cómo crear un grupo de subredes Puede utilizar la Consola de administración de AWS o la AWS CLI para crear un grupo de subredes de Amazon DocumentDB: ------ #### [ Using the Consola de administración de AWS ] Siga los siguientes pasos para crear un grupo de subredes de Amazon DocumentDB. **Creación de un grupo de subredes de Amazon DocumentDB** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). 1. En el panel de navegación, elija **Subnet groups (Grupos de subredes)**y, a continuación, elija **Create (Crear)**. **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. 1. En la página **Create subnet group (Crear grupo de subredes)**: 1. En la sección **Subnet group details (Detalles del grupo de subredes)**: 1. **Nombre**: introduzca un nombre significativo para el grupo de la subred. 1. **Description (Descripción)**: introduzca una descripción del grupo de subredes. 1. En la sección **Add subnets (Añadir subredes)**: 1. **VPC**: elija una VPC de la lista, para este grupo de subredes. 1. Realice una de las siguientes acciones: + Para incluir todas las subredes en la VPC seleccionada, elija **Add all the subnets related to this VPC (Añadir todas las subredes asociadas a esta VPC)**. + Para especificar subredes para este grupo de subredes, realice los pasos siguientes para cada zona de disponibilidad para la que desee incluir subredes. Debe incluir al menos dos zonas de disponibilidad. 1. **Zona de disponibilidad**: de la lista, elija una zona de disponibilidad. 1. **Subred**: de la lista, elija una subred de la zona de disponibilidad elegida para este grupo de subredes. 1. Seleccione **Add subnet (Añadir subred)**. 1. Seleccione **Crear**. Cuando se crea el grupo de subredes, se muestra junto con los demás grupos de subredes. ![\[Captura de pantalla que muestra los detalles de un grupo de subredes.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-subnet-groups-list.png) ------ #### [ Using the AWS CLI ] Para poder crear un grupo de subredes mediante la AWS CLI, primero debe determinar qué subredes se encuentran disponibles. Ejecute la siguiente operación de la AWS CLI para ver una lista de las zonas de disponibilidad y sus subredes. **Parámetros:** + **--db-subnet-group**: opcional. Si especifica un grupo de subredes concreto, puede ver las zonas de disponibilidad y las subredes de dicho grupo. Si omite este parámetro, puede ver las zonas de disponibilidad y las subredes de todos los grupos de subredes. Si especifica el grupo de subredes `default` puede ver todas las subredes de la VPC. **Example** Para Linux, macOS o Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name default \ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` Para Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name default ^ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "default", [ [ "us-east-1a", "subnet-4e26d263" ], [ "us-east-1c", "subnet-afc329f4" ], [ "us-east-1e", "subnet-b3806e8f" ], [ "us-east-1d", "subnet-53ab3636" ], [ "us-east-1b", "subnet-991cb8d0" ], [ "us-east-1f", "subnet-29ab1025" ] ] ] ] ``` Si utiliza el resultado de la operación anterior, puede crear un nuevo grupo de subredes. El grupo de subredes nuevo debe incluir subredes de al menos dos zonas de disponibilidad. **Parámetros:** + **--db-subnet-group-name**: obligatorio. Nombre de este grupo de subredes. + **--db-subnet-group-description**: obligatorio. Descripción de este grupo de subredes. + **--subnet-ids**: obligatorio. Lista de las subredes que se van a incluir en este grupo de subredes. Ejemplo: : `subnet-53ab3636`. + –Etiquetas****: opcional. Lista de las etiquetas (pares clave-valor) que se van a asociar a este grupo de subredes. El código siguiente crea el grupo de subredes `sample-subnet-group` con tres subredes, `subnet-4e26d263`, `subnet-afc329f4` y `subnet-b3806e8f`. Para Linux, macOS o Unix: ``` aws docdb create-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --db-subnet-group-description "A sample subnet group" \ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` Para Windows: ``` aws docdb create-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --db-subnet-group-description "A sample subnet group" ^ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupDescription": "A sample subnet group", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetIdentifier": "subnet-4e26d263", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetIdentifier": "subnet-afc329f4", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetIdentifier": "subnet-b3806e8f", "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "SubnetGroupStatus": "Complete" } } ``` ------ # Descripción de un grupo de subredes de Amazon DocumentDB Puede utilizar la Consola de administración de AWS o la AWS CLI para obtener detalles de un grupo de subredes de Amazon DocumentDB. ------ #### [ Using the Consola de administración de AWS ] En el siguiente procedimiento se muestra cómo obtener detalles de un grupo de subredes de Amazon DocumentDB. **Para obtener los detalles de un grupo de subredes** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). 1. En el panel de navegación, elija **Subnet groups (grupos de subredes)**. **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. 1. Para consultar los detalles de un grupo de subredes seleccione el nombre de dicho grupo. ![\[Captura de pantalla que muestra los detalles de un grupo de subredes.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-subnet-group-details.png) ------ #### [ Using the AWS CLI ] Para obtener los detalles de un grupo de subredes de Amazon DocumentDB, utilice la operación `describe-db-subnet-groups` con el siguiente parámetro. **Parámetro** + `--db-subnet=group-name`: opcional. Si se incluye, se muestran los detalles del grupo de subredes nombrado. Si se omite, se muestran los detalles de hasta 100 grupos de subredes. **Example** El siguiente código muestra los detalles del grupo de subredes `sample-subnet-group` que creamos en la sección [Creación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-create.md). Para Linux, macOS o Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name sample-subnet-group ``` Para Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name sample-subnet-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "VpcId": "vpc-91280df6", "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-b3806e8f" } ], "DBSubnetGroupDescription": "A sample subnet group" } } ``` ------ # Modificación de un grupo de subredes de Amazon DocumentDB Puede utilizar la Consola de administración de AWS o la AWS CLI para modificar la descripción de un grupo de subredes o para añadir o eliminar subredes de un grupo de subredes de Amazon DocumentDB. Sin embargo, no puede modificar el grupo de subredes `default`. ------ #### [ Using the Consola de administración de AWS ] Puede utilizar la Consola de administración de AWS para cambiar la descripción de un grupo de subredes o para añadir o eliminar subredes. Recuerde que, cuando termine, debe tener al menos dos zonas de disponibilidad asociadas al grupo de subredes. **Para modificar un grupo de subredes** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). 1. En el panel de navegación, elija **Subnet groups (grupos de subredes)**. A continuación, elija el botón situado a la izquierda del nombre del grupo de subredes. Recuerde que no puede modificar el grupo de subredes `default`. **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. 1. Elija **Actions (Acciones)** y después **Modify (Modificar)**. 1. **Descripción**: para cambiar la descripción del grupo de subredes, introduzca una descripción nueva. 1. Para cambiar las subredes asociadas a un grupo de subredes, realice uno o varios de los siguientes pasos en la sección **Add subnets (Añadir subredes)**: + Para eliminar todas las subredes de este grupo de subredes, seleccione **Remove all (Eliminar todo)**. + Para eliminar subredes específicas de este grupo de subredes, seleccione **Remove (Eliminar)** en cada subred que desee eliminar. + Para añadir todas las subredes asociadas a esta VPC, seleccione **Add all the subnets related to this VPC (Añadir todas las subredes asociadas a esta VPC)**. + Para añadir subredes específicas a este grupo de subredes, realice los siguientes pasos para cada zona de disponibilidad para la que desee añadir una subred. 1. **Zona de disponibilidad**: de la lista, elija una nueva zona de disponibilidad. 1. **Subred**: de la lista, elija una subred de la zona de disponibilidad elegida para este grupo de subredes. 1. Seleccione **Add subnet (Añadir subred)**. 1. En el cuadro de diálogo de confirmación: + Para hacer estos cambios en el grupo de subredes, elija **Modify (Modificar)**. + Para que el grupo de subredes permanezca sin modificaciones, seleccione **Cancel (Cancelar)**. ------ #### [ Using the AWS CLI ] Puede utilizar la AWS CLI para cambiar la descripción de un grupo de subredes o para añadir o eliminar subredes. Recuerde que, cuando termine, debe tener al menos dos zonas de disponibilidad asociadas al grupo de subredes. No se puede modificar el grupo de subredes `default`. **Parámetros:** + `--db-subnet-group-name`: obligatorio. Nombre del grupo de subredes de Amazon DocumentDB que está modificando. + `--subnet-ids`: obligatorio. Lista de las subredes que debe haber en el grupo de subredes después de realizar este cambio. **importante** Cualquier subred que actualmente se encuentre en el grupo de subredes y que no se incluya en esta lista se eliminará del grupo de subredes. Si desea mantener cualquiera de las subredes que actualmente se encuentra en el grupo de subredes, debe incluirla en esta lista. + `--db-subnet-group-description`: opcional. Descripción del grupo de subredes. **Example** El siguiente código modifica la descripción y sustituye las subredes existentes por las subredes `subnet-991cb8d0`, `subnet-53ab3636` y `subnet-29ab1025`. Para Linux, macOS o Unix: ``` aws docdb modify-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \ --db-subnet-group-description "Modified subnet group" ``` Para Windows: ``` aws docdb modify-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^ --db-subnet-group-description "Modified subnet group" ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). Tenga en cuenta que este es el mismo grupo de subredes que se creó en la sección [Creación de un grupo de subredes de Amazon DocumentDB](document-db-subnet-group-create.md). Sin embargo, las subredes del grupo de subredes se sustituyen por las que se muestran en la operación `modify-db-subnet-group`. ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "DBSubnetGroupDescription": "Modified subnet group", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" }, { "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-29ab1025" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupName": "sample-subnet-group" } } ``` ------ # Eliminación de un grupo de subredes de Amazon DocumentDB Puede utilizar la Consola de administración de AWS o la AWS CLI para eliminar un grupo de subredes de Amazon DocumentDB. Sin embargo, no puede eliminar el grupo de subredes `default`. ------ #### [ Using the Consola de administración de AWS ] Puede utilizar la Consola de administración de AWS para eliminar un grupo de subredes. Sin embargo, no se puede eliminar el grupo de subredes `default`. **Para eliminar un grupo de subredes** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). 1. En el panel de navegación, elija **Subnet groups (grupos de subredes)**. A continuación, elija el botón situado a la izquierda del nombre del grupo de subredes. Recuerde que no puede eliminar el grupo de subredes `default`. **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. 1. Elija **Acciones** y, a continuación, elija **Eliminar**. 1. En el cuadro de diálogo de confirmación: + Para eliminar el grupo de subredes, seleccione **Delete (Eliminar)**. + Para mantener el grupo de subredes, seleccione **Cancel (Cancelar)**. ------ #### [ Using the AWS CLI ] Para eliminar un grupo de subredes de Amazon DocumentDB mediante la AWS CLI, utilice la operación `delete-db-subnet-group` con el siguiente parámetro. **Parámetro** + `--db-subnet-group-name`: obligatorio. Nombre del grupo de subredes de Amazon DocumentDB que se va a eliminar. Recuerde que no puede eliminar el grupo de subredes `default`. **Example** El código siguiente elimina `sample-subnet-group`. Para Linux, macOS o Unix: ``` aws docdb delete-db-subnet-group \ --db-subnet-group-name sample-subnet-group ``` Para Windows: ``` aws docdb delete-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ``` Esta operación no produce ningún resultado. ------ # Alta disponibilidad y replicación de Amazon DocumentDB Puede conseguir un alto nivel de disponibilidad y escalado de lectura en Amazon DocumentDB (con compatibilidad con MongoDB) mediante instancias de réplica. Un único clúster de Amazon DocumentDB admite una sola instancia principal y hasta 15 instancias de réplica. Dichas instancias pueden distribuirse entre las zonas de disponibilidad dentro de la región del clúster. La instancia principal acepta el tráfico de lectura y escritura, y las instancias de réplica solo aceptan solicitudes de lectura. El volumen del clúster consta de varias copias de los datos del clúster. Sin embargo, los datos del volumen del clúster se representan como un único volumen lógico para la instancia principal y para las réplicas de Amazon DocumentDB del clúster. Las instancias de réplica presentan consistencia final. Devuelven los resultados de las consultas con un retardo de réplica mínimo, normalmente muy inferior a 100 milisegundos una vez que la instancia principal ha escrito una actualización. El retardo de la réplica varía en función de la velocidad de cambio de la base de datos. Es decir, durante los periodos en los que se produce una gran cantidad de operaciones de escritura en la base de datos, puede registrarse un aumento del retardo de réplica. ## Escalado de lectura Las réplicas de Amazon DocumentDB funcionan bien para el escalado de lectura porque están totalmente dedicadas a las operaciones de lectura en el volumen del clúster. Las operaciones de escritura se administran en la instancia principal. El volumen del clúster lo comparten todas las instancias del clúster. Por lo tanto, no tiene que replicar y mantener una copia de los datos de cada réplica de Amazon DocumentDB. ## Alta disponibilidad Cuando se crea un clúster de Amazon DocumentDB, dependiendo del número de zonas de disponibilidad del grupo de subredes (debe haber al menos dos), Amazon DocumentDB aprovisiona instancias en las distintas zonas de disponibilidad. Cuando se crea las instancias del clúster, Amazon DocumentDB distribuye automáticamente las instancias entre las zonas de disponibilidad de un grupo de subredes para equilibrar el clúster. Esta acción también impide que todas las instancias se encuentren en la misma zona de disponibilidad. **Ejemplo** Para ilustrarlo, imagine un ejemplo en el que se crea un clúster que tiene un grupo de subredes con tres zonas de disponibilidad: *AZ1*, *AZ* y *AZ3*. Cuando se crea la primera instancia del clúster, es la instancia principal y se sitúa en una de las zonas de disponibilidad. En este ejemplo, está en *AZ1*. La segunda instancia que se crea es una instancia de réplica y se sitúa en una de las otras dos zonas de disponibilidad, por ejemplo *AZ2*. La tercera instancia que se crea también es una instancia de réplica y se sitúa en la zona de disponibilidad restante, *AZ3*. Si se crean más instancias, estas se distribuyen entre las distintas zonas de disponibilidad para lograr el equilibrio en el clúster. Si se produce un error en la instancia principal (AZ1), se activará una conmutación por error y una de las réplicas existentes pasará a ser la instancia principal. Cuando se recupere la antigua instancia principal, se convertirá en una réplica en la misma zona de disponibilidad en la que se aprovisionó (AZ1). Al suministrar un clúster de tres instancias, Amazon DocumentDB sigue conservando ese clúster de tres instancias. Amazon DocumentDB gestiona automáticamente la detección, la conmutación por error y la recuperación de los errores de las instancias sin ninguna intervención manual. Cuando Amazon DocumentDB realiza una conmutación por error y recupera una instancia, la instancia recuperada permanece en la zona de disponibilidad en la que se aprovisionó originalmente. Sin embargo, el rol de la instancia podría cambiar de principal a réplica. Esto tiene por objeto evitar que una serie de conmutaciones por error pueda provocar que todas las instancias se encuentren en la misma zona de disponibilidad. Puede especificar réplicas de Amazon DocumentDB para que actúen como destino para las conmutaciones por error. Es decir, si la instancia principal falla, la réplica de un tercero o la réplica de Amazon DocumentDB que ha especificado pasa a ser la instancia principal. En este proceso se produce una breve interrupción durante la cual las solicitudes de escritura y lectura realizadas a la instancia principal generan errores con una excepción. Si el clúster de Amazon DocumentDB no incluye ninguna réplica de Amazon DocumentDB; la instancia principal se vuelve cuando produce un error. Promover una réplica de Amazon DocumentDB es mucho más rápido que volver a crear la instancia principal. Para escenarios de alta disponibilidad, le recomendamos que cree una o varias réplicas de Amazon DocumentDB. Dichas réplicas deberían ser de la misma clase de instancia que la instancia principal y estar en zonas de disponibilidad distintas para el clúster de Amazon DocumentDB. Para obtener más información, consulte los siguientes temas: + [Información general de la tolerancia a errores de clúster de Amazon DocumentDB](db-cluster-fault-tolerance.md) + [Conmutación por error a Amazon DocumentDB](failover.md) + [Control del destino de la conmutación por error](failover.md#failover-target_control) ### Alta disponibilidad con clústeres globales Para una alta disponibilidad en varias Regiones de AWS, puede configurar [clústeres globales de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.html). Cada clúster global abarca varias regiones, lo que permite lecturas globales de baja latencia y la recuperación de desastres de interrupciones en una Región de AWS. Amazon DocumentDB maneja automáticamente la reproducción de todos los datos y actualizaciones desde la región primaria a cada una de las regiones secundarias. ## Adición de réplicas de La primera instancia que se añade al clúster es la instancia principal. Cada instancia de base de datos que se añade después de la primera instancia es una instancia de réplica. Un clúster puede tener hasta 15 instancias de réplica, además de la instancia principal. Cuando crea un clúster mediante la Consola de administración de AWS, se crea automáticamente una instancia principal al mismo tiempo. Para crear una réplica al mismo tiempo que crea el clúster y la instancia principal, seleccione **Create replica in different zone (Crear réplica en zona diferente)**. Para obtener más información, consulte el paso 4.d de [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md). Para añadir más réplicas a un clúster de Amazon DocumentDB, consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md). Cuando usa la AWS CLI para crear el clúster, debe crear explícitamente la instancia principal y las instancias de réplica. Para obtener más información, consulte la sección "Mediante la AWS CLI" de los temas siguientes: + [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md) + [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md) # Conmutación por error a Amazon DocumentDB En algunos casos, como en determinados tipos de mantenimiento planificado, o en el improbable caso de que se produzca un error en el nodo principal o en la zona de disponibilidad, Amazon DocumentDB (con compatibilidad con MongoDB) detectará el error y reemplazará el nodo principal. Durante una conmutación por error, el tiempo de inactividad de escritura se minimiza. Esto se debe a que el papel del nodo principal se conmuta por error a una de las réplicas de lectura en lugar de tener que crear y aprovisionar un nuevo nodo principal. Esta detección de error y promoción de réplica garantizan la posibilidad de reanudar la escritura en el nuevo principal tan pronto como se complete la promoción. Para que la conmutación por error funcione, el clúster debe tener como mínimo dos instancias: una instancia principal y al menos una de réplica. **nota** Este tema solo se aplica a los clústeres basados en instancias de Amazon DocumentDB. No se aplica a los clústeres elásticos o globales. ## Control del destino de la conmutación por error Amazon DocumentDB proporciona niveles de conmutación por error como una forma de controlar qué instancia de réplica pasa a ser la instancia principal cuando se produce una conmutación por error. **Niveles de conmutación por error** Cada instancia de réplica está asociada a un nivel de conmutación por error (0-15). Cuando se produce una conmutación por error debido a tareas de mantenimiento o al caso improbable de que se produzca un error de hardware, la instancia principal se conmuta a una réplica con el nivel de prioridad mayor (el nivel más bajo). Si varias réplicas tienen el mismo nivel de prioridad, la instancia principal se conmutará a la réplica de ese nivel cuyo tamaño sea lo más similar a la principal anterior. Estableciendo el nivel de conmutación por error para un grupo de réplicas seleccionadas en `0` (la prioridad más alta), puede asegurarse de que una conmutación por error promoverá una de las réplicas de ese grupo. En la práctica, puede evitar determinadas réplicas pasen a ser la instancia principal en caso de que se produzca una conmutación por error asignando un nivel de prioridad bajo (un número alto) a esas réplicas. Esto resulta útil en aquellos casos en los que determinadas réplicas se usan ampliamente en una aplicación y la conmutación por error a una de ellas afectaría negativamente a una aplicación crítica. Puede configurar el nivel de conmutación por error de una instancia cuando la cree o modificándola más adelante. La configuración del nivel conmutación por error de una instancia modificando la instancia no genera una conmutación por error. Para obtener más información, consulte los siguientes temas: + [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md) + [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md) Al iniciar manualmente una conmutación por error, dispone de dos métodos para controlar qué instancia de réplica pasa a ser la principal: los niveles de conmutación por error indicados anteriormente y el parámetro `--target-db-instance-identifier`. **--`target-db-instance-identifier`** Para las pruebas, puede forzar una conmutación por error mediante la operación `failover-db-cluster`. Puede utilizar el parámetro `--target-db-instance-identifier` para especificar qué réplica pasará a ser la instancia principal. El uso del parámetro `--target-db-instance-identifier` invalida el nivel de prioridad de conmutación por error. Si no especifica el parámetro `--target-db-instance-identifier`, la conmutación por error de la instancia principal se rige por el nivel de prioridad de conmutación por error. ## ¿Qué ocurre durante una conmutación por error? Amazon DocumentDB administra automáticamente la conmutación por error para que sus aplicaciones puedan reanudar las operaciones de la base de datos lo antes posible y sin intervención administrativa. + Si dispone de una réplica de Amazon DocumentDB en la misma zona de disponibilidad o en otra distinta cuando se realiza la conmutación por error, Amazon DocumentDB cambia el registro de nombre canónico (CNAME) para que su instancia apunte a la réplica en buen estado que, a su vez, se convierte en la nueva instancia principal. La conmutación por error suele completarse en 30 segundos de principio a fin. + Si no tiene una instancia de réplica de Amazon DocumentDB (por ejemplo, un clúster de instancia única), Amazon DocumentDB intentará crear una nueva instancia en la misma zona de disponibilidad que la instancia original. Este reemplazo de la instancia original se lleva a cabo con el mayor esfuerzo, pero puede fallar si, por ejemplo, existe un problema que esté afectando a la zona de disponibilidad de manera generalizada. La aplicación debe reintentar establecer las conexiones de la base de datos en caso de que se pierda la conexión. ## Prueba de conmutación por error Una conmutación por error de un clúster promueve una de las réplicas de Amazon DocumentDB (instancias de solo lectura) del clúster a instancia principal (la instancia de escritura del clúster). Cuando se produce un error en la instancia principal, Amazon DocumentDB conmuta automáticamente a una réplica de Amazon DocumentDB, si existe. Puede forzar una conmutación por error cuando desee simular un error en una instancia principal para realizar pruebas. Cada instancia de un clúster tiene su propia dirección de punto de conexión. Por lo tanto, es necesario eliminar y restablecer las conexiones existentes que utilizan dichas direcciones de punto de conexión cuando finalice la conmutación por error. Para forzar una conmutación por error, utilice la operación `failover-db-cluster` con los parámetros que se indican a continuación. + `--db-cluster-identifier`: obligatorio. El nombre del clúster de base de datos que se va a conmutar por error. + `--target-db-instance-identifier`: opcional. El nombre de la instancia que pasará a ser la instancia principal. **Example** La siguiente operación fuerza una conmutación por error del clúster `sample-cluster`. No especifica qué instancia se convertirá en la nueva instancia principal, por lo que Amazon DocumentDB elige la instancia de acuerdo con el nivel de prioridad de conmutación por error. Para Linux, macOS o Unix: ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster ``` Para Windows: ``` aws docdb failover-db-cluster ^ --db-cluster-identifier sample-cluster ``` La siguiente operación fuerza una conmutación por error del clúster `sample-cluster`, especificando que `sample-cluster-instance` pasará a ser la instancia principal. (Observe `"IsClusterWriter": true` en el resultado). Para Linux, macOS o Unix: ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster \ --target-db-instance-identifier sample-cluster-instance ``` Para Windows: ``` aws docdb failover-db-cluster ^ --db-cluster-identifier sample-cluster ^ --target-db-instance-identifier sample-cluster-instance ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBCluster": { "HostedZoneId": "Z2SUY0A1719RZT", "Port": 27017, "EngineVersion": "3.6.0", "PreferredMaintenanceWindow": "thu:04:05-thu:04:35", "BackupRetentionPeriod": 1, "ClusterCreateTime": "2018-06-28T18:53:29.455Z", "AssociatedRoles": [], "DBSubnetGroup": "default", "MasterUsername": "master-user", "Engine": "docdb", "ReadReplicaIdentifiers": [], "EarliestRestorableTime": "2018-08-21T00:04:10.546Z", "DBClusterIdentifier": "sample-cluster", "ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com", "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-cluster-instance", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": true }, { "DBInstanceIdentifier": "sample-cluster-instance-00", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": false }, { "DBInstanceIdentifier": "sample-cluster-instance-01", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": false } ], "AvailabilityZones": [ "us-east-1b", "us-east-1c", "us-east-1a" ], "DBClusterParameterGroup": "default.docdb3.6", "Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com", "IAMDatabaseAuthenticationEnabled": false, "AllocatedStorage": 1, "LatestRestorableTime": "2018-08-22T21:57:33.904Z", "PreferredBackupWindow": "00:00-00:30", "StorageEncrypted": false, "MultiAZ": true, "Status": "available", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-12345678" } ], "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ" } } ``` ## Retraso de replicación El retraso de replicación suele ser de 50 ms o menos. Los motivos más comunes del aumento del retraso en la réplica son: + Una velocidad de escritura alta en la principal que hace que las réplicas de lectura queden por detrás de la principal. + Discrepancia en las réplicas de lectura entre consultas de larga duración (p. ej., escaneos secuenciales de gran tamaño o consultas de agregación) y la replicación de escritura entrante. + Gran cantidad de consultas simultáneas en las réplicas de lectura. Para minimizar el retraso en la replicación, pruebe estas técnicas de solución de problemas: + Si tiene una alta velocidad de escritura o un uso elevado de la CPU, le recomendamos que escale verticalmente las instancias del clúster. + Si hay consultas de larga duración en las réplicas de lectura y se actualizan con mucha frecuencia los documentos consultados, plantéese la posibilidad de modificar las consultas de larga duración o ejecutarlas en la réplica principal o de escritura para evitar problemas en las réplicas de lectura. + Si hay un gran número de consultas simultáneas o un uso elevado de la CPU solo en las réplicas de lectura, otra opción es escalar horizontalmente el número de réplicas de lectura para distribuir la carga de trabajo. + Dado que el retraso en la replicación se debe a un alto rendimiento de escritura y a que las consultas se ejecutan durante mucho tiempo, recomendamos solucionar el retraso de la replicación utilizando la métrica DBClusterReplicaLagMaximum CW en combinación con el registrador de consultas lentas y las métricas `WriteThroughput`/`WriteIOPS`. En general, se recomienda que todas las réplicas sean del mismo tipo de instancia, de modo que una conmutación por error de un clúster no provoque una degradación del rendimiento. Si va a elegir entre escalar verticalmente y horizontalmente (por ejemplo, seis instancias más pequeñas frente a tres instancias más grandes), normalmente recomendamos que primero intente escalar verticalmente (instancias más grandes) antes de hacerlo horizontalmente, ya que obtendrá una caché de búfer más grande por instancia de base de datos. De forma proactiva, debe configurar una alarma de retraso de replicación y establecer su umbral en un valor que considere que es el límite superior del retraso (u “obsoleto”) que pueden estar los datos de las instancias de réplica antes de que comiencen a afectar a la funcionalidad de la aplicación. En general, le recomendamos que se supere el umbral de retraso de replicación en varios puntos de datos antes de emitir una alarma debido a las cargas de trabajo transitorias. **nota** Además, recomendamos que configure otra alarma para los retrasos de replicación que superen los 10 segundos. Si supera este umbral para varios puntos de datos, recomendamos que escale verticalmente las instancias o reduzca el rendimiento de la escritura en la instancia principal. # Administración de índices de Amazon DocumentDB **Topics** + [Creación de índices de Amazon DocumentDB](#index-creation) + [Mantenimiento de índices de Amazon DocumentDB](#maintaining-indexes) ## Creación de índices de Amazon DocumentDB La compilación de índices en Amazon DocumentDB requiere tomar una serie de decisiones: + ¿Con qué rapidez debe completarse? + ¿Es posible que no se pueda acceder a la colección mientras se realiza la compilación? + ¿Cuánta potencia de computación de una instancia se puede asignar a la compilación? + ¿Qué tipo de índice se debe crear? Esta sección le ayuda a responder a estas preguntas y proporciona los comandos y ejemplos de supervisión para crear un índice de Amazon DocumentDB en su colección de clústeres basada en instancias. ### Directrices Las siguientes pautas incluyen los límites básicos y las desventajas de configuración a la hora de crear nuevos índices: + **Compatibilidad con la versión de Amazon DocumentDB**: si bien la indexación de un solo proceso de trabajo se admite en todas las versiones de Amazon DocumentDB, la indexación de varios procesos de trabajo solo se admite en las versiones 4.0 y 5.0 de Amazon DocumentDB. + **Compensación de rendimiento**: aumentar el número de procesos de trabajo en el proceso de creación del índice aumenta la utilización de la CPU y la E/S de lectura en la instancia principal de la base de datos Amazon DocumentDB. Los recursos necesarios para crear un índice nuevo no estarán disponibles para su carga de trabajo en ejecución. + **Clústeres elásticos**: la indexación em paralelo no se admite en los clústeres elásticos de Amazon DocumentDB. + **Número máximo de procesos de trabajo**: el número máximo de procesos de trabajo que puede configurar depende del tamaño de la instancia principal en el clúster de base de datos. Es la mitad del número total de v CPUs en la instancia principal del clúster de base de datos. Por ejemplo, puede ejecutar un máximo de 32 trabajadores en una instancia db.r6g.16xlarge que tenga 64 v. CPUs **nota** Los equipos de trabajo en paralelo no son compatibles con las clases de instancias 2xlarge y versiones anteriores. + **Número mínimo de procesos de trabajo**: el número mínimo de procesos de trabajo que puede configurar es uno. La configuración predeterminada para la creación de índices en clústeres basados en instancias es de dos procesos de trabajo. Sin embargo, puede reducir el número de procesos de trabajo a uno mediante la opción “subprocesos de trabajo”. Esto ejecutará el proceso con un solo proceso de trabajo. + **Compresión de índices**: Amazon DocumentDB no admite la compresión de índices. Los tamaños de datos para índices pueden ser superiores que cuando utiliza otras opciones. + **Indexación de varias colecciones**: la mitad de la v CPUs de la instancia principal del clúster de base de datos se puede usar para los trabajadores configurados que crean índices en varias colecciones. + **Tipos de índices**: consulte [esta entrada de blog](https://aws.amazon.com/blogs/database/how-to-index-on-amazon-documentdb-with-mongodb-compatibility/) para obtener una explicación completa de los tipos de índices admitidos en Amazon DocumentDB. ### Introducción Para iniciar la creación de índices en una colección, utilice el comando `createIndexes`. De forma predeterminada, el comando ejecutará dos elementos de trabajo paralelos, lo que aumentará dos veces la velocidad del proceso de creación del índice. Por ejemplo, el siguiente proceso de comando muestra cómo crear un índice para el campo “user\$1name” de un documento y cómo aumentar la velocidad del proceso de indexación a cuatro elementos de trabajo: 1. Cree índices utilizando dos elementos de trabajo paralelos en el clúster: ``` db.runCommand({"createIndexes":"test","indexes":[{"key": {"user_name":1}, "name":"username_idx"}]}) ``` 1. Para optimizar la velocidad del proceso de creación del índice, puede especificar el número de procesos de trabajo mediante la opción “subprocesos de trabajo” (`"workers":`) del comando `db.runCommand createIndexes`. Aumente la velocidad del proceso a cuatro procesos de trabajo paralelos: ``` db.runCommand({"createIndexes":"test","indexes":[{"key": {"user_name":1}, "name":"username_idx", "workers":4}]}) ``` **nota** Cuanto mayor sea el número de procesos de trabajo, más rápido avanzará la creación del índice. Sin embargo, cuanto mayor sea el número de trabajadores, mayor será la carga en las E/S de lectura CPUs y v de la instancia principal. Asegúrese de que el clúster esté lo suficientemente aprovisionado para soportar el aumento de la carga sin degradar otras cargas de trabajo. ### Estado del progreso de indexación El proceso de creación de índices funciona inicializando, escaneando las colecciones, clasificando las claves y, finalmente, insertándolas mediante un generador de índices. El proceso tiene hasta seis etapas cuando se ejecuta en primer plano y hasta nueve etapas cuando se ejecuta en segundo plano. Puede ver las métricas de estado, como el porcentaje de finalización, el número total de bloques de almacenamiento escaneados, las claves clasificadas y las claves insertadas, etapa por etapa. Supervise el progreso del proceso de indexación mediante el comando `db.currentOp()` del shell mongo. Una finalización del 100 % de la última etapa indica que todos los índices se han creado correctamente: ``` db.currentOp({"command.createIndexes": { $exists : true } }) ``` **nota** La visualización del estado del progreso de la indexación se admite solamente en Amazon DocumentDB 5.0. #### Tipos de creación de índices Los cuatro tipos de compilaciones de índices son: + **Primer plano**: la compilación del índice en primer plano bloquea todas las demás operaciones de la base de datos hasta que se crea el índice. La compilación en primer plano de Amazon DocumentDB consta de cinco etapas. + **Primer plano (único)**: las compilaciones de índices en primer plano de un solo documento (únicas) bloquean otras operaciones de la base de datos como las compilaciones en primer plano normales. A diferencia de la compilación básica en primer plano, la compilación única utiliza una etapa adicional (clasificación de claves 2) para buscar claves duplicadas. La compilación en primer plano (única) consta de seis etapas. + **Fondo**: la compilación del índice en segundo plano permite que otras operaciones de la base de datos se ejecuten en primer plano mientras se crea el índice. La compilación de fondo de Amazon DocumentDB consta de ocho etapas. + **Fondo (único)**: las compilaciones de índices en segundo plano de un solo documento (único) permiten que otras operaciones de la base de datos se ejecuten en primer plano mientras se crea el índice. A diferencia de la compilación básica de fondo, la compilación única utiliza una etapa adicional (clasificación de claves 2) para buscar claves duplicadas. La compilación de fondo (única) se compone de nueve etapas. #### Etapas de compilación del índice | Etapa | Primer plano | Primer plano (único) | Introducción | Fondo (único) | | --- | --- | --- | --- | --- | | Inicializando | 1 | 1 | 1 | 1 | | creando índice: inicializando | 2 | 2 | 2 | 2. | | creando índice: escaneando colección | 3 | 3 | 3 | 3 | | creando índice: clasificando claves 1 | 4 | 4 | 4 | 4 | | creando índice: clasificando claves 2 | | 5 | | 5 | | creando índice: insertando claves | 5 | 6 | 5 | 6 | | validando: escaneando índice | | | 6 | 7 | | validando: clasificando tuplas | | | 7 | 8 | | validando: escaneando colección | | | 8 | 9 | + **inicializando**: createIndex está preparando el generador de índices. Esta fase debe ser muy breve. + **creando índice: inicializando**: el generador de índices se está preparando para crear el índice. Esta fase debe ser muy breve. + **creando índice: escaneando colección**: el generador de índices está escaneando la colección para recopilar las claves del índice. La unidad de medida son los “bloques”. **nota** Si hay más de un elemento de trabajo configurado para la compilación del índice, se mostrará en esta etapa. La etapa “escaneando colección” es la única etapa en la que se utilizan varios procesos de trabajo durante el proceso de compilación del índice. En todas las demás etapas se mostrará un único proceso de trabajo. + **creando índice: clasificando claves 1**: el generador de índices está clasificando las claves de índice recopiladas. La unidad de medida son las “claves”. + **creando índice: clasificando claves 2**: el generador de índices está clasificando las claves de índice recopiladas que corresponden a tuplas muertas. Esta fase solo existe para la compilación de índices únicos. La unidad de medida son las “claves”. + **creando índice: insertando claves**: el generador de índices está insertando claves de índice en el nuevo índice. La unidad de medida son las “claves”. + **validando: escaneando índice**: createIndex está escaneando el índice para buscar las claves que deben validarse. La unidad de medida son los “bloques”. + **validando: clasificando tuplas**: createIndex está ordenando el resultado de la fase de escaneo del índice. + **validando: escaneando colección**: createIndex está escaneando la colección para validar las claves de índice encontradas en las dos fases anteriores. La unidad de medida son los “bloques”. #### Ejemplo de salida de compilación del índice En el siguiente ejemplo de salida (compilación del índice en primer plano), se muestra el estado de la creación del índice. El campo “msg” resume el progreso de la compilación indicando la etapa y el porcentaje de finalización de la compilación. El campo “procesos de trabajo” indica el número de procesos de trabajo utilizados durante esa etapa de la compilación del índice. El campo “progreso” muestra los números reales utilizados para calcular el porcentaje de finalización. **nota** Los campos «currentIndexBuildNombre», «mensaje» y «progreso» no son compatibles con la versión 4.0 de Amazon DocumentDB. ``` { "inprog" : [{ … "command": { "createIndexes": "test", "indexes": [{ "v": 2, "key": { "user_name": 1 }, "name": "user_name_1" }], "lsid": { "id": UUID(“094d0fba-8f41-4373-82c3-7c4c7b5ff13b”) }, "$db": "test" }, "currentIndexBuildName": user_name_1, "msg": "Index Build: building index number_1, stage 6/6 building index: 656860/1003520 (keys) 65%", "workers": 1, "progress": { "done": 656861, "total": 1003520 }, … ], "ok" : 1 } ``` ## Mantenimiento de índices de Amazon DocumentDB **Topics** + [Sobrecarga del índice](#db-index-bloat) + [Mantenimiento de índices mediante `reIndex`](#reIndex) ### Sobrecarga del índice Amazon DocumentDB utiliza el control de concurrencia multiversión (MVCC) para gestionar las transacciones simultáneas. Cuando los documentos se eliminan o actualizan, sus versiones anteriores permanecen en las colecciones e índices como versiones «inactivas». El proceso de recopilación de elementos no utilizados recupera automáticamente el espacio de estas versiones inactivas para futuras operaciones. La sobrecarga de índices se produce cuando el tamaño de los índices de una colección aumenta debido a la acumulación de índices inactivos u obsoletos o a la fragmentación de las páginas. El porcentaje informado representa la cantidad de espacio de índice que pueden utilizar las entradas de índice futuras. Esta sobrecarga consume espacio tanto en la memoria caché como en el almacenamiento del búfer. Si desea eliminar la sobrecarga, tendrá que recopilar los índices. **Example Ejemplo** Ejecute el siguiente comando para determinar el almacenamiento no utilizado del índice: ``` db.coll.aggregate({$indexStats:{}}); ``` El resultado tendrá un aspecto parecido al siguiente: ``` { "name" : "_id_", "key" : { "_id" : 1 }, "host" : "devbox-test.localhost.a2z.com:27317", "size" : NumberLong(827392), "accesses" : { "ops" : NumberLong(40000), "docsRead" : NumberLong(46049), "since" : ISODate("2025-04-03T21:44:51.251Z") }, "cacheStats" : { "blksRead" : NumberLong(264), "blksHit" : NumberLong(140190), "hitRatio" : 99.8121 }, "unusedStorageSize" : { "unusedSizeBytes" : 409600, "unusedSizePercent" : 49.51 } } ``` Puede reconstruir los índices sin tiempo de inactividad mediante el comando `reIndex`, que requiere escanear toda la colección. Consulte [Mantenimiento de índices mediante `reIndex`](#reIndex). ### Mantenimiento de índices mediante `reIndex` `reIndex` es un comando que se utiliza para reconstruir un índice. Se utiliza normalmente cuando un índice está dañado o es ineficiente. Con el tiempo, los índices pueden acumular espacio no utilizado debido a muchas actualizaciones, inserciones o eliminaciones, lo que reduce el rendimiento. La reindexación ayuda a eliminar ese espacio no utilizado y a restablecer la eficiencia del índice. #### Directrices de `reIndex` + `reIndex` solo es compatible con Amazon DocumentDB 5.0. + Amazon DocumentDB admite `reindex` un único índice en segundo plano, lo que permite varios procesos de trabajo. Las consultas pueden utilizar el índice anterior cuando el proceso de `reIndex` está en ejecución. + Amazon DocumentDB admite informes de progreso de indexación a través de `currentOp`. Puede ver las etapas de creación del índice de forma similar a las [Etapas de compilación del índice](#index-build-stages) vistas durante la creación del índice. La única diferencia es que `reIndex` siempre tiene ocho etapas, independientemente de si son únicas o no. No existe una etapa de “creación de índices: claves de clasificación 2”. + `reIndex` se puede ejecutar simultáneamente con cualquier comando, excepto los comandos relacionados con índices de la misma colección: `createIndexes`, `dropIndexes`, `collMod` y `renameCollection`. + `reIndex` actualmente no es compatible con índices de texto, geoespaciales, vectoriales ni parciales. ##### Creación de `reIndex` Use el siguiente comando para reconstruir el índice: ``` db.runCommand({ reIndex: "collection-name", index: "index-name"}) ``` Si lo desea, también puede controlar el número de procesos de trabajo asignados al proceso de reconstrucción: ``` db.runCommand({ reIndex: "collection-name", index: "index-name", workers: number }) ``` # Gestión de la compresión de documentos a nivel de colección La compresión de documentos a nivel de colección de Amazon DocumentDB 5.0 le permite reducir los costos de almacenamiento y E/S al comprimir los documentos de sus colecciones. Puede habilitar la compresión de documentos a nivel de colección y ver las métricas de compresión según sea necesario, midiendo las ganancias de almacenamiento mediante métricas de compresión como es el tamaño de almacenamiento de los documentos comprimidos y el estado de la compresión. Amazon DocumentDB 5.0 utiliza el algoritmo de LZ4 compresión para comprimir documentos. Amazon DocumentDB admite la compresión de documentos a partir de la versión 5.0. Las siguientes son funciones de compresión de documentos a nivel de colección: + **Comportamiento predeterminado**: la configuración de compresión predeterminada para las nuevas colecciones de un clúster de la versión 5.0 viene determinada por el parámetro `default_collection_compression` del clúster. Este parámetro está establecido en “deshabilitado” de forma predeterminada. + **Compresión de las colecciones existentes**: la configuración de compresión de las colecciones existentes se puede cambiar mediante el comando `collMod`. + **Cambio del umbral de compresión**: el umbral de compresión predeterminado es de 2 KB. Este valor se puede especificar para las colecciones nuevas mediante el comando `createCollection` y se puede cambiar para las colecciones existentes mediante el comando `collMod`. **nota** La compresión de documentos de Amazon DocumentDB no es compatible en las versiones 3.6 y 4.0 de Amazon DocumentDB. **Topics** + [Administración de la compresión de documentos](#manage-compression) + [Supervisión de la compresión de documentos](#monitoring-compression) ## Administración de la compresión de documentos ### Habilitación de la compresión de documentos en una colección Active la compresión de documentos al crear una colección en Amazon DocumentDB 5.0 mediante `db.createCollection()` el método: ``` db.createCollection( sample_collection,{ storageEngine : { documentDB: { compression:{enable: } } } }) ``` ### Habilitación de la compresión de documentos en un clúster La compresión de documentos se puede habilitar de forma predeterminada para todas las colecciones nuevas a nivel de clúster al establecer el parámetro `default_collection_compression` del clúster en “habilitado”. Si este parámetro se establece en “habilitado”, las colecciones recién creadas en el clúster tendrán la compresión habilitada de forma predeterminada con un umbral de compresión de 2 KB. ### Compresión de colecciones existentes También puede modificar la configuración de compresión de una colección existente mediante la operación `collMod` y especificando la siguiente configuración `storageEngine`. Tenga en cuenta que el cambio realizado con este comando solo se aplicará a inserted/updated los documentos nuevos y la compresión de los documentos insertados anteriormente no cambiará. ``` db.runCommand({ collMod: "orders", storageEngine: { documentDB: {compression: {enable: } } } }) ``` ### Establecimiento de los umbrales de compresión De forma predeterminada, el umbral de compresión de las colecciones comprimidas es de 2032 bytes. Este valor de umbral se puede establecer en el comando `createCollection` al crear una nueva colección con la compresión habilitada: ``` db.createCollection( sample_collection, { storageEngine : { documentDB: { compression: { enable: true, threshold: <128 - 8000> } } } }) ``` También puede modificar el umbral de compresión de una colección comprimida existente mediante la operación `collMod` y al especificar la siguiente configuración `storageEngine`: ``` db.runCommand({ collMod: "orders", storageEngine: { documentDB: { compression: { enable: true, threshold: <128 - 8000> } } } }) ``` Tenga en cuenta que el umbral de compresión solo se puede establecer en un valor entre 128 y 8000 bytes. Además, la opción `enable` debe estar configurada en “true” al especificar el umbral de compresión. ## Supervisión de la compresión de documentos Puede comprobar si una colección está comprimida y calcular la relación de compresión de la siguiente manera: Para ver las estadísticas de compresión, ejecute el comando `db.printCollectionStats()` o `db.collection.stats()` desde el intérprete de comandos de mongo. El resultado muestra el tamaño original y el tamaño comprimido, que puede comparar para analizar las ganancias de almacenamiento derivadas de la compresión de documentos. En este ejemplo, se muestran las estadísticas de una colección denominada “sample\$1collection” a continuación. A continuación, se utiliza un factor de escala de 1024\$11024 para generar los valores `size` y `storageSize` en MB. ``` db.sample_collection.stats(1024*1024) ``` El siguiente es un ejemplo del resultado para el comando anterior: ``` { "ns" : "test.sample_collection", "count" : 1000000, "size" : 3906.3, "avgObjSize" : 4096, "storageSize" : 1953.1, compression:{"enabled" : true,"threshold" : 2032}, ... } ``` + **tamaño**: el tamaño original de la colección de documentos. + **avgObjSize**- El tamaño medio del documento antes de la compresión se redondea al primer decimal. La unidad de medida son bytes. + **StorageSize**: el tamaño de almacenamiento de la colección después de la compresión. La unidad de medida son bytes. + **habilitada**: indica si la compresión está habilitada o deshabilitada. Para calcular la relación de compresión real, divida el tamaño de la colección entre el tamaño de almacenamiento (Size/StorageSize). En el ejemplo anterior, el cálculo es 3906.3/1953.1, lo que se traduce en una relación de compresión de 2:1. # Administración de la compresión basada en diccionarios en Amazon DocumentDB 8.0 Amazon DocumentDB 8.0 presenta un nuevo algoritmo de compresión de documentos, zstd, como una alternativa mejorada a. LZ4 Al habilitar la compresión de diccionarios en una colección de Amazon DocumentDB 8.0 seleccionando Zstd como algoritmo de compresión, los documentos de la colección se muestrean para crear un diccionario de compresión personalizado. Los documentos nuevos y actualizados se comprimen con este diccionario y el algoritmo zstd. Este enfoque suele lograr relaciones de compresión más altas que los métodos de compresión estándar, especialmente para colecciones con esquemas de documentos consistentes o nombres de campo repetidos. Lz4 es un algoritmo diseñado para una compresión y descompresión rápidas. Se sabe que es liviano para la CPU y, al mismo tiempo, logra una compresión notable. Zstd es un algoritmo de uso general que, con la configuración predeterminada, usa más CPU pero logra mejores relaciones de compresión que lz4. El uso de diccionarios mejora aún más la compresión en la mayoría de los documentos JSON. Algunas de las ventajas del algoritmo Zstd son: + Reducción de los costes de almacenamiento: unas relaciones de compresión más altas implican un menor uso del almacenamiento y unos costes más bajos. + Menor rendimientoI/O: Compressed documents require less I/O, lo que podría mejorar. + Optimizado para su colección: el diccionario está diseñado específicamente para los patrones de datos de su colección. **nota** La compresión basada en diccionarios no se admite en las versiones 3.6, 4.0 y 5.0 de Amazon DocumentDB. ## Consideraciones sobre el rendimiento La compresión Zstd implica las siguientes ventajas y desventajas: + Almacenamiento frente a CPU: la compresión Zstd logra mejores relaciones de compresión, pero puede consumir un poco más de recursos de la CPU en comparación con la compresión. LZ4 + Compresión inicial: es posible que las nuevas colecciones no logren una compresión óptima hasta que no se hayan insertado suficientes documentos para formar un diccionario eficaz. En la actualidad, un diccionario se entrena si reúne al menos 100 documentos. + Tipo de carga de trabajo: las cargas de trabajo de lectura intensiva en las que todos los datos caben en la caché del búfer pueden experimentar un aumento de la latencia y el uso de la CPU debido a la sobrecarga de descompresión. La compresión Zstd es especialmente eficaz para colecciones con documentos pequeños, matrices de documentos y nombres de campos repetidos. ## Habilitar la compresión basada en diccionarios En el caso de colecciones nuevas, puede utilizar el siguiente comando para activar la compresión Zstd: ``` db.createCollection("myCollection", { storageEngine: { documentDB: { compression: { enable: true, algorithm: "zstd" } } } } ) ``` También puedes activar o modificar la compresión en una colección existente: ``` db.runCommand({ collMod: "myCollection", storageEngine: { documentDB: { compression: { enable: true, algorithm: "zstd" } } } }) ``` Para habilitar el algoritmo Zstd en todas las colecciones del clúster, puede modificar el grupo de parámetros del clúster para seleccionar «zstd» como valor para el parámetro «default\$1collection\$1compression». ## Introducción Amazon DocumentDB 8.0 incluye la compresión Zstd activada de forma predeterminada. Siempre puede desactivarla configurando el valor de 'default\$1compression' como deshabilitado en el grupo de parámetros del clúster. Debe tenerse en cuenta que, a partir de Amazon DocumentDB 8.0, «activado» ya no es una opción válida para default\$1compression y debe seleccionar entre Zstd y. LZ4 ## Supervisión Puede ver la información de compresión de una colección mediante uno de los siguientes comandos: + db.runCommand (\$1CollStats: «myCollection»\$1) O + db.collection.stats () Estos comandos devuelven estadísticas clave que puede utilizar para calcular la relación de compresión: + algoritmo de compresión: el algoritmo utilizado («lz4" o «zstd») + StorageSize: el almacenamiento real que utiliza la colección después de la compresión. Tenga en cuenta que este número incluye la fragmentación (es decir, el espacio no utilizado en las páginas de la base de datos) + avgObjSize: El tamaño lógico promedio de los documentos de la colección, descomprimido. Tenga en cuenta que si su colección tiene más de 20 000 documentos, este número será una aproximación basada en una muestra de 20 000 documentos. + tamaño: el tamaño lógico de la colección sin compresión. Este número se obtiene multiplicando avgObjSize por el número total de documentos de la colección, por lo que si avgObjSize es una aproximación, este número también será una aproximación. + recuento: número de documentos de la colección Las siguientes CloudWatch métricas pueden resultar útiles a la hora de evaluar la compresión basada en diccionarios: + CPUUtilization + FreeableMemory + VolumeBytesUsed + VolumeReadIOPs + VolumeWriteIOPs Métricas de CollStats: + storageSize + tamaño Además, puede resultar útil realizar un seguimiento de las métricas específicas de la aplicación, como la latencia y el rendimiento por tipo de consulta o API. # Administración de eventos de Amazon DocumentDB Amazon DocumentDB (con compatibilidad con MongoDB) mantiene un registro de los eventos relacionados con los clústeres, las instancias, las instantáneas, los grupos de seguridad y los grupos de parámetros de clúster. Esta información incluye la fecha y hora del evento, el nombre del origen y el tipo del origen del evento y un mensaje relacionado con el evento. **importante** En determinadas características de administración, Amazon DocumentDB utiliza una tecnología operativa que comparte con Amazon RDS y Amazon Neptune. Los límites regionales, es decir, los límites que se aplican en el nivel de región, se comparten entre Amazon DocumentDB, Amazon RDS, y Amazon Neptune. Para obtener más información, consulte [Cuotas regionales](limits.md#limits-regional_quotas). **Topics** + [Visualización de las categorías de eventos de Amazon DocumentDB](#viewing-event-categories) + [Visualización de eventos de Amazon DocumentDB](#viewing-events) ## Visualización de las categorías de eventos de Amazon DocumentDB Cada tipo de recurso de Amazon DocumentDB, tiene tipos específicos de eventos que se pueden asociar a él. Puede utilizar la operación `describe-event-categories` de la AWS CLI para ver la correspondencia entre los tipos de eventos y los tipos de recursos de Amazon DocumentDB. **Parámetros** + **--source-type**: opcional. Utilice el parámetro `--source-type` para ver las categorías de eventos de un tipo de origen particular. Se permiten los siguientes valores: + `db-cluster` + `db-instance` + `db-parameter-group` + `db-security-group` + `db-cluster-snapshot` + **--filters**: opcional. Para ver categorías de eventos únicamente para Amazon DocumentDB, utilice el filtro `--filter Name=engine,Values=docdb`. **Example** El siguiente código muestra las categorías de eventos asociadas a los clústeres. Para Linux, macOS o Unix: ``` aws docdb describe-event-categories \ --filter Name=engine,Values=docdb \ --source-type db-cluster ``` Para Windows: ``` aws docdb describe-event-categories ^ --filter Name=engine,Values=docdb ^ --source-type db-cluster ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "EventCategoriesMapList": [ { "EventCategories": [ "notification", "failure", "maintenance", "failover" ], "SourceType": "db-cluster" } ] } ``` El siguiente código muestra las categorías de eventos asociadas a cada tipo de recurso de Amazon DocumentDB. ``` aws docdb describe-event-categories ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "EventCategoriesMapList": [ { "SourceType": "db-instance", "EventCategories": [ "notification", "failure", "creation", "maintenance", "deletion", "recovery", "restoration", "configuration change", "read replica", "backtrack", "low storage", "backup", "availability", "failover" ] }, { "SourceType": "db-security-group", "EventCategories": [ "configuration change", "failure" ] }, { "SourceType": "db-parameter-group", "EventCategories": [ "configuration change" ] }, { "SourceType": "db-cluster", "EventCategories": [ "notification", "failure", "maintenance", "failover" ] }, { "SourceType": "db-cluster-snapshot", "EventCategories": [ "backup" ] } ] } ``` ## Visualización de eventos de Amazon DocumentDB Puede recuperar eventos de los recursos de Amazon DocumentDB a través de la consola de Amazon DocumentDB, la cual muestra los eventos de las últimas 24 horas. También puede recuperar eventos para los recursos de Amazon DocumentDB utilizando el comando [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI, o la operación [DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html) de la API de Amazon DocumentDB. Si utiliza la AWS CLI o la API de Amazon DocumentDB para ver eventos, puede recuperar eventos de los últimos 14 días como máximo. ------ #### [ Using the Consola de administración de AWS ] **Visualización de todos los eventos de las instancias de Amazon DocumentDB de las últimas 24 horas** 1. Inicie sesión en la Consola de administración de AWS y abra la 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 **Events**. Los eventos disponibles aparecen en una lista. 1. Utilice la lista **Filter (Filtro)** para filtrar los eventos por tipo. Escriba un término en el cuadro de texto para filtrar aún más los resultados. Por ejemplo, la siguiente captura de pantalla muestra la filtración de todos los eventos de Amazon DocumentDB para los eventos de *instantánea*. ![\[Captura de pantalla de la sección de eventos que muestra el filtrado de eventos de instantáneas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/events-filtering.png) ------ #### [ Using the AWS CLI ] **Visualización de todos los eventos de las instancias de Amazon DocumentDB de los últimos 7 días** Puede ver todos los eventos de las instancias de Amazon DocumentDB de los últimos 7 días ejecutando la operación [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) de la AWS CLI con el parámetro `--duration` establecido en `10080` (10 080 minutos). ``` aws docdb describe-events --duration 10080 ``` **Filtrado de eventos de Amazon DocumentDB** Para ver eventos de Amazon DocumentDB específicos, utilice la operación `describe-events` con los siguientes parámetros. **Parámetros** + **--filter**: necesario para limitar los valores devueltos a los eventos de Amazon DocumentDB. Utilice **Name=engine,Values=docdb** para filtrar todos los eventos únicamente para Amazon DocumentDB. + **--source-identifier**: opcional. El identificador del origen de eventos para el que se devuelven eventos. Si se omite, se incluyen en los resultados los eventos de todos los orígenes. + **--source-type**: opcional, a menos que se proporcione `--source-identifier`, entonces es obligatorio. Si se proporciona `--source-identifier`, `--source-type` debe coincidir con el tipo de `--source-identifier`. Se permiten los siguientes valores: + `db-cluster` + `db-instance` + `db-parameter-group` + `db-security-group` + `db-cluster-snapshot` El siguiente ejemplo muestra todos los eventos de Amazon DocumentDB. ``` aws docdb describe-events --filters Name=engine,Values=docdb ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "Events": [ { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3", "Message": "instance created", "SourceType": "db-instance", "Date": "2018-12-11T21:17:40.023Z", "SourceIdentifier": "sample-cluster-instance3", "EventCategories": [ "creation" ] }, { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23", "Message": "instance shutdown", "SourceType": "db-instance", "Date": "2018-12-11T21:25:01.245Z", "SourceIdentifier": "docdb-2018-12-11-21-08-23", "EventCategories": [ "availability" ] }, { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23", "Message": "instance restarted", "SourceType": "db-instance", "Date": "2018-12-11T21:25:11.441Z", "SourceIdentifier": "docdb-2018-12-11-21-08-23", "EventCategories": [ "availability" ] } ] } ``` ------ Para obtener más información, consulte [Auditoría de eventos de Amazon DocumentDB](event-auditing.md). # Elección de regiones y zonas de disponibilidad Los recursos de computación en la nube de Amazon están alojados en varias ubicaciones de todo el mundo. Estas ubicaciones constan Regiones de AWS de zonas de disponibilidad. Cada *Región de AWS* es un área geográfica independiente. Cada región tiene varias ubicaciones aisladas conocidas como *zonas de disponibilidad*. Amazon DocumentDB le ofrece la posibilidad de colocar recursos, como instancias, y datos en varias ubicaciones. Los recursos no se replican en todos los demás, Regiones de AWS a menos que lo haga específicamente. Amazon opera centros de datos de alta disponibilidad con tecnología de vanguardia. Aunque es infrecuente, puede suceder que se produzcan errores que afecten a la disponibilidad de las instancias que están en la misma ubicación. Si hospeda todas las instancias en una misma ubicación y se produce un error en ella, ninguna de las instancias estaría disponible. El siguiente diagrama muestra una Región de AWS con tres zonas de disponibilidad. ![\[Un diagrama de una región que contiene tres zonas de disponibilidad: a, b y c.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/RegionsAndAZs.png) Es importante recordar que cada región es completamente independiente. Cualquier actividad de Amazon DocumentDB que se inicie (por ejemplo, la creación de instancias o la enumeración de las instancias de base de datos disponibles) se ejecuta solo en la Región de AWS predeterminada actual. Puede cambiar la región predeterminada en la consola configurando la variable de entorno `EC2_REGION`. También puede invalidarla mediante el parámetro `--region` de la AWS CLI. Para obtener más información, consulte [Configurar AWS Command Line Interface, específicamente, las](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) secciones sobre variables de entorno y opciones de línea de comandos. Cuando crea un clúster mediante la consola de Amazon DocumentDB y decide crear una réplica en una zona de disponibilidad diferente, Amazon DocumentDB crea dos instancias. Crea la instancia principal en una zona de disponibilidad y la instancia de réplica en una zona de disponibilidad diferente. El volumen del clúster siempre se replica en tres zonas de disponibilidad. Para crear o trabajar con una instancia de Amazon DocumentDB en una instancia específica Región de AWS, utilice el punto de enlace de servicio regional correspondiente. ## Disponibilidad por región Amazon DocumentDB está disponible en las siguientes AWS regiones. **Regiones compatibles con Amazon DocumentDB** | Nombre de la región | Region | Zonas de disponibilidad (cálculo) | | --- | --- | --- | | Este de EE. UU. (Ohio) | `us-east-2` | 3 | | Este de EE. UU. (Norte de Virginia) | `us-east-1` | 6 | | Oeste de EE. UU. (Oregón) | `us-west-2` | 4 | | África (Ciudad del Cabo) | `af-south-1` | 3 | | América del Sur (São Paulo) | `sa-east-1` | 3 | | Asia-Pacífico (Hong Kong) | `ap-east-1` | 3 | | Asia-Pacífico (Hyderabad) | `ap-south-2` | 3 | | Asia-Pacífico (Malasia) | `ap-southeast-5` | 3 | | Asia-Pacífico (Mumbai) | `ap-south-1` | 3 | | Asia-Pacífico (Osaka) | `ap-northeast-3` | 3 | | Asia-Pacífico (Seúl) | `ap-northeast-2` | 4 | | Asia-Pacífico (Singapur) | `ap-southeast-1` | 3 | | Asia-Pacífico (Sídney) | `ap-southeast-2` | 3 | | Asia-Pacífico (Yakarta) | `ap-southeast-3` | 3 | | Asia-Pacífico (Melbourne) | `ap-southeast-4` | 3 | | Asia-Pacífico (Tailandia) | `ap-southeast-7` | 3 | | Asia-Pacífico (Tokio) | `ap-northeast-1` | 3 | | Canadá (centro) | `ca-central-1` | 3 | | Región China (Pekín) | `cn-north-1` | 3 | | China (Ningxia) | `cn-northwest-1` | 3 | | Europa (Fráncfort) | `eu-central-1` | 3 | | Europa (Zúrich) | `eu-central-2` | 3 | | Europa (Irlanda) | `eu-west-1` | 3 | | Europa (Londres) | `eu-west-2` | 3 | | Europa (Milán) | `eu-south-1` | 3 | | Europa (París) | `eu-west-3` | 3 | | Europa (España) | `eu-south-2` | 3 | | Europa (Estocolmo) | `eu-north-1` | 3 | | México (centro) | `mx-central-1` | 3 | | Medio Oriente (EAU) | `me-central-1` | 3 | | Israel (Tel Aviv) | `il-central-1` | 3 | | AWS GovCloud (EE. UU.-Oeste) | `us-gov-west-1` | 3 | | AWS GovCloud (EE. UU.-Este) | `us-gov-east-1` | 3 | Por defecto, la zona horaria de un clúster de Amazon DocumentDB es la hora universal coordinada (UTC). Para obtener más información sobre cómo buscar puntos de conexión de clústeres e instancias en una región determinada, consulte [Descripción de los puntos de conexión de Amazon DocumentDB](endpoints.md). # Administración de los grupos de parámetros de clúster de Amazon DocumentDB Es posible administrar la configuración del motor de Amazon DocumentDB mediante los parámetros de un grupo de parámetros de clúster. Un *grupo de parámetros de clúster* es una colección de valores de configuración de Amazon DocumentDB que facilitan la administración de los parámetros de los clústeres de Amazon DocumentDB. Los grupos de parámetros de clúster actúan como un contenedor para los valores de configuración del motor que se aplican a todas las instancias del clúster. En esta sección se describe cómo crear, ver y modificar grupos de parámetros de clúster. También muestra cómo se puede determinar qué grupo de parámetros de clúster está asociado a un clúster determinado. **Topics** + [Descripción de los grupos de parámetros de clúster](cluster_parameter_groups-describe.md) + [Creación de grupos de parámetros de clúster](cluster_parameter_groups-create.md) + [Modificación de grupos de parámetros de clúster](cluster_parameter_groups-modify.md) + [Modificación de clústeres para utilizar grupos de parámetros de clúster personalizados](cluster_parameter_groups-modify_clusters.md) + [Copia de grupos de parámetros de clúster](cluster_parameter_groups-copy.md) + [Restablecimiento de los grupos de parámetros de clúster](cluster_parameter_groups-reset.md) + [Eliminación de grupos de parámetros de clúster](cluster_parameter_groups-delete.md) + [Referencia de parámetros de clúster](cluster_parameter_groups-list_of_parameters.md) # Descripción de los grupos de parámetros de clúster de Amazon DocumentDB Un grupo de parámetros de clúster `default` se crea automáticamente al crear el primer clúster de Amazon DocumentDB en una nueva región o al utilizar un motor nuevo. Los clústeres siguientes que se creen en la misma región y tengan la misma versión de motor se crean con el grupo de parámetros de clúster `default`. **Topics** + [Descripción de los detalles de un grupo de parámetros de clúster](#cluster_parameter_groups-describe_details) + [Determinación del grupo de parámetros de un clúster](#cluster_parameter_groups-determine) + [Determinar los clústeres e instancias asociados a un grupo de parámetros de clúster](#cluster_parameter_groups-count) ## Descripción de los detalles de un grupo de parámetros de clúster de Amazon DocumentDB Para describir los detalles de un grupo de parámetros de clúster determinado, complete los siguientes pasos con Consola de administración de AWS o AWS Command Line Interface (AWS CLI). ------ #### [ Using the Consola de administración de AWS ] **** 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 **Grupos de parámetros**. **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. 1. En el panel **Cluster parameter groups (Grupos de parámetros de clúster)**, seleccione el nombre del grupo de parámetros cuyos detalles desee ver. 1. La página resultante muestra los parámetros del grupo de parámetros, la actividad reciente y las etiquetas. + En **Cluster parameters (Parámetros de clúster)**, puede ver el nombre del parámetro, el valor actual, los valores permitidos, si el parámetro es modificable, su tipo de aplicación, tipo de datos y descripción. Puede modificar parámetros individuales seleccionando el parámetro y eligiendo **Edit (Editar)** en la sección **Cluster parameters (Parámetros de clúster)** . Para obtener más información, consulte [Modificación de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-parameters.md). + En **Recent events (Eventos recientes)**, puede ver los eventos más recientes de este grupo de parámetros. Puede filtrar estos eventos mediante la barra de búsqueda de esta sección. Para obtener más información, consulte [Administración de eventos de Amazon DocumentDB](managing-events.md). + En **Tags (Etiquetas)**, puede ver las etiquetas que se encuentran en este grupo de parámetros de clúster. Puede agregar o quitar etiquetas seleccionando **Edit (Editar)** en la sección **Tags (Etiquetas)** . Para obtener más información, consulte [Etiquetado de recursos de Amazon DocumentDB](tagging.md). ------ #### [ Using the AWS CLI ] Puede usar el `describe-db-cluster-parameter-groups` AWS CLI comando para ver el nombre del recurso de Amazon (ARN), la familia, la descripción y el nombre de un único grupo de parámetros de clúster o de todos los grupos de parámetros de clúster que tiene para Amazon DocumentDB. También puede usar el `describe-db-cluster-parameters` AWS CLI comando para ver los parámetros y sus detalles dentro de un único grupo de parámetros de clúster. + **--describe-db-cluster-parameter-groups**: para ver una lista de todos los grupos de parámetros de clúster y sus detalles. + **--db-cluster-parameter-group-name**: opcional. El nombre del grupo de parámetros de clúster que desea describir. Si se omite este parámetro, se describen todos los grupos de parámetros de clúster. + **--describe-db-cluster-parameters**: para obtener una lista de los parámetros de un grupo de parámetros, junto con sus valores. + **--db-cluster-parameter-group name**: obligatorio. El nombre del grupo de parámetros de clúster que desea describir. **Example** El código siguiente enumera hasta 100 grupos de parámetros de clúster y su ARN, familia, descripción y nombre. ``` aws docdb describe-db-cluster-parameter-groups ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroups": [ { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0", "DBParameterGroupFamily": "docdb4.0", "Description": "Default cluster parameter group for docdb4.0", "DBClusterParameterGroupName": "default.docdb4.0" }, { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group", "DBParameterGroupFamily": "docdb4.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupName": "sample-parameter-group" } ] } ``` **Example** El código siguiente enumera el ARN, la familia, la descripción y el nombre de `sample-parameter-group`. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name sample-parameter-group ``` Para Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroups": [ { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group", "Description": "Custom docdb4.0 parameter group", "DBParameterGroupFamily": "docdb4.0", "DBClusterParameterGroupName": "sample-parameter-group" } ] } ``` **Example** El código siguiente enumera los valores de los parámetros de `sample-parameter-group`. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Para Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "change_stream_log_retention_duration", "ParameterValue": "17777", "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.", "Source": "user", "ApplyType": "dynamic", "DataType": "integer", "AllowedValues": "3600-86400", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ ## Determinación del grupo de parámetros de un clúster de Amazon DocumentDB Para determinar qué grupo de parámetros está asociado a un clúster en particular, complete los siguientes pasos utilizando el Consola de administración de AWS o el AWS CLI. ------ #### [ Using the Consola de administración de AWS ] 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 izquierdo, elija **Clusters (Clústeres)**. 1. En la lista de clústeres, elija el nombre del clúster de su interés. 1. La página resultante muestra los detalles del clúster seleccionado. Desplácese hacia abajo hasta **Cluster details (Detalles del clúster)**. En la parte inferior de esa sección, busque el nombre del grupo de parámetros debajo del **grupo de parámetros de clúster**. ![\[Captura de pantalla que muestra un grupo de parámetros de un clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png) ------ #### [ Using the AWS CLI ] El siguiente AWS CLI código determina qué grupo de parámetros rige el clúster. `sample-cluster` ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "sample-cluster", "sample-parameter-group" ] ] ``` ------ ## Determinar los clústeres e instancias asociados a un grupo de parámetros de clúster de Amazon DocumentDB Para determinar cuántos clústeres e instancias están asociados a cada grupo de parámetros, complete los siguientes pasos mediante el AWS CLI. ------ #### [ Using the AWS CLI ] El siguiente AWS CLI código determina a cuántos clústeres e instancias están asociados`sample-parameter-group`. Para Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \ --output json | \ jq -r 'group_by(.[0]) | map({ parameter_group_name: .[0][0], total_clusters: length, total_instances: map(.[2] | length) | add // 0 }) | .[]' ``` Para Windows: ``` aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^ --output json | ^ jq -r 'group_by(.[0]) | map({ parameter_group_name: .[0][0], total_clusters: length, total_instances: map(.[2] | length) | add // 0 }) | .[]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "parameter_group_name": "sample-parameter-group", "total_clusters": 50, "total_instances": 150 } ``` ------ # Creación de grupos de parámetros de clúster de Amazon DocumentDB Los grupos de parámetros de clúster predeterminados como `default.docdb5.0`, `default.docdb4.0` o `default.docdb3.6`, se crean al crear un clúster con una nueva versión del motor y en una nueva región. Los clústeres siguientes que se creen en esta región y tengan la misma versión de motor heredan el grupo de parámetros de clúster `default`. Una vez creados, los grupos de parámetros `default` no se pueden eliminar ni cambiar de nombre. Puede modificar el comportamiento del motor de las instancias de clúster creando un grupo de parámetros personalizado con los valores de parámetros preferidos y adjuntándolo a su clúster de Amazon DocumentDB. El siguiente procedimiento le guía a través de la creación de un grupo de parámetros de clúster personalizado. A continuación, puede [modificar los parámetros dentro de ese grupo de parámetros](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html). **nota** Después de crear un grupo de parámetros de clúster, debe esperar al menos 5 minutos antes de usar ese grupo de parámetros en concreto. Esto permite a `create` finalizar por completo la acción Amazon DocumentDB antes de que el grupo de parámetros de clúster se use para un nuevo clúster. Puede utilizar la `describe-db-cluster-parameter-groups` AWS CLI operación Consola de administración de AWS o para comprobar que se ha creado el grupo de parámetros del clúster. Para obtener más información, consulte [Descripción de los grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-describe.md). ------ #### [ Using the Consola de administración de AWS ] **Creación de un grupo de parámetros de clúster** 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 **Grupos de parámetros**. **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. 1. En el panel **Cluster parameter groups (Grupos de parámetros del clúster)**, elija **Create (Crear)**. 1. En el panel **Create cluster parameter group (Crear grupo de parámetros de clúster)** escriba lo siguiente: 1. **Nombre del nuevo grupo de parámetros de clúster**: escriba un nombre para el grupo de parámetros de clúster. Por ejemplo, `sample-parameter-group`. Los grupos de parámetros de clúster tienen las siguientes restricciones de denominación: + La longitud es de [1-255] caracteres alfanuméricos. + El primer carácter debe ser una letra. + No puede terminar con un guion ni contener dos guiones consecutivos. 1. **Familia**: elija la versión de DocumentDB que desee usar para su clúster. 1. **Descripción**: proporcione una descripción para este grupo de parámetros de clúster. 1. Para crear el grupo de parámetros de clúster, elija **Create (Crear)**. Para cancelar la operación, elija **Cancel (Cancelar)**. 1. Después de seleccionar **Create (Crear)**, aparece el siguiente texto en la parte superior de la página para comprobar que el grupo de parámetros de clúster se ha creado correctamente: ``` Successfully created cluster parameter group 'sample-parameter-group'. ``` ------ #### [ Using the AWS CLI ] Para crear un nuevo grupo de parámetros de clúster para los clústeres de Amazon DocumentDB 4.0, utilice la AWS CLI `create-db-cluster-parameter-group` operación con los siguientes parámetros: + **--db-cluster-parameter-group-name**: el nombre del grupo de parámetros de clúster de base de datos. Por ejemplo, `sample-parameter-group`. + **--db-cluster-parameter-group-family**: la familia de grupos de parámetros de clúster que se utiliza como plantilla para el grupo de parámetros de clúster personalizado. + **--description**: la descripción proporcionada por el usuario para este grupo de parámetros de clúster. El siguiente ejemplo utiliza “`Custom docdb4.0 parameter group`”. Para Linux, macOS o Unix: **Example** ``` aws docdb create-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --db-parameter-group-family docdb5.0 \ --description "Custom docdb5.0 parameter group" ``` Para Windows: ``` aws docdb create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --db-parameter-group-family docdb5.0 ^ --description "Custom docdb5.0 parameter group" ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupName": "sample-parameter-group", "DBParameterGroupFamily": "docdb5.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupArn": "sample-parameter-group-arn" } } ``` ------ # Modificación de grupos de parámetros de clúster de Amazon DocumentDB En esta sección se explica cómo modificar un grupo de parámetros *personalizados* de Amazon DocumentDB. En Amazon DocumentDB, no puede modificar un grupo de parámetros de clúster `default` que se crea al crear por primera vez un clúster con una nueva versión del motor en una nueva región. Si el clúster de Amazon DocumentDB utiliza el grupo de parámetros de clúster predeterminado y desea modificar un valor en él, primero debe [crear un nuevo grupo de parámetros](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) o [copiar un grupo de parámetros existente](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), modificarlo y, a continuación, aplicar el grupo de parámetros modificado a su clúster. Siga los pasos siguientes para modificar un grupo de parámetros de clúster. Las acciones de modificación pueden tardar un tiempo en propagarse. Espere a que el grupo de parámetros de clúster modificado esté disponible antes de adjuntarlo al clúster. Puede utilizar la AWS CLI `describe-db-cluster-parameters` operación Consola de administración de AWS o para comprobar que el grupo de parámetros del clúster se ha modificado. Para obtener más información, consulte [Descripción de los grupos de parámetros de clúster](cluster_parameter_groups-describe.md). ------ #### [ Using the Consola de administración de AWS ] Siga estos pasos para modificar un grupo de parámetros personalizado de Amazon DocumentDB. No puede modificar un grupo de parámetros `default`. Si desea modificar un valor del grupo de parámetros `default`, puede [copiar el grupo de parámetros del clúster por defecto](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), modificarlo y, a continuación, aplicar el grupo de parámetros modificado al clúster. Para obtener más información sobre la aplicación de grupos de parámetros al clúster, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md). **Modificación de un grupo de parámetros de clúster personalizado** 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 del lado izquierdo de la consola, elija **Parameter groups (Grupos de parámetros)**. En la lista de grupos de parámetros, seleccione el nombre del grupo de parámetros que desee modificar. **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. 1. Para cada parámetro del grupo de parámetros que desee modificar, haga lo siguiente: 1. Localice el parámetro que desea modificar y compruebe que es modificable comprobando si aparece en la `true` columna **Modifiable (Modificable)** . 1. Si es modificable, seleccione el parámetro y elija **Edit (Editar)** en la parte superior derecha de la página de la consola. 1. En el cuadro de diálogo **Modify (Modificar) ``**, realice los cambios que desee. A continuación, elija **Modify cluster parameter (Modificar el parámetro de clúster)**, o elija **Cancel (Cancelar)** para descartar los cambios. ------ #### [ Using the AWS CLI ] Puede modificar los valores de `ParameterValue`, `Description` o `ApplyMethod` de cualquier parámetro modificable de un grupo de parámetros de clúster personalizado de Amazon DocumentDB mediante la AWS CLI. No se pueden realizar modificaciones directamente en un grupo de parámetros de clúster por defecto. Para modificar los parámetros de un grupo de parámetros de clúster personalizado, utilice la operación `modify-db-cluster-parameter-group` con los siguientes parámetros. + **--db-cluster-parameter-group-name**: obligatorio. El nombre del grupo de parámetros de clúster que va a modificar. + **--parameters**: obligatorio. Los parámetros que está modificando. Para obtener una lista de los parámetros que se aplican a todas las instancias de un clúster de Amazon DocumentDB, consulte [Referencia de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md). Cada entrada de parámetro debe incluir lo siguiente: + **ParameterName**: el nombre del grupo de parámetros de clúster que va a modificar. + **ParameterValue**: el valor nuevo de este parámetro de clúster. + **ApplyMethod**: cómo desea que se apliquen los cambios a este parámetro. Los valores permitidos son `immediate` y `pending-reboot`. **nota** Los parámetros con el `ApplyType` de `static` deben tener un `ApplyMethod` de `pending-reboot`. **Example - Modificación del valor de un parámetro** En este ejemplo, se muestran los valores de parámetro de `sample-parameter-group` y se modifica el parámetro `tls`. A continuación, después de 5 minutos, también se muestran los valores de parámetro de `sample-parameter-group` para ver los valores de parámetro que han cambiado. 1. Muestre los parámetros de `sample-parameter-group` y sus valores. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Para Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] } ``` 1. Modifique el parámetro `tls` para que su valor sea `disabled`. No se puede modificar `ApplyMethod` ya que `ApplyType` es `static`. Para Linux, macOS o Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot ``` Para Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. Espere al menos 5 minutos. 1. Enumere los valores de parámetro de `sample-parameter-group` para verificar que se modificó el parámetro de `tls`. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Para Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "Parameters": [ { "ParameterValue": "false", "ParameterName": "enable_audit_logs", "ApplyType": "dynamic", "DataType": "string", "Description": "Enables auditing on cluster.", "AllowedValues": "true,false", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterValue": "disabled", "ParameterName": "tls", "ApplyType": "static", "DataType": "string", "Description": "Config to enable/disable TLS", "AllowedValues": "disabled,enabled", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ # Modificación de clústeres de Amazon DocumentDB para utilizar grupos de parámetros de clúster personalizados Al crear un clúster de Amazon DocumentDB, se crea automáticamente un grupo de parámetros `default.docdb4.0` para ese clúster. No se puede modificar el grupo de parámetros del clúster `default`. En su lugar, puede modificar el clúster de Amazon DocumentDB para asociar un nuevo grupo de parámetros personalizados con él. En esta sección se explica cómo modificar un clúster de Amazon DocumentDB existente para que utilice un grupo de parámetros de clúster personalizado con Consola de administración de AWS y AWS Command Line Interface ()AWS CLI. ------ #### [ Using the Consola de administración de AWS ] **Modificación de un clúster de Amazon DocumentDB para utilizar un nuevo grupo de parámetros de clúster no predeterminado** 1. Antes de comenzar, asegúrese de haber creado un clúster de Amazon DocumentDB y un grupo de parámetros de clúster. Consulte [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md) y [Creación de grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-create.md) para obtener más instrucciones. 1. Después de crear el grupo de parámetros de clúster, abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). En el panel de navegación, elija **Clusters (Clústeres)** para añadir el nuevo grupo de parámetros a un clúster. 1. Elija el clúster al que desea asociar el grupo de parámetros. Elija **Actions (Acciones)**, y, a continuación, elija **Modify (Modificar)** para modificar el clúster. 1. En **Cluster options (Opciones de clúster)**, elija el nuevo grupo de parámetros al que desea asociar el clúster. 1. Elija **Continue (Continuar)** para ver un resumen de las modificaciones. 1. Después de verificar los cambios, puede aplicarlos inmediatamente o durante el siguiente período de mantenimiento en **Scheduling of modifications (Programación de modificaciones)**. 1. Elija **Modify cluster (Modificar clúster)** para actualizar el clúster con el nuevo grupo de parámetros. ------ #### [ Using the AWS CLI ] Antes de comenzar, asegúrese de haber creado un clúster de Amazon DocumentDB y un grupo de parámetros de clúster. Puede [crear un clúster de Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html) mediante la AWS CLI `create-db-cluster` operación. Puede [crear un grupo de parámetros de clúster](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) mediante la AWS CLI `create-db-cluster-parameter-group` operación. Para añadir el nuevo grupo de parámetros del clúster al clúster, utilice la AWS CLI `modify-db-cluster` operación con los siguientes parámetros. + **-- db-cluster-identifier** — El nombre del clúster (por ejemplo,`sample-cluster`). + **-- db-cluster-parameter-group -name**: el nombre del grupo de parámetros al que desea asociar el clúster (por ejemplo,`sample-parameter-group`). **Example** ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` "DBCluster": { "AvailabilityZones": [ "us-west-2c", "us-west-2b", "us-west-2a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", ... } ``` ------ # Copia de grupos de parámetros de clúster de Amazon DocumentDB Puede hacer una copia de un grupo de parámetros de clúster en Amazon DocumentDB con Consola de administración de AWS o AWS Command Line Interface ()AWS CLI. ------ #### [ Using the Consola de administración de AWS ] El siguiente procedimiento le guía a través de la creación de un nuevo grupo de parámetros de clúster mediante una copia de un grupo de parámetros de clúster existente. **Copiar de un grupo de parámetros de clúster** 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 **Grupos de parámetros**. 1. En el panel **Cluster parameter groups (Grupos de parámetros del clúster)**, seleccione el nombre del grupo de parámetros de clúster que quiera copiar. 1. Elija **Actions (Acciones)**, y, a continuación, elija **Copy (Copiar)** para copiar ese grupo de parámetros. 1. En **Copy options (Opciones de copia)**, introduzca un nombre y una descripción para el nuevo grupo de parámetros de clúster. A continuación, elija **Copy (Copiar)** para guardar los cambios. ------ #### [ Using the AWS CLI ] Para realizar una copia de un grupo de parámetros de clúster, utilice la operación `copy-db-cluster-parameter-group` con los siguientes parámetros. + **--source-db-cluster-parameter-group-identifier**: obligatorio. El nombre o nombre de recurso de Amazon (ARN) del grupo de parámetros de clúster del que desea realizar una copia. Si los grupos de parámetros del clúster de origen y destino están en el mismo lugar Región de AWS, el identificador puede ser un nombre o un ARN. Si los grupos de parámetros del clúster de origen y destino son diferentes Regiones de AWS, el identificador debe ser un ARN. + **--target-db-cluster-parameter-group-identifier**: obligatorio. El nombre o ARN del grupo de parámetros de clúster que se va a copiar. Restricciones: + No puede ser nulo ni estar vacío o en blanco. + Debe contener de 1 a 255 letras, números o guiones. + El primer carácter debe ser una letra. + No puede terminar con un guion ni contener dos guiones consecutivos. + **--target-db-cluster-parameter-group-description**: obligatorio. Una descripción del usuario de la copia del grupo de parámetros de clúster. **Example** El siguiente código realiza una copia de `sample-parameter-group` y le asigna el nombre `sample-parameter-group-copy`. Para Linux, macOS o Unix: ``` aws docdb copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier sample-parameter-group \ --target-db-cluster-parameter-group-identifier sample-parameter-group-copy \ --target-db-cluster-parameter-group-description "Copy of sample-parameter-group" ``` Para Windows: ``` aws docdb copy-db-cluster-parameter-group ^ --source-db-cluster-parameter-group-identifier sample-parameter-group ^ --target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^ --target-db-cluster-parameter-group-description "Copy of sample-parameter-group" ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy", "DBClusterParameterGroupName": "sample-parameter-group-copy", "DBParameterGroupFamily": "docdb4.0", "Description": "Copy of sample-parameter-group" } } ``` ------ # Restablecimiento de grupos de parámetros de clúster de Amazon DocumentDB Puede restablecer algunos o todos los valores de parámetros de un grupo de parámetros de clúster de Amazon DocumentDB a sus valores predeterminados utilizando Consola de administración de AWS o AWS Command Line Interface (AWS CLI) para restablecer el grupo de parámetros del clúster. ------ #### [ Using the Consola de administración de AWS ] Siga estos pasos para restablecer algunos o todos los valores de parámetros de un grupo de parámetros de clúster a sus valores predeterminados. **Restablecimiento de los valores de parámetros de un grupo de parámetros de clúster** 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 del lado izquierdo de la consola, elija **Parameter groups (Grupos de parámetros)**. 1. En el panel **Cluster parameter groups (Grupos de parámetros del clúster)**, seleccione el nombre del grupo de parámetros de clúster que quiera reiniciar. 1. Elija **Actions (Acciones)**, y, a continuación, elija **Reset (Reiniciar)** para restablecer ese grupo de parámetros. 1. En la página de **confirmación de restablecimiento del grupo de parámetros del clúster** resultante, confirme que desea restablecer todos los parámetros del clúster de ese grupo de parámetros a sus valores predeterminados. A continuación, seleccione **Reset (Restablecer)** para restablecer el grupo de parámetros. También puede seleccionar **Cancel (Cancelar)** para descartar los cambios. ------ #### [ Using the AWS CLI ] Para restablecer algunos o todos los valores de parámetros de un grupo de parámetros de clúster a sus valores predeterminados, use la operación `reset-db-cluster-parameter-group` con los siguientes parámetros. + **--db-cluster-parameter-group-name**: obligatorio. El nombre del grupo de parámetros de clúster que se va a restablecer. + **--parameters**: opcional. Una lista de `ParameterName` y `ApplyMethod` del grupo de parámetros de clúster que se va a restablecer a sus valores predeterminados. Los parámetros estáticos se deben establecer en `pending-reboot` para que se apliquen la próxima vez que se reinicie la instancia o en la siguiente solicitud `reboot-db-instance`. Debe llamar a `reboot-db-instance` para cada instancia del clúster a la que desee aplicar el parámetro estático actualizado. Este parámetro y `--reset-all-parameters` se excluyen mutuamente: puede utilizar uno pero no ambos. + **--reset-all-parameters** o **--no-reset-all-parameters**: opcional. Especifica si se deben restablecer todos los parámetros (`--reset-all-parameters`) o solo algunos de los parámetros (`--no-reset-all-parameters`) a sus valores predeterminados. El parámetro `--reset-all-parameters` y `--parameters` se excluyen mutuamente: puede utilizar uno pero no ambos. Cuando restablece todo el grupo, los parámetros dinámicos se actualizan inmediatamente. Los parámetros estáticos se establecen en `pending-reboot` para que se apliquen la próxima vez que se reinicie la instancia o en la siguiente solicitud `reboot-db-instance`. Debe llamar a `reboot-db-instance` para cada instancia del clúster a la que desee aplicar el parámetro estático actualizado. **Example** **Ejemplo 1: restablecimiento de todos los parámetros a sus valores predeterminados** El siguiente código restablece todos los parámetros del grupo de parámetros de clúster `sample-parameter-group` a sus valores predeterminados. Para Linux, macOS o Unix: ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --reset-all-parameters ``` Para Windows: ``` aws docdb reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --reset-all-parameters ``` **Ejemplo 2: restablecimiento de los parámetros especificados a sus valores predeterminados** El siguiente código restablece el parámetro `tls` del grupo de parámetros de clúster `sample-parameter-group` a su valor predeterminado. Para Linux, macOS o Unix: ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --no-reset-all-parameters \ --parameters ParameterName=tls,ApplyMethod=pending-reboot ``` Para Windows: ``` aws docdb reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --no-reset-all-parameters ^ --parameters ParameterName=tls,ApplyMethod=pending-reboot ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` **Reinicio de una instancia del clúster** Antes de que el valor de un parámetro estático cambie, la instancia del clúster debe reiniciarse. Reinicie cada instancia del clúster a la que desee aplicar el parámetro estático actualizado. Para Linux, macOS o Unix: ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-cluster-instance ``` Para Windows: ``` aws docdb reboot-db-instance ^ --db-instance-identifier sample-cluster-instance ``` ------ # Borrado de grupos de parámetros de clúster de Amazon DocumentDB Puede eliminar un grupo de parámetros de clúster de Amazon DocumentDB personalizado mediante Consola de administración de AWS o AWS Command Line Interface ()AWS CLI. No se puede eliminar el grupo de parámetros del clúster `default.docdb4.0`. ------ #### [ Using the Consola de administración de AWS ] **Eliminación de un grupo de parámetros de clúster** 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 **Grupos de parámetros**. **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. 1. En el panel **Parameter groups (Grupos de parámetros)**, seleccione el botón de opción situado a la izquierda del grupo de parámetros de clúster que desea eliminar. 1. Elija **Acciones** y, a continuación, elija **Eliminar**. 1. En el panel de confirmación **Delete (Eliminar)** elija **Delete (Eliminar)** para eliminar el grupo de parámetros del clúster. Para mantener el grupo de parámetros del clúster, elija **Cancel (Cancelar)**. ------ #### [ Using the AWS CLI ] Para eliminar un grupo de parámetros de clúster, utilice la operación `delete-db-cluster-parameter-group` con el siguiente parámetro. + **--db-cluster-parameter-group-name**: obligatorio. El nombre del grupo de parámetros de clúster que se va a eliminar. Debe ser un grupo de parámetros de clúster existente. *No se puede eliminar el grupo de parámetros del clúster `default.docdb4.0`. * **Example - Eliminación de un grupo de parámetros de clúster** En el siguiente ejemplo, se presentan los tres pasos para eliminar un grupo de parámetros de clúster: 1. Buscar el nombre del grupo de parámetros de clúster que desea eliminar. 1. Eliminar el grupo de parámetros de clúster especificado. 1. Verificar que el grupo de parámetros de clúster se ha eliminado. **1. Busque el nombre del grupo de parámetros de clúster que desea eliminar.** El siguiente código muestra los nombres de todos los grupos de parámetros de clúster. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Para Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` El resultado de la operación anterior es una lista de los nombres de grupos de parámetros de clúster similar a la siguiente (formato JSON). ``` [ [ "default.docdb4.0" ], [ "sample-parameter-group" ], [ "sample-parameter-group-copy" ] ] ``` **2. Elimine un grupo de parámetros de clúster.** El siguiente código elimina el grupo de parámetros de clúster `sample-parameter-group-copy`. Para Linux, macOS o Unix: ``` aws docdb delete-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group-copy ``` Para Windows: ``` aws docdb delete-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group-copy ``` Esta operación no muestra ningún resultado. **3. Verifique que el grupo de parámetros de clúster especificado se ha eliminado.** El siguiente código muestra los nombres de todos los grupos de parámetros de clúster restantes. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Para Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` El resultado de la operación anterior es una lista de los grupos de parámetros de clúster similar a la siguiente (formato JSON). El grupo de parámetros de clúster que acaba de eliminar no debe estar en la lista. La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "default.docdb4.0" ], [ "sample-parameter-group" ] ] ``` ------ # Referencia de parámetros de clúster de Amazon DocumentDB Cuando se modifica un parámetro dinámico y se guarda el grupo de parámetros de clúster, el cambio se aplica inmediatamente, sea cual sea el estado de *Apply Immediately (Aplicar inmediatamente)*. Cuando se cambia un parámetro estático y se guarda el grupo de parámetros de clúster, el cambio de parámetros tiene efecto después de reiniciar manualmente la instancia. Puede reiniciar una instancia mediante la consola de Amazon DocumentDB o llamar de forma explícita a `reboot-db-instance`. En la tabla siguiente, se muestran todos los parámetros que se aplican a todas las instancias de un clúster de Amazon DocumentDB. **Parámetros a nivel de clúster de Amazon DocumentDB** | Parámetro | Predeterminado | Valores válidos | Modificable | Tipo de aplicación | Tipo de datos | Description (Descripción) | | --- | --- | --- | --- | --- | --- | --- | | audit\$1logs | disabled | activado, desactivado, ddl, dml\$1read, dml\$1write, todos, ninguno | Sí | Dinámico | Cadena | Define si los registros CloudWatch de auditoría de Amazon están habilitados. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Sí | Dinámico | Entero | Define la duración (en segundos) que se conserva y se puede consumir el registro del flujo de cambios. | | default\$1collection\$1compression | disabled | activado, desactivado (Amazon DocumentDB 5.0)/zstd, lz4, ninguno (Amazon Document .0) DB8 | Sí | Dinámico | Cadena | Define la configuración de compresión predeterminada para las nuevas colecciones de un clúster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | profiler | disabled | habilitado, deshabilitado | Sí | Dinámico | Cadena | Habilita la creación de perfiles para operaciones lentas. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | profiler\$1sampling\$1rate | 1.0 | 0,0-1,0 | Sí | Dinámico | Flotante | Define la velocidad de muestreo para las operaciones registradas. | | profiler\$1threshold\$1ms | 100 | 50-2147483646 | Sí | Dinámico | Entero | Define el umbral de profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | planner\$1version | 3.0 | 1,0, 2,0, 3,0 | Sí | Dinámico | Flotante | Define la versión del planificador de consultas que se utilizará en las consultas.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | tls | enabled | habilitado, deshabilitado, fips-140-3, tls1.2\$1, tls1.3\$1 | Sí | Estático | Cadena | Define si son obligatorias las conexiones de seguridad de la capa de transporte (TLS). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | ttl\$1monitor | enabled | habilitado, deshabilitado | Sí | Dinámico | Cadena | Define si la monitorización de tiempo de vida (TTL) está habilitada para el clúster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | # Modificación de parámetros de clúster de Amazon DocumentDB En Amazon DocumentDB, *los grupos de parámetros de clúster* constan de *parámetros* que se aplican a todas las instancias que cree en el clúster. En los grupos de parámetros de clúster personalizados, puede modificar un valor de parámetro en cualquier momento o restablecer todos los valores de parámetro a sus valores predeterminados para los grupos de parámetros que cree. En esta sección se describe cómo ver los parámetros que conforman un grupo de parámetros de clúster de Amazon DocumentDB y sus valores, y cómo cambiar o actualizar estos valores. Los parámetros pueden ser *dinámicos* o *estáticos*. Cuando se modifica un parámetro dinámico y se guarda el grupo de parámetros de clúster, el cambio se aplica inmediatamente, sea cual sea el estado de `Apply Immediately`. Cuando se cambia un parámetro estático y se guarda el grupo de parámetros de clúster, el cambio de parámetros solo tiene efecto después de reiniciar manualmente la instancia. ## Visualización de los parámetros de un grupo de parámetros de clúster de Amazon DocumentDB Para ver los parámetros y valores de un clúster de Amazon DocumentDB, utilice o. Consola de administración de AWS AWS CLI ------ #### [ Using the Consola de administración de AWS ] **Visualización de los detalles de un grupo de parámetros de clúster** 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 **Grupos de parámetros**. **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. 1. En el panel **Parameter groups (Grupos de parámetros)**, seleccione el nombre del grupo de parámetros de clúster cuyos detalles desee ver. 1. La página resultante muestra los siguientes valores para cada parámetro: el nombre del parámetro, el valor actual, los valores permitidos, si el parámetro es modificable, el tipo de aplicación, el tipo de datos y la descripción. ![\[Captura de pantalla: Nombres y valores de parámetros.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png) ------ #### [ Using the AWS CLI ] Para ver los parámetros de un grupo de parámetros de un clúster y sus valores, utilice la operación `describe-db-cluster-parameters` con los siguientes parámetros. + **--db-cluster-parameter-group-name**: obligatorio. El nombre del grupo de parámetros de clúster para el que desea obtener una lista detallada de parámetros. + **--source**: opcional. Si se especifica, devuelve solo los parámetros de un origen específico. Los orígenes de parámetros pueden ser `engine-default`, `system` o `user`. **Example** El siguiente código de ejemplo muestra los parámetros, junto con sus valores, del grupo de parámetros `custom3-6-param-grp`. Para obtener más información sobre el grupo de parámetros, omita la línea `--query`. Para obtener más información sobre todos los grupos de parámetros, omita la línea `--db-cluster-parameter-group-name`. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name custom3-6-param-grp \ --query 'Parameters[*].[ParameterName,ParameterValue]' ``` Para Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name custom3-6-param-grp ^ --query 'Parameters[*].[ParameterName,ParameterValue]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "audit_logs", "disabled" ], [ "tls", "enabled" ], [ "ttl_monitor", "enabled" ] ] ``` ------ ## Modificación de los parámetros de un grupo de parámetros de clúster de Amazon DocumentDB Puede modificar los parámetros de un grupo de parámetros con las teclas o. Consola de administración de AWS AWS CLI ------ #### [ Using the Consola de administración de AWS ] **Actualización de los parámetros de un grupo de parámetros de clúster** 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 **Grupos de parámetros**. **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. 1. En el panel **Parameter groups (Grupos de parámetros)**, elija el grupo de parámetros del clúster cuyos parámetros desea actualizar. 1. La página resultante muestra los parámetros y sus detalles correspondientes para este grupo de parámetros de clúster. Seleccione un parámetro para actualizar. 1. En la parte superior derecha de la página, elija **Edit (Editar)** para cambiar el valor del parámetro. Para obtener más información sobre los tipos de parámetros de clúster, consulte [Referencia de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md). 1. Realice el cambio y, a continuación, elija **Modify cluster parameter (Modificar parámetro de clúster)** para guardar los cambios. Para descartar los cambios, selecciona **Cancel (Cancelar)**. ------ #### [ Using the AWS CLI ] Para modificar los parámetros de un grupo de parámetros de clúster, utilice la operación `modify-db-cluster-parameter-group` con los siguientes parámetros. + **--db-cluster-parameter-group-name**: obligatorio. El nombre del grupo de parámetros de clúster que va a modificar. + **--parameters**: obligatorio. El parámetro o los parámetros que va a modificar. Cada entrada de parámetro debe incluir lo siguiente: + **ParameterName**: el nombre del grupo de parámetros de clúster que va a modificar. + **ParameterValue**: el valor nuevo de este parámetro de clúster. + **ApplyMethod**: cómo desea que se apliquen los cambios a este parámetro. Los valores permitidos son `immediate` y `pending-reboot`. **nota** Los parámetros con el `ApplyType` de `static` deben tener un `ApplyMethod` de `pending-reboot`. **Para cambiar los valores de los parámetros de un grupo de parámetros de clúster (AWS CLI)** En el siguiente ejemplo se cambia el nombre del parámetro `tls`. 1. **Muestre los parámetros y sus valores de `sample-parameter-group`** Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Para Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] } ``` 1. **Modifique el parámetro `tls` para que su valor sea `disabled`**. No se puede modificar `ApplyMethod` ya que `ApplyType` es `static`. Para Linux, macOS o Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot" ``` Para Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot" ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. **Espere al menos 5 minutos.** 1. **Muestre los valores de parámetro de `sample-parameter-group`.** Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Para Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "tls", "ParameterValue": "disabled", "Description": "Config to enable/disable TLS", "Source": "user", "ApplyType": "static", "DataType": "string", "AllowedValues": "disabled,enabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ # Descripción de los puntos de conexión de Amazon DocumentDB Puede usar los puntos de conexión de Amazon DocumentDB (con compatibilidad con MongoDB) para conectarse a un clúster o a una instancia. Amazon DocumentDB tiene tres tipos diferentes de puntos de conexión, cada uno con su propia finalidad. **Topics** + [Búsqueda de puntos de conexión de un clúster](db-cluster-endpoints-find.md) + [Búsqueda del punto de conexión de una instancia](db-instance-endpoint-find.md) + [Conexión a puntos de conexión](endpoints-connecting.md) **Punto de conexión de clúster** Un punto de conexión de clúster es un punto de conexión de un clúster de Amazon DocumentDB que se conecta a la instancia principal actual del clúster. Cada clúster de Amazon DocumentDB tiene un solo punto de conexión de clúster y una sola instancia principal. En caso de que se produzca una conmutación por error, el punto de conexión del clúster se reasigna a la nueva instancia principal. **Punto de conexión del lector** Un punto de conexión del lector es un punto de conexión de un clúster de Amazon DocumentDB que se conecta a una de las réplicas disponibles de ese clúster. Cada clúster de base de datos de Amazon DocumentDB tiene un punto de conexión del lector. Si hay más de una réplica, el punto de conexión del lector dirige cada solicitud de conexión a una de las réplicas de Amazon DocumentDB. **Punto de conexión de instancia** Un punto de conexión de una instancia es aquel que se conecta a una instancia específica. Cada instancia de un clúster, independientemente de si es una instancia principal o de réplica, tiene su propio punto de conexión de instancia único. Es mejor no usar puntos de conexión de instancias en las aplicaciones. Esto se debe a que pueden cambiar los roles en caso de una conmutación por error, lo que obligaría a realizar modificaciones en el código de la aplicación. # Búsqueda de puntos de conexión de un clúster Puede buscar el punto de conexión de clúster de un clúster y el punto de conexión del lector mediante la consola de Amazon DocumentDB o la AWS CLI. ------ #### [ Using the Consola de administración de AWS ] **Cómo encontrar los puntos de conexión de un clúster mediante la consola:** 1. Inicie sesión en la Consola de administración de AWS y abra la 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 lista de clústeres, seleccione el nombre del clúster de su interés. 1. En la página de detalles del clúster, elija la pestaña **Configuración**. En la sección **Configuraciones y estado**, encontrará el **Punto de conexión del clúster** y el **Punto de conexión del lector**. ![\[La sección Configuraciones y estado muestra los puntos de conexión del clúster y del lector.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-endpoints.png) 1. Para conectarse a este clúster, seleccione la pestaña **Conectividad y seguridad**. Localice la cadena de conexión del shell de `mongo` y una cadena de conexión que pueda utilizar en el código de la aplicación para conectarse a su clúster. ![\[La sección Conectar muestra una cadena para conectarse a la instancia con el shell de mongo y una cadena para conectarse al clúster con una aplicación.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cluster-connection-strings.png) ------ #### [ Using the AWS CLI ] Para buscar los puntos de conexión del clúster y del lector para su clúster con la AWS CLI, ejecute el comando `describe-db-clusters` con estos parámetros. **Parámetros** + **--db-cluster-identifier**: opcional. Especifica el clúster para el que se van a devolver puntos de conexión. Si se omite, devuelve los puntos de conexión de hasta 100 clústeres. + **--query**: opcional. Especifica los campos para mostrar. Sirve para reducir la cantidad de datos que se necesitan consultar para encontrar los puntos de conexión. Si se omite, se devuelve toda la información de un clúster. + **--region**: opcional. Utilice el parámetro `--region` para especificar la región a la que desea aplicar el comando. Si se omite, se utiliza la región predeterminada. **Example** En el siguiente ejemplo, se devuelve el punto de conexión `DBClusterIdentifier` (punto de conexión del clúster) y `ReaderEndpoint` para `sample-cluster`. Para Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --region us-east-1 \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]' ``` Para Windows: ``` aws docdb describe-db-clusters ^ --region us-east-1 ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "sample-cluster", 27017, "sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com", "sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com" ] ] ``` Ahora que tiene el punto de conexión del clúster, puede conectarse al clúster mediante `mongo` o `mongodb`. Para obtener más información, consulte [Conexión a puntos de conexión](endpoints-connecting.md). ------ # Búsqueda del punto de conexión de una instancia Puede encontrar los puntos de conexión para una instancia de base de datos mediante la consola de Amazon DocumentDB o la AWS CLI. ------ #### [ Using the Consola de administración de AWS ] **Búsqueda del punto de conexión de una instancia mediante la consola** 1. Inicie sesión en la Consola de administración de AWS y abra la 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)**. **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. 1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla. ![\[Tabla de clústeres que muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png) 1. Marque la casilla de verificación situada a la izquierda de la instancia de su interés. 1. Desplácese hacia abajo hasta la sección **Details (Detalles)** y localice el punto de conexión de la instancia. ![\[Captura de pantalla de la consola que muestra la página de detalles con el punto de conexión de la instancia resaltado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-instance-endpoint.png) 1. Para conectarse a esta instancia, desplácese hacia abajo hasta la sección **Connect (Conexión)**. Localice la cadena de conexión del shell de `mongo` y una cadena de conexión que pueda utilizar en el código de su aplicación para conectarse a su instancia. ![\[Captura de pantalla de la consola que muestra la sección Conexión del shell de mongo y cadenas de conexión de la aplicación resaltadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/instance-connection-strings.png) ------ #### [ Using the AWS CLI ] Para buscar el punto de conexión de la instancia mediante la AWS CLI, ejecute el siguiente comando con estos argumentos. **Argumentos** + **--db-instance-identifier**: opcional. Especifica la instancia para la que se va a devolver el punto de conexión. Si se omite, se devuelve el punto de conexión de hasta 100 instancias. + **--query**: opcional. Especifica los campos para mostrar. Sirve para reducir la cantidad de datos que se necesitan consultar para encontrar los puntos de conexión. Si se omite, se devuelve toda la información de la instancia. El campo `Endpoint` tiene tres miembros, por lo que la consulta del siguiente ejemplo devuelve los tres miembros. Si solo está interesado en algunos de los miembros de `Endpoint` sustituya `Endpoint` en la consulta por los miembros de su interés, tal y como se muestra en el segundo ejemplo. + **--region**: opcional. Utilice el parámetro `--region` para especificar la región a la que desea aplicar el comando. Si se omite, se utiliza la región predeterminada. **Example** Para Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --region us-east-1 \ --db-instance-identifier sample-cluster-instance \ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]' ``` Para Windows: ``` aws docdb describe-db-instances ^ --region us-east-1 ^ --db-instance-identifier sample-cluster-instance ^ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "sample-cluster-instance", { "Port": 27017, "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com", "HostedZoneId": "Z2R2ITUGPM61AM" } ] ] ``` Reduciendo el resultado para eliminar el `HostedZoneId` del punto de conexión, puede modificar su consulta especificando `Endpoint.Port` y `Endpoint.Address`. Para Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --region us-east-1 \ --db-instance-identifier sample-cluster-instance \ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]' ``` Para Windows: ``` aws docdb describe-db-instances ^ --region us-east-1 ^ --db-instance-identifier sample-cluster-instance ^ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ [ "sample-cluster-instance", 27017, "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com" ] ] ``` Ahora que tiene el punto de conexión de la instancia, puede conectarse a la instancia mediante `mongo` o `mongodb`. Para obtener más información, consulte [Conexión a puntos de conexión](endpoints-connecting.md). ------ # Conexión a puntos de conexión Cuando tenga su punto de conexión, ya sea del clúster o de la instancia, puede conectarse a él utilizando el shell de `mongo` o una cadena de conexión. ## Conexión mediante el shell de mongo Utilice la siguiente estructura para crear la cadena que necesita para conectarse a su clúster o instancia mediante el shell de `mongo`: ``` mongo \ --ssl \ --host Endpoint:Port \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` **Ejemplos del shell de `mongo`** Conectarse a un clúster: ``` mongo \ --ssl \ --host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` Conectarse a una instancia: ``` mongo \ --ssl \ --host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` ## Conexión mediante una cadena de conexión Utilice la siguiente estructura para crear la cadena de conexión que necesita para conectarse a su clúster o instancia. ``` mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ``` **Ejemplos de cadenas de conexión** Conectarse a un clúster: ``` mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ``` Conectarse a una instancia: ``` mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ```   # Descripción de los nombres de recursos de Amazon DocumentDB () ARNs Cada uno de los recursos que cree AWS se identifica de forma única con un nombre de recurso de Amazon (ARN). Para determinadas operaciones de Amazon DocumentDB (compatible con MongoDB), debe identificar de forma inequívoca un recurso de Amazon DocumentDB mediante su ARN. Por ejemplo, cuando añade una etiqueta a un recurso, debe proporcionar el ARN del recurso. **Topics** + [Creación de un nombre ARN](#documentdb-arns-constructing) + [Búsqueda de un ARN](#documentdb-arns-find) ## Creación de un ARN para un recurso de Amazon DocumentDB Puede crear un ARN para un recurso de Amazon DocumentDB utilizando la siguiente sintaxis. Amazon DocumentDB comparte el formato de Amazon Relational Database Service (Amazon RDS). ARNs Amazon DocumentDB ARNs contiene `rds` y no. `docdb` `arn:aws:rds:region:account_number:resource_type:resource_id` | Nombre de la región | Region | Zonas de disponibilidad (cálculo) | | --- | --- | --- | | Este de EE. UU. (Ohio) | `us-east-2` | 3 | | Este de EE. UU. (Norte de Virginia) | `us-east-1` | 6 | | Oeste de EE. UU. (Oregón) | `us-west-2` | 4 | | África (Ciudad del Cabo) | `af-south-1` | 3 | | América del Sur (São Paulo) | `sa-east-1` | 3 | | Asia-Pacífico (Hong Kong) | `ap-east-1` | 3 | | Asia-Pacífico (Hyderabad) | `ap-south-2` | 3 | | Asia-Pacífico (Malasia) | `ap-southeast-5` | 3 | | Asia-Pacífico (Mumbai) | `ap-south-1` | 3 | | Asia-Pacífico (Osaka) | `ap-northeast-3` | 3 | | Asia-Pacífico (Seúl) | `ap-northeast-2` | 4 | | Asia-Pacífico (Singapur) | `ap-southeast-1` | 3 | | Asia-Pacífico (Sídney) | `ap-southeast-2` | 3 | | Asia-Pacífico (Yakarta) | `ap-southeast-3` | 3 | | Asia-Pacífico (Melbourne) | `ap-southeast-4` | 3 | | Asia-Pacífico (Tailandia) | `ap-southeast-7` | 3 | | Asia-Pacífico (Tokio) | `ap-northeast-1` | 3 | | Canadá (centro) | `ca-central-1` | 3 | | Región China (Pekín) | `cn-north-1` | 3 | | China (Ningxia) | `cn-northwest-1` | 3 | | Europa (Fráncfort) | `eu-central-1` | 3 | | Europa (Zúrich) | `eu-central-2` | 3 | | Europa (Irlanda) | `eu-west-1` | 3 | | Europa (Londres) | `eu-west-2` | 3 | | Europa (Milán) | `eu-south-1` | 3 | | Europa (París) | `eu-west-3` | 3 | | Europa (España) | `eu-south-2` | 3 | | Europa (Estocolmo) | `eu-north-1` | 3 | | México (centro) | `mx-central-1` | 3 | | Medio Oriente (EAU) | `me-central-1` | 3 | | Israel (Tel Aviv) | `il-central-1` | 3 | | AWS GovCloud (EE. UU.-Oeste) | `us-gov-west-1` | 3 | | AWS GovCloud (Estados Unidos-Este) | `us-gov-east-1` | 3 | **nota** La arquitectura de Amazon DocumentDB separa el almacenamiento y la computación. Para la capa de almacenamiento, Amazon DocumentDB replica seis copias de los datos en tres zonas de AWS disponibilidad (). AZs Las que AZs aparecen en la tabla anterior son las AZs que puede utilizar en una región determinada para aprovisionar instancias informáticas. Por ejemplo, si lanza un clúster de Amazon DocumentDB en ap-northeast-1, su almacenamiento se replicará de seis formas en tres, pero sus instancias de procesamiento solo estarán disponibles en dos. AZs AZs En la siguiente tabla se muestra el formato que debe utilizar al crear un ARN para un tipo de recurso concreto de Amazon DocumentDB. Amazon DocumentDB comparte el formato de Amazon RDS. ARNs Amazon DocumentDB ARNs contiene `rds` y no. `docdb` | Tipo de recurso | Formato de ARN / Ejemplo | | --- | --- | | Instancia (`db`) | `arn:aws:rds:region:account_number:db:resource_id` 
arn:aws:rds:us-east-1:1234567890:db:sample-db-instance
| | Clúster (`cluster`) | `arn:aws:rds:region:account_number:cluster:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster
| | Grupo de parámetros del clúster (`cluster-pg`) | `arn:aws:rds:region:account_number:cluster-pg:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group
| | Grupo de seguridad (`secgrp`) | `arn:aws:rds:region:account_number:secgrp:resource_id` 
arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp
| | Instantánea de clúster (`cluster-snapshot`) | `arn:aws:rds:region:account_number:cluster-snapshot:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot
| | Grupo de subredes (`subgrp`) | `arn:aws:rds:region:account_number:subgrp:resource_id` 
arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10
| ## Búsqueda de un ARN de recurso de Amazon DocumentDB Puede encontrar el ARN de un recurso de Amazon DocumentDB mediante Consola de administración de AWS el o el. AWS CLI ------ #### [ Using the Consola de administración de AWS ] Para buscar un ARN mediante la consola, vaya al recurso cuyo ARN desea obtener y consulte los detalles de ese recurso. Por ejemplo, puede obtener el ARN de un clúster desde la pestaña **Configuración** de los detalles del clúster. El ARN se encuentra en la sección **Configuraciones y estado**, como se muestra en la siguiente captura de pantalla. ![\[Captura de pantalla de la consola que muestra un ARN en la sección de configuraciones y estado del panel de detalles.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/documentdb-arn.png) ------ #### [ Using the AWS CLI ] Para obtener un ARN mediante un recurso concreto de Amazon DocumentDB, utilice `describe` la operación AWS CLI para ese recurso. En la tabla siguiente se muestran cada AWS CLI operación y la propiedad ARN que se utiliza con la operación para obtener un ARN. | AWS CLI Comando | Propiedad ARN | | --- | --- | | `describe-db-instances` | `DBInstanceArn` | | `describe-db-clusters` | `DBClusterArn` | | `describe-db-parameter-groups` | `DBParameterGroupArn` | | `describe-db-cluster-parameter-groups` | `DBClusterParameterGroupArn` | | `describe-db-security-groups` | `DBSecurityGroupArn` | | `describe-db-snapshots` | `DBSnapshotArn` | | `describe-db-cluster-snapshots` | `DBClusterSnapshotArn` | | `describe-db-subnet-groups` | `DBSubnetGroupArn` | **Example - Búsqueda del ARN de un clúster** La siguiente AWS CLI operación busca el ARN del clúster. `sample-cluster` Para Linux, macOS o Unix: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterArn' ``` Para Windows: ``` aws docdb describe-db-clusters ^ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterArn' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster" ] ``` **Example - ARNs Búsqueda de varios grupos de parámetros** Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn' ``` Para Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` [ "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp", "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6", "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.docdb3.6" ] ``` ------ # Etiquetado de recursos de Amazon DocumentDB Puede utilizar etiquetas de Amazon DocumentDB (con compatibilidad con MongoDB) para agregar metadatos a los recursos de Amazon DocumentDB. Estas etiquetas se pueden utilizar junto con políticas de AWS Identity and Access Management (IAM) para administrar el acceso a los recursos de Amazon DocumentDB y para controlar qué acciones se pueden aplicar a los recursos. También puede utilizar etiquetas para hacer un seguimiento de los costos, agrupando los gastos correspondientes en recursos con etiquetas similares. Puede etiquetar los siguientes recursos de Amazon DocumentDB: + Clústeres + instancias + Instantáneas + Instantáneas del clúster + Grupos de parámetros + Grupos de parámetros de clústeres + Grupos de seguridad + Grupos de subredes ## Información general de las etiquetas de recursos de Amazon DocumentDB Las etiquetas de Amazon DocumentDB son pares nombre-valor que el usuario define y asocia a un recurso de Amazon DocumentDB. El nombre es la *clave*. Si lo desea puede proporcionar un valor para la clave o no. También puede usar etiquetas para asignar información arbitraria a un recurso de Amazon DocumentDB. Puede usar claves de etiqueta, por ejemplo, para definir una categoría, y el valor de la etiqueta puede ser un elemento dentro de esa categoría. Por ejemplo, puede definir una clave de etiqueta `project` y un valor de etiqueta de `Salix` para indicar que el recurso de Amazon DocumentDB se asigna al proyecto Salix. Asimismo, puede utilizar etiquetas para designar recursos de Amazon DocumentDB para pruebas o para producción mediante una clave como `environment=test` o `environment=production`. Se recomienda utilizar un conjunto coherente de claves de etiqueta que facilite el seguimiento de los metadatos asociados a los recursos de Amazon DocumentDB. Puede usar etiquetas para organizar la factura de AWS de modo que refleje su propia estructura de costos. Para ello, inscríbase para obtener una factura de Cuenta de AWS que incluya valores de clave de etiquetas. A continuación, para ver los costos de los recursos combinados, organice la información de facturación de acuerdo con los recursos con los mismos valores de clave de etiquetas. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación específico y luego organizar su información de facturación para ver los costos totales de la aplicación en distintos servicios. Para obtener más información, consulte [Uso de etiquetas de asignación de costos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la *AWSGuía del usuario de Administración de facturación y costos*. Cada recurso de Amazon DocumentDB tiene un conjunto de etiquetas que contiene todas las etiquetas asignadas a ese recurso. Un conjunto de etiquetas puede contener hasta 10 etiquetas, y también puede estar vacío. Si agrega una etiqueta a un recurso de Amazon DocumentDB con la misma clave que una etiqueta existente en el recurso, el nuevo valor sobrescribirá al antiguo. AWS no aplica ningún significado semántico a las etiquetas, que se interpretan estrictamente como cadenas de caracteres. Amazon DocumentDB puede definir etiquetas en una instancia u otros recursos de Amazon DocumentDB, según la configuración utilizada al crear el recurso. Por ejemplo, Amazon DocumentDB podría añadir una etiqueta que indique que una instancia es para producción o para la realización de pruebas. Puede añadir una etiqueta a una instantánea, pero la factura no reflejará esta agrupación. Puede utilizar la Consola de administración de AWS o la AWS CLI para añadir, mostrar y eliminar etiquetas de los recursos de Amazon DocumentDB. Si utiliza la AWS CLI, deberá proporcionar el nombre de recurso de Amazon (ARN) correspondiente al recurso con el que desee trabajar. Para obtener más información acerca de los ARN de Amazon DocumentDB, consulte [Descripción de los nombres de recursos de Amazon DocumentDB () ARNs](documentdb-arns.md). ## Restricciones de las etiquetas Se aplican las siguientes restricciones de Amazon DocumentDB a las etiquetas: + Cantidad máxima de etiquetas por recurso: 10 + Longitud máxima de la **clave**: 128 caracteres Unicode + Longitud máxima del **valor**: 256 caracteres Unicode + Caracteres válidos para la **clave** y **valor**: letras mayúsculas y minúsculas del juego de caracteres UTF-8, números, espacios y los siguientes caracteres: `_ . : / = + -` y `@` (expresión regular de Java: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`) + Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. + El prefijo `aws:` no se puede usar para las claves o valores de una etiqueta; está reservado para AWS. ## Agregación y actualización de etiquetas en un recurso de Amazon DocumentDB Puede agregar hasta 10 etiquetas a un recurso mediante la Consola de administración de AWS o la AWS CLI. ------ #### [ Using the Consola de administración de AWS ] El proceso para añadir una etiqueta a un recurso es similar independientemente de a qué recurso añada la etiqueta. En este ejemplo, se añade una etiqueta a un clúster. **Para añadir o actualizar etiquetas a un clúster utilizando la consola** 1. Inicie sesión en la Consola de administración de AWS y abra la 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. Seleccione el nombre del clúster al que desea añadir etiquetas. 1. Desplácese hacia abajo hasta la sección **Tags (Etiquetas)** y, a continuación, elija **Edit (Editar)**. 1. Para cada etiqueta que desee añadir a este recurso, haga lo siguiente: 1. Para añadir una nueva etiqueta, escriba el nombre de la etiqueta en el cuadro **Key (Clave)**. Para cambiar el valor de una etiqueta, busque el nombre de la etiqueta en la columna **Key (Clave)**. 1. Para asignar a la etiqueta un valor nuevo o actualizado, escriba un valor para la etiqueta en el cuadro **Value (Valor)**. 1. Si desea añadir más etiquetas, elija **Add (Añadir)**. En caso contrario, cuando haya terminado, elija **Save (Guardar)**. ------ #### [ Using the AWS CLI ] El proceso para añadir una etiqueta a un recurso es similar independientemente de a qué recurso añada etiquetas. En este ejemplo, se añaden tres etiquetas a un clúster. La segunda etiqueta, `key2`, no tiene ningún valor. Utilice la operación AWS CLI de la `add-tags-to-resource` con estos parámetros. **Parámetros** + **--resource-name**: el ARN del recurso Amazon DocumentDB al que desea agregar etiquetas. + **--tags**: una lista de etiquetas (par clave-valor) que desea agregar a este recurso en el formato. `Key=key-name,Value=tag-value` **Example** Para Linux, macOS o Unix: ``` aws docdb add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` Para Windows: ``` aws docdb add-tags-to-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` La operación `add-tags-to-resource` no produce ningún resultado. Para ver los resultados de la operación, utilice la operación `list-tags-for-resource`. ------ ## Lista de etiquetas en un recurso de Amazon DocumentDB Puede utilizar la Consola de administración de AWS o la AWS CLI para obtener una lista de las etiquetas de un recurso de Amazon DocumentDB. ------ #### [ Using the Consola de administración de AWS ] El proceso para mostrar las etiquetas de un recurso es similar independientemente de a qué recurso añada la etiqueta. En este ejemplo, se muestran las etiquetas de un clúster. **Para mostrar las etiquetas en un clúster mediante la consola** 1. Abra la 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. Seleccione el nombre del clúster para el que desea mostrar las etiquetas. 1. Para ver una lista de las etiquetas de este recurso, desplácese hacia abajo hasta la sección **Tags (Etiquetas)**. ------ #### [ Using the AWS CLI ] El proceso para mostrar las etiquetas de un recurso es similar independientemente del recurso cuyas etiquetas vaya a mostrar. En este ejemplo, se muestran las etiquetas de un clúster. Utilice la operación AWS CLI de la `list-tags-for-resource` con estos parámetros. **Parámetros** + **--resource-name**: obligatorio. El ARN del recurso Amazon DocumentDB del que desea ver las etiquetas. **Example** Para Linux, macOS o Unix: ``` aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` Para Windows: ``` aws docdb list-tags-for-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "" }, { "Key": "key3", "Value": "value3" } ] } ``` ------ ## Eliminación de etiquetas de un recurso de Amazon DocumentDB Puede usar la Consola de administración de AWS o la AWS CLI para eliminar etiquetas de recursos de Amazon DocumentDB. ------ #### [ Using the Consola de administración de AWS ] El proceso para eliminar etiquetas de un recurso es similar independientemente del recurso que vaya a eliminar. En este ejemplo, se eliminan las etiquetas de un clúster. **Para eliminar las etiquetas de un clúster mediante la consola** 1. Abra la 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. Seleccione el nombre del clúster cuyas etiquetas desea eliminar. 1. Desplácese hacia abajo hasta la sección **Tags (Etiquetas)** y, a continuación, elija **Edit (Editar)**. 1. Si desea eliminar todas las etiquetas de este recurso, seleccione **Remove all (Eliminar todas)**. De lo contrario, para cada etiqueta que desee eliminar de este recurso, haga lo siguiente: 1. Localice el nombre de la etiqueta en la columna **Key (Clave)**. 1. Elija **Remove (Eliminar)** en la misma fila que la clave de etiqueta. 1. Cuando termine, elija **Guardar**. ------ #### [ Using the AWS CLI ] El proceso para eliminar una etiqueta de un recurso es similar independientemente del recurso del que vaya a eliminar una etiqueta. En este ejemplo, se elimina una etiqueta de un clúster. Utilice la operación AWS CLI de la `remove-tags-from-resource` con estos parámetros. + **--resource-name**: obligatorio. El ARN del recurso Amazon DocumentDB del que desea eliminar las etiquetas. + **--tag-keys**: obligatorio. Una lista de las claves de etiqueta que desea quitar de este recurso. **Example** Para Linux, macOS o Unix: ``` aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` Para Windows: ``` aws docdb remove-tags-from-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` La operación `removed-tags-from-resource` no produce ningún resultado. Para ver los resultados de la operación, utilice la operación `list-tags-for-resource`. ------ # Mantenimiento de Amazon DocumentDB Amazon DocumentDB realiza tareas de mantenimiento periódicas en los recursos de Amazon DocumentDB. En la mayoría de los casos, estas tareas de mantenimiento incluyen actualizaciones del motor de base de datos (mantenimiento de clústeres) o el sistema operativo subyacente de la instancia (mantenimiento de instancias). Las actualizaciones del motor de base de datos son parches necesarios e incluyen correcciones de seguridad, correcciones de errores y mejoras en el motor de base de datos. Si bien la mayoría de los parches del sistema operativo son opcionales, si no los aplica durante un tiempo, es posible que el parche sea necesario y se aplique automáticamente para mantener su postura de seguridad. Por lo tanto, le recomendamos que aplique las actualizaciones del sistema operativo a sus instancias de Amazon DocumentDB tan pronto como estén disponibles. Los parches del motor de base de datos necesitan que desconecte los clústeres de Amazon DocumentDB durante un breve plazo de tiempo. Una vez disponibles, estos parches se programan automáticamente para que se apliquen durante un próximo periodo de mantenimiento programado del clúster de Amazon DocumentDB. Los clústeres y las instancias tienen sus propios periodos de mantenimiento. Las modificaciones de la instancia y clúster que haya decidido no aplicar inmediatamente también se aplican durante el periodo de mantenimiento. De forma predeterminada, al crear un clúster, Amazon DocumentDB asigna un periodo de mantenimiento tanto para el clúster como para cada instancia individual. Puede elegir el periodo de mantenimiento en el momento de crear un clúster o una instancia. También puede modificar los periodos de mantenimiento en cualquier momento para ajustarlos a las prácticas o las programaciones de su empresa. Por lo general, se recomienda elegir periodos de mantenimiento que minimicen la repercusión de las tareas de mantenimiento en la aplicación (por ejemplo, por las noches o durante los fines de semana). **Topics** + [Notificaciones de parches del motor de Amazon DocumentDB](#patch-notifications) + [Visualización de las operaciones de mantenimiento pendientes de Amazon DocumentDB](#view-pending-maintenance) + [Actualizaciones del motor de Amazon DocumentDB](#db-instance-updates-apply) + [Actualizaciones iniciadas por el usuario](#user-initiated-updates) + [Administración de los periodos de mantenimiento de Amazon DocumentDB](#maintenance-window) + [Actualizaciones del sistema operativo de Amazon DocumentDB](#os-system-updates) ## Notificaciones de parches del motor de Amazon DocumentDB Recibirá notificaciones de mantenimiento de los parches del motor de base de datos necesarios a través de eventos de estado en la AWS consola Panel de estado (AHD) y mediante correos electrónicos. Cuando un parche de mantenimiento del motor de Amazon DocumentDB esté disponible en una AWS región determinada, todas las cuentas de usuario de Amazon DocumentDB afectadas de la región recibirán una notificación AHD y por correo electrónico para cada versión de Amazon DocumentDB afectada por el parche. Puede ver estas notificaciones en la sección de **cambios programados** del AHD de la consola. AWS La notificación incluirá detalles sobre el tiempo de disponibilidad de los parches, el calendario de aplicación automática, la lista de clústeres afectados y las notas de la versión. Esta notificación también se enviará por correo electrónico a la dirección de correo electrónico del usuario raíz de la AWS cuenta. ![\[Consola de Amazon DocumentDB que muestra la pestaña de cambios programados para las actualizaciones de los parches del motor.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/scheduled-changes.png) Una vez que reciba esta notificación, podrá optar por aplicar automáticamente estos parches del motor a los clústeres de Amazon DocumentDB antes de la fecha de aplicación automática programada. O bien, puede esperar a que los parches del motor se apliquen automáticamente durante un próximo periodo de mantenimiento (opción predeterminada). **nota** El **Estado** de la notificación en el AHD se establecerá como “En curso” hasta que se publique un nuevo parche del motor de Amazon DocumentDB con una nueva versión del parche del motor. Una vez aplicado el parche del motor al clúster de Amazon DocumentDB, la versión del parche del motor del clúster se actualizará para reflejar la versión en la notificación. Puede ejecutar el comando `db.runCommand({getEngineVersion: 1})` para verificar esta actualización. AWS Health también se integra con Amazon EventBridge , que utiliza eventos para crear aplicaciones escalables basadas en eventos y se integra con más de 20 destinos AWS Lambda, incluidos Amazon Simple Queue Service (SQS) y otros. Puedes usar el código de `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED` evento para configurar Amazon EventBridge antes de que los parches del motor estén disponibles. Puede configurarlo EventBridge para responder al evento y realizar automáticamente acciones, como capturar información sobre el evento, iniciar eventos adicionales, enviar notificaciones a través de canales adicionales, como notificaciones push AWS Console Mobile Application, y tomar medidas correctivas o de otro tipo, cuando un parche del motor Amazon DocumentDB esté disponible en su región. En el raro caso de que Amazon DocumentDB cancele un parche del motor, recibirá una notificación de AHD y un correo electrónico en el que se le informará de la cancelación. En consecuencia, puedes usar el código de `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED` evento para configurar Amazon EventBridge para que responda a este evento. Consulta la *Guía del EventBridge usuario de Amazon* para obtener más información sobre el uso de [ EventBridge las reglas de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). ## Visualización de las operaciones de mantenimiento pendientes de Amazon DocumentDB Puedes ver si hay una actualización de mantenimiento disponible para tu clúster utilizando el Consola de administración de AWS o el AWS CLI. Si hay disponible una actualización, puede realizar una de las acciones siguientes: + Aplace una acción de mantenimiento que esté actualmente programada para el próximo periodo de mantenimiento (solo para los parches del sistema operativo). + Aplicar inmediatamente las operaciones de mantenimiento. + Programar las operaciones de mantenimiento para que se inicien durante el siguiente periodo de mantenimiento. **nota** Si no lleva a cabo ninguna acción, las acciones de mantenimiento necesarias, como los parches del motor, se aplicarán automáticamente en un próximo periodo de mantenimiento programado. El periodo de mantenimiento determina el momento en que comienzan las operaciones pendientes, pero no limita su tiempo total de ejecución. ------ #### [ Using the Consola de administración de AWS ] 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. Si hay disponible una actualización, se indicará con la palabra **Disponible** u **Obligatorio**, o **Siguiente período** en la columna **Mantenimiento** del clúster en la consola de Amazon DocumentDB, como se muestra a continuación: ![\[Consola de Amazon DocumentDB que muestra la columna Maintenance (Mantenimiento) de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-maintenance-updates-status.png) 1. Para realizar una acción, elija la instancia el clúster para mostrar sus detalles y, a continuación, seleccione **Mantenimiento y copias de seguridad**. Aparecerán los elementos de **mantenimiento pendientes**. ![\[La consola de Amazon DocumentDB muestra la ventana de mantenimiento del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cluster-maint-3.png) ------ #### [ Using the AWS CLI ] Utilice la siguiente AWS CLI operación para determinar qué acciones de mantenimiento están pendientes. Este resultado indica que no hay ninguna operación de mantenimiento pendiente. ``` aws docdb describe-pending-maintenance-actions ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "PendingMaintenanceActions": [] } ``` ------ ## Actualizaciones del motor de Amazon DocumentDB Con Amazon DocumentDB puede elegir el momento en que desea aplicar las operaciones de mantenimiento. Puede decidir cuándo Amazon DocumentDB aplica las actualizaciones mediante las Consola de administración de AWS teclas o. AWS CLI Utilice los procedimientos que se explican en este tema para actualizar inmediatamente o para programar una actualización del clúster. ------ #### [ Using the Consola de administración de AWS ] Puede utilizar la consola para administrar las actualizaciones de las instancias y los clústeres de Amazon DocumentDB. **Administración de la actualización de un clúster** 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 lista de clústeres, elija el botón situado junto al nombre del clúster al que desea aplicar la operación de mantenimiento. 1. En el menú **Actions (Acciones)**, elija una de las opciones siguientes: + **Upgrade now (Actualizar ahora)** para realizar inmediatamente las tareas de mantenimiento pendientes. + **Upgrade at next window (Actualizar en el siguiente periodo)** para realizar las tareas de mantenimiento pendientes durante el siguiente periodo de mantenimiento del clúster. También puede hacer clic en **Aplicar ahora** o **Aplicar durante la próxima ventana de mantenimiento** en la sección Mantenimiento pendiente de la pestaña **Mantenimiento y copias de seguridad** del clúster (consulte **Uso de la Consola de administración de AWS** en la sección anterior). **nota** Si no hay tareas de mantenimiento pendientes, las opciones anteriores están inactivas. ------ #### [ Using the AWS CLI ] Para aplicar una actualización pendiente a un clúster, utilice la operación. `apply-pending-maintenance-action` AWS CLI **Parameters** + **--resource-identifier**: el Nombre de recurso de Amazon (ARN) Amazon DocumentDB del recurso al que se aplica la acción de mantenimiento pendiente. + **--apply-action**: la acción de mantenimiento pendiente que se aplica a este recurso. Valores válidos: `system-update` y `db-upgrade`. + **--opt-in-type**: un valor que indica el tipo de solicitud de alta o deshace una solicitud de alta. Una solicitud de alta de tipo `immediate` no se puede deshacer. Valores válidos: + `immediate`: aplicar inmediatamente la acción de mantenimiento. + `next-maintenance`: aplicar la acción de mantenimiento durante la siguiente ventana de mantenimiento del recurso. + `undo-opt-in`: cancelar todas las solicitudes de alta `next-maintenance` existentes. **Example** Para Linux, macOS o Unix: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \ --apply-action system-update \ --opt-in-type immediate ``` Para Windows: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^ --apply-action system-update ^ --opt-in-type immediate ``` Para devolver una lista de recursos que tienen al menos una actualización pendiente, utilice el `describe-pending-maintenance-actions` AWS CLI comando. **Example** Para Linux, macOS o Unix: ``` aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb ``` Para Windows: ``` aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2019-01-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2019-01-18T03:01:00Z", "AutoAppliedAfterDate": "2019-01-11T03:01:00Z" } ] } ] } ``` También puede devolver una lista de recursos para un clúster especificando el `--filters` parámetro de la `describe-pending-maintenance-actions` AWS CLI operación. El formato de la operación `--filters` es `Name=filter-name,Values=resource-id,...`. `db-cluster-id` son los valores aceptados para el parámetro `Name` del filtro. Este valor acepta una lista de identificadores de clúster o ARNs. La lista devuelta solo incluye las acciones de mantenimiento pendientes para los clústeres identificados por estos identificadores o. ARNs En el ejemplo siguiente se obtienen las operaciones de mantenimiento pendientes para los clústeres `sample-cluster1` y `sample-cluster2`. **Example** Para Linux, macOS o Unix: ``` aws docdb describe-pending-maintenance-actions \ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2 ``` Para Windows: ``` aws docdb describe-pending-maintenance-actions ^ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2 ``` ------ ### Fechas de aplicación Cada operación de mantenimiento tiene una fecha de aplicación que encontrará al describir las operaciones de mantenimiento pendientes. Al leer el resultado de las acciones de mantenimiento pendientes del AWS CLI, aparecen tres fechas. Estos valores de fecha son `null` cuando el mantenimiento es opcional. Los valores se rellenan una vez que se programa o aplica la acción de mantenimiento correspondiente. + **CurrentApplyDate**: fecha en la que se aplicará la acción de mantenimiento inmediatamente o en la siguiente ventana de mantenimiento. + **ForcedApplyDate**: fecha en la que el mantenimiento se aplicará automáticamente, independientemente del período de mantenimiento. + **AutoAppliedAfterDate**: fecha a partir de la cual se aplicará el mantenimiento durante el período de mantenimiento del clúster. ## Actualizaciones iniciadas por el usuario Como usuario de Amazon DocumentDB, puede iniciar las actualizaciones de los clústeres o las instancias. Por ejemplo, puede cambiar la clase de una instancia por otra con más o menos memoria o modificar el grupo de parámetros de un clúster. Amazon DocumentDB ve estos cambios de forma diferente a las actualizaciones iniciadas por Amazon DocumentDB. Para obtener más información sobre cómo modificar un clúster o una instancia, consulte lo siguiente: + [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md) + [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md) Para ver una lista de modificaciones pendientes iniciadas por el usuario, ejecute el siguiente comando. **Example** **Para ver los cambios pendientes iniciados por el usuario para las instancias** Para Linux, macOS o Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]' ``` Para Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]' ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). En este caso, `sample-cluster-instance` tiene un cambio pendiente en una clase de instancia `db.r5.xlarge`, mientras que `sample-cluster-instance-2` no tiene ningún cambio pendiente. ``` [ [ "sample-cluster", "sample-cluster-instance", { "DBInstanceClass": "db.r5.xlarge" } ], [ "sample-cluster", "sample-cluster-instance-2", {} ] ] ``` ## Administración de los periodos de mantenimiento de Amazon DocumentDB Cada instancia y clúster incluye un periodo de mantenimiento semanal durante el que se aplican los cambios pendientes. Este periodo de mantenimiento es una oportunidad de controlar cuándo se producen modificaciones y se aplican parches de software, en caso de que se solicite o sea necesario. Si hay un evento de mantenimiento programado para una semana determinada, se iniciará durante el periodo de mantenimiento de 30 minutos que identifique. La mayoría de los eventos de mantenimiento también se completan durante el periodo de mantenimiento de 30 minutos, aunque otros eventos de mantenimiento pueden tardar más de 30 minutos en completarse. El periodo de mantenimiento de 30 minutos se selecciona al azar dentro de un bloque de 8 horas por región. Si no especifica un periodo de mantenimiento preferido al crear una instancia o un clúster, Amazon DocumentDB asigna un periodo de mantenimiento de 30 minutos un día de la semana seleccionado al azar. En la siguiente tabla, se muestran los bloques de tiempo de cada región desde los que se asignan los periodos de mantenimiento predeterminados. | Nombre de la región | Region | Bloque de tiempo en UTC | | --- | --- | --- | | Este de EE. UU. (Ohio) | us-east-2 | 03:00-11:00 | | Este de EE. UU. (Norte de Virginia) | us-east-1 | 03:00-11:00 | | Oeste de EE. UU. (Oregón) | us-west-2 | 06:00-14:00 | | África (Ciudad del Cabo) | af-south-1 | 03:00-11:00 | | Asia-Pacífico (Hong Kong) | ap-east-1 | 06:00-14:00 | | Asia-Pacífico (Hyderabad) | ap-south-2 | 06:30–14:30 | | Asia-Pacífico (Malasia) | ap-southeast-5 | 13:00-21:00 | | Asia-Pacífico (Mumbai) | ap-south-1 | 06:00-14:00 | | Asia-Pacífico (Osaka) | ap-northeast-3 | 12:00–20:00 | | Asia-Pacífico (Seúl) | ap-northeast-2 | 13:00-21:00 | | Asia-Pacífico (Singapur) | ap-southeast-1 | 14:00–22:00 | | Asia-Pacífico (Sídney) | ap-southeast-2 | 12:00–20:00 | | Asia-Pacífico (Yakarta) | ap-southeast-3 | 08:00-16:00 | | Asia-Pacífico (Melbourne) | ap-southeast-4 | 11:00-19:00 | | Asia-Pacífico (Tailandia) | ap-southeast-7 | 15:00-23:00 | | Asia-Pacífico (Tokio) | ap-northeast-1 | 13:00-21:00 | | Canadá (centro) | ca-central-1 | 03:00-11:00 | | China (Pekín) | cn-north-1 | 06:00-14:00 | | China (Ningxia) | cn-northwest-1 | 06:00-14:00 | | Europa (Fráncfort) | eu-central-1 | 21:00-05:00 | | Europa (Zúrich) | eu-central-2 | 02:00-10:00 | | Europa (Irlanda) | eu-west-1 | 22:00-06:00 | | Europa (Londres) | eu-west-2 | 22:00-06:00 | | Europa (Milán) | eu-south-1 | 02:00-10:00 | | Europa (París) | eu-west-3 | 23:59-07:29 | | Europa (España) | eu-south-2 | 02:00-10:00 | | Europa (Estocolmo) | eu-north-1 | 04:00 — 12:00 | | México (centro) | mx-central-1 | 03:00-11:00 | | Medio Oriente (EAU) | me-central-1 | 05:00-13:00 | | América del Sur (São Paulo) | sa-east-1 | 00:00-08:00 | | Israel (Tel Aviv) | il-central-1 | 04:00-12:00 | | AWS GovCloud (Este de EE. UU.) | us-gov-east-1 | 17:00-01:00 | | AWS GovCloud (EE. UU.-Oeste) | us-gov-west-1 | 06:00-14:00 | ### Cambio de los periodos de mantenimiento de Amazon DocumentDB El periodo de mantenimiento debe corresponder al momento de mínimo uso y, por tanto, podría ser preciso modificarlo cada cierto tiempo. El clúster o la instancia solo dejan de estar disponibles durante este periodo si se están aplicando cambios en el sistema (por ejemplo, se está realizando una operación de escalado del almacenamiento o un cambio de clase de instancia) y se requiere una interrupción. En ese caso, solo dejará de estar disponible durante el tiempo mínimo requerido para realizar los cambios necesarios. En el caso de las actualizaciones del motor de base de datos, Amazon DocumentDB utiliza el periodo de mantenimiento preferido del clúster y no el periodo de mantenimiento de las instancias individuales. **Para cambiar el periodo de mantenimiento** + Para un clúster, consulte [Modificación de un clúster de Amazon DocumentDB](db-cluster-modify.md). + Para una instancia, consulte [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md). ## Actualizaciones del sistema operativo de Amazon DocumentDB En ocasiones, las instancias de los clústeres de Amazon DocumentDB requieren actualizaciones del sistema operativo. Amazon DocumentDB actualiza el sistema operativo a una versión más reciente para mejorar el rendimiento de la base de datos y la posición de seguridad general de los clientes. Las actualizaciones del sistema operativo no cambian la versión del motor del clúster ni la clase de instancia de una instancia de Amazon DocumentDB. Le recomendamos que actualice primero las instancias del lector en un clúster y, a continuación, la instancia del escritor para maximizar la disponibilidad de su clúster. No recomendamos actualizar las instancias de lector y escritor al mismo tiempo, ya que podría producirse un tiempo de inactividad en caso de una conmutación por error. La mayoría de las actualizaciones del sistema operativo para Amazon DocumentDB son opcionales y no tienen una fecha fija para aplicarlas. Sin embargo, si no aplica estas actualizaciones durante un tiempo, es posible que acaben siendo necesarias y se apliquen automáticamente durante el periodo de mantenimiento de la instancia. Esto ayuda a mantener la posición de seguridad de la base de datos. Para evitar cualquier tiempo de inactividad inesperado, le recomendamos que aplique las actualizaciones del sistema operativo a las instancias de Amazon DocumentDB tan pronto como estén disponibles y que establezca el periodo de mantenimiento de las instancias en el momento que le resulte más conveniente según las necesidades de la empresa. Para recibir una notificación cuando haya una nueva actualización opcional disponible, puede suscribirse al RDS-EVENT-0230 en la categoría de eventos de parches de seguridad. Para obtener información sobre la suscripción a eventos de Amazon DocumentDB, consulte [Suscripción a eventos de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-subscriptions.subscribe.html). Debe esperar que, mientras se lleva a cabo el mantenimiento en el clúster o la instancia, si se trata de una instancia principal, se producirá una conmutación por error. Para mejorar su disponibilidad, le recomendamos que utilice más de una instancia para sus clústeres de Amazon DocumentDB. Para obtener más información, consulte [Conmutación por error a Amazon DocumentDB](failover.md). **nota** Para determinadas funciones de administración, Amazon DocumentDB utiliza tecnología operativa que se comparte con Amazon Relational Database Service (Amazon RDS). **importante** La instancia de Amazon DocumentDB se desconectará durante la actualización del sistema operativo. Puede minimizar el tiempo de inactividad del clúster si dispone de un clúster de varias instancias. Si no tiene un clúster de varias instancias, puede optar por crear uno temporalmente mediante la adición de instancias secundarias para llevar a cabo este mantenimiento y, a continuación, eliminar las instancias de lectura adicionales una vez finalizado el mantenimiento (se aplicarán los cargos habituales por la instancia secundaria). **nota** Mantenerse al día en todas las actualizaciones opcionales y obligatorias podría ser necesario para cumplir varias obligaciones de conformidad. Le recomendamos que aplique todas las actualizaciones que Amazon DocumentDB pone a disposición de forma rutinaria durante los periodos de mantenimiento. Puede utilizar el Consola de administración de AWS o el AWS CLI para determinar si hay una actualización disponible. ------ #### [ Using the Consola de administración de AWS ] Para determinar si una actualización está disponible mediante la Consola de administración de AWS: 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, elija **Clústeres** y, a continuación, seleccione la instancia. 1. Elija **Mantenimiento**. 1. En la sección **Mantenimiento pendiente**, busque la actualización del sistema operativo. ![\[Consola de Amazon DocumentDB que muestra la columna Maintenance (Mantenimiento) de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/maintenance-available-1.png) Puede seleccionar la actualización del sistema operativo y hacer clic en **Aplicar ahora** o en **Aplicar durante la próxima ventana de mantenimiento** en la sección **Mantenimiento pendiente**. Si el valor de mantenimiento es **siguiente periodo**, aplace los elementos de mantenimiento seleccionando **aplazar actualización**. No puede aplazar una acción de mantenimiento si ya se ha iniciado. Como alternativa, puede elegir la instancia de una lista de clústeres. Para ello, haga clic en **Clústeres** en el panel de navegación y seleccione **Aplicar ahora** o **Aplicar durante la próxima ventana de mantenimiento** en el menú **Acciones**. ------ #### [ Using the AWS CLI ] Para determinar si hay una actualización disponible mediante el AWS CLI, ejecute el comando: `describe-pending-maintenance-actions` ``` aws docdb describe-pending-maintenance-actions ``` ``` { "ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "Description": "New Operating System update is available" } ] } ``` ------ Las actualizaciones del sistema operativo son específicas para la versión del motor de Amazon DocumentDB y la clase de instancia. Por lo tanto, las instancias de Amazon DocumentDB reciben o requieren actualizaciones en diferentes momentos. Cuando una actualización del sistema operativo está disponible para su instancia en función de su versión del motor y de la clase de instancia, la actualización aparece en la consola. También se puede ver ejecutando el AWS CLI `describe-pending-maintenance-actions` comando o llamando a la operación de la `DescribePendingMaintenanceActions` API. Si no está ejecutando la última versión del parche de clúster del motor de Amazon DocumentDB, es posible que la actualización del sistema operativo no aparezca en la lista de mantenimiento disponible. Para ver y administrar la actualización del sistema operativo, primero debe actualizar a la versión más reciente de parche del motor. # Descripción de los roles vinculados a servicios Amazon DocumentDB (compatible con MongoDB) usa AWS Identity and Access Management roles vinculados a servicios (IAM). Un [rol vinculado a un servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) es un tipo único de rol de IAM que está vinculado directamente a Amazon DocumentDB. Amazon DocumentDB predefine las funciones vinculadas a servicios e incluyen todos los permisos que el servicio requiere para llamar a AWS otros servicios en su nombre. Un rol vinculado a un servicio simplifica el uso de Amazon DocumentDB porque ya no tendrá que agregar manualmente los permisos requeridos. Amazon DocumentDB define los permisos de sus roles vinculados al servicio y, a menos que esté definido de otra manera, solo Amazon DocumentDB puede asumir sus roles. Los permisos definidos incluyen las políticas de confianza y de permisos, y que la política de permisos no se pueda asociar a ninguna otra entidad de IAM. Las funciones se pueden eliminar únicamente después de eliminar primero sus recursos relacionados. De esta forma, se protegen los recursos de Amazon DocumentDB, ya que se evita que se puedan eliminar accidentalmente permisos de acceso a los recursos. Para obtener información sobre otros servicios que son compatibles con los roles vinculados a servicios, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) y busque los servicios que muestran **Yes** (Sí) en la columna **Service-Linked Role** (Rol vinculado a servicios). Elija una opción **Sí** con un enlace para ver la documentación acerca del rol vinculado al servicio en cuestión. ## Permisos de roles vinculados a servicios para Amazon DocumentDB Amazon DocumentDB (compatible con MongoDB) utiliza el rol vinculado a servicios denominado RDS para **AWSServiceRoleForpermitir** que Amazon DocumentDB llame a los servicios en nombre de sus clústeres. AWS El rol vinculado al servicio AWSService RoleFor de RDS confía en los siguientes servicios para asumir el rol: + `docdb.amazonaws.com` La política de permisos del rol permite que Amazon DocumentDB realice las siguientes acciones en los recursos especificados: + Acciones en `ec2`: + `AssignPrivateIpAddresses` + `AuthorizeSecurityGroupIngress` + `CreateNetworkInterface` + `CreateSecurityGroup` + `DeleteNetworkInterface` + `DeleteSecurityGroup` + `DescribeAvailabilityZones` + `DescribeInternetGateways` + `DescribeSecurityGroups` + `DescribeSubnets` + `DescribeVpcAttribute` + `DescribeVpcs` + `ModifyNetworkInterfaceAttribute` + `RevokeSecurityGroupIngress` + `UnassignPrivateIpAddresses` + Acciones en `sns`: + `ListTopic` + `Publish` + Acciones en `cloudwatch`: + `PutMetricData` + `GetMetricData` + `CreateLogStream` + `PullLogEvents` + `DescribeLogStreams` + `CreateLogGroup` **nota** Debe configurar permisos para permitir a una entidad de IAM (como un usuario, grupo o rol) crear, editar o eliminar un rol vinculado a servicios. Podría encontrarse con el siguiente mensaje de error: **Unable to create the resource. Verify that you have permission to create service linked role. Otherwise wait and try again later.** Si aparece este error, asegúrese de que tiene los siguientes permisos habilitados: ``` { "Action": "iam:CreateServiceLinkedRole", "Effect": "Allow", "Resource": "arn:aws:iam::*:role/aws-service-role/rds.amazonaws.com/AWSServiceRoleForRDS", "Condition": { "StringLike": { "iam:AWSServiceName":"rds.amazonaws.com" } } } ``` Para obtener más información, consulte [Permisos de roles vinculados a servicios](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) en la *Guía del usuario de IAM*. ## Creación de un rol vinculado a servicios para Amazon DocumentDB No necesita crear manualmente un rol vinculado a servicios. Al crear un clúster, Amazon DocumentDB se encarga de crear de nuevo el rol vinculado a servicios en su nombre. Si elimina este rol vinculado a un servicio y necesita crearlo de nuevo, puede utilizar el mismo proceso para volver a crear el rol en su cuenta. Al crear un clúster, Amazon DocumentDB se encarga de crear de nuevo el rol vinculado a servicios en su nombre de nuevo. ## Modificación de un rol vinculado a servicios para Amazon DocumentDB Amazon DocumentDB no le permite modificar la función vinculada al servicio de AWSService RoleFor RDS. Después de crear un rol vinculado a un servicio, no podrá cambiar el nombre del rol, ya que varias entidades podrían hacer referencia al mismo. Sin embargo, puede modificar la descripción del rol utilizando IAM. Para obtener más información, consulte [Edición de un rol vinculado a servicios](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) en la *Guía del usuario de IAM*. ## Eliminación de un rol vinculado a servicios para Amazon DocumentDB Si ya no necesita utilizar una característica o servicio que requiere un rol vinculado a servicios, recomendamos que elimine dicho rol. Así no tendrá una entidad no utilizada que no se supervise ni mantenga de forma activa. Sin embargo, debe eliminar todos los clústeres para poder eliminar el rol vinculado al servicio. ### Limpieza de un rol vinculado a servicios para Amazon DocumentDB Antes de poder utilizar IAM para eliminar un rol vinculado a un servicio, primero debe confirmar que dicho rol no tiene sesiones activas y eliminar los recursos que utiliza. **Para comprobar si el rol vinculado al servicio tiene una sesión activa mediante la consola** 1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 1. En el panel de navegación de la consola de IAM, elija **Funciones** y, a continuación, elija el nombre (no la casilla de verificación) de la función de **AWSServiceRoleForRDS**. 1. En la página **Resumen** del rol seleccionado, seleccione la pestaña **Asesor de acceso**. 1. En la pestaña **Access Advisor**, revise la actividad reciente del rol vinculado al servicio. **nota** Si no está seguro de si Amazon DocumentDB utiliza el rol de AWSService RoleFor RDS, puede intentar eliminarlo. Si el servicio está utilizando el rol, este no podrá eliminarse y podrá ver las regiones en las que se está utilizando. Si el rol se está utilizando, debe esperar que la sesión finalice para poder eliminarlo. No se puede revocar la sesión de un rol vinculado a servicios. Si desea eliminar el rol de AWSService RoleFor RDS, primero debe eliminar *todas las* instancias y clústeres. Para obtener información acerca de cómo eliminar instancias y clústeres, consulte los siguientes temas: + [Eliminación de una instancia de Amazon DocumentDB](db-instance-delete.md) + [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md) ## Regiones admitidas para los roles vinculados a servicios para Amazon DocumentDB Amazon DocumentDB admite el uso de roles vinculados a servicios en todas las regiones en las que se encuentra disponible el servicio. Para obtener más información, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability](https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability).   # Uso de flujos de cambios con Amazon DocumentDB La característica de flujos de cambios de Amazon DocumentDB (compatible con MongoDB) brinda una secuencia en orden cronológico de los eventos de actualización que se producen dentro de las colecciones de su clúster. Puede leer eventos de una secuencia de cambios para implementar muchos casos de uso diferentes, incluidos los siguientes: + Notificación de cambio + Búsqueda de texto completo con Amazon OpenSearch Service (OpenSearch Servicio) + Análisis con Amazon Redshift Las aplicaciones pueden usar los flujos de cambios para suscribirse a los cambios de datos en colecciones individuales. Los eventos de flujos de cambios se ordenan a medida que se producen en el clúster y se almacenan durante 3 horas (valor predeterminado) desde el momento de registro del evento. El período de retención se puede ampliar hasta 7 días utilizando el parámetro `change_stream_log_retention_duration`. Para modificar el período de retención del flujo de cambios, consulte [Modificación de la duración de retención del registro del flujo de cambios](https://docs.aws.amazon.com/documentdb/latest/developerguide/change_streams.html#change_streams-modifying_log_retention). **Topics** + [Operaciones admitidas](#change_streams-supported_ops) + [Facturación](#change_streams-billing) + [Limitaciones](#change_streams-limitations) + [Habilitación de flujos de cambios](#change_streams-enabling) + [Ejemplo: uso de flujos de cambios con Python](#change_streams-using_example) + [Búsqueda completa de documentos](#change_streams-lookup) + [Reanudación de un flujo de cambios](#change_streams-resuming) + [Reanudación de un flujo de cambios con `startAtOperationTime`](#change_streams-startAtOperation) + [Reanudación de un flujo de cambios con `postBatchResumeToken`](#change_streams-postBatchResumeToken) + [Transacciones en flujos de cambios](#change_streams-transactions) + [Modificación de la duración de la retención del registro de flujos de cambios](#change_streams-modifying_log_retention) + [Uso de flujos de cambios en instancias secundarias](#change-streams-secondary-instances) ## Operaciones admitidas Amazon DocumentDB admite las siguientes operaciones para flujos de cambio: + Todos los eventos de cambio admitidos en la API `db.collection.watch()`, `db.watch()` y `client.watch()` de MongoDB. + Búsqueda completa de documentos para actualizaciones. + Etapas de agregación: `$match`, `$project`, `$redact`, `$addFields` y `$replaceRoot`. + Reanudación de un flujo de cambios desde un token de reanudación + Reanudación de un flujo de cambios a partir de una marca de tiempo mediante `startAtOperation` (aplicable a Amazon DocumentDB 4.0 y versiones posteriores) ## Facturación La característica de secuencias de cambios de Amazon DocumentDB está desactivada de forma predeterminada y no genera ningún cargo adicional hasta que se habilita y se utiliza. El uso de flujos de cambios en un clúster conlleva costes adicionales de lectura, escritura IOs y almacenamiento. Puede utilizar la operación `modifyChangeStreams` de la API con el fin de habilitar esta característica para las colecciones del clúster. Para obtener más información acerca de los precios, consulte [Precios de Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/). ## Limitaciones Las secuencias de cambio tienen las siguientes limitaciones en Amazon DocumentDB: + En Amazon DocumentDB 3.6. y Amazon DocumentDB 4.0, los flujos de cambios solo se pueden abrir desde una conexión a la instancia principal de un clúster de Amazon DocumentDB. Amazon DocumentDB 3.6 y Amazon DocumentDB 4.0 no admiten la lectura de flujos de cambios en una instancia de réplica. Al invocar la operación de la API `watch()`, debe especificar una preferencia de lectura `primary` para asegurarse de que todas las lecturas se dirigen a la instancia principal (consulte la sección [Ejemplo](#change_streams-using_example)). + En Amazon DocumentDB 5.0, los flujos de cambios se pueden abrir tanto desde la instancia principal como desde la secundaria, incluidos los clústeres globales. Puede especificar una preferencia de lectura secundaria para redirigir los flujos de cambios a instancias secundarias. Consulte [Uso de flujos de cambios en instancias secundarias](#change-streams-secondary-instances) para ver las limitaciones y prácticas recomendadas adicionales. + Los eventos escritos en una secuencia de cambios de una colección están disponibles hasta 7 días (el valor predeterminado es 3 horas). Los datos de flujos de cambios se eliminan después del periodo de tiempo de conservación de los registros, aunque no se hayan realizado cambios. + Una operación de escritura de larga duración en una colección como `updateMany` o `deleteMany` puede estancar temporalmente la escritura de eventos de secuencias de cambio hasta que se completa dicha operación de escritura de larga duración. + Amazon DocumentDB no es compatible con el registro de operaciones de MongoDB (`oplog`). + Con Amazon DocumentDB, debe habilitar explícitamente las secuencias de cambios en una colección determinada. + Si el tamaño total de un evento de secuencias de cambios (incluidos los datos de cambio y el documento completo, si se solicita) es mayor que `16 MB`, el cliente experimentará un error de lectura en las secuencias de cambios. + Actualmente, el controlador Ruby no es compatible al usar `db.watch()` y `client.watch()` con Amazon DocumentDB 3.6. + El resultado del comando `updateDescription` en los flujos de cambios es diferente en Amazon DocumentDB que en MongoDB cuando el valor actualizado del campo es el mismo que el anterior: + Amazon DocumentDB no devuelve ningún campo en la salida `updateDescription` si el campo proporcionado está especificado en el comando `$set` y su valor objetivo ya es igual al valor de origen. + MongoDB devuelve el campo en la salida, incluso si el valor especificado es igual al valor actual. ## Habilitación de flujos de cambios Puede habilitar las secuencias de cambios de Amazon DocumentDB para todas las colecciones contenidas en una base de datos determinada o solamente para las colecciones seleccionadas. Los siguientes ejemplos muestran cómo habilitar las secuencias de cambios para diferentes casos de uso mediante el intérprete de comandos de mongo. Las cadenas vacías se tratan como comodines al especificar los nombres de las bases de datos y de las colecciones. ``` //Enable change streams for the collection "foo" in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "foo", enable: true}); ``` ``` //Disable change streams on collection "foo" in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "foo", enable: false}); ``` ``` //Enable change streams for all collections in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "", enable: true}); ``` ``` //Enable change streams for all collections in all databases in a cluster db.adminCommand({modifyChangeStreams: 1, database: "", collection: "", enable: true}); ``` Las secuencias de cambios se habilitarán para una colección si se cumple alguna de las siguientes condiciones: + Tanto la base de datos como la colección están habilitadas explícitamente. + La base de datos que contiene la colección está habilitada. + Todas las bases de datos están habilitadas. La eliminación de una colección de una base de datos no deshabilita las secuencias de cambios para esa colección si la base de datos principal también tiene activadas las secuencias de cambios o si todas las bases de datos del clúster están habilitadas. Si se crea una nueva colección con el mismo nombre que la colección eliminada, las secuencias de cambios se habilitarán para esa colección. Puede enumerar todas las secuencias de cambios habilitadas del clúster mediante la etapa de canalización de agregación `$listChangeStreams`. Todas las etapas de agregación admitidas por Amazon DocumentDB se pueden utilizar en la canalización para un procesamiento adicional. Si se deshabilita una colección que antes estaba habilitada, no aparecerá en la salida de `$listChangeStreams`. ``` //List all databases and collections with change streams enabled cursor = new DBCommandCursor(db, db.runCommand( {aggregate: 1, pipeline: [{$listChangeStreams: 1}], cursor:{}})); ``` ``` //List of all databases and collections with change streams enabled { "database" : "test", "collection" : "foo" } { "database" : "bar", "collection" : "" } { "database" : "", "collection" : "" } ``` ``` //Determine if the database “bar” or collection “bar.foo” have change streams enabled cursor = new DBCommandCursor(db, db.runCommand( {aggregate: 1, pipeline: [{$listChangeStreams: 1}, {$match: {$or: [{database: "bar", collection: "foo"}, {database: "bar", collection: ""}, {database: "", collection: ""}]}} ], cursor:{}})); ``` ## Ejemplo: uso de flujos de cambios con Python El siguiente es un ejemplo del uso de una secuencia de cambios de Amazon DocumentDB con Python a nivel de la colección. ``` import os import sys from pymongo import MongoClient, ReadPreference username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] #While ‘Primary’ is the default read preference, here we give an example of #how to specify the required read preference when reading the change streams coll = db.get_collection('foo', read_preference=ReadPreference.PRIMARY) #Create a stream object stream = coll.watch() #Write a new document to the collection to generate a change event coll.insert_one({'x': 1}) #Read the next change event from the stream (if any) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'insert'} """ #A subsequent attempt to read the next change event returns nothing, as there are no new changes print(stream.try_next()) """ Expected Output: None """ #Generate a new change event by updating a document result = coll.update_one({'x': 1}, {'$set': {'x': 2}}) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf99d400000001010000000100009025'}, 'clusterTime': Timestamp(1571789268, 1), 'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'update', 'updateDescription': {'removedFields': [], 'updatedFields': {'x': 2}}} """ ``` El siguiente es un ejemplo del uso de una secuencia de cambios de Amazon DocumentDB con Python a nivel de la base de datos. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] #Create a stream object stream = db.watch() coll = db.get_collection('foo') #Write a new document to the collection foo to generate a change event coll.insert_one({'x': 1}) #Read the next change event from the stream (if any) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'insert'} """ #A subsequent attempt to read the next change event returns nothing, as there are no new changes print(stream.try_next()) """ Expected Output: None """ coll = db.get_collection('foo1') #Write a new document to another collection to generate a change event coll.insert_one({'x': 1}) print(stream.try_next()) """ Expected Output: Since the change stream cursor was the database level you can see change events from different collections in the same database {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo1', 'db': 'bar'}, 'operationType': 'insert'} """ ``` ## Búsqueda completa de documentos El evento de cambio de actualización no incluye el documento completo; incluye tan solo el cambio realizado. Si su caso de uso requiere el documento completo afectado por una actualización, puede habilitar la búsqueda completa de documentos al abrir la secuencia. El documento `fullDocument` de un evento de secuencias de cambios de actualización representa la versión más reciente del documento actualizado en el momento de la búsqueda de documentos. Si se han producido cambios entre la operación de actualización y la búsqueda de `fullDocument`, es posible que el documento `fullDocument` no represente el estado del documento en el momento de la actualización. Para crear un objeto de flujo con la búsqueda de actualizaciones habilitada, use este ejemplo: ``` stream = coll.watch(full_document='updateLookup') #Generate a new change event by updating a document result = coll.update_one({'x': 2}, {'$set': {'x': 3}}) stream.try_next() ``` El resultado del objeto de flujo tendrá un aspecto similar a este: ``` {'_id': {'_data': '015daf9b7c00000001010000000100009025'}, 'clusterTime': Timestamp(1571789692, 1), 'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')}, 'fullDocument': {'_id': ObjectId('5daf9502ea258751778163d7'), 'x': 3}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'update', 'updateDescription': {'removedFields': [], 'updatedFields': {'x': 3}}} ``` ## Reanudación de un flujo de cambios Puede reanudar una secuencia de cambios más tarde mediante un token de reanudación, que es igual al campo `_id` del último documento de evento de cambio recuperado. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem', retryWrites='false') db = client['bar'] coll = db.get_collection('foo') #Create a stream object stream = db.watch() coll.update_one({'x': 1}, {'$set': {'x': 4}}) event = stream.try_next() token = event['_id'] print(token) """ Output: This is the resume token that we will later us to resume the change stream {'_data': '015daf9c5b00000001010000000100009025'} """ #Python provides a nice shortcut for getting a stream’s resume token print(stream.resume_token) """ Output {'_data': '015daf9c5b00000001010000000100009025'} """ #Generate a new change event by updating a document result = coll.update_one({'x': 4}, {'$set': {'x': 5}}) #Generate another change event by inserting a document result = coll.insert_one({'y': 5}) #Open a stream starting after the selected resume token stream = db.watch(full_document='updateLookup', resume_after=token) #Our first change event is the update with the specified _id print(stream.try_next()) """ #Output: Since we are resuming the change stream from the resume token, we will see all events after the first update operation. In our case, the change stream will resume from the update operation {x:5} {'_id': {'_data': '015f7e8f0c000000060100000006000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602129676, 6), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2')}, 'fullDocument': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2'), 'x': 5}, 'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}} """ #Followed by the insert print(stream.try_next()) """ #Output: {'_id': {'_data': '015f7e8f0c000000070100000007000fe038'}, 'operationType': 'insert', 'clusterTime': Timestamp(1602129676, 7), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94')}, 'fullDocument': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94'), 'y': 5}} """ ``` ## Reanudación de un flujo de cambios con `startAtOperationTime` Puede reanudar un flujo de cambios más adelante a partir de una marca de tiempo determinada utilizando `startAtOperationTime`. **nota** `startAtOperationTime` se puede utilizar en Amazon DocumentDB 4.0 y versiones posteriores. Cuando se utiliza `startAtOperationTime`, el cursor del flujo de cambios solo devolverá los cambios que se hayan producido en la marca de tiempo especificada o después de ella. Los comandos `startAtOperationTime` y `resumeAfter` se excluyen mutuamente y, por lo tanto, no se pueden usar juntos. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='rds-root-ca-2020.pem',retryWrites='false') db = client['bar'] coll = db.get_collection('foo') #Create a stream object stream = db.watch() coll.update_one({'x': 1}, {'$set': {'x': 4}}) event = stream.try_next() timestamp = event['clusterTime'] print(timestamp) """ Output Timestamp(1602129114, 4) """ #Generate a new change event by updating a document result = coll.update_one({'x': 4}, {'$set': {'x': 5}}) result = coll.insert_one({'y': 5}) #Generate another change event by inserting a document #Open a stream starting after specified time stamp stream = db.watch(start_at_operation_time=timestamp) print(stream.try_next()) """ #Output: Since we are resuming the change stream at the time stamp of our first update operation (x:4), the change stream cursor will point to that event {'_id': {'_data': '015f7e941a000000030100000003000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602130970, 3), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e9417c423bafbfd9adbb1')}, 'updateDescription': {'updatedFields': {'x': 4}, 'removedFields': []}} """ print(stream.try_next()) """ #Output: The second event will be the subsequent update operation (x:5) {'_id': {'_data': '015f7e9502000000050100000005000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602131202, 5), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e94ffc423bafbfd9adbb2')}, 'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}} """ print(stream.try_next()) """ #Output: And finally the last event will be the insert operation (y:5) {'_id': {'_data': '015f7e9502000000060100000006000fe038'}, 'operationType': 'insert', 'clusterTime': Timestamp(1602131202, 6), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e95025c4a569e0f6dde92')}, 'fullDocument': {'_id': ObjectId('5f7e95025c4a569e0f6dde92'), 'y': 5}} """ ``` ## Reanudación de un flujo de cambios con `postBatchResumeToken` El flujo de cambios de Amazon DocumentDB ahora devuelve un campo adicional denominado `postBatchResumeToken`. Este campo lo devuelven el comando `$changestream` y el comando `getMore`. Ejemplo del comando `$changestream` en Python: ``` db.command({"aggregate": "sales", "pipeline": [{ "$changeStream": {}}], "cursor": {"batchSize": 1}}) ``` Resultado previsto: ``` cursor" : { "firstBatch" : [ ], "postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"}, "id" : NumberLong("9660788144470"), "ns" : "test.sales" } ``` Ejemplo del comando `getMore` en Python: ``` db.command({"getMore": NumberLong(), "collection": "sales", "batchSize": 1 }) ``` Resultado previsto ``` cursor" : { "nextBatch" : [ ], "postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"}, "id" : NumberLong("9660788144470"), "ns" : "test.sales" } ``` El campo `postBatchResumeToken` se puede usar para abrir nuevos cursores del flujo de cambios en el campo `resumeAfter`, de forma similar a como se usa el token de reanudación. Abra un flujo que comience después del `postBatchResumeToken` seleccionado: ``` post_batch_resume_token = output['cursor']['postBatchResumeToken'] stream = db.watch(full_document='updateLookup', resume_after=post_batch_resume_token) ``` A diferencia de un token de reanudación normal, que siempre corresponde a una entrada del registro de operaciones (oplog) que refleja un evento real, `postBatchResumeToken` corresponde a una entrada del oplog hasta la que el flujo de cambios ha escaneado en el servidor y que no es necesariamente un cambio coincidente. Si intenta reanudar con un token de reanudación normal antiguo, la base de datos tendrá que escanear todas las entradas del oplog entre la marca de tiempo especificada y el momento actual. Esto puede generar muchas consultas internas y cada subconsulta se escanea durante un breve período de tiempo. Esto provocará un aumento en el uso de la CPU y degradará el rendimiento de la base de datos. Si se reanuda con el último `postBatchResumeToken`, se omite el escaneo de entradas del oplog que no coincidan. ## Transacciones en flujos de cambios Los eventos del flujo de cambios no contendrán eventos de transacciones and/or canceladas no confirmadas. Por ejemplo, si inicia una transacción con una operación de `INSERT` y una operación de `UPDATE`, y la operación de `INSERT` se realiza correctamente, pero no así la operación de `UPDATE`, la transacción se revertirá. Como esta transacción se ha revertido, tu flujo de cambios no contendrá ningún evento de esta transacción. ## Modificación de la duración de la retención del registro de flujos de cambios Puede modificar la duración de retención del registro del flujo de cambios para que oscile entre 1 hora y 7 días utilizando Consola de administración de AWS o. AWS CLI ------ #### [ Using the Consola de administración de AWS ] **Modificación de la duración de la retención del registro de secuencias de cambios** 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 **Grupos de parámetros**. **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. 1. En el panel **Parameter groups (Grupos de parámetros)**, elija el grupo de parámetros de clúster asociado a su clúster. Para identificar el grupo de parámetros de clúster asociado a su clúster, consulte [Determinación del grupo de parámetros de un clúster de Amazon DocumentDB](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine). 1. La página resultante muestra los parámetros y sus detalles correspondientes para el grupo de parámetros de su clúster. Seleccione el parámetro `change_stream_log_retention_duration`. 1. En la parte superior derecha de la página, elija **Edit (Editar)** para cambiar el valor del parámetro. El parámetro `change_stream_log_retention_duration` se puede modificar para que abarque entre 1 hora y 7 días. 1. Realice el cambio y, a continuación, elija **Modify cluster parameter (Modificar parámetro de clúster)** para guardar los cambios. Para descartar los cambios, selecciona **Cancel (Cancelar)**. ------ #### [ Using the AWS CLI ] Para modificar los parámetros de un grupo de parámetros de clúster `change_stream_log_retention_duration`, utilice la operación `modify-db-cluster-parameter-group` con los siguientes parámetros: + **--db-cluster-parameter-group-name**: obligatorio. El nombre del grupo de parámetros de clúster que va a modificar. Para identificar el grupo de parámetros de clúster asociado a su clúster, consulte [Determinación del grupo de parámetros de un clúster de Amazon DocumentDB](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine). + **--parameters**: obligatorio. Los parámetros que está modificando. Cada entrada de parámetro debe incluir lo siguiente: + **ParameterName**: el nombre del grupo de parámetros de clúster que va a modificar. En este caso, es `change_stream_log_retention_duration` + **ParameterValue**: el valor nuevo de este parámetro de clúster. + **ApplyMethod**: cómo desea que se apliquen los cambios a este parámetro. Los valores permitidos son `immediate` y `pending-reboot`. **nota** Los parámetros con el `ApplyType` de `static` deben tener un `ApplyMethod` de `pending-reboot`. 1. Para cambiar los valores del parámetro `change_stream_log_retention_duration`, ejecute el siguiente comando y reemplace `parameter-value` por el valor que desea que tenga el parámetro. Para Linux, macOS o Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate" ``` Para Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate" ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. Espere al menos 5 minutos. 1. Enumere los valores de parámetros de `sample-parameter-group` para garantizar que se han realizado los cambios. Para Linux, macOS o Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Para Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` La salida de esta operación será similar a lo que se indica a continuación (formato JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "change_stream_log_retention_duration", "ParameterValue": "12345", "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.", "Source": "user", "ApplyType": "dynamic", "DataType": "integer", "AllowedValues": "3600-86400", "IsModifiable": true, "ApplyMethod": "immediate" } ] } ``` ------ **nota** La retención del registro de flujos de cambios no eliminará los registros anteriores al `change_stream_log_retention_duration` valor configurado hasta que el tamaño del registro sea superior a (>) 51.200 MB. ## Uso de flujos de cambios en instancias secundarias Para empezar a utilizar el flujo de cambios en las instancias secundarias, abra el cursor del flujo de cambios con `readPreference` como instancia secundaria. Puede abrir un cursor de flujo de cambios para observar los cambios en una colección específica o en todas las colecciones de un clúster o base de datos. Puede abrir un cursor de flujo de cambios en cualquier instancia de Amazon DocumentDB y recuperar documentos del flujo de cambios tanto de las instancias de escritura como de lectura. Puede compartir los tokens de flujo de cambios (por ejemplo, `resumeToken` o `startOperationTime`) entre distintos cursores del flujo de cambios abiertos en una instancia de escritura y lectura. **Ejemplo** ``` import os import sys from pymongo import MongoClient, ReadPreference username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint" client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] # Make sure to use SECONDARY to redirect cursor reads from secondary instances coll = db.get_collection('foo', read_preference=ReadPreference.SECONDARY) # Create a stream object on RO. The token needs to generated from PRIMARY. stream = coll.watch(resumeAfter=token) for event in stream: print(event) ``` **Directrices y limitaciones para los flujos de cambios en las instancias secundarias** + Los eventos del flujo de cambios deben replicarse desde la instancia principal a las instancias secundarias. Puedes controlar el retraso de la `DBInstanceReplicaLag` métrica en Amazon CloudWatch. + Es posible que las marcas de tiempo de las instancias secundarias no estén siempre sincronizadas con las de la instancia principal. En este caso, espere retrasos en la marca de tiempo de la instancia secundaria para que pueda ponerse al día. Es recomendable que utilice `startAtOperationTime` o `resumeToken` para iniciar el reloj en la instancia secundaria. + Es posible que obtenga un rendimiento inferior en las instancias secundarias en comparación con la instancia principal si el tamaño del documento es grande; está haciendo `fullDocumentLookup` y hay una gran carga de trabajo de escritura simultánea en la instancia principal. Como práctica recomendada, le recomendamos que supervise la proporción de aciertos de la caché del búfer en la secundaria y que se asegure de que la tasa de aciertos de la caché del búfer sea alta. # Uso de la intercalación en Amazon DocumentDB 8.0 Amazon DocumentDB 8.0 ahora admite la intercalación. La intercalación le permite configurar reglas específicas del idioma para la comparación de cadenas. Con la intercalación, puede especificar reglas para las comparaciones que distingan mayúsculas de minúsculas o especificar una configuración regional de idioma. La intercalación se puede configurar a nivel de colección o de índice en DocumentDB 8.0. Cuando se utiliza la intercalación en DocumentDB, internamente se crea un documento de intercalación con los siguientes parámetros. ``` { locale: string, caseLevel: boolean, caseFirst: string, strength: int, numericOrdering: boolean, alternate: string, maxVariable: string, backwards: boolean, normalization: boolean } ``` ## Limitaciones La intercalación tiene las siguientes limitaciones en Amazon DocumentDB: + La intercalación es compatible con el planificador v3 disponible en Amazon DocumentDB 8.0. El cambio a plannerv2 o plannerv1 puede provocar comportamientos incoherentes, incluidos errores de tipo «índice no encontrado». + Debido a las diferencias inherentes a las bibliotecas, si se exporta una colección de mongodb con intercalación, tendrá que actualizar los archivos.bson de metadatos y cambiar su versión de 57.1 a 60.2 antes de realizar la migración. + En raras ocasiones, la configuración de intercalación puede superar el límite interno de número de caracteres y provocar el siguiente error. «Error: el documento de intercalación tiene más atributos no predeterminados de los admitidos. Reduzca el número de opciones». En este caso, intente reducir las opciones que proporciona en el documento de cotejo o, si lo prefiere, puede intentar utilizar los valores predeterminados siempre que sea posible. # Uso de vistas en Amazon DocumentDB 8.0 + Amazon DocumentDB 8.0 ahora admite vistas. Las vistas funcionan como colecciones virtuales que presentan datos en función de operaciones de agregación especificadas. Al crear una vista, se define una consulta que transforma los datos de una o más colecciones de fuentes. Amazon DocumentDB 8.0 ejecuta esta consulta cada vez que se accede a la vista, sin consumir recursos de almacenamiento adicionales. A diferencia de las colecciones estándar, las vistas de Amazon DocumentDB 8.0 no almacenan los documentos en disco, lo que las convierte en una solución eficaz para presentar datos transformados o filtrados a las aplicaciones. Para crear una vista en Amazon DocumentDB, puede utilizar el comando CreateView o el método auxiliar db.createView (): ``` db.createView("viewName","sourceCollection", [ { $match: { status: "active" } }, { $project: { _id: 1, name: 1, email: 1 } } ] ) ``` Esto crea una vista denominada «viewName» basada en «SourceCollection» que solo incluye los documentos activos y proyecta únicamente los campos \$1id, name y correo electrónico. Las vistas de Amazon DocumentDB son de solo lectura. Las operaciones de escritura en las vistas devolverán un error. Para obtener un rendimiento óptimo con conjuntos de datos de gran tamaño, puede estructurar sus canalizaciones de visualización para maximizar la eficiencia. Para los procesos de agregación complejos, se recomienda utilizar la etapa \$1match como primera etapa o al principio del proceso para reducir la cantidad de documentos que deben procesarse las etapas posteriores y, de este modo, mejorar el rendimiento de las consultas. ## Prácticas recomendadas A continuación se detallan algunas de las prácticas recomendadas que se deben seguir con Views. + Filtrar anticipadamente: utilice las etapas de \$1match al principio de las canalizaciones de visualización para reducir la cantidad de datos procesados. + Evite las agregaciones complejas: para las vistas con agregaciones complejas a las que se accede con frecuencia, considere la posibilidad de crear una colección independiente con resultados precalculados que se actualicen periódicamente. + Planificación de índices: asegúrese de que los campos utilizados en las canalizaciones de vistas, especialmente en las operaciones \$1match y \$1sort, estén indexados correctamente en la colección de origen. + Optimización de consultas: utilice el comando explain para comprender cómo se ejecutan las consultas de visualización y optimizarlas en consecuencia. + Alternativas para las vistas: dadas las diferencias funcionales entre las vistas de Amazon DocumentDB y MongoDB, considere la posibilidad de utilizar colecciones regulares con actualizaciones programadas como alternativa a las vistas cuando se encuentre con limitaciones. ## Compatibilidad con los operadores de agregadores Amazon DocumentDB admite muchos operadores de agregación en las definiciones de vistas y, al mismo tiempo, sigue ampliando la compatibilidad. Cuando utilice vistas, concéntrese en los siguientes operadores compatibles: + \$1match para filtrar documentos + \$1project para la selección y transformación de campos + \$1addFields para añadir campos calculados + \$1sort para ordenar los resultados + \$1limit y \$1skip para paginación Algunos operadores especializados, como \$1currentOp, \$1replaceRoot y \$1geoNear, actualmente funcionan en consultas de agregación directa en lugar de ver definiciones. ## Aprovechamiento de índices y vistas Las vistas de Amazon DocumentDB 8.0 utilizan los índices de la colección subyacente. Como resultado, no puede crear, eliminar ni reconstruir índices directamente en una vista. Sin embargo, unos índices bien diseñados en la colección fuente pueden mejorar considerablemente el rendimiento de las consultas de visualización. A continuación, se indican algunos pasos para optimizar el rendimiento de las consultas en las vistas: + Asegúrese de que existan los índices adecuados en los campos de la colección fuente utilizados en la canalización de la vista, especialmente en las operaciones \$1match y \$1sort + Utilice el método explain () para analizar los planes de ejecución de las consultas y verificar el uso de los índices. Por ejemplo, `db.viewName.find({...}).explain() ` # Uso de AWS Lambda con flujos de cambios Amazon DocumentDB está integrado con AWS Lambda de modo que pueda utilizar funciones de Lambda para procesar registros en un flujo de cambios. La asignación de orígenes de eventos de Lambda es un recurso que se puede utilizar para invocar funciones de Lambda con el fin de procesar eventos de Amazon DocumentDB que no invocan directamente Lambda. Con el flujo de cambios de Amazon DocumentDB como origen de eventos, puede crear aplicaciones basadas en eventos que respondan a cambios en sus datos. Por ejemplo, puede utilizar funciones de Lambda para procesar documentos nuevos, realizar un seguimiento de actualizaciones de documentos existentes o registrar documentos eliminados. Puede configurar una asignación de orígenes de eventos para enviar registros desde su flujo de cambios de Amazon DocumentDB a una función de Lambda. Los eventos pueden enviarse de uno en uno o por lotes para mejorar la eficiencia y se procesan por orden. Puede configurar el comportamiento de procesamiento de su asignación de orígenes de eventos en función de una duración específica (de 0 a 300 segundos) o del recuento de registros por lotes (límite máximo de 10 000 registros). Puede crear varios mapeos de fuentes de eventos para procesar los mismos datos con distintas funciones de Lambda o para procesar distintos elementos de varios flujos con una sola función. Sin embargo, si la función devuelve un error, Lambda vuelve a intentar ejecutar el lote hasta que se procese correctamente. En caso de que los eventos del flujo de cambios hayan caducado, Lambda deshabilitará la asignación de orígenes de eventos. En este caso, puede crear una nueva asignación de orígenes de eventos y configurarla con la posición inicial que elija. Las asignaciones de orígenes de eventos Lambda procesan los eventos al menos una vez debido a la naturaleza distribuida de los sondeadores. Como resultado, la función de Lambda puede recibir eventos duplicados en situaciones excepcionales. Siga las mejores prácticas al trabajar con funciones AWS Lambda para crear funciones idempotentes para evitar problemas relacionados con eventos duplicados. Para obtener más información, consulte [Uso de AWS Lambda console con Amazon DocumentDB ](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) en la *Guía para desarrolladores de AWS Lambda*. Como práctica recomendada de rendimiento, la función Lambda debe ser de corta duración. Para evitar introducir retrasos innecesarios en el procesamiento, tampoco debe ejecutar una lógica compleja. Para un flujo de alta velocidad en concreto, es mejor desencadenar un flujo de trabajo asíncrono de funciones de posprocesamiento que funciones Lambda sincrónicas de larga duración. Para obtener más información sobre AWS Lambda, consulte [la Guía para desarrolladores de AWS Lambda.](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) ## Limitaciones A continuación, se describen las limitaciones que se deben tener en cuenta al trabajar con Amazon DocumentDB y AWS Lambda: + AWS Lambda solo es compatible actualmente con Amazon DocumentDB 4.0 y 5.0. + AWS Lambda no es compatible actualmente con clústeres elásticos ni clústeres globales. + Los tamaños de carga útil de AWS Lambda no pueden superar los 6 MB. *Para obtener más información sobre los tamaños de los lotes de Lambda, consulte “Comportamiento de procesamiento por lotes” en la sección [Asignación de origen de eventos de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-batching) de la Guía para desarrolladores de AWS Lambda*.