Inicio rápido: Creación de un clúster de Azure DocumentDB mediante Azure Portal

En este inicio rápido, creará un nuevo clúster de Azure DocumentDB. Este clúster contiene todos los recursos típicos de MongoDB: bases de datos, colecciones y documentos. El clúster proporciona un punto de conexión único para que varias herramientas y controladores se conecten a Azure DocumentDB y realicen operaciones diarias.

Prerrequisitos

• Una suscripción de Azure

  • Si no tiene ninguna suscripción a Azure, cree una cuenta gratuita

Crear un clúster

Para empezar, primero debe crear un clúster de Azure DocumentDB, que sirve como base para almacenar y administrar los datos NoSQL.

1. Inicie sesión en Azure Portal (https://portal.azure.com).

2. En el menú de Azure Portal o en la página principal, seleccione Crear un recurso.

3. En la página Nuevo , busque y seleccione Azure DocumentDB.

   

4. En la página Crear clúster de Azure DocumentDB y, en la sección Aspectos básicos , seleccione la opción Configurar en la sección Nivel de clúster.

   

5. En la página Escala , configure estas opciones y seleccione Guardar para conservar los cambios en el nivel de clúster.

   	Importancia
   Nivel de clúster	M30 tier, 2 vCore, 8-GiB RAM
   Almacenamiento por partición	128 GiB

   

6. De nuevo en la sección Aspectos básicos , configure las siguientes opciones:

   	Importancia
   Subscription	Seleccione su suscripción a Azure.
   Grupo de recursos	Cree un grupo de recursos nuevo o seleccione uno existente
   Nombre del clúster	Proporcione un nombre único global.
   Ubicación	Seleccione una región de Azure compatible para su suscripción
   Versión de MongoDB	Seleccionar 8.0
   Nombre de usuario administrador	Creación de un nombre de usuario para acceder al clúster como administrador de usuarios
   Contraseña	Uso de una contraseña única asociada al nombre de usuario

   

   Sugerencia

   Registre los valores que usa para el nombre de usuario y la contraseña. Estos valores se usan más adelante en esta guía. Para más información sobre los valores válidos, consulte Limitaciones del clúster.

7. Seleccione Siguiente: Redes.

8. En la sección Reglas de firewall de la pestaña Redes , configure estas opciones:

   	Importancia
   Método de conectividad	Public access
   Permitir el acceso público desde servicios y recursos de Azure a este clúster	Enabled

9. Agregue una regla de firewall para el dispositivo cliente actual para conceder acceso al clúster seleccionando + Agregar dirección IP del cliente actual.

   

   Sugerencia

   En muchos entornos corporativos, las direcciones IP de la máquina del desarrollador se ocultan debido a una VPN u otra configuración de red corporativa. En estos casos, puede permitir temporalmente el acceso a todas las direcciones IP agregando el 0.0.0.0 - 255.255.255.255 intervalo de direcciones IP como regla de firewall. Use esta regla de firewall solo temporalmente como parte de las pruebas de conexión y el desarrollo.

10. Selecciona Revisar + crear.

11. Revise la configuración que proporcione y, a continuación, seleccione Crear. La operación de creación del clúster tarda unos minutos. Espere a que se complete la implementación de recursos.

12. Por último, seleccione Ir al recurso para ir al clúster de Azure DocumentDB en el portal.

Obtener credenciales del clúster

Obtenga las credenciales que usa para conectarse al clúster.

1. En la página del clúster, seleccione la opción Cadenas de conexión en el menú de recursos.

2. En la sección Cadenas de conexión , copie o registre el valor del campo Cadena de conexión .

Importante

La cadena de conexión del portal no incluye el valor de contraseña. Debe reemplazar el marcador de posición <password> por los datos de acceso que introdujo al crear el clúster o ingresar la contraseña de manera interactiva.

Conexión mediante el shell de MongoDB desde el inicio rápido

Para conectarse directamente a Azure DocumentDB mediante el shell de MongoDB, use la experiencia de inicio rápido disponible en la página del recurso en Azure Portal.

1. En la página de recursos del clúster, seleccione Inicio rápido (versión preliminar) en el menú de navegación.

2. A continuación, seleccione Abrir shell de MongoDB.

3. Espere a que se inicie el entorno de Shell de MongoDB.

4. Una vez que el entorno esté listo, escriba Y para aceptar el aviso.

   Nota:

   Si tiene un problema al conectarse mediante el shell de MongoDB después de aceptar el aviso, asegúrese de que Azure Cloud Shell tiene acceso al clúster.

5. Ahora, escriba la contraseña para conectar el clúster a Cloud Shell.

Realización de consultas de prueba

Compruebe que se ha conectado correctamente al clúster realizando una serie de comandos y consultas de prueba.

1. Para comprobar el estado de la conexión, ejecute el connectionStatus comando .

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. Enumere las bases de datos del clúster.

   show dbs
   

3. Cambie a una base de datos específica. Reemplace el <database-name> marcador de posición por el nombre de cualquier base de datos del clúster.

   use <database-name>
   

   Sugerencia

   Por ejemplo, si el nombre de la base de datos es inventory, el comando sería use inventory.

4. Enumere las colecciones dentro de la base de datos.

   show collections
   

5. Busque los cinco primeros elementos dentro de una colección específica. Reemplace el <collection-name> marcador de posición por el nombre de cualquier colección del clúster.

   db.<collection-name>.find().limit(5)
   

   Sugerencia

   Por ejemplo, si el nombre de la colección es equipment, el comando sería db.equipment.find().limit(5).

Limpieza de recursos

Cuando haya terminado con el clúster de Azure DocumentDB, puede eliminar los recursos de Azure que creó para que no incurra en más cargos.

1. En la barra de búsqueda de Azure Portal, busque y seleccione Grupos de recursos.

   

2. En la lista, seleccione el grupo de recursos que usó para este inicio rápido.

   

3. En la página del grupo de recursos, seleccione Eliminar grupo de recursos.

4. En el cuadro de diálogo de confirmación de eliminación, escriba el nombre del grupo de recursos para confirmar que desea eliminarlo. Por último, seleccione Eliminar para eliminar de forma permanente el grupo de recursos.

   

Contenido relacionado

• Conexión desde el shell de MongoDB
• Conexión desde Azure Cloud Shell
• Migración de datos a Azure DocumentDB