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. # Introducción a los clústeres elásticos de Amazon DocumentDB En esta sección de introducción se explica cómo crear y consultar su primer clúster elástico. Existen muchas formas de conectarse a Amazon DocumentDB y empezar a usarlo. El siguiente procedimiento es la forma más rápida, sencilla y fácil de que los usuarios comiencen a utilizar nuestra potente base de datos de documentos. En esta guía se utiliza el [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) para conectarse al clúster de Amazon DocumentDB directamente desde la Consola de administración de AWS y consultarlo. Los nuevos clientes que reúnan los requisitos para la capa AWS gratuita pueden utilizar Amazon DocumentDB de forma CloudShell gratuita. Si su AWS CloudShell entorno o el clúster elástico de Amazon DocumentDB utilizan recursos más allá de la capa gratuita, se le cobrarán AWS las tarifas normales por esos recursos. Esta guía le permitirá empezar a utilizar Amazon DocumentDB en menos de 5 minutos. **Topics** + [Requisitos previos](#elastic-clusters-prerequisites) + [Paso 1: crear un clúster elástico](#elastic-get-started-clusters) + [Paso 2: conectarse a su clúster elástico](#ec-gs-connect) + [Paso 3: hacer una partición de su colección; insertar y consultar los datos](#elastic-get-started-shard) + [Paso 4: Explorar](#ec-gs-congrats) ## Requisitos previos Antes de crear el primer clúster de Amazon DocumentDB, debe hacer lo siguiente: **Creación de una cuenta de Amazon Web Services (AWS)** Para empezar a utilizar Amazon DocumentDB, debe tener una cuenta de Amazon Web Services (AWS). La AWS cuenta es gratuita. Solo se paga por los servicios y los recursos que se utilicen. Si no tiene una Cuenta de AWS, complete los siguientes pasos para crearla. **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). **Configure los permisos AWS Identity and Access Management (IAM) necesarios.** El acceso para gestionar los recursos de Amazon DocumentDB, como clústeres, instancias y grupos de parámetros de clústeres, requiere credenciales que AWS pueda utilizar para autenticar sus solicitudes. Para obtener más información, consulte [Identity and Access Management para Amazon DocumentDB](security-iam.md). 1. En la barra de búsqueda del Consola de administración de AWS, escriba IAM y seleccione **IAM** en el menú desplegable. 1. Cuando esté en la consola de IAM, seleccione **Usuarios** en el panel de navegación. 1. Seleccione su nombre de usuario. 1. Haga clic en **Add Permission (Agregar permiso)**. 1. Seleccione **Adjuntar políticas directamente**. 1. Escriba `AmazonDocDBElasticFullAccess` en la barra de búsqueda y selecciónelo en cuanto aparezca en los resultados de búsqueda. 1. Haga clic en **Next (Siguiente)**. 1. Haga clic en **Add Permission (Agregar permiso)**. **** Su AWS cuenta incluye una VPC predeterminada en cada región. Si decide utilizar una Amazon VPC, complete los pasos del tema [Creación de una Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) en la *Guía del usuario de Amazon VPC*. ## Paso 1: crear un clúster elástico En esta sección, explicamos cómo crear un clúster elástico completamente nuevo, utilizando las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones. ------ #### [ Using the Consola de administración de AWS ] Para crear una configuración de clúster elástico 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 la **consola de administración de Amazon DocumentDB**, en **Clústeres**, elija **Crear**. ![\[Tabla de clústeres elásticos en la que no se muestra ningún clúster como punto de partida.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-start.png) 1. En la página **Crear clúster de Amazon DocumentDB**, en la sección **Tipo de clúster**, elija **Clúster elástico**. ![\[Diálogo de Tipo de clúster de clústeres elásticos que muestra una selección de clústeres basados en instancias y clústeres elásticos.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-type.png) 1. En la sección **Configuración**, configure lo siguiente: 1. En el campo **Nombre del clúster**, introduzca un identificador de clúster único (siguiendo los requisitos de denominación que aparecen debajo del campo). 1. En el campo **Recuento de particiones**, introduzca el número de particiones que desea tener en el clúster. El número máximo de particiones por clúster es 32. **nota** Se implementarán dos nodos para cada partición. Ambos nodos tendrán la misma capacidad de partición. 1. En el campo **Recuento de instancias de partición**, elija el número de instancias de réplica que desee asociar a cada partición. El número máximo de instancias de partición es 16, en incrementos de 1. Todas las instancias de réplica tienen la misma capacidad de partición que se define en el campo siguiente. Para fines de prueba, el valor predeterminado de 2 debería ser suficiente. **nota** El número de instancias de réplica se aplica a todas las particiones del clúster elástico. Un valor de recuento de instancias de particiones igual a 1 significa que hay una instancia de escritura y las instancias adicionales son réplicas que se pueden usar para llevar a cabo lecturas y mejorar la disponibilidad. Para fines de prueba, el valor predeterminado de 2 debería ser suficiente. 1. En el campo **Capacidad del fragmento**, elija el número de elementos virtuales CPUs (vCPUs) que desee asociar a cada instancia del fragmento. La cantidad máxima de v CPUs por instancia de partición es 64. Los valores permitidos son 2, 4, 8, 16, 32, 64. Para fines de prueba, el valor predeterminado de 2 debería ser suficiente. 1. En el campo **Nube privada virtual (VPC)**, elija una VPC de la lista desplegable. 1. Para **las subredes y los** grupos de **seguridad de VPC**, puede usar los valores predeterminados o seleccionar tres subredes de su elección y hasta tres **grupos de seguridad de VPC** (uno como mínimo). ![\[Diálogo de configuración del clúster elástico que muestra los campos configurables.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-configuration.png) 1. En la sección **Autenticación**, ingrese una cadena que identifique el nombre de inicio de sesión del usuario principal en el campo **Nombre de usuario**. En el campo **Contraseña**, introduzca una contraseña única que cumpla con las instrucciones y, a continuación, confírmela. ![\[Sección Autenticación que incluye campos de entrada para el nombre de usuario y la contraseña.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-authentication.png) 1. En la sección **Cifrado**, mantenga la configuración predeterminada (**Clave predeterminada**). Si lo desea, puede introducir un AWS KMS key ARN que haya creado. Para obtener más información, consulte [Activación del cifrado de datos en reposo de un clúster elástico de Amazon DocumentDB](elastic-encryption.md). **importante** El cifrado debe estar habilitado para los clústeres elásticos. 1. En la sección **Copia de seguridad**, edite los campos de acuerdo con los requisitos de copia de seguridad. Para fines de prueba, puede retener la configuración predeterminada. ![\[Captura de pantalla del diálogo de copia de seguridad con los pasos para configurar el período de copia de seguridad del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-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. Elija **Seleccionar periodo** si desea configurar la hora y la duración de la creación de las copias de seguridad. **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. **Duración**: en la lista, elija el número de horas que se deben asignar para crear las copias de seguridad automáticas. 1. Seleccione **Sin preferencia** si desea que Amazon DocumentDB elija la hora y la duración de la creación de las copias de seguridad. 1. En la sección **Mantenimiento**, elija el día, la hora y la duración en que se aplicarán las modificaciones o los parches al clúster. Para fines de prueba, puede retener la configuración predeterminada. ![\[Sección Mantenimiento en la que se muestran las opciones del período de mantenimiento.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-maintenance.png) 1. Elija **Create cluster**. El clúster elástico se está aprovisionando ahora. Esto puede tardar unos minutos en terminar. Puede conectarse a su clúster cuando el estado del clúster elástico aparezca como **Disponible** en la lista de **Clústeres**. ------ #### [ Using the AWS CLI ] Para crear un clúster elástico mediante AWS CLI, utilice la `create-cluster` operación con los siguientes parámetros: + **--cluster-name**: obligatorio. El nombre actual del clúster de escala elástica tal como se ingresó durante la creación o se modificó por última vez. + **--shard-capacity**: obligatorio. El número de v CPUs asignado a cada fragmento. El máximo es 64. Los valores permitidos son 2, 4, 8, 16, 32, 64. + **--shard-count**: obligatorio. La cantidad de particiones asignadas al clúster. El máximo es 32. + **--shard-instance-count**: opcional. El número de instancias de réplica que se aplican a todos los fragmentos de este clúster. El máximo es 16. + **--admin-user-name**: obligatorio. Nombre del usuario asociado al usuario administrador. + **--admin-user-password**: obligatorio. La contraseña asociada al usuario administrador. + **--auth-type**: obligatorio. El tipo de autenticación utilizado para determinar dónde buscar la contraseña que se usa para acceder al clúster elástico. Los tipos válidos son `PLAIN_TEXT` o `SECRET_ARN`. + **--vpc-security-group-ids**: opcional. Configure una lista de grupos de seguridad de la VPC de EC2 para asociar a este clúster. + **--preferred-maintenance-window**: opcional. Configure el tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en tiempo universal coordinado (UTC). El formato es: `ddd:hh24:mi-ddd:hh24:mi`. Días válidos: lunes, martes, miércoles, jueves, viernes, sábado, domingo El valor predeterminado es un periodo de 30 minutos seleccionado al azar de un bloque de 8 horas de tiempo para cada región de Amazon Web Services, que tiene lugar un día de la semana de forma aleatoria. El plazo mínimo es 30 minutos. + **--kms-key-id**: opcional. Configure el identificador de la clave de KMS de un clúster cifrado. El identificador de clave de KMS es el nombre de recurso de Amazon (ARN) de la clave de AWS KMS cifrado. Si está creando un clúster con la misma cuenta de Amazon Web Services a la que pertenece la clave de cifrado de KMS utilizada para cifrar el clúster nuevo, puede utilizar el alias de la clave de KMS en lugar del ARN para la clave de cifrado de KMS. Si no se especifica ninguna clave de cifrado KmsKeyId y el `StorageEncrypted` parámetro es verdadero, Amazon DocumentDB utiliza la clave de cifrado predeterminada. + **--preferred-backup-window**: opcional. El intervalo de tiempo diario preferido durante el que se crean las copias de seguridad automatizadas. El valor predeterminado es un período de 30 minutos seleccionado al azar de un bloque de tiempo de 8 horas para cada uno. Región de AWS + **--backup-retention-period**: opcional. El número de días durante los que se retienen las copias de seguridad automatizadas. El valor predeterminado es 1. + **--storage-encrypted**: opcional. Configura si el clúster está cifrado o no. `--no-storage-encrypted` especifica que el clúster no está cifrado. + **--subnet-ids**: opcional. Configure los identificadores de subred de la red. Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información. **nota** Los siguientes ejemplos incluyen la creación de una clave KMS específica. Para usar la clave KMS predeterminada, no incluya el `--kms-key-id` parámetro. Para Linux, macOS o Unix: ``` aws docdb-elastic create-cluster \ --cluster-name sample-cluster-123 \ --shard-capacity 8 \ --shard-count 4 \ --shard-instance-count 3 \ --auth-type PLAIN_TEXT \ --admin-user-name testadmin \ --admin-user-password testPassword \ --vpc-security-group-ids ec-65f40350 \ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7 ``` Para Windows: ``` aws docdb-elastic create-cluster ^ --cluster-name sample-cluster-123 ^ --shard-capacity 8 ^ --shard-count 4 ^ --shard-instance-count 3 ^ --auth-type PLAIN_TEXT ^ --admin-user-name testadmin ^ --admin-user-password testPassword ^ --vpc-security-group-ids ec-65f40350 ^ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7 ``` ------ ## Paso 2: conectarse a su clúster elástico Conéctese a su clúster elástico de Amazon DocumentDB mediante. AWS CloudShell 1. En la consola de administración de Amazon DocumentDB, en **Clústeres**, localice el clúster elástico que ha creado. Para elegir el clúster, haga clic en la casilla de verificación situada junto a él. ![\[Interfaz de administración de clústeres de Amazon DocumentDB en la que se muestra un clúster elástico.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-cluster-new.png) 1. Haga clic en **Conectarse al clúster** (que se encuentra junto al menú desplegable **Acciones**). Este botón se activa solamente después de haber hecho clic en la casilla de verificación situada junto al clúster y el estado del clúster se muestra como **Disponible**. Aparece la pantalla de **comandos CloudShell Ejecutar**. 1. En el campo **Nombre del nuevo entorno**, ingrese un nombre único, como «prueba» y elija **Crear y ejecutar**. Los detalles del entorno de la VPC se configuran automáticamente para la base de datos de Amazon DocumentDB. ![\[Pantalla de comandos de Elastic Cluster: CloudShell ejecuta una solicitud para el nuevo nombre del entorno\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-run-command.png) 1. Cuando vea la petición, introduzca la contraseña que creó en el Paso 1: crear un clúster elástico de Amazon DocumentDB (subpaso 5). ![\[CloudShell Pantalla de clúster elástico que solicita la contraseña de usuario\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/ec-gs-cs-password.png) Después de ingresar la contraseña y de que la petición se convierte en `direct: mongos] >`, significa que se ha conectado correctamente al clúster de Amazon DocumentDB. **nota** Para obtener información sobre la solución de problemas, consulte [Solución de problemas de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html). ## Paso 3: hacer una partición de su colección; insertar y consultar los datos Los clústeres elásticos aportan compatibilidad para crear particiones en Amazon DocumentDB. Ahora que está conectado a su clúster, puede hacer particiones, insertar datos y ejecutar algunas consultas. 1. Para hacer particiones en una colección, escriba lo siguiente: ``` sh.shardCollection("db.Employee1" , { "Employeeid" : "hashed" }) ``` 1. Para insertar un solo documento, escriba lo siguiente: ``` db.Employee1.insertOne({"Employeeid":1, "Name":"Joe", "LastName": "Bruin", "level": 1 }) ``` Se muestra lo siguiente: ``` WriteResult({ "nInserted" : 1 }) ``` 1. Para leer el documento que escribió, introduzca el comando `findOne()` (devuelve un único documento): ``` db.Employee1.findOne() ``` Se muestra lo siguiente: ``` { "_id" : ObjectId("61f344e0594fe1a1685a8151"), "EmployeeID" : 1, "Name" : "Joe", "LastName" : "Bruin", "level" : 1 } ``` 1. Para realizar algunas consultas más, plantéese un caso de uso de perfil de juegos. Primero, inserte algunas entradas en una colección titulada “Empleado”. Introduzca lo siguiente: ``` db.profiles.insertMany([ { "_id": 1, "name": "Matt", "status": "active", "level": 12, "score": 202 }, { "_id": 2, "name": "Frank", "status": "inactive", "level": 2, "score": 9 }, { "_id": 3, "name": "Karen", "status": "active", "level": 7, "score": 87 }, { "_id": 4, "name": "Katie", "status": "active", "level": 3, "score": 27 } ]) ``` Se muestra lo siguiente: ``` { acknowledged: true, insertedIds: { '0': ObjectId('679d02cd6b5a0581be78bcbd'), '1': ObjectId('679d02cd6b5a0581be78bcbe'), '2': ObjectId('679d02cd6b5a0581be78bcbf'), '3': ObjectId('679d02cd6b5a0581be78bcc0') } } ``` 1. Para devolver todos los documentos de la colección de perfiles, introduzca el comando `find` (): ``` db.Employee.find() ``` Se muestran los datos que ingresó en el paso 4. 1. Para consultar un solo documento, incluya un filtro (por ejemplo: “Katie”). Introduzca lo siguiente: ``` db.Employee.find({name: "Katie"}) ``` Se muestra lo siguiente: ``` [
 {
 _id: ObjectId('679d02cd6b5a0581be78bcc0'),
 Employeeid: 4,
 name: 'Katie',
 lastname: 'Schaper',
 level: 3
 }
 ] ``` 1. Para buscar un perfil y modificarlo, introduzca el comando `findAndModify`. En este ejemplo, al empleado “Matt” se le asigna un nivel superior de “14”: ``` db.Employee.findAndModify({ query: { "Employeeid" : 1, "name" : "Matt"}, update: { "Employeeid" : 1, "name" : "Matt", "lastname" : "Winkle", "level" : 14 } }) ``` Aparece el siguiente resultado (tenga en cuenta que el nivel no ha cambiado todavía): ``` {
 _id: ObjectId('679d02cd6b5a0581be78bcbd'),
 Employeeid: 1,
 name: 'Matt',
 lastname: 'Winkle',
 level: 12
 } ``` 1. Para verificar el aumento de nivel, introduzca la siguiente consulte: ``` db.Employee.find({name: "Matt"}) ``` Se muestra lo siguiente: ``` [ {
 _id: ObjectId('679d02cd6b5a0581be78bcbd'),
 Employeeid: 1,
 name: 'Matt',
 lastname: 'Winkle',
 level: 14
 } ] ``` ## Paso 4: Explorar ¡Enhorabuena\$1 Ha completado correctamente el procedimiento de introducción a los clústeres elásticos de Amazon DocumentDB. Pasos siguientes Descubra cómo aprovechar al máximo esta base de datos con algunas de sus características más populares: + [Prácticas recomendadas para los clústeres elásticos de Amazon DocumentDB](elastic-best-practices.md) + [Administración de los clústeres elásticos de Amazon DocumentDB](elastic-managing.md) **nota** El clúster elástico que creó a partir de este procedimiento de introducción seguirá acumulando costos a menos que lo elimine. Para obtener instrucciones, consulte [Eliminación de un clúster elástico](elastic-managing.md#elastic-delete).