MongoDB (Pré-visualização)
O MongoDB é uma plataforma de dados de documentos de uso geral, distribuída, amada pelos desenvolvedores e usada em todas as empresas para executar uma variedade de cargas de trabalho. Agora você pode explorar os vários endpoints e executar operações e agregações CRUD em sua coleção usando o MongoDB Connector.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | - | Não disponível |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte MongoDB |
| URL | https://www.mongodb.com/community/forums/ |
| support-operations@mongodb.com |
| Metadados do conector | |
|---|---|
| Editora | MongoDB Corp |
| Sítio Web | https://www.mongodb.com |
| Política de privacidade | https://www.mongodb.com/legal/privacy-policy |
| Categorias | Data |
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 nas coleções do MongoDB Atlas. O conector MongoDB facilita a execução de operações e agregações CRUD em seus dados em minutos e permite que você consulte o MongoDB para criar aplicativos e fluxos de trabalho avançados em Power Apps, Power Automate e Logic Apps.
*** Observe que o MongoDB substituiu as APIs de dados do Atlas a partir 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
Registe-se para obter uma nova Conta Atlas aqui. Siga as etapas de 1 a 4 (Criar uma conta do Atlas, Implantar um cluster gratuito, Adicionar seu IP à lista de acesso IP e Criar um usuário do 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 ações do GitHub OU 2. Usando o Zip Deploy
Escolha o método de ações do GitHub, se você for capaz de bifurcar o repositório atual, pode ter as ações do GitHub habilitadas nesse repositório e que você gostaria de adicionar mais APIs e preferir um CI/CD ou DevOps configurado pronto para uso. 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 MongoDB. Observe o novo url de repositório bifurcado. Se as ações do GitHub NÃO estiverem habilitadas por padrão, ative-as acessando 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 ter a função do Azure 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 Informações do Aplicativo). Você pode manter o nome da função e SKU como os padrões ou alterar se você gosta de seguir alguns padrões específicos. Recomendamos que você adicione o nome do cluster ao nome do aplicativo de função 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ê seu url de 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ção é criado, as variáveis env são preenchidas, mas a função real ainda não está implantada no aplicativo de função.
d. Para que as ações do GitHub sejam executadas a partir do seu repositório e implantem a função, obtenha o perfil de publicação da função do Azure criada.
Ele é baixado, abri-lo em um editor de texto e copiar todo o seu conteúdo.
e. Vá para o repositório GitHub -> Configurações -> Segredos e variáveis -> Ações Clique em Novo segredo do repositório e copie todo o valor no seu perfil de publicação para um novo segredo chamado "AZUREAPPSERVICE_PUBLISHPROFILE"
f. Faça uma pequena alteração no Leiame 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ção. Agora você deve ver a função disponível no Functon App e o código em function_app.py implantado.
g. A guia Ações do GitHub no repositório GitHub mostrará as etapas da 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 o ZipDeploy
a. Clique no botão Implantar no Azure abaixo para ter a função do Azure 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 Informações do Aplicativo). Você pode manter o nome da função e SKU como os padrões ou alterar se você gosta de seguir alguns padrões específicos. Recomendamos que você adicione seu nome de cluster ao nome do aplicativo de função para que seja exclusivo e fácil de identificar.
Por favor, ** NÃO altere ** o packageUrl, pois é o URL SAS da conta de armazenamento que tem o zip que precisa ser implantado. Selecione Criar e ele criará o aplicativo de função do Azure, implantará a função azure junto com os recursos associados.
Como obter credenciais
Obter a BaseUrl e a chave da API
a. No aplicativo Função, selecione sua função e clique em Obter URL da função . Copie o url da função desde o início até antes de "/action", como mostrado na captura de tela abaixo. Esta é a URL base que você usará para invocar qualquer uma das APIs CRUD/ Aggregate do MongoDB.
b) Vá para seu aplicativo de função -> Em Funções -> Chaves do aplicativo , Pegue a chave de API _master ou 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 CRUD / agregadas do MongoDB.
Introdução ao conector
- Quando os pré-requisitos estiverem concluídos, vá para PowerAutomate -> Conexões. Clique em "Nova conexão" e procure por MongoDB na barra de pesquisa no canto superior direito, como mostrado abaixo na captura de tela.
- Clique na conexão MongoDB e você verá o pop-up abaixo que pede para inserir a chave da API e a 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 no MongoDB Atlas Cluster. 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 que você crie aplicativos ricos e automatize quaisquer processos demorados. Você continua aprimorando os aplicativos adicionando mais recursos e campos à mesma coleção.
Problemas conhecidos e limitações
Como o MongoDB não impõe um esquema, o conector atual pode ser usado apenas com Power Automate e Aplicativos Lógicos, que suportam esquema dinâmico para a resposta da API, que pode ser analisado usando as construções "Parse 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 MongoDB certificado do repositório Microsoft Github como um conector personalizado para usá-lo diretamente no Power Apps para personalizar o esquema de resposta de acordo com seu esquema de coleção 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 são suportados no contexto do usuário de 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 recursos.
Erros e soluções comuns
Os códigos de resposta típicos da API também se aplicam aqui. Quaisquer erros 4XX indicam problema com o pedido do cliente. Certifique-se de que a fonte de dados, banco de dados, coleção são fornecidos 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 mais.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 (de caracteres) | A url da Função do Azure (Exemplo:https://mdb-dataapi-repl.azurewebsites.net/api/mdb_dataapi) | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de 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 filter no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, apenas 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. |
| Encontrar vários documentos |
Usando o ponto de extremidade find, você pode buscar vários documentos de uma só vez. Use a propriedade filter 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 devolvidos. |
| Excluir documento |
Para excluir um único documento, use o ponto de extremidade deleteOne. Use a propriedade filter no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, apenas a primeira correspondência será excluída. |
| Excluir muitos documentos |
Você pode usar deleteMany para excluir vários documentos de uma só vez. Use a propriedade filter para especificar quais documentos devem ser excluídos. Cuidado que usar esta API sem filtros irá 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 seu pipeline no campo 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 document no corpo da solicitação para especificar o documento que deve ser criado. |
| Inserir vários documentos |
Você pode adicionar mais de um documento de cada vez usando o ponto de extremidade insertMany. Nesse caso, você deve usar a propriedade documents no corpo da solicitação para especificar a matriz de documentos que deseja inserir na coleção. |
| Localizar documento |
O uso do ponto de extremidade findOne permitirá que você recupere um único documento de uma coleção. Use a propriedade filter no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, apenas a primeira correspondência será retornada. |
Atualizar documento
Você pode usar o ponto de extremidade updateOne para atualizar um único registro. Use a propriedade filter no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, apenas 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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um filtro de consulta MongoDB.A ação UpdateOne modifica o primeiro documento da coleção que corresponde a esse filtro. |
|
actualização
|
update | True | object |
Uma expressão de atualização do MongoDB que especifica como modificar o documento correspondente. |
|
atualizar/inserir
|
upsert | boolean |
O sinalizador Upsert só se aplica se nenhum documento corresponder ao filtro especificado. Se true, a ação updateOne insere um novo documento que corresponde ao filtro com a atualização especificada aplicada a ele. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
Contagem de correspondências |
|
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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um filtro de consulta MongoDB . A ação updateMany modifica todos os documentos da coleção que correspondem a esse filtro. |
|
actualização
|
update | True | object |
Uma expressão de atualização do MongoDB que especifica como modificar documentos correspondentes. |
|
atualizar/inserir
|
upsert | boolean |
O sinalizador upsert só se aplica se nenhum documento corresponder ao filtro especificado. Se true, a ação updateMany insere um novo documento que corresponde ao filtro com a atualização especificada aplicada a ele. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
matchedCount
|
matchedCount | integer |
Contagem de correspondências |
|
modifiedCount
|
modifiedCount | integer |
ModifiedCount |
Encontrar vários documentos
Usando o ponto de extremidade find, você pode buscar vários documentos de uma só vez. Use a propriedade filter 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 devolvidos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | object |
Um Filtro de Consulta 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 do MongoDB Query. Dependendo da projeção, os documentos retornados omitem campos específicos ou incluem apenas campos e valores especificados. |
|
|
ordenar
|
sort | object |
Uma expressão de classificação do MongoDB. Os 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 pedido pode devolver 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. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Documentação
|
documents | array of object |
Documentação |
|
items
|
documents | object |
Excluir documento
Para excluir um único documento, use o ponto de extremidade deleteOne. Use a propriedade filter no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, apenas a primeira correspondência será excluída.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um filtro de consulta MongoDB. A ação deleteOne exclui o primeiro documento da coleção que corresponde a esse filtro. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
deletedCount
|
deletedCount | integer |
Contagem excluída |
Excluir muitos documentos
Você pode usar deleteMany para excluir vários documentos de uma só vez. Use a propriedade filter para especificar quais documentos devem ser excluídos. Cuidado que usar esta API sem filtros irá excluir todos os documentos da coleção. Use deletemany com cuidado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | True | object |
Um filtro de consulta MongoDB . A ação deleteMany exclui todos os documentos da coleção que correspondem a esse filtro. |
Devoluções
| Name | 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 seu pipeline no campo pipeline do corpo da solicitação.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
pipeline
|
pipeline | object |
items |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Documentação
|
documents | array of object |
Documentação |
|
items
|
documents | object |
Inserir documento
Usando o ponto de extremidade insertOne, você pode adicionar um documento a uma coleção. Use a propriedade document no corpo da solicitação para especificar o documento que deve ser criado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
documento
|
document | True | object |
Um documento EJSON para inserir na coleção. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
insertedId
|
insertedId | string |
insertedId |
Inserir vários documentos
Você pode adicionar mais de um documento de cada vez usando o ponto de extremidade insertMany. Nesse caso, você deve usar a propriedade documents no corpo da solicitação para especificar a matriz de documentos que deseja inserir na coleção.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
Documentação
|
documents | object |
items |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
insertedIds
|
insertedIds | array of string |
insertedIds |
Localizar documento
O uso do ponto de extremidade findOne permitirá que você recupere um único documento de uma coleção. Use a propriedade filter no corpo da solicitação para especificar os critérios de pesquisa. Se mais de um documento corresponder aos critérios, apenas a primeira correspondência será retornada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do cluster MongoDB
|
dataSource | True | string |
O nome do cluster. |
|
Nome do banco de dados MongoDB
|
database | True | string |
O nome do banco de dados. |
|
Nome da coleção MongoDB
|
collection | True | string |
O nome da coleção. |
|
filtro
|
filter | object |
Um filtro de consulta 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 |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
documento
|
document | object |
documento |