Conecta-seEntrar na plataforma

Neo4j

Consultar e alterar dados em um banco de grafos Neo4j.

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

O que faz

Integre o banco de dados de grafos Neo4j ao fluxo. Permite consultar, criar, mesclar, atualizar e excluir nós e relacionamentos.

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

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 Neo4j 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
Consultar (MATCH)Consulta (MATCH) com o bloco Neo4j.
Criar nós/relacionamentosCria nós/relacionamentos com o bloco Neo4j.
Mesclar (encontrar ou criar)Mescla (encontrar ou criar) com o bloco Neo4j.
Atualizar propriedades (SET)Atualiza propriedades (SET) com o bloco Neo4j.
Excluir nós/relacionamentosExclui nós/relacionamentos com o bloco Neo4j.
Executar CypherExecuta Cypher com o bloco Neo4j.
Inspecionar esquemaInspeciona esquema com o bloco Neo4j.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Consultar (MATCH) · Criar nós/relacionamentos · Mesclar (encontrar ou criar) · Atualizar propriedades (SET) · Excluir nós/relacionamentos · Executar Cypher · Inspecionar esquema
    Padrão:
    Consultar (MATCH)

  • Servidor

    ObrigatórioDado protegido

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

    Padrão:
    Segredo protegido

  • Porta

    Obrigatório

    Porta de conexão do Neo4j pelo protocolo Bolt; o padrão é 7687.

    Padrão:
    7687

  • Nome do banco de dados

    Obrigatório

    Nome do banco de dados no Neo4j em que as consultas vão rodar; o padrão é neo4j.

    Padrão:
    neo4j

  • Nome de usuário

    Obrigatório

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

    Padrão:
    neo4j
    Exemplo:
    Exemplo de atendimento

  • Senha

    ObrigatórioDado protegido

    Senha do seu banco de dados.

    Padrão:
    Segredo protegido

  • Criptografia

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

    Opções:
    Desativado · Ativada (TLS/SSL)
    Padrão:
    Desativado

  • Consulta Cypher

    Obrigatório conforme a operação

    MATCH (n:Person) WHERE n.age > 21 RETURN n LIMIT 10.

    Aparece em:
    Consultar (MATCH)
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Parâmetros

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

    Exemplo:
    { "chave": "valor" }

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 <neo4j.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
<neo4j.message>stringMensagem de sucesso ou de erro que descreve o resultado da operação.
<neo4j.records>arrayLista de registros retornados pela consulta.
<neo4j.recordCount>numberQuantidade de registros retornados ou afetados.
<neo4j.summary>jsonResumo da execução, com tempos e contadores de alterações no banco de dados.

Exemplo de uso

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

InícioNeo4jpróxima etapa
Operação
Consultar (MATCH)
Porta
7687
Nome do banco de dados
neo4j
Nome de usuário
Exemplo de atendimento
Criptografia
Desativado
Consulta Cypher
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 <neo4j.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