Oracle DB

O módulo Oracle DB executa uma consulta SQL diretamente em um banco de dados Oracle da sua empresa, sem sair do fluxo. É útil para buscar ou atualizar informações em sistemas próprios que usam Oracle durante o atendimento.

Este módulo é específico para bancos Oracle. Para SQL Server, MySQL ou PostgreSQL, use o módulo Consulta em Banco de Dados.

🧭 Como acessar

1. No menu lateral, clique em Gerenciamento de aplicativos.

2. Em seguida, clique em Fluxos.

3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

4. No painel de módulos, localize a categoria Integração (identificada pela cor azul).

5. Arraste o módulo Oracle DB para a área de trabalho do fluxo.

Antes de usar este módulo: você precisa ter em mãos os dados de acesso ao banco Oracle (usuário, senha e string de conexão) — os dados de conexão são preenchidos direto no módulo, sem uma credencial cadastrada previamente.

🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

🔌 Conexão

Campo	O que preencher
Usuário	Usuário de acesso ao banco Oracle
Senha	Senha de acesso ao banco Oracle
String de Conexão	String de conexão do banco Oracle (endereço, porta e identificação do serviço/banco)

Evite digitar a senha do banco diretamente neste campo. Sempre que possível, cadastre-a como uma variável de ambiente marcada como secreta e use a variável aqui — assim ela não fica visível no histórico de execução do fluxo.

📝 Consulta

No campo de consulta, escreva o comando SQL a ser executado. Você pode usar variáveis do fluxo dentro da consulta.

Exemplo:

SELECT * FROM CLIENTES WHERE TELEFONE = '{{input.phone}}'

Nunca insira um texto digitado pelo cliente diretamente dentro da consulta SQL sem validação. Isso pode permitir que alguém manipule a consulta para ler, alterar ou apagar dados que não deveriam ser acessados. Sempre que possível, valide ou trate o valor da variável antes de usá-lo na consulta.

⚙️ Opções avançadas

Campo opcional em formato JSON, usado para configurações adicionais da conexão com o Oracle. Deixe em branco se não precisar de nenhuma configuração especial.

🔀 Saídas do módulo

O módulo tem duas saídas:

• Sucesso — a consulta foi executada, com o resultado (uma lista de registros) disponível para os próximos módulos do fluxo.

• Erro — não foi possível executar a consulta (por exemplo, credenciais inválidas, erro de conexão ou erro de sintaxe na consulta).

💡 Caso de uso

Cenário: uma empresa quer consultar o status de um pedido, armazenado em um banco de dados Oracle próprio, para informar o cliente durante o atendimento.

Configuração:

1. Adicione o módulo Oracle DB ao fluxo.

2. Preencha os dados de conexão com o banco Oracle da empresa.

3. Na consulta, escreva: SELECT STATUS FROM PEDIDOS WHERE CODIGO = '{{input.codigoPedido}}'.

4. Conecte a saída Sucesso a um módulo que use o resultado na conversa com o cliente.

Resultado: o fluxo consulta automaticamente o status do pedido informado pelo cliente e pode usar essa informação na resposta.

📌 Dicas úteis

• Sempre teste a consulta com dados reais antes de publicar o fluxo em produção.

• Evite consultas que possam alterar ou apagar muitos registros de uma vez sem uma condição bem definida.

• Sempre conecte a saída Erro a algum tratamento, já que operações de banco de dados podem falhar por diversos motivos.

• Guarde os dados de conexão (usuário e senha) em variáveis de ambiente sempre que possível, em vez de digitá-los diretamente no módulo.

📝 Resumo

• O módulo Oracle DB executa uma consulta SQL em um banco de dados Oracle.

• Os dados de conexão (usuário, senha, string de conexão) são preenchidos diretamente no módulo.

• Nunca insira texto do cliente diretamente na consulta sem validação, para evitar manipulação indevida do banco de dados.

• O módulo tem uma saída de Sucesso, com o resultado disponível para o fluxo, e uma saída de Erro.