Uso de Visual Studio Code para conectarse y consultar instancias de Azure Cosmos DB

SE APLICA A: NoSQL MongoDB

Visual Studio Code es un editor de código versátil para Linux, macOS y Windows, que admite numerosas extensiones. En este inicio rápido se muestra cómo conectarse a un clúster de Azure Cosmos DB for NoSQL y Azure Cosmos DB for MongoDB (núcleo virtual) mediante Visual Studio Code. Abarca la realización de operaciones básicas de base de datos, como la consulta, la inserción, la actualización y la eliminación de datos.

Requisitos previos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

• Una cuenta de Azure Cosmos DB configurada con una base de datos y una colección para NoSQL API. Use cualquiera de estos inicios rápidos siguientes para configurar un recurso:

  • Portal
  • CLI de Azure

• Para conectarse y administrar datos en Azure Cosmos DB en Visual Studio, instale primero la extensión Azure Databases.

  1. Abra Visual Studio Code.
  2. Para acceder al panelExtensiones, seleccione Ver > extensiones o use el método abreviado Ctrl + Mayús + X en Windows y Comando + Mayús + X en MacOS.
  3. En la barra de búsqueda, escriba Extensión Azure Databases y seleccione la extensión. Luego haga clic en Instalar.
  4. Después de la instalación, vuelva a cargar Visual Studio Code si se le solicita.

Conexión a una instancia de Azure Cosmos DB for NoSQL

1. En Visual Studio Code, vaya al panel de Azure (seleccione el icono deAzure en la barra de actividades).
2. Inicie sesión en su cuenta de Azure a través de Entra ID: Nota: Se recomienda usar siempre RBAC de Microsoft Entra ID al acceder a los recursos de Azure Cosmos DB (en lugar de las claves de cuenta) para el método de autenticación más seguro.
3. Una vez que haya iniciado sesión, en la vista de árbol de Azure, busque la suscripción de Azure y profundice en Azure Cosmos DB.
4. Seleccione una cuenta existente o haga clic con el botón derecho para crear un nuevo recurso.

Consulta y visualización de los datos

Los pasos siguientes usarán el editor de Power Query para ejecutar una consulta y ver los resultados de la consulta:

1. En el menú de la colección, haga clic con el botón derecho en la colección para abrir el editor de Power Query en vista previa.

   

2. Ejecute la consulta proporcionada en el editor de Power Query para mostrar los datos en Vista tabla:

   

3. Explore los datos en otras vistas admitidas:

• Vista JSON: consulte la estructura de datos sin procesar.
• Vista de árbol: explore fácilmente los datos anidados.

Visualización de métricas de consulta e índice

En el editor de Power Query, vea métricas de índices y consultas adicionales para ayudar a optimizar mejor el rendimiento de las consultas.

1. Seleccione la pestaña Estadísticas junto a la consulta Resultados.

2. Para más información sobre las definiciones de métricas, consulte la documentación de métricas de consulta.

Insertar, editar y eliminar documentos

• Edición de documentos en tiempo real: agregar, ver, editar y eliminar documentos al instante, con cambios reflejados en tiempo real.
• Importar desde JSON: cargue los datos rápidamente desde archivos JSON.

Exportación de los resultados de la consulta

• Resultados de descarga: descargue los resultados de la consulta en archivos CSV o JSON.

Pasos siguientes

En este tutorial, ha aprendido a consultar datos en VS Code, exportar resultados de consulta, ver métricas de consulta e índice para optimizar el rendimiento de las consultas y mostrar datos en varias vistas admitidas. Ahora puede usar la extensión vs Code de Azure Database para revisar los datos reales de la base de datos.

• Introducción a la API para NoSQL
• Inicio rápido de Node.js
• Inicio rápido de Python
• Inicio rápido de Java
• Ir a Inicio rápido

Requisitos previos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

• Una cuenta de Azure Cosmos DB configurada con una base de datos en Azure Cosmos DB for MongoDB. Use uno de estos inicios rápidos para configurar una base de datos:
  • Portal
  • CLI de Azure
• Para conectarse y administrar datos en Azure Cosmos DB, debe instalar la extensión Azure Databases para Visual Studio Code.
  1. Abra Visual Studio Code.
  2. Para acceder al panelExtensiones, seleccione Ver > extensiones o use el método abreviado Ctrl + Mayús + X en Windows y Comando + Mayús + X en MacOS.
  3. En la barra de búsqueda, escriba Extensión Azure Databases y seleccione la extensión. Luego haga clic en Instalar.
  4. Después de la instalación, vuelva a cargar Visual Studio Code si se le solicita.
• Shell de MongoDB (mongosh) instalado para interacciones de línea de comandos (opcional, pero recomendada).

---

Conexión a una carga de trabajo de MongoDB

Conexión al clúster de Azure Cosmos DB for MongoDB (núcleo virtual)

1. En la extensión Azure Databases, expanda la sección Recursos de Azure.
2. Busque la Suscripción que tiene la carga de trabajo de MongoDB. En la suscripción deseada, observará la rama deAzure Cosmos DB for MongoDB (núcleo virtual). Expanda la rama para ver los clústeres y las bases de datos.
3. Elija el clúster de Azure Cosmos DB for MongoDB (núcleo virtual) en la lista expandida.
4. Cuando se le solicite, escriba la contraseña de administrador del clúster.
5. Una vez autenticado, obtendrá acceso al clúster.

Nota:

La contraseña solo se usa para la autenticación y no se almacena.

Nota:

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, se recomienda empezar con permitir el acceso a todas las direcciones IP agregando la regla de firewall 0.0.0.0 - 255.255.255.255 para las pruebas de conexión inicialmente antes de refinar la lista de permitidos.

Conexión a cualquier clúster de MongoDB

1. En el panel Área de trabajo, expanda la sección Cuentas de MongoDB.
2. Aquí puede ver todas las cuentas de MongoDB. Para conectarse a una nueva cuenta de MongoDB mediante una cadena de conexión, haga clic en Nueva conexión y escriba la cadena de conexión cuando se le solicite.
   • Opcionalmente, es posible que se le pida que proporcione su nombre de usuario y contraseña para la autenticación.

Nota:

Todos los clústeres de MongoDB conectados correctamente permanecerán en la sección Cuentas de MongoDB, incluso después de cerrar VS Code.

Administración intuitiva de datos

Administre fácilmente las bases de datos en Visual Studio Code:

• Crear y quitar bases de datos o colecciones: haga clic con el botón derecho en su cuenta, base de datos o colección en el panel de recursos para crear o eliminar bases de datos y colecciones.

• Importar desde JSON: importe rápidamente datos de archivos JSON a la colección.

  • Iniciar importación
    1. Haga clic con el botón derecho en el nombre de la colección en la vista de recursos y seleccione Importar documentos en colección.
    2. Como alternativa, abra la "Vista de colección" haciendo clic en la entrada Documentos de la colección y a continuación, haga clic en el botón Importar.
  • Selección del archivo JSON
    1. Busque el archivo *.json que contiene los datos.
    2. Confirme que inicia el proceso de importación.

• Exportar datos: guarde colecciones o resultados de consulta como JSON para la copia de seguridad o el uso compartido.

  • Iniciar exportación:
    • Opción 1
      1. Haga clic con el botón derecho en el nombre de la colección en la vista de recursos y seleccione Exportar documentos de la colección para exportar toda la colección.
    • Opción 2
      1. Abra la "Vista de colección" haciendo clic en la entrada Documentos de la colección y a continuación, haga clic en el botón Exportar.
      2. Elija exportar toda la colección o los resultados de la consulta actual.
  • Especificar archivo de destino:
    1. Escriba el nombre y la ubicación del archivo *.json de destino.
    2. Confirme la exportación para empezar a guardar los datos.

• Edición de documentos en tiempo real: agregar, ver, editar y eliminar documentos de forma instantánea con actualizaciones en tiempo real.

  • Abrir edición de documentos:
    • Acceda a las opciones de edición de documentos directamente dentro de la "Vista de recopilación". Estos controles se encuentran convenientemente encima de la vista de datos para facilitar el acceso.
  • Acciones disponibles:
    • Agregar: cree nuevos documentos dentro de la colección.
    • Vista: vea el contenido del documento seleccionado.
    • Editar: edite el contenido de los documentos seleccionados.
    • Eliminar: quite los documentos seleccionados con los cambios reflejados inmediatamente.

Herramientas de consulta eficaces

Ejecute y refinar las consultas sin problemas:

• Resultados instantáneos: vea inmediatamente los resultados de la consulta en su formato preferido: tabla, JSON o vista árbol.

  • Cambie las vistas fácilmente mediante el menú desplegable Ver.

• Ejecutar consultas directamente: escriba y ejecute consultas de MongoDB con características como el resaltado de sintaxis y la autocompletar.

  • Para ejecutar la consulta, haga clic en el botónBuscar consulta o presione Ctrl/Cmd+Enter en el editor de Power Query.

Nota:

Actualmente, solo se admiten las consultas de filtro, con funcionalidades de consulta expandidas próximamente.

Vistas de datos flexibles

Explore los datos mediante varias vistas para distintas perspectivas:

• Vista JSON: consulte la estructura de datos JSON sin procesar.

• Vista de árbol: navegue y explore los datos anidados sin esfuerzo.

• Vista de tabla: examine rápidamente los datos y explore en profundidad los documentos anidados.

  • Para explorar en profundidad: busque entradas con el icono {}, que indican objetos incrustados. Haga doble clic para expandir y ver el contenido.
  • Para volver atrás: use las rutas de navegación debajo de la vista de tabla para volver a los niveles anteriores.

Integración de Mongo Shell

La funcionalidad de la línea de comandos está disponible:

• Iniciar mongosh: ejecute comandos avanzados de MongoDB directamente desde Visual Studio Code.

Nota:

El shell de MongoDB (mongosh) no se incluye con la extensión. Debe instalarse por separado y configurarse manualmente.

Administración de clústeres

Manténgase al tanto de los recursos:

• Ver detalles del clúster: compruebe el nivel, la versión del servidor y el uso de recursos del clúster.

• Administrar etiquetas: organice los clústeres con etiquetas que se sincronicen con Azure Portal.

Pasos siguientes

Migración de la carga de trabajo de MongoDB a Azure Cosmos DB