Conectores
Transformação de Dados
JQ
8min
objetivo/resumo o conector jq é uma ferramenta poderosa utilizada para filtrar, transformar, e manipular dados json de forma eficiente e flexível ele permite que desenvolvedores e analistas de dados realizem operações complexas em estruturas json, extraiam informações relevantes e formatem os dados de maneira customizada para atender a diversas necessidades de processamento e análise saiba mais manual tutorial wiki cookbook página oficial valide seus filtros neste playground criando um fluxo utilizando conector jq este conector não precisa de conexão para ser usado basta configurar suas parametrizações de acordo com a lógica a ser implementada no fluxo para usá lo, crie um fluxo e arraste o conector jq para o canvas obs criar fluxo docid\ ocjtbfhi9rerkr2d6owip o passo a passo para criar um fluxo após arrastar o conector para o canvas, selecione o e na aba parametrizações , preencha os seguintes parâmetros de configuração query/filter informe a query/filter jq que será aplicada no json de entrada (campo obrigatório) json input informe o json de entrada em que sera aplicada a query/filter (campo obrigatório) na aba propriedades dê um nome ao passo docid 9ju6qklqzlk13hl hftih e se necessário detalhe uma descrição para melhor uso do conector sugerimos acessar a documentação oficial do jq, lá você terá mais informações detalhadas como filtros basicos, expressões regulares entre outras, acesse aqui também deixaremos o playground oficial do jq para testar suas querys na prática neste tópico iremos criar um fluxo que irá demonstrar a execução de uma query jq em um json utilizando o conector jq assim ficará a parametrização do nosso primeiro e único passo a query/filter configuramos como {firstname name} ela irá montar um json onde o valor firstname será recuperado do json de entrada no qual será aplicado a query o json input iremos buscar do payload de entrada do fluxo utilizando fluid expression language docid 0vqvpw6saqz2z1jgp8fwc com a função getjsonescaped na aba propriedades informamos o nome do passo conclusão com o passo configurado basta disparar o fluxo informando o seguinte payload de entrada { "name" "john" } após o disparo, o resultado do fluxo aparecerá em realtime no canvas ao clicar em detalhes, temos a resposta gerada pelo conector jq filtros úteis liste chaves usadas em qualquer objeto em uma lista considere o seguinte array \[{"a" {"b" 1}}, {"a" {"c" 2}}] para obter uma lista das chaves no nível principal do array (gera o resultado \["a"] ) add | keys para obter a lista das chaves independente da profundidade onde elas aparecem \[ | objects | keys\[]] | unique resultado \["a", "b", "c"]