MongoDB (versión preliminar)

MongoDB es una plataforma de datos de documentos distribuida y de uso general que los desarrolladores y usan en las empresas para ejecutar diversas cargas de trabajo. Ahora puede explorar los distintos puntos de conexión y realizar operaciones CRUD y agregaciones en la colección mediante el conector de MongoDB.

Este conector está disponible en los siguientes productos y regiones:

El conector de MongoDB proporciona una manera sencilla de conectarse a MongoDB Atlas a través de las API de datos hospedadas mediante la función de Azure en el inquilino para leer y escribir datos en colecciones de MongoDB Atlas. El conector de MongoDB facilita la realización de operaciones CRUD y agregaciones en los datos en cuestión de minutos y le permite consultar MongoDB para crear flujos de trabajo y aplicaciones enriquecidas en Power Apps, Power Automate y Logic Apps.

*** Tenga en cuenta que MongoDB desusó las API de datos de Atlas desde septiembre de 2025 y, por tanto, use este enfoque de conector para configurar una función de Azure y use sus claves url y API en lugar de las de Atlas en las aplicaciones y flujos. ***

Prerrequisitos

1. Configuración del entorno de Atlas

Regístrese aquí para obtener una nueva cuenta de Atlas. Siga los pasos de 1 a 4 (Creación de una cuenta de Atlas, Implementación de un clúster gratuito, Adición de la dirección IP a la lista de acceso a IP y Creación de un usuario de base de datos) para configurar el entorno de Atlas.

2. Configuración de Azure Functions como Atlas Data API Para configurar la función de Azure que hospedará el código para que actúe como Api de datos de Atlas, tenemos dos opciones : 1. Uso de Acciones de GitHub O 2. Uso de Zip Deploy

   Elija el método de acciones de GitHub, si puede bifurcar el repositorio actual, puede tener habilitadas las acciones de GitHub en ese repositorio y que desea agregar más API y preferir una configuración de CI/CD o DevOps de forma predeterminada. Sin embargo, si busca una forma rápida y sencilla de implementar y solo necesita la configuración de la función de Azure para sustituir las API de datos de Atlas, vaya a la opción Implementación zip.

   Opción 1: Configuración de la función de Azure mediante acciones de GitHub

   a.Bifurcar el repositorio de MongoDB. Anote la nueva dirección URL del repositorio bifurcado. Si las acciones de GitHub NO están habilitadas de forma predeterminada, habilitelas; para ello, vaya a Configuración -> Acciones -> General en el repositorio bifurcado y seleccione una de las opciones Permitir acciones o flujos de trabajo que se pueden volver a usar.

   b.Haga clic en el botón Implementar en Azure siguiente para que la función de Azure se cree en el inquilino.

   

   c. Seleccione o cree el grupo de recursos que contendrá la función de Azure y sus componentes asociados (Plan de App Service, Cuenta de almacenamiento y App Insights). Puede mantener el nombre de la función y la SKU como valores predeterminados o cambiar si desea seguir algunos estándares específicos. Se recomienda agregar el nombre del clúster al nombre de la aplicación de funciones para que sea único y fácil de identificar.

   Proporcione la dirección URL de conexión de MongoDB para el clúster en el que se ejecutará esta función de Azure. Esta cadena de conexión se guardará como una variable environmnet. Asigne la dirección URL del repositorio bifurcado como repositorio de GitHub. Seleccione Crear y creará la función de Azure con los recursos asociados. Tenga en cuenta que en esta fase se crea la aplicación de funciones, las variables de desarrollo se rellenan, pero la función real aún no se implementa en la aplicación de funciones.

   d. Para que las acciones de GitHub se ejecuten desde el repositorio e implementen la función, obtenga el perfil de publicación de la función de Azure creada.

   Se descarga, ábralo en un editor de texto y copie todo su contenido.

   

   e. Vaya al repositorio de GitHub -> Configuración -> Secretos y variables -> Acciones Haga clic en Nuevo secreto de respository y copie el valor completo en el perfil de publicación en un nuevo secreto denominado "AZUREAPPSERVICE_PUBLISHPROFILE"

   f. Realice un cambio menor en README y Commit Changes (Confirmar cambios ) para invocar acciones de GitHub que implementarían el código de Python en la función de Azure en la aplicación de funciones. Ahora debería ver la función disponible en la aplicación functon y el código en function_app.py implementado.

   g. La pestaña Acciones de GitHub en el repositorio de GitHub mostrará los pasos de la implementación (incluida la instalación de dependencias) y el resultado de cada paso.

   Opción 2: Configuración de la función de Azure mediante ZipDeploy

   a) Haga clic en el botón Implementar en Azure para que la función de Azure se cree en el inquilino.

   

   b. Seleccione o cree el grupo de recursos que contendrá la función de Azure y sus componentes asociados (Plan de App Service, Cuenta de almacenamiento y App Insights). Puede mantener el nombre de la función y la SKU como valores predeterminados o cambiar si desea seguir algunos estándares específicos. Se recomienda agregar el nombre del clúster al nombre de la aplicación de funciones para que sea único y fácil de identificar.

   Por favor ** DONOT cambie ** el packageUrl ya que es la dirección URL de SAS de la cuenta de almacenamiento que tiene el archivo ZIP que debe implementarse. Seleccione Crear y creará la aplicación de funciones de Azure, implementará la función de Azure junto con los recursos asociados.

Obtención de credenciales

Obtención de la clave de API y BaseUrl

a) En Function App, seleccione la función y haga clic en Obtener dirección URL de la función . Copie la dirección URL de la función desde el principio hasta antes de "/action", como se muestra en la captura de pantalla siguiente. Esta es la dirección URL base que usará para invocar cualquiera de las API CRUD/Aggregate de MongoDB.

b. Vaya a la aplicación de funciones:> en Functions -> Claves de aplicación , tome el _master o la clave de API predeterminada para la función de Azure Esta es la clave de API que usará junto con la dirección URL base para crear una conexión de MongoDB para invocar cualquiera de las API CRUD/Aggregate de MongoDB.

Introducción al conector

1. Una vez completados los requisitos previos, vaya a PowerAutomate -> Conexiones. Haga clic en "Nueva conexión" y busque MongoDB en la barra de búsqueda de la parte superior derecha, como se muestra a continuación en la captura de pantalla.

2. Haga clic en la conexión de MongoDB y verá el siguiente elemento emergente que le pide que escriba la clave de API y la dirección URL base.

3. En los campos "Dirección URL base" y "Clave de API", escriba los valores recuperados de la sección Obtención de credenciales anterior.

Use una de las 8 API de datos para cualquier operación CRUD en el clúster de MongoDB Atlas. Para consultas complejas, use la API "Ejecutar una canalización de agregación" para usar fases de agregación para masajear la salida de una fase a otra. La flexibilidad y el dinamismo de MongoDB le permiten crear aplicaciones enriquecidas y automatizar los procesos que consumen mucho tiempo. Para mejorar las aplicaciones, agregue más características y campos a la misma colección.

Problemas y limitaciones conocidos

Dado que MongoDB no aplica un esquema, el conector actual solo se puede usar con Power Automate y Logic Apps, que admite el esquema dinámico para la respuesta de la API, que luego se puede analizar mediante las construcciones "Analizar JSON". Se puede usar en Power Apps invocando un flujo de Power Automate para cada interacción de MongoDB. También puede seguir usando el conector de MongoDB certificado desde el repositorio de Microsoft Github como conector personalizado para usarlo directamente en Power Apps para personalizar el esquema de respuesta según el esquema de colección de MongoDB.

Las restricciones aplicables a las operaciones de datos de MongoDB también se aplican al conector de MongoDB. Consulte este vínculo para obtener más información sobre las fases de agregación que no se admiten en el contexto de usuario de las API de datos.

Siga este vínculo para conocer las limitaciones conocidas con las funciones de Azure, como tiempos de espera y otros límites de servicio para cada plan de recursos.

Errores y soluciones comunes

Los códigos de respuesta de API típicos también se aplican aquí. Los errores 4XX indican un problema con la solicitud del cliente. Asegúrese de que la colección dataSource, database, se proporciona en un formato JSON válido. Consulte esta colección de Postman para obtener ejemplos. En el caso de los errores 5XX, asegúrese de que la función de Azure está en funcionamiento y compruebe su seguimiento para investigarlos aún más.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Acciones

Actualizar documento

Actualizar varios documentos

Buscar documento

Buscar varios documentos

Ejecución de la canalización de agregación

Eliminar documento

Eliminar muchos documentos

Insertar documento

Insertar varios documentos