Tutoriais

jsonW: como filtrar linhas de um arquivo grande pelo terminal?

No jsonW, use wjsw filtrar com operadores como = e > para pegar linhas de um .jsw no terminal. Veja a sintaxe, a saída real e os erros comuns.

Por Equipe Wortic 7 min de leitura

No jsonW, para filtrar linhas de um arquivo grande pelo terminal, use wjsw filtrar com o arquivo e uma condição entre aspas simples, como preco > 10 BRL. O comando aceita os operadores =!=, <, <=, >, >=, ~ para contém, além de campo nulo e campo nao-nulo. Se você informar um nome de arquivo no fim, as linhas que passam vão para um .jsw novo.

Qual é a sintaxe do filtrar?

A ajuda do wjsw 1.4.1 mostra a forma: o arquivo, a condição com campo, operador e valor, e, opcionalmente, o arquivo de saída. Quando são várias condições, separe com ponto e vírgula. O guia de comandos dá um exemplo com duas condições, peso maior que 500 e preço menor que 10 BRL, e diz que dinheiro pede a moeda.

Qual é o passo a passo para filtrar um arquivo grande?

  1. Rode wjsw info e confirme o nome exato das colunas e o tipo de cada uma.
  2. Escreva a condição com o nome da coluna, o operador e o valor. Para dinheiro, inclua a moeda, como BRL.
  3. Coloque a condição entre aspas simples no terminal, para o shell não interpretar o sinal de maior.
  4. Rode wjsw filtrar sem arquivo de saída, para ver as linhas e o resumo.
  5. Quando o resultado estiver certo, acrescente o nome do arquivo de saída para gravar um .jsw novo.
  6. Rode wjsw conferir no arquivo de saída.

Como foi o teste?

No arquivo de seis produtos fictícios, filtrei as linhas de São Paulo com preço acima de 10 BRL. Depois mandei o filtro só de preço para um arquivo novo:

wjsw filtrar vendas.jsw 'preco > 10 BRL; uf = SP'
2 de 6 linhas em 0.1 ms · blocos 1, pulados pela zona 0 · linhas lidas 6
wjsw filtrar vendas.jsw 'preco > 10 BRL' sp-caros.jsw
4 de 6 linhas em 0.0 ms · blocos 1, pulados pela zona 0 · linhas lidas 6
-> sp-caros.jsw

O resumo vem antes das linhas que passam. Aqui mostrei só o resumo, para caber na leitura. Na primeira execução, saíram duas linhas, ambas de São Paulo e com preço acima de 10 BRL. Na segunda, o arquivo sp-caros.jsw recebeu as quatro linhas com preço acima de 10 BRL.

Qual é o erro de moeda, e a mensagem exata?

No teste, a condição preco > 10, sem a moeda, falhou. A saída foi esta:

valor de preco: dinheiro: esperava numero + moeda (12,50 BRL) perto de ""

A mensagem diz que o valor de preco era dinheiro e que pedia número mais moeda, com um exemplo em 12,50 BRL. O erro é útil, porque mostra o formato certo. Escreva o valor com a moeda, como BRL, e a condição passa a funcionar.

Qual é o erro de coluna errada, e a mensagem exata?

Outro erro comum é usar um nome de coluna que não existe. Rodei wjsw filtrar com a condição cidade = SP, e a saída foi:

campo cidade nao existe

O código de saída foi 1. Antes de filtrar, rode wjsw info para ver as colunas do arquivo. Os nomes são sensíveis ao que está no esquema, e um erro de digitação aparece logo nesta mensagem.

Como o jq faz o mesmo filtro?

O jq também filtra linhas de JSON, e a página do manual do jq diz: “jq is parsed as a sequence of whitespace-separated JSON values which are passed through the provided filter one at a time.” No teste, lendo a saída do para-texto, o filtro com jq trouxe os mesmos produtos de São Paulo:

wjsw para-texto vendas.jsw --json | jq -r 'select(.uf == "SP") | .produto'
Cafe especial
Biscoito
Granola

A diferença está no ponto de partida. O jq filtra o texto que já saiu do arquivo, e o wjsw filtrar atua sobre o .jsw, com zonas que pulam blocos inteiros. Num arquivo grande e com vários blocos, esse atalho de zonas é o que o jq não tem, porque ele lê o JSON que recebe.

E o SQLite? Um WHERE faz o mesmo?

Sim, para a condição de uf e de estoque. Criei a tabela no sqlite3 local com as colunas id, produto, uf e estoque, e rodei uma consulta com WHERE. A página do programa sqlite3 descreve o programa como a forma oficialmente suportada de trabalhar com SQL na linha de comando. A consulta foi esta, e o resultado coincide com o filtro do jsonW sobre estoque:

sqlite3 teste.db "select produto from vendas where uf = 'SP' and estoque > 10 order by id;"
Cafe especial
Granola

Na prática, o SQLite pede uma tabela criada antes, e o wjsw não. Para um arquivo que já é .jsw, o filtrar é o caminho direto. Para um banco que já existe, o WHERE é o natural.

O que fazer quando a coluna não é número?

Quando a coluna é texto e você usa um operador de comparação numérica, o caminho certo é conferir o tipo da coluna com wjsw info antes de filtrar. O tipo decide quais operadores fazem sentido. Para texto, o operador de contém costuma ser o certo. O guia de comandos mostra, por exemplo, um filtro de grafia parecida com o operador de som em português, que aceita um limiar de 0 a 1. Esse tipo de filtro é útil quando a coluna guarda marcas, cidades ou produtos digitados à mão.

Quando filtrar não basta?

Um filtro devolve linhas. Se o que você quer é um total, use wjsw calcular, que conta, soma e tira a média por grupo. Se o que você quer é o ranking das maiores, use wjsw escolher. E atenção à permissão: segundo o README da versão 1.4.1, uma condição sobre coluna escondida falha com aviso de falta de permissão, e a saída dessa coluna sai vazia sem a visão.

Onde a Wortic entra nisso?

A Wortic publica o jsonW, e a página para desenvolvedores da Wortic diz que o formato é grátis para usar dentro do seu produto. Quem liga a Wortic ao Claude ou ao ChatGPT encontra o caminho na página sobre como usar a Wortic dentro do Claude e do ChatGPT. As APIs abertas de CNPJ e CEP estão na página para desenvolvedores. Os planos da Wortic estão na página de planos, e o código público do jsonW fica no GitHub.

Perguntas frequentes

O que é wjsw filtrar?

É o comando que seleciona as linhas de um .jsw que atendem a uma ou mais condições. Ele aceita operadores de comparação, de contém e testes de campo nulo. Pode gravar o resultado num .jsw novo.

Como usar wjsw filtrar na prática?

Escreva a condição entre aspas simples, por exemplo preco > 10 BRL. Separe as condições com ponto e vírgula. No teste, a condição com moeda e uma coluna de São Paulo devolveu duas linhas.

Quais são os limites de wjsw filtrar?

Valor de dinheiro sem moeda dá erro, e coluna que não existe também. Condições sobre colunas escondidas pela permissão falham. O filtro devolve linhas, então, para totais, use calcular.

Fontes

Conheça: Zonas no jsonW: pular blocos inteiros.

Quer isso funcionando na sua empresa?

Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.

Falar com um consultor

Equipe editorial

Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.

  • Automacao com IA
  • Gestao empresarial
  • CRM
  • ERP
  • Marketing digital

Isso funcionando no seu negócio.

Um consultor mostra o sistema do seu ramo, com a IA dentro.