Comience a utilizar Amazon DocumentDB

Existen muchas formas de conectarse a Amazon DocumentDB y empezar a usarlo. Creamos esta guía porque nos pareció que era la forma más rápida, sencilla y fácil de que los usuarios comenzaran a utilizar nuestra potente base de datos de documentos. Esta guía utiliza Amazon Elastic Compute Cloud (AmazonEC2) para conectar y consultar su clúster de Amazon DocumentDB directamente desde. AWS Management Console Los nuevos clientes que reúnan los requisitos para la capa AWS gratuita pueden utilizar Amazon DocumentDB y Amazon de forma EC2 gratuita. Si su EC2 entorno de Amazon o su clúster de Amazon DocumentDB utilizan recursos que van más allá de la capa gratuita, se le cobrarán las AWS tarifas normales por esos recursos. Esta guía le permitirá empezar a utilizar Amazon DocumentDB en menos de 15 minutos.

nota

Las instrucciones de esta guía son específicas para crear clústeres basados en instancias de Amazon DocumentDB y conectarse a ellos. Si desea crear clústeres elásticos de Amazon DocumentDB y conectarse a ellos, consulte Introducción a los clústeres elásticos de Amazon DocumentDB.

Si prefiere conectarse a su Amazon DocumentDB desde su máquina local mediante la creación de una SSH conexión a una EC2 instancia de Amazon, consulte Connect mediante Amazon EC2

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.

2. Siga las instrucciones que se le indiquen.

   Parte del procedimiento de registro consiste en recibir una llamada telefónica 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 AWSse 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.

Configura 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.

1. En la barra de búsqueda del AWS Management Console, escriba IAM y seleccione IAMen el menú desplegable que aparece.

2. Cuando estés en la IAM consola, selecciona Usuarios en el panel de navegación.

3. Seleccione su nombre de usuario.

4. Haga clic en el botón Añadir permisos.

5. Seleccione Asociar directamente las políticas existentes.

6. Escriba AmazonDocDBFullAccess en la barra de búsqueda y selecciónelo en cuanto aparezca en los resultados de búsqueda.

7. Haga clic en el botón azul de la parte inferior que dice Siguiente: Revisión.

8. Haga clic en el botón azul de la parte inferior que dice Añadir permisos.

Creación de una Amazon Virtual Private Cloud (AmazonVPC)

Su AWS cuenta incluye un valor predeterminado VPC en cada región. Este paso solo es necesario si eliges usar un Amazon predeterminadoVPC. En este caso, complete los pasos del VPC tema Crear un Amazon de la Guía del VPC usuario de Amazon.

Lanza una EC2 instancia de Amazon

Complete los pasos 1 y 2 del EC2 tema Comenzar con Amazon de la Guía del usuario de Amazon Elastic Compute Cloud.

Paso 1: Crear un clúster de Amazon DocumentDB

En este paso, creará un clúster de Amazon DocumentDB.

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

   

2. 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).

   

3. En la sección Configuración:

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

   2. Para la versión Engine, elija 5.0.0.

   3. Para la clase de instancia, elija db.t3.medium. Esto es apto para la capa gratuita. AWS

   4. En Número de instancias, selecciona 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.

   

4. En la sección Configuración de almacenamiento en clústeres, elija Amazon DocumentDB Standard (esta es la opción predeterminada).

5. En la sección Conectividad:

   1. Seleccione Conectarse a un recurso EC2 informático.

   2. En EC2Instance, selecciona la EC2 instancia en la que la creasteRequisitos previos.

   

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

   

7. Deje todas las demás opciones como predeterminadas y elija Crear clúster.

nota

Al configurar una conexión entre una EC2 instancia y una base de datos de Amazon DocumentDB, Amazon DocumentDB configura automáticamente el grupo de seguridad de la instancia y de VPC la base de EC2 datos de Amazon DocumentDB. Para obtener más información, consulte Descripción general de la conectividad automática con una EC2 instancia.

Amazon DocumentDB está aprovisionando su clúster, lo que puede tardar unos minutos en terminar. Puede conectarse a su clúster cuando el estado del clúster y de la instancia muestre que están disponibles.

nota

Para obtener información sobre los valores de estado de los clústeres, consulte Valores de estado del clúster en el capítulo Cómo monitorizar Amazon DocumentDB.

Para obtener información sobre los valores de estado de las instancias, consulte Valores de estado de instancia en el capítulo Cómo monitorizar Amazon DocumentDB.

Paso 2: Instala el shell mongo

Instala el shell mongo en la EC2 instancia de Amazon en Requisitos previos la que creaste. El intérprete de comandos de mongo es una utilidad de línea de comandos que se utiliza para conectarse al clúster de Amazon DocumentDB y consultarlo.

Conéctate a tu EC2 instancia de Amazon y, en la línea de comandos, crea el archivo de repositorio con el siguiente comando:

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

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

sudo yum install -y mongodb-org-shell

Paso 3: Conéctese a su clúster de Amazon DocumentDB

Conéctese a su clúster de Amazon DocumentDB mediante el shell mongo que instaló en el paso 2.

1. 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.

   

2. Encryption-in-transit está habilitada de forma predeterminada en Amazon DocumentDB. Si lo desea, puede deshabilitarloTLS. Para descargar el certificado actual necesario para autenticarse en su clúster, en la pestaña Conectividad y seguridad, en la sección Conectar, en Descargar el certificado de la autoridad de certificación (CA) de Amazon DocumentDB necesario para autenticarse en su clúster, copie el comando proporcionado. Vuelve a tu EC2 instancia de Amazon y pega el comando.

   

3. 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.

   

   Vuelve a tu EC2 instancia de Amazon y pega la cadena de conexión.

Cuando introduzca su contraseña y aparezca el mensajers0:PRIMARY>, estará conectado correctamente a su clúster de Amazon DocumentDB.

nota

Para obtener información sobre la solución de problemas, consulte Solución de problemas de Amazon DocumentDB.

Paso 4: Inserte y consulte los datos

Ahora que está conectado a su clúster, puede realizar algunas consultas para familiarizarse con el uso de una base de datos de documentos.

1. Para insertar un solo documento, escriba lo siguiente:

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

2. Obtiene el siguiente resultado:

   WriteResult({ "nInserted" : 1 })

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

   db.collection.findOne()

4. Obtiene el siguiente resultado:

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

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

6. Obtiene el siguiente resultado:

   { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

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

   db.profiles.find()

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

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

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

10. Debería recibir este resultado:

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

11. 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 } }
                })

12. 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
    }

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

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

14. Obtiene el siguiente resultado:

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

Paso 5: Explorar

¡Enhorabuena! Ha completado correctamente la Guía de introducción a Amazon DocumentDB.

Pasos siguientes Descubra cómo aprovechar al máximo esta base de datos con algunas de sus características más populares:

• Administración de Amazon DocumentDB

• Escalado

• Copia de seguridad y restauración

nota

El clúster que creó a partir de este ejercicio de introducción seguirá acumulando costos a menos que lo elimine. Para obtener instrucciones, consulte Cómo eliminar un clúster de Amazon DocumentDB.