Tecnologia

Formato de dados aberto em português: como o jsonW funciona?

jsonW é um formato de dados da Wortic com texto compatível com JSON, arquivo em coluna, tipos de negócio e permissões. Veja como funciona.

Por Equipe Wortic 6 min de leitura

O jsonW é um formato de dados criado pela Wortic, no Brasil. O mesmo dado existe em três formas sem perda: texto, linha e coluna no arquivo .jsw. Todo JSON válido é um jsonW-texto válido. A versão atual é a 1.4.1, distribuída com a licença Sustainable Use, do tipo fair-code.

O que é o jsonW?

O jsonW é um formato de dados e uma biblioteca em C, sem dependências externas, com ferramenta de linha de comando e SDKs para várias linguagens. O README público resume o projeto como um arquivo que é ao mesmo tempo texto compatível com JSON, armazenamento colunar, índice vetorial para busca por significado e camada de permissão.

As palavras-chave do esquema são em português: texto, dinheiro, medida, codigo, tempo, dic e qualquer. O próprio README explica que o vocabulário é pequeno e fixo, e que o formato nasceu no Brasil.

Na prática, um arquivo jsonW traz no topo um esquema, uma linha com o nome e o tipo de cada coluna. Por exemplo, id, produto, preço e peso. O tipo diz o que o valor significa, e não só como ele está escrito. Um peso marcado como medida em gramas aceita quilos e converte ao gravar.

Como o mesmo dado vira texto, linha e coluna?

Um mesmo conjunto de registros pode ficar em três formas. A forma texto é legível por pessoas. A forma linha, binária, serve para eventos e mensagens. A forma coluna, no arquivo .jsw, serve para lotes, histórico e busca. A conversão entre elas não perde dado. Os comandos abaixo são do README do projeto:

wjsw de-texto 'id:i64,product:texto,price:dinheiro,weight:medida[g],sku:codigo' sales.jsonl sales.jsw

wjsw ver sales.jsw mostra as linhas em jsonW-texto. wjsw conferir sales.jsw faz a verificação completa, com sha256 e crc32c. wjsw para-texto sales.jsw --json devolve o JSON de volta, sem perda.

Quais tipos o jsonW tem que o JSON não tem?

O JSON guarda números, textos e listas. O jsonW acrescenta tipos pensados para dados de negócio, descritos na referência do formato:

  • dinheiro: cada valor leva a moeda ISO 4217, e a soma só acontece na mesma moeda.
  • decimal[2]: valor exato com escala fixa, sem passar por ponto flutuante.
  • medida[kg]: unidades da mesma grandeza são convertidas ao gravar, e outra grandeza é recusada.
  • codigo: bytes exatos, sem normalizar. Serve para CNPJ, chave, placa e SKU, em que o zero da frente não pode sumir.
  • tempo: microssegundos em UTC.
  • vf16[n] e vq8[n]: vetores, para busca por cosseno.

Como o jsonW controla quem vê cada dado?

A permissão fica no esquema. Uma coluna marcada com +pessoal só aparece para quem tem o escopo pessoal. Uma coluna marcada com +escopo(x) só aparece com o escopo x. Se houver uma coluna tenant com número inteiro, a credencial vê só as linhas do seu cliente.

A referência resume a regra assim: o que a sessão não pode ver não sai do servidor. Na conferência, cada bloco tem crc32c e o arquivo tem uma cadeia de SHA-256 ou BLAKE3. Qualquer byte alterado faz a conferência falhar.

O que ainda está em construção?

Há dois pontos para conhecer antes de adotar. O primeiro: a leitura de um arquivo .jsw usa um núcleo só hoje. Os blocos são independentes, o que permite leitura paralela, e ler em vários núcleos é o próximo passo. O segundo: a versão 1.4.0 traz cifragem do arquivo em repouso, com a chave guardada fora do arquivo. Versões mais antigas recusam o arquivo cifrado em vez de ler o conteúdo cifrado.

Dá para usar o jsonW sem trocar o banco de dados?

Dá. O comando wcon leva dados do PostgreSQL, MySQL, MariaDB, SQLite, Redis e MongoDB para um arquivo .jsw e de volta, em ida e volta sem perda, segundo o README. Você continua usando o seu banco. Para a leitura no navegador, há uma versão em WebAssembly do mesmo núcleo, só de leitura.

Quando faz sentido usar o jsonW?

Ele faz sentido quando o dado de negócio exige precisão: valores em dinheiro, medidas com unidade, códigos que não podem perder o zero da frente. Faz sentido também quando a mesma base serve clientes diferentes e cada um deve ver só a sua parte, como as linhas de cada cliente e as colunas marcadas com escopo.

Para uma primeira experiência, comece com um arquivo pequeno. Converta um JSONL com o comando de-texto, confira o resultado com o comando conferir e leia com o comando ver. Se o resultado bater com o que você esperava, o mesmo esquema cresce com os dados reais.

Perguntas frequentes sobre o jsonW

O jsonW é código aberto?

O formato, os SDKs, os tipos e a ferramenta de linha de comando são públicos, e você pode usá-los dentro dos seus produtos sob a licença Sustainable Use. Essa licença é do tipo fair-code, e não é uma licença open source no sentido da OSI. O núcleo em C vem como binário compilado, e você não pode revender o jsonW como serviço.

Preciso trocar meu banco de dados para usar o jsonW?

Não. O wcon faz a ida e a volta entre o seu banco e o arquivo .jsw, sem perda, segundo o README do projeto. Você mantém o banco e ganha o arquivo para análise, busca e permissões.

Dá para ler um arquivo jsonW no navegador?

Sim, desde a versão 1.3.14, pela versão em WebAssembly do mesmo núcleo C. A leitura é só de leitura: a escrita fica no servidor, e dados com permissão devem ter a visão aplicada no servidor antes de chegar ao navegador.

Perguntas frequentes

O jsonW é código aberto?

O formato, os SDKs, os tipos e a ferramenta de linha de comando são públicos, e você pode usá-los dentro dos seus produtos sob a licença Sustainable Use. Essa licença é do tipo fair-code, e não é uma licença open source no sentido da OSI. Você não pode revender o jsonW como serviço.

Preciso trocar meu banco de dados para usar o jsonW?

Não. O wcon faz a ida e a volta entre o seu banco e o arquivo .jsw, sem perda, segundo o README do projeto. Você mantém o banco e ganha o arquivo para análise, busca e permissões.

Dá para ler um arquivo jsonW no navegador?

Sim, desde a versão 1.3.14, pela versão em WebAssembly do mesmo núcleo C. A leitura é só de leitura, e dados com permissão devem ter a visão aplicada no servidor antes de chegar ao navegador.

Fontes

Conheça: jsonW (json Wondrous): o formato de dados da Wortic.

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.