View a markdown version of this page

Introducción a Amazon DocumentDB - Amazon DocumentDB
Requisitos previosPaso 1: creación de un clústerPaso 2: Conéctese a su clústerPaso 3: Insertar y consultar datosPaso 4: Explora

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 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. En esta guía se utiliza el AWS CloudShell 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 clúster de Amazon DocumentDB utilizan recursos que superan 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 cinco minutos.

nota

Las instrucciones de esta guía son específicas para crear y conectarse a clústeres basados en instancias de Amazon DocumentDB donde Amazon DocumentDB y Amazon DocumentDB estén disponibles. AWS CloudShell

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 suscribirse a una Cuenta de AWS

  1. Abra https://portal.aws.amazon.com/billing/signup.

  2. 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 una Cuenta de AWS, Usuario raíz de la cuenta de AWSse crea una. 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.

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.

  1. En la barra de búsqueda Consola de administración de AWS, escriba IAM y seleccione IAM en el menú desplegable que aparece.

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

  3. Seleccione su nombre de usuario.

  4. Elija Añadir permisos.

  5. Seleccione Adjuntar políticas directamente.

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

  7. Elija Siguiente.

  8. Elija Añadir permisos.

nota

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 en la Guía del usuario de Amazon VPC.

Paso 1: creación de un clúster

En este paso creará 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

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

    Panel de clústeres vacío con opciones para crear un nuevo clúster y administrar los recursos.

  3. En la página Crear clúster de Amazon DocumentDB, en la sección Tipo de clúster, elija Instance-based clúster (esta es la opción predeterminada).

    Selección del tipo de clúster con la opción Clúster basado en instancias resaltada y ambos tipos de clústeres descritos.
    nota

    La otra opción de esta categoría es el clúster elástico. Para obtener más información sobre los clústeres elásticos de Amazon DocumentDB, consulte Uso de Amazon DocumentDB Elastic Clusters.

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

    Formulario de configuración para un clúster de base de datos con campos para el identificador y la versión del motor.

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

    Selección del tipo de almacenamiento con la opción Amazon DocumentDB estándar resaltada y ambos tipos de almacenamiento descritos.
    nota

    La otra opción de esta categoría es Amazon DocumentDB I/O-Optimized. Para obtener más información sobre las opciones, consulte Configuraciones de almacenamiento en clústeres de Amazon DocumentDB.

  6. 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 son NVMe-backed las clases. Para obtener más información, consulte NVMe-backed instancias.

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

    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.

    Formulario de configuración para una instancia de base de datos con campos para la clase de instancia de base de datos, la clase de instancia compatible y el número de instancias.

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

    Configuración de conectividad para la base de datos con opciones para conectarse o no conectarse a un recurso de computación de EC2.

  8. 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 lugar de eso, 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.

    Selección del tipo de autenticación con la AWS Secrets Manager opción Administrado en resaltada y ambos tipos de autenticación descritos.

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

Amazon DocumentDB está aprovisionando su clúster, lo que puede tardar unos minutos en terminar.

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.

Paso 2: Conéctese a su clúster

Conéctese a su clúster de Amazon DocumentDB mediante. AWS CloudShell

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

    Interfaz de administración de clústeres de Amazon DocumentDB en la que se muestra un clúster regional con detalles de la instancia principal.

  2. Selecciona 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 de comandos CloudShell Ejecutar.

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

    Clúster de clústeres: CloudShell ejecute la pantalla de comandos solicitando un nuevo nombre de entorno

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

    CloudShell Pantalla de clúster que solicita la contraseña de usuario

    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.

nota

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

Paso 3: Insertar y consultar 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.insertOne({"hello":"DocumentDB"})

    Obtiene el siguiente resultado:

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

  2. 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" }

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

  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.

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

  6. 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}]

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

Paso 4: Explora

¡Enhorabuena! Ha completado correctamente la Guía de introducción a clústeres basados en instancias 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:

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.