> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/servicos-do-floui/floui-datasource/consultar-dados.md). # Consultar dados {% tabs %} {% tab title="Parâmetros" %}

| Campo | Tipo | Descrição | | -------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | Descrição | Campo de texto | Descrição visual do conector no editor de fluxo. | | Datasource | Seletor | Permite selecionar entre Datasources cadastradas no Workspace atual. | | Variáveis de entrada | Tabela de parâmetros | Tabela de parâmetros para mapeamento de variáveis do Datasource no contexto do Fluxo. | | Variável | Campo de texto | Nome da variável cadastrada no Datasource | | Valor | Campo de texto | Valor da variável que será utilizada na consulta | | Em caso de erro | Seletor | Permite selecionar entre parar a execução do fluxo ao encontrar erro ou continuar a execução com uma saída de erro no conector | | Output Path | Campo de texto | Refere-se ao caminho onde o resultado da execução da consulta é armazenado na saída do conector, dentro do contexto de execução do fluxo. | | {% endtab %} | | | {% tab title="Pré-requisitos" %} ### Pré-requisitos Para utilizar este conector, é necessário que haja um Datasource cadastrado em seu ambiente e uma conexão com banco de dados suportado. Caso ainda não tenha um, consulte a documentação de Datasources para aprender como realizar o cadastro de um novo Datasource. [Clique aqui](/guia/ferramentas/construcao/floui-datasources.md) para entender mais sobre Datasources. {% endtab %} {% tab title="Payload" %} ### Sucesso Ao executar com sucesso o Datasource no contexto do Fluxo, via conector, os dados estarão disponíveis no caminho parametrizado na configuração Output Path dentro de `data`, em formato de JSON Array. As variáveis parametrizadas no conector estarão disponíveis no caminho `input_vars`. Exemplo:

### Erros Em casos de erro, se for escolhida a opção de interromper a execução do fluxo, uma `flow_run_exception` será gerada durante a execução, indicando o motivo do erro. Exemplo:

Se for escolhida a opção de continuar a execução do fluxo mesmo em casos de erro, o processo não será interrompido, mas o erro será registrado na saída do conector. Nesse caso, o campo `error` terá o valor booleano `true`, permitindo que o erro seja tratado no contexto do fluxo para realizar as devidas validações. Exemplo:

### Variáveis Os Datasources podem conter variáveis obrigatórias para que a consulta seja realizada corretamente. Para isso, é necessário também parametrizar essas variáveis no conector, garantindo o sucesso na execução do fluxo. Caso a variável obrigatória não tenha sido parametrizada no conector, a execução retornará um erro, podendo interromper ou não o processo, dependendo da configuração do conector. Exemplo:

Além disso, na configuração do Datasource, é possível atribuir um valor padrão a uma variável. Nesse caso, se a variável obrigatória não for parametrizada no conector, a execução utilizará o valor padrão definido na configuração do Datasource. No exemplo abaixo, a variável `min_stock`, configurada no Datasource, é obrigatória, mas possui um valor padrão de 50. Como essa variável não foi parametrizada no conector, a execução usará o valor padrão de 50.

Caso o Datasource utilizado não possua variáveis, a tabela de parâmetros não necessita ser configurada. {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.floui.io/guia/conectores/categorias/servicos-do-floui/floui-datasource/consultar-dados.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.