MongoDB (versão prévia)
O MongoDB é uma plataforma de dados de documento de finalidade geral, distribuída e que é amada por desenvolvedores e usada entre empresas para executar uma variedade de cargas de trabalho. Agora você pode explorar os vários pontos de extremidade e executar operações CRUD e agregações em sua coleção usando o Conector do MongoDB.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | - | Não disponível |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do MongoDB |
| URL | https://www.mongodb.com/community/forums/ |
| support-operations@mongodb.com |
| Metadados do conector | |
|---|---|
| Publicador | MongoDB Corp |
| Website | https://www.mongodb.com |
| Política de privacidade | https://www.mongodb.com/legal/privacy-policy |
| Categorias | Dados |
O MongoDB Connector fornece uma maneira simples de se conectar ao MongoDB Atlas por meio de APIs de dados hospedadas usando a função do Azure em seu locatário para ler e gravar dados em coleções do Atlas do MongoDB. O conector do MongoDB facilita a execução de operações CRUD e agregações em seus dados em minutos e permite que você consulte o MongoDB para criar aplicativos avançados e fluxos de trabalho no Power Apps, Power Automate e Aplicativos Lógicos.
*** Observe que o MongoDB preteriu as APIs de Dados do Atlas de setembro de 2025 e, portanto, use essa abordagem de conector para configurar uma função do Azure e usar suas chaves de URL e API em vez das do Atlas em seus Aplicativos e Fluxos. ***
Pré-requisitos
- Configurar o Ambiente do Atlas
Registre-se para uma nova conta do Atlas aqui. Siga as etapas de 1 a 4 (Criar uma conta do Atlas, implantar um cluster gratuito, adicionar seu IP à lista de acesso de IP e criar um usuário de banco de dados) para configurar o ambiente do Atlas.
Configurar a Função do Azure como API de Dados do Atlas Para configurar a função do Azure que hospedará o código para atuar como APIs de Dados do Atlas, temos duas opções : 1. Usando o GitHub Actions OR 2. Usando a implantação zip
Escolha o método de ações do GitHub, se você for capaz de bifurcar o repositório atual, poderá ter ações do GitHub habilitadas nesse repositório e que você deseja adicionar mais APIs e preferir que um CI/CD ou DevOps seja configurado fora da caixa. No entanto, se você estiver procurando uma maneira rápida e fácil de implantação e precisar apenas da função do Azure configurada para substituir as APIs de Dados do Atlas, vá com a opção de implantação zip.
Opção 1: Configurar a função do Azure usando ações do GitHub
a.Fork o repositório do MongoDB. Observe a nova URL do repositório bifurcado. Se as ações do GitHub NÃO estiverem habilitadas por padrão, habilite-as acessando as Configurações –> Ações –> Geral em seu repositório bifurcado e selecione uma das opções Permitir ações/fluxos de trabalho reutilizáveis.
b.Clique no botão Implantar no Azure abaixo para que a função do Azure seja criada em seu locatário.
c. Selecione ou crie seu grupo de recursos que conterá a função do Azure e seus componentes associados (Plano do Serviço de Aplicativo, Conta de Armazenamento e Insights do Aplicativo). Você pode manter o nome da função e a SKU como padrões ou alterar se quiser seguir alguns padrões específicos. Recomendamos que você adicione o nome do cluster ao nome do aplicativo de funções para que seja exclusivo e fácil de identificar.
Forneça a URL de conexão do MongoDB para o Cluster no qual essa função do Azure será executada. Essa cadeia de conexão será salva como uma variável Environmnet. Dê a url do repositório bifurcado como repositório github. Selecione Criar e criará a função do Azure com os recursos associados. Observe que, neste estágio, o aplicativo de funções é criado, as variáveis de env são preenchidas, mas a função real ainda não foi implantada no aplicativo de funções.
d. Para que as ações do GitHub sejam executadas no repositório e implantem a função, obtenha o perfil de publicação da função criada do Azure.
Ele é baixado, aberto em um editor de Texto e copia todo o conteúdo.
e. Vá para o repositório GitHub –> Configurações –> Segredos e variáveis –> Ações Clique em Novo Segredo de Repositório e copie todo o valor em seu perfil de publicação para um novo segredo chamado "AZUREAPPSERVICE_PUBLISHPROFILE"
f. Faça uma pequena alteração no README e confirme alterações para invocar ações do GitHub que implantariam o código python na função do Azure em seu aplicativo de funções. Agora você deve ver a função disponível no Aplicativo Functon e o código em function_app.py implantado.
g. A guia Ações do GitHub no repositório GitHub mostrará as etapas na implantação (incluindo a instalação de dependências) e o resultado de cada etapa.
Opção 2: Configurar a função do Azure usando ZipDeploy
a. Clique no botão Implantar no Azure abaixo para que a função do Azure seja criada em seu locatário.
b. Selecione ou crie seu grupo de recursos que conterá a função do Azure e seus componentes associados (Plano do Serviço de Aplicativo, Conta de Armazenamento e Insights do Aplicativo). Você pode manter o nome da função e a SKU como padrões ou alterar se quiser seguir alguns padrões específicos. Comunicamos novamente que você adiciona seu nome de cluster ao nome do aplicativo de funções para que ele seja exclusivo e fácil de identificar.
Por favor** DONOT altere ** o packageUrl, pois é a URL SAS da conta de Armazenamento que tem o zip que precisa ser implantado. Selecione Criar e criará o aplicativo de funções do Azure, implantará a função do azure junto com os recursos associados.
Como obter credenciais
Obter a BaseUrl e a Chave de API
a. No Aplicativo de Funções, selecione sua função e clique em Obter URL da função . Copie a URL da função do início até antes de "/action", conforme mostrado na captura de tela abaixo. Essa é a URL base que você usará para invocar qualquer uma das APIs DE AGREGAÇÃO/CRUD do MongoDB.
b. Vá para o aplicativo de funções –> em funções –> chaves de aplicativo, pegue o _master ou a chave de API padrão para sua função do Azure Esta é a Chave de API que você usará junto com a Url Base para criar uma conexão mongoDB para invocar qualquer uma das APIs DE AGREGAÇÃO/CRUD do MongoDB.
Introdução ao conector
- Depois que os pré-requisitos forem concluídos, vá para PowerAutomate –> Conexões. Clique em "Nova Conexão" e pesquise mongoDB na Barra de Pesquisa no canto superior direito, conforme mostrado abaixo na captura de tela.
- Clique na conexão do MongoDB e você verá o pop-up abaixo que solicita a inserção da chave de API e da URL base.
- Para os campos "Url Base" e "Chave de API", insira os valores recuperados da seção Como obter credenciais acima
Use uma das 8 APIs de Dados para qualquer operação CRUD em relação ao cluster Do Atlas do MongoDB. Para consultas complexas, use a API "Executar um Pipeline de Agregação" para usar estágios de agregação para massagear a saída de um estágio para outro. A flexibilidade e o dinamismo do MongoDB permitem criar aplicativos avançados e automatizar processos demorados. Você continua aprimorando os aplicativos adicionando mais recursos e campos à mesma coleção.
Problemas e limitações conhecidos
Como o MongoDB não impõe um esquema, o conector atual só pode ser usado com o Power Automate e os Aplicativos Lógicos, que dá suporte ao esquema dinâmico para a resposta da API, que pode ser analisado usando os constructos "Analisar JSON". Ele pode ser usado no Power Apps invocando um fluxo do Power Automate para cada interação do MongoDB. Você também pode continuar a usar o conector certificado do MongoDB do repositório Do Microsoft Github como um conector personalizado para usá-lo diretamente no Power Apps para personalizar o esquema de resposta de acordo com o esquema de coleção do MongoDB.
As restrições aplicáveis às operações de dados do MongoDB também se aplicam ao conector do MongoDB. Consulte este link para saber mais sobre os estágios de agregação que não têm suporte no contexto de usuário das APIs de Dados.
Siga este link para obter as limitações conhecidas com as funções do Azure, como tempos limite e outros limites de serviço para cada plano de recurso.
Erros e soluções comuns
Códigos de resposta típicos da API também se aplicam aqui. Qualquer erro 4XX indica problema com a solicitação do cliente. Verifique se a coleção dataSource, database, é fornecida em um formato JSON válido. Consulte esta Coleção Postman para obter exemplos. Para erros 5XX, verifique se a função do Azure está em execução e verifique seu rastreamento para investigar melhor.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API para esta api | Verdade |
| BaseUrl | cadeia | A URL da Função do Azure (exemplo:https://mdb-dataapi-repl.azurewebsites.net/api/mdb_dataapi) | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Atualizar Documento |
Você pode usar o ponto de extremidade updateOne para atualizar um único registro. Use a propriedade de filtro no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, somente a primeira correspondência será retornada. Em seguida, use o campo de atualização para especificar o que deve ser atualizado. Você deve usar um dos operadores de atualização para atualizar seus documentos. |
| Atualizar vários documentos |
Usando updateMany, você pode atualizar todos os documentos correspondentes a um filtro específico especificado no corpo da solicitação. Use um dos operadores de atualização no campo de atualização para atualizar seus documentos. |
| Excluir Documento |
Para excluir um único documento, use o ponto de extremidade deleteOne. Use a propriedade de filtro no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, somente a primeira correspondência será excluída. |
| Excluir muitos documentos |
Você pode usar deleteMany para excluir vários documentos ao mesmo tempo. Use a propriedade de filtro para especificar quais documentos excluir. Lembre-se de que o uso dessa API sem filtros excluirá todos os documentos da coleção. Use deletemany com cuidado. |
| Executar pipeline de agregação |
Você pode até mesmo executar pipelines de agregação com a API de Dados. Para fazer isso, use o ponto de extremidade agregado e especifique o pipeline no campo de pipeline do corpo da solicitação. |
| Inserir Documento |
Usando o ponto de extremidade insertOne, você pode adicionar um documento a uma coleção. Use a propriedade do documento no corpo da solicitação para especificar o documento que deve ser criado. |
| Inserir vários documentos |
Você pode adicionar mais de um documento por vez usando o ponto de extremidade insertMany. Nesse caso, você deve usar a propriedade de documentos no corpo da solicitação para especificar a matriz de documentos que deseja inserir na coleção. |
| Localizar Documento |
Usar o ponto de extremidade findOne permitirá que você recupere um único documento de uma coleção. Use a propriedade de filtro no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, somente a primeira correspondência será retornada. |
| Localizar vários documentos |
Usando o ponto de extremidade de localização, você pode buscar vários documentos ao mesmo tempo. Use a propriedade de filtro no corpo da solicitação para especificar os critérios nos quais filtrar. Se você passar um objeto vazio, todos os documentos da coleção serão retornados. |
Atualizar Documento
Você pode usar o ponto de extremidade updateOne para atualizar um único registro. Use a propriedade de filtro no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, somente a primeira correspondência será retornada. Em seguida, use o campo de atualização para especificar o que deve ser atualizado. Você deve usar um dos operadores de atualização para atualizar seus documentos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um Filtro de Consulta do MongoDB.A ação UpdateOne modifica o primeiro documento da coleção que corresponde a esse filtro. |
|
atualização
|
update | True | object |
Uma expressão de atualização do MongoDB que especifica como modificar o documento correspondente. |
|
executar upsert
|
upsert | boolean |
O sinalizador Upsert só se aplica se nenhum documento corresponder ao filtro especificado. Se for true, a ação updateOne inserirá um novo documento que corresponde ao filtro com a atualização especificada aplicada a ele. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |
Atualizar vários documentos
Usando updateMany, você pode atualizar todos os documentos correspondentes a um filtro específico especificado no corpo da solicitação. Use um dos operadores de atualização no campo de atualização para atualizar seus documentos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um filtro de consulta do MongoDB. A ação updateMany modifica todos os documentos na coleção que correspondem a esse filtro. |
|
atualização
|
update | True | object |
Uma expressão de atualização do MongoDB que especifica como modificar documentos correspondentes. |
|
executar upsert
|
upsert | boolean |
O sinalizador upsert só se aplica se nenhum documento corresponder ao filtro especificado. Se for true, a ação updateMany inserirá um novo documento que corresponde ao filtro com a atualização especificada aplicada a ele. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
matchedcount |
|
modifiedCount
|
modifiedCount | integer |
modifiedcount |
Excluir Documento
Para excluir um único documento, use o ponto de extremidade deleteOne. Use a propriedade de filtro no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, somente a primeira correspondência será excluída.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um filtro de consulta do MongoDB. A ação deleteOne exclui o primeiro documento da coleção que corresponde a esse filtro. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedcount |
Excluir muitos documentos
Você pode usar deleteMany para excluir vários documentos ao mesmo tempo. Use a propriedade de filtro para especificar quais documentos excluir. Lembre-se de que o uso dessa API sem filtros excluirá todos os documentos da coleção. Use deletemany com cuidado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um filtro de consulta do MongoDB. A ação deleteMany exclui todos os documentos da coleção que correspondem a esse filtro. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
deletedCount |
Executar pipeline de agregação
Você pode até mesmo executar pipelines de agregação com a API de Dados. Para fazer isso, use o ponto de extremidade agregado e especifique o pipeline no campo de pipeline do corpo da solicitação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
pipeline
|
pipeline | object |
items |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Documentos
|
documents | array of object |
Documentos |
|
items
|
documents | object |
Inserir Documento
Usando o ponto de extremidade insertOne, você pode adicionar um documento a uma coleção. Use a propriedade do documento no corpo da solicitação para especificar o documento que deve ser criado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
documento
|
document | True | object |
Um documento EJSON a ser inserido na coleção. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
insertedId
|
insertedId | string |
insertedId |
Inserir vários documentos
Você pode adicionar mais de um documento por vez usando o ponto de extremidade insertMany. Nesse caso, você deve usar a propriedade de documentos no corpo da solicitação para especificar a matriz de documentos que deseja inserir na coleção.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
Documentos
|
documents | object |
items |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
insertedIds
|
insertedIds | array of string |
insertedIds |
Localizar Documento
Usar o ponto de extremidade findOne permitirá que você recupere um único documento de uma coleção. Use a propriedade de filtro no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, somente a primeira correspondência será retornada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | object |
Um filtro de consulta do MongoDB. A ação findOne retorna o primeiro documento da coleção que corresponde a esse filtro. |
|
|
projeção
|
projection | object |
Uma projeção de consulta do MongoDB. Dependendo da projeção, o documento retornado omitirá campos específicos ou incluirá apenas campos ou valores especificados |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
documento
|
document | object |
documento |
Localizar vários documentos
Usando o ponto de extremidade de localização, você pode buscar vários documentos ao mesmo tempo. Use a propriedade de filtro no corpo da solicitação para especificar os critérios nos quais filtrar. Se você passar um objeto vazio, todos os documentos da coleção serão retornados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster do MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados do MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção do MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | object |
Um Filtro de Consulta do MongoDB.A ação localizar retorna documentos na coleção que correspondem a esse filtro. Se você não especificar um filtro, a ação corresponderá a todos os documentos da coleção. |
|
|
projeção
|
projection | object |
Uma projeção de consulta do MongoDB. Dependendo da projeção, os documentos retornados omitem campos específicos ou incluem apenas campos e valores especificados. |
|
|
classificar
|
sort | object |
Uma expressão de classificação do MongoDB. Documentos correspondentes são retornados em ordem crescente ou decrescente dos campos especificados na expressão. |
|
|
limit
|
limit | integer |
O número máximo de documentos correspondentes a serem incluídos no conjunto de resultados retornado. Cada solicitação pode retornar até 50.000 documentos. |
|
|
ignorar
|
skip | integer |
O número de documentos correspondentes a serem ignorados antes de adicionar documentos correspondentes ao conjunto de resultados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Documentos
|
documents | array of object |
Documentos |
|
items
|
documents | object |