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.

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?
- Rode wjsw info e confirme o nome exato das colunas e o tipo de cada uma.
- Escreva a condição com o nome da coluna, o operador e o valor. Para dinheiro, inclua a moeda, como BRL.
- Coloque a condição entre aspas simples no terminal, para o shell não interpretar o sinal de maior.
- Rode wjsw filtrar sem arquivo de saída, para ver as linhas e o resumo.
- Quando o resultado estiver certo, acrescente o nome do arquivo de saída para gravar um .jsw novo.
- 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.jswO 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 existeO 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
GranolaA 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
GranolaNa 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
- AGENTS.md do jsonW: guia de comandos
- README do jsonW (versão 1.4.1)
- docs/JSONW.md do jsonW: formato e garantias
- Texto de ajuda do wjsw 1.4.1 (binário no repositório público)
- Manual do jq
- Página do programa sqlite3
- Página para desenvolvedores da Wortic
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 consultorEquipe editorial
Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.
- Automacao com IA
- Gestao empresarial
- CRM
- ERP
- Marketing digital
