Consultar dados
Realiza uma consulta em um Datasource cadastrado no workspace.
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
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.
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.
Last updated
Was this helpful?