Introducción a Amazon DocumentDB

Desde allí, AWS Management Console navegue hasta la AWS Cloud9 consola y elija Crear entorno.

En la sección Detalles del cuadro de diálogo Crear entorno, introduzca DocumentDBCloud9 en el campo Nombre.

Para las secciones Nueva instancia de EC2, Configuración de red y Etiquetas, deje la configuración predeterminada tal y como está y haga clic en Crear en la parte inferior de la pantalla.

En la Consola de administración de Amazon EC2, en Red y seguridad, elija Grupos de seguridad.

Elija Crear grupo de seguridad.

En la sección de detalles básicos:

1. En Nombre del grupo de seguridad, introduzca demoDocDB.

2. En Descripción, escriba una descripción.

3. En VPC, acepte el uso de la VPC predeterminada.

En la sección Inbound rules (Reglas de entrada), elija Add rule (agregar regla).

1. En Tipo, elija Regla TCP personalizada.

2. En Rango de puertos, escriba 27017.

3. En Source, elija el grupo de seguridad para el AWS Cloud9 entorno que acaba de crear. Para ver una lista de los grupos de seguridad disponibles, escriba cloud9 en el campo de búsqueda a la derecha del campo Origen. Elija el grupo de seguridad con el nombre aws-cloud9-<environment name>.

4. En Destino, elija Personalizado. En el campo contiguo, busque el grupo de seguridad al que acaba de llamar demoEC2. Es posible que tenga que actualizar el navegador para que la consola Amazon EC2 complete automáticamente el nombre de la fuente demoEC2.

Acepte todos los demás valores predeterminados y elija Crear grupo de seguridad.

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ústeres basados en instancias (esta es la opción predeterminada).

En la sección Configuración, elija la instancia 1. 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. Puede dejar los demás ajustes de la sección de Configuración con sus valores predeterminados.

En Conectividad, deje la configuración predeterminada de No conectarse a un recurso informático de EC2.

En la sección Autenticación, introduzca las credenciales de inicio de sesión.

Active Mostrar configuración avanzada.

En la sección Configuración de red, en Grupos de seguridad de VPC, elija demoDocDB (VPC) si va a crear un clúster de prueba o demostración. Si va a crear un clúster para un sistema de producción, elija VPC predeterminada o, si quiere crear un grupo de seguridad de VPC específico, consulte Grupos de seguridad en la Guía del usuario de Amazon Virtual Private Cloud.

Elija Create cluster.

Si su AWS Cloud9 entorno sigue abierto desde el paso 1, vuelva a ese entorno y vaya directamente a la instrucción 3. Si ha navegado fuera de su AWS Cloud9 entorno, en la consola de AWS Cloud9 administración, en Entornos, busque el entorno denominado DocumentDBCloud9. Elija Abrir en la columna IDE de Cloud9.

En el símbolo del sistema, cree el archivo de repositorio con el siguiente comando:

echo -e "[mongodb-org-4.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/4.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-4.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-4.0.repo

Cuando esté completo, instale el intérprete de comandos mongo con el siguiente comando:

sudo yum install -y mongodb-org-shell

En la consola de administración de Amazon DocumentDB, en Clústeres, localice su clúster. Elija el clúster que creó haciendo clic en el identificador del clúster.

E ncryption-in-transit está habilitada de forma predeterminada en Amazon DocumentDB. Si lo desea, puede deshabilitar el TLS. Para descargar el certificado actual necesario para autenticarse en el clúster, en la pestaña Conectividad y seguridad de la sección Conectar, en Descargar el certificado de la Autoridad de certificación (CA) de Amazon DocumentDB necesario para autenticarse en el clúster, copie la cadena de conexión proporcionada. Regrese a su AWS Cloud9 entorno y pegue la cadena de conexión.

Regrese a su clúster en la consola de Amazon DocumentDB, en la pestaña Conectividad y seguridad, en la sección Conectar, en Conectarse a este clúster con el intérprete de comandos mongo, copie la cadena de conexión proporcionada. Omita copiar <insertYourPassword> para que el intérprete de comandos mongo le pida la contraseña cuando se conecte.

Regrese a su AWS Cloud9 entorno y pegue la cadena de conexión.

Para insertar un solo documento, escriba lo siguiente:

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

Obtiene el siguiente resultado:

WriteResult({ "nInserted" : 1 })

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" : [ 1, 2, 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 5.

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

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

Debería recibir este 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 diez 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 }