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. 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.
Temas
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 Conectarse 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 suscribirse a una Cuenta de AWS
Abrir https://portal.aws.amazon.com/billing/registro
. 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.
-
En la barra de búsqueda del AWS Management Console, escriba IAM y seleccione IAMen el menú desplegable que aparece.
-
Cuando estés en la IAM consola, selecciona Usuarios en el panel de navegación.
-
Seleccione su nombre de usuario.
-
Haga clic en el botón Añadir permisos.
-
Seleccione Asociar directamente las políticas existentes.
-
Escriba
AmazonDocDBFullAccess
en la barra de búsqueda y selecciónelo en cuanto aparezca en los resultados de búsqueda. -
Haga clic en el botón azul de la parte inferior que dice Siguiente: Revisión.
-
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: creación de un clúster de Amazon DocumentDB
En este paso creará un clúster de Amazon DocumentDB.
-
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:
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.En Versión del motor, elija 5.0.0.
En Clase de instancia, elija db.t3.medium. Esto es apto para la capa AWS gratuita.
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 Configuración del almacenamiento en clúster, elija Amazon DocumentDB estándar (es la opción predeterminada).
-
En la sección Conectividad:
Seleccione Conectarse a un recurso EC2 informático.
En EC2Instance, selecciona la EC2 instancia en la que la creasteRequisitos previos.
-
En la sección Autenticación, introduzca un nombre de usuario para el usuario principal y, a continuación, elija una contraseña AWS gestionada o una contraseña autogestionada.
Si elige la opción AWS Secrets Manager, configure la KMS clave creando la suya propia o utilizando una clave que cree Secrets Manager.
Si decide administrar automáticamente la contraseña del usuario principal, introdúzcala y, a continuación, confírmela.
-
Deje todas las demás opciones en sus valores predeterminados y seleccione 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 instancia de EC2.
Amazon DocumentDB está aprovisionando su clúster, lo que puede tardar unos minutos en terminar. Puede conectarse a su clúster cuando tanto el estado del clúster como de la instancia sea disponible.
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: instalación del intérprete de comandos de 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: conexión al clúster de Amazon DocumentDB
Conéctese al clúster de Amazon DocumentDB mediante el intérprete de comandos de mongo que instaló en el paso 2.
-
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.
-
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 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 el comando proporcionado. Vuelve a tu EC2 instancia de Amazon y pega el comando.
-
Vuelva a su clúster en la consola de Amazon DocumentDB, en la pestaña Conectividad y seguridad, en la sección Conectar y, en Conectarse a este clúster con el shell 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 ingresa la contraseña y el aviso se convierte en rs0:PRIMARY>
, 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 4: inserción y consulta de 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.
-
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 }
Paso 5: exploración
¡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:
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.