Introducción a Amazon DocumentDB

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.

En la consola de administración de Amazon DocumentDB, en Clústeres, elija Crear.

En la página Crear clúster de Amazon DocumentDB, en la sección Tipo de clúster, elija Clúster basado en instancias (esta es la opción predeterminada).

En la sección Configuración de clúster:

1. En el campo Identificador del clúster, ingrese un nombre único, como mydocdbcluster. Tenga en cuenta que la consola cambiará todos los nombres de los clústeres a minúsculas independientemente de cómo se ingresen.

2. En Versión del motor, elija 5.0.0.

En la sección Configuración del almacenamiento en clúster, elija Amazon DocumentDB estándar (es la opción predeterminada).

Sección de Configuración de instancias:

1. En Clase de instancia de base de datos, elija Clases optimizadas para memoria (incluidas las clases r), que es la opción predeterminada.

   La otra opción de instancia es Clases respaldadas por NVMe. Para obtener más información, consulte Instancias respaldadas por NVMe.

2. En Clase de instancia, elija db.t3.medium. Esto es apto para la prueba gratuita de AWS.

3. En Número de instancias, elija 1 instancia. La elección de una instancia ayuda a minimizar los costos. Si se tratara de un sistema de producción, le recomendamos que aprovisione tres instancias para una alta disponibilidad.

En la sección Conectividad, deje la configuración predeterminada de No conectarse a un recurso de computación de EC2.

En la sección Autenticación, ingrese un nombre de usuario para el usuario principal y, a continuación, elija Autoadministrado. Ingrese una contraseña y, a continuación, confírmela.

Si, en su lugar, eligió Administrado en AWS Secrets Manager, consulte Administración de contraseñas con Amazon DocumentDB y AWS Secrets Manager para obtener más información.

Deje todas las demás opciones en sus valores predeterminados y seleccione Crear clúster.

En la consola de administración de Amazon DocumentDB, en Clústeres, localice el clúster que ha creado. Para elegir el clúster, haga clic en la casilla de verificación situada junto a él.

Haga clic en Conectar 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 regional y las instancias principales se muestra como Disponible. Aparece la pantalla Ejecutar comando de CloudShell.

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.

Cuando vea la petición, introduzca la contraseña que creó en el Paso 1: crear un clúster de Amazon DocumentDB (subpaso 7).

Después de ingresar la contraseña, cuando la petición se convierte en rs0 [direct: primary] <env-name>>, significa que se ha conectado correctamente al clúster de Amazon DocumentDB.

Para insertar un solo documento, escriba lo siguiente:

db.collection.insertOne({"hello":"DocumentDB"})

Obtiene el siguiente resultado:

{
  acknowledged: true,
  insertedId: ObjectId('673657216bdf6258466b128c')
}

Puede leer el documento que escribió con el comando findOne() (ya que solo devuelve un documento). La siguiente entrada:

db.collection.findOne()

Obtiene el siguiente resultado:

{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

Para realizar algunas consultas más, plantéese un caso de uso de perfiles de juegos. Primero, inserte algunas entradas en una colección titulada profiles. La siguiente entrada:

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 }
])

Obtiene el siguiente resultado:

{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } }

Utilice el comando find() para devolver todos los documentos de la colección de perfiles. La siguiente entrada:

db.profiles.find()

Obtendrá un resultado que coincidirá con los datos que escribió en el paso 3.

Utilice una consulta para un único documento mediante un filtro. La siguiente entrada:

db.profiles.find({name: "Katie"})

Obtiene el siguiente resultado:

{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}

Ahora intentemos buscar un perfil y modificarlo con el comando findAndModify. Le daremos al usuario Matt 10 puntos adicionales con el siguiente código:

db.profiles.findAndModify({
        query: { name: "Matt", status: "active"},
        update: { $inc: { score: 10 } }
    })

Se obtiene el siguiente resultado (tenga en cuenta que la puntuación aún no ha aumentado):

{
    [{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}]

Puede comprobar que su puntuación ha cambiado con la siguiente consulta:

db.profiles.find({name: "Matt"})

Obtiene el siguiente resultado:

{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }