Conecta-seEntrar na plataforma

MongoDB

Consultar e alterar dados em um banco MongoDB.

Integrações e ferramentasBancos de dadosConexão: Credencial protegida

O que faz

Integre o MongoDB ao fluxo. Permite buscar, inserir, atualizar, excluir e agregar dados.

Quando usar: Use quando o seu fluxo precisar consultar e alterar dados em um banco MongoDB.

Exemplo de situação: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione MongoDB ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Buscar documentosBusca documentos com o bloco MongoDB.
Inserir documentosInsere documentos com o bloco MongoDB.
Atualizar documentosAtualiza documentos com o bloco MongoDB.
Excluir documentosExclui documentos com o bloco MongoDB.
Pipeline de agregaçãoExecuta a operação “Pipeline de agregação” com o bloco MongoDB.
Inspecionar bancoInspeciona banco com o bloco MongoDB.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Buscar documentos · Inserir documentos · Atualizar documentos · Excluir documentos · Pipeline de agregação · Inspecionar banco
    Padrão:
    Buscar documentos

  • Conexão

    Obrigatório

    Escolha uma conexão do workspace.

    Exemplo:
    (escolha na lista do campo)

  • Servidor

    ObrigatórioEm campos adicionais

    Endereço do servidor MongoDB, como nome ou IP (ex.: db.minhaempresa.com.br); o servidor precisa aceitar conexões vindas da plataforma.

    Exemplo:
    localhost ou seu.servidor.mongodb

  • Porta

    ObrigatórioEm campos adicionais

    Porta do servidor MongoDB; o padrão é 27017.

    Padrão:
    27017

  • Banco de dados

    ObrigatórioEm campos adicionais

    Nome do banco de dados do MongoDB em que o bloco vai trabalhar (ex.: loja).

    Exemplo:
    nome_do_banco

  • Usuário

    ObrigatórioEm campos adicionais

    Define o nome ou título usado para identificar o recurso.

    Exemplo:
    Exemplo de atendimento

  • Senha

    ObrigatórioEm campos adicionaisDado protegido

    Senha do banco de dados.

    Padrão:
    Segredo protegido

  • Banco de autenticação

    Em campos adicionais

    Banco em que o usuário do MongoDB foi criado e onde a senha é conferida; normalmente é admin.

    Exemplo:
    admin

  • Criptografia da conexão

    Em campos adicionais

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Desativada · Obrigatória · Preferencial
    Padrão:
    Preferencial
    Exemplo:
    Desativada

  • Nome da coleção

    Obrigatório conforme a operação

    Coleção do MongoDB em que a operação atua, o equivalente a uma tabela (ex.: clientes).

    Quando aparece:
    Quando o campo “Operação” for diferente de “Inspecionar banco”
    Exemplo:
    usuarios

  • Filtro da busca (JSON)

    Informa a consulta usada para localizar ou transformar dados.

    Aparece em:
    Buscar documentos
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Pipeline de agregação (array JSON)

    Obrigatório conforme a operação

    Informa dados estruturados ou código no formato exigido pelo campo.

    Aparece em:
    Pipeline de agregação
    Exemplo:
    { "chave": "valor" }

  • Limite

    Em campos adicionais

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Buscar documentos
    Exemplo:
    10

  • Ordenação (JSON)

    Em campos adicionais

    Informa dados estruturados ou código no formato exigido pelo campo.

    Aparece em:
    Buscar documentos
    Exemplo:
    { "chave": "valor" }

  • Documentos (array JSON)

    Obrigatório conforme a operação

    Informa ou seleciona o arquivo usado nesta operação.

    Aparece em:
    Inserir documentos
    Exemplo:
    { "chave": "valor" }

  • Filtro (JSON)

    Obrigatório conforme a operação

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Atualizar documentos
    Exemplo:
    status = 'ativo'

  • Atualização (JSON)

    Obrigatório conforme a operação

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Atualizar documentos
    Exemplo:
    2026-09-15

  • Criar se não existir (upsert)

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Atualizar documentos
    Opções:
    Não · Sim
    Padrão:
    Não

  • Atualizar vários

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Atualizar documentos
    Opções:
    Não · Sim
    Padrão:
    Não

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <mongodb.message>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<mongodb.message>stringMensagem de sucesso ou de erro que descreve o resultado da operação.
<mongodb.documents>arrayLista de documentos retornados pela operação.
<mongodb.documentCount>numberNúmero de documentos afetados pela operação.
<mongodb.insertedId>stringID do documento inserido (inserção única).
<mongodb.insertedIds>arrayLista de IDs dos documentos inseridos (inserção múltipla).
<mongodb.modifiedCount>numberNúmero de documentos modificados (operações de atualização).
<mongodb.deletedCount>numberNúmero de documentos excluídos (operações de exclusão).
<mongodb.matchedCount>numberNúmero de documentos encontrados pelo filtro (operações de atualização).
<mongodb.databases>arrayLista de nomes de bancos de dados (operação de inspeção).
<mongodb.collections>arrayLista de informações das coleções, com nome, tipo, quantidade de documentos e índices (operação de inspeção).

Exemplo de uso

Objetivo: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

InícioMongoDBpróxima etapa
Operação
Buscar documentos
Conexão
(escolha na lista do campo)
Nome da coleção
usuarios
Filtro da busca (JSON)
SELECT * FROM clientes WHERE status = 'ativo'

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <mongodb.message>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
Não foi possível conectar ao banco
Confira endereço, porta, nome do banco e usuário da conexão, e se o banco aceita conexões vindas da plataforma (firewall e lista de IPs liberados).
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados