Consultar dados

Realiza uma consulta em um Datasource cadastrado no workspace.

Parâmetros

Parâmetros de configuração

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.

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 para entender mais sobre Datasources.

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:

Exceção em caso de erro

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:

Continuar a execução em caso de erro

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:

Variável obrigatória em datasource

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.

Valor padrão de variável de datasource

Caso o Datasource utilizado não possua variáveis, a tabela de parâmetros não necessita ser configurada.