> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-de-chatbots/integracao/consulta-em-banco-de-dados.md).

# Consulta em banco de dados

O módulo de **Consulta em banco de dados** é utilizado para realizar um consulta SQL no banco de dados desejado.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FgVZy9X1sLtA8VIYVC0JK%2FdbQuery-gif.gif?alt=media&amp;token=71333420-29aa-4fce-b8e4-ed0056328605" alt=""><figcaption><p>Utilização do módulo <strong>Consulta em banco de dados</strong> em um fluxo real</p></figcaption></figure>

### Detalhes do fluxo

É possível configurar os dados da consulta dentro das configurações do módulo.\
Configurações disponíveis:

* Tipo do banco de dados
* Host
* Porta
* Usuário
* Senha
* Nome do banco de dados
* Nome da instância
* Consulta em SQL

O módulo possui duas saídas de retorno: "Sucesso" e "Erro".

### Bancos de dados suportados

* SQLServer
* MySql
* PgSql
* PLSQL

### Exemplo de consulta

SELECT 1

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FfAqc9V0cZpZt78E9hprq%2Fimage.png?alt=media&amp;token=9775b01e-175c-4d3b-ad21-b25e0ed9fb15" alt="" width="494"><figcaption><p>Screenshot da consulta</p></figcaption></figure>

### Caso de uso

Precisamos realizar uma consulta em um banco de dados de clientes para obter o conjunto de clientes que fazem aniversário no dia. Para isso, utilizamos o módulo **Consulta em banco de dados**, selecionamos o tipo de banco de dados utilizado, preenchemos as informações do módulo e por fim adicionamos a consulta que será realizada no campo "Consulta".