# 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](https://docs.floui.io/guia/ferramentas/construcao/floui-datasources) 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 %}