jsonW e PostgreSQL: com quais versões ele funciona?
No jsonW, o wcon lê e grava PostgreSQL. Testei o 18.6: a data caiu um dia na volta com o fuso Brazil/East, e PGTZ=UTC resolve o caso.

No jsonW, o conector wcon lê e grava PostgreSQL. O README diz ter provado o conector nas versões 14, 16 e 18. Eu rodei só o PostgreSQL 18.6, numa base de teste local. Nele, as seis linhas voltaram iguais em todas as colunas, exceto a data, que caiu um dia para trás quando a sessão estava no fuso Brazil/East. Com o fuso em UTC, o md5 bateu nas duas pontas. Não testei 14 nem 16.
Quais versões foram provadas, e quais não foram?
O README do repositório diz que o jsonW foi “Tested against the real thing”, com a frase seguinte: “PostgreSQL 14, 16 and 18 (md5 on both sides)”. Ou seja, a afirmação é de que a comparação foi feita célula por célula nas três versões. Eu não tenho acesso a um servidor de PostgreSQL 14 ou 16 neste Mac, e a base de teste que usei roda só a versão 18. Por isso, este texto confirma a versão 18.6 e deixa 14 e 16 como afirmação da documentação, não como prova minha. Quem precisa dessas versões deve rodar o mesmo roteiro no servidor real antes de confiar.
Como preparei a base de teste?
Criei uma base nova e vazia, clonada de um modelo de teste, e nela uma tabela com tipos variados. A ideia era cobrir os casos que mais costumam dar problema: número com casas decimais, data com hora e fuso, data sem hora, texto com zero à esquerda, booleano, ponto flutuante e valores nulos. A tabela de destino, usada na volta, foi criada com a mesma estrutura.
CREATE TABLE vendas (
id bigint PRIMARY KEY,
produto text NOT NULL,
preco numeric(10,2),
quando timestamptz,
dia date,
sku text,
ativo boolean,
nota double precision
);
INSERT INTO vendas VALUES
(1,'Cafe especial',12.50,'2026-11-10 09:30:00-03','2026-11-10','000123',true,4.5),
(2,'Cha verde',8.90,'2026-11-11 14:05:21.123456-03','2026-11-11','0045',false,NULL),
(3,'Mel',21.75,'2026-11-12 00:00:00+00','2026-11-12','SKU-9',true,0.1),
(4,'Biscoito',4.00,NULL,NULL,NULL,NULL,3.0),
(5,'Granola',15.30,'2026-11-13 18:45:00-03','2026-11-13','0007',true,2.25),
(6,'Azeite',33.00,'2026-11-14 08:00:00-03','2026-11-14','0001',false,7.0);
CREATE TABLE vendas_volta (LIKE vendas INCLUDING ALL); Depois da carga, conferi as linhas com um SELECT simples, para ter a referência de origem antes de exportar.
Passo a passo: do PostgreSQL ao arquivo e de volta
- Confirmei o esquema que o wcon daria para a consulta, sem gravar nada. Com wcon pg-esquema, a saída foi a linha de esquema que aparece no passo seguinte.
- Exportei a tabela com wcon pg, usando a URL na variável WSQL_URL. A senha, em um ambiente real, deve ficar em PGPASSWORD ou no arquivo ~/.pgpass, e não na linha de comando.
- Conferi o arquivo com wjsw info e wjsw conferir.
- Gravei de volta com wcon pg-gravar, na tabela vendas_volta.
- Comparei as duas tabelas com md5 sobre todas as linhas, em ordem de id.
WSQL_URL=postgresql://usuario@127.0.0.1:PORTA/jsonw_957 wcon pg-esquema "select * from vendas order by id"
id:i64?,produto:texto?,preco:decimal[2]?,quando:tempo?,dia:tempo?,sku:texto?,ativo:bool?,nota:f64?
WSQL_URL=postgresql://usuario@127.0.0.1:PORTA/jsonw_957 wcon pg "select * from vendas order by id" vendas_pg.jsw
6 linhas em 533 ms · COPY binario do Postgres 0.0 MB -> jsonW 0.0 MB
esquema: id:i64?,produto:texto?,preco:decimal[2]?,quando:tempo?,dia:tempo?,sku:texto?,ativo:bool?,nota:f64?
wjsw conferir vendas_pg.jsw
ok: 6 linhas, 1 blocos, sha256 e crc32c conferidos
WSQL_URL=postgresql://usuario@127.0.0.1:PORTA/jsonw_957 wcon pg-gravar vendas_pg.jsw public.vendas_volta
6 linhas gravadas em public.vendas_volta (COPY binario, uma transacao) Os tipos chegaram como o README descreve: numeric virou decimal com duas casas, e timestamptz e date viraram tempo. O zero à esquerda do sku, como 000123 e 0045, também sobreviveu, porque a coluna foi tratada como texto. Os nulos saíram como null no arquivo e voltaram como nulos no banco.
O que a comparação mostrou?
Com a sessão no fuso padrão do servidor, Brazil/East, o md5 das duas tabelas não bateu. Ao comparar linha por linha, a diferença estava só na coluna dia. A data 2026-11-10 voltou como 2026-11-09, e a 2026-11-12 como 2026-11-11. Todas as outras colunas bateram, inclusive o timestamptz com microssegundos, que voltou com o mesmo instante.
origem|(1,"Cafe especial",12.50,"2026-11-10 09:30:00-03",2026-11-10,000123,t,4.5)
volta |(1,"Cafe especial",12.50,"2026-11-10 09:30:00-03",2026-11-09,000123,t,4.5) Refiz a gravação com o fuso em UTC, de duas formas: com a variável PGTZ=UTC no cliente, e com a opção TimeZone em UTC dentro da URL. Nos dois casos, o md5 de volta bateu com o md5 da origem, que foi d0d35a49312fb3cc31f1dd29f30488ad.
PGTZ=UTC WSQL_URL=postgresql://usuario@127.0.0.1:PORTA/jsonw_957 wcon pg-gravar vendas_pg.jsw public.vendas_utc
WSQL_URL="postgresql://usuario@127.0.0.1:PORTA/jsonw_957?options=-c%20TimeZone%3DUTC" wcon pg-gravar vendas_pg.jsw public.vendas_tz Por que a data mudou um dia?
Quando li o arquivo com wjsw ver, a data já estava como instante em UTC. Por exemplo, a linha 1 aparece com dia:t"2026-11-10T00:00:00.000000Z". Ou seja, a leitura estava certa nos dois casos, com o fuso padrão e com PGTZ=UTC. O que muda é a volta. Ao gravar, o driver converte o instante para a data local da sessão, e com o fuso de Brazil/East, meia-noite UTC cai no dia anterior. Esse é o mecanismo que o que eu vi sugere, mas não o rastreei dentro do código do conector.
O README diz que a data é written back exactly, e o AGENTS.md diz que “No Postgres, timestamptz, timestamp e date viram tempo e voltam iguais”. Nesta base de teste, com este fuso, a data não voltou igual. Por isso a recomendação prática é gravar com o fuso em UTC, e confirmar o md5 depois.
Quais erros aparecem, e o que significam?
Errei de propósito três vezes, para ver a mensagem de cada caso. Na primeira, rodei o wcon pg sem a variável WSQL_URL. A primeira linha da saída não falou do banco, e sim da API do Docker:
failed to connect to the docker API at unix:///var/run/docker.sock; check if the path is correct and if the daemon is running: dial unix /var/run/docker.sock: connect: no such file or directory
falhou: a consulta nao abriu (psql 256, 0 colunas) Ou seja, sem a URL, o wcon tenta antes um caminho de contêiner, e a mensagem parece ser de Docker mesmo quando a intenção é o PostgreSQL. A solução é definir WSQL_URL. Na segunda, apontei para a porta errada, e a mensagem veio do cliente psql:
psql: erro: a conexão com o servidor em "127.0.0.1", porta 55441 falhou: Connection refused
falhou: a consulta nao abriu (psql 512, 0 colunas) Na terceira, usei uma tabela que não existe. O erro veio do servidor:
ERROR: relation "tabela_que_nao_existe" does not exist
falhou: a consulta nao abriu (psql 768, 0 colunas) Nos três casos o código de saída foi 1 e nenhum arquivo foi criado. Esse detalhe importa em um script, porque o arquivo de saída não aparece quando a consulta falha.
Quando usar o wcon com PostgreSQL, e quando não usar?
Use o wcon quando o dado precisa sair do PostgreSQL com tipo preservado, para ler, filtrar ou guardar um arquivo que passa na conferência. Valor com casas decimais vira decimal exato, e o zero à esquerda de um código não se perde. A documentação do PostgreSQL sobre o parâmetro de fuso, descrito na página de configuração do cliente, explica por que a sessão importa. A página de variáveis de ambiente do libpq lista PGTZ, que foi a forma que funcionou aqui.
Não use o wcon com PostgreSQL 14 ou 16 como se estivesse provado por você sem rodar o teste no seu servidor. Também não use a volta com data sem conferir o fuso do servidor, porque foi justamente aí que a data mudou. Não testei o tipo vector do pgvector, então não afirmo nada sobre ele. E não testei a gravação sem a tabela de destino criada antes, já que, no meu teste, a tabela de volta existia.
O que a documentação não cobre?
A documentação do repositório fala em md5 nas versões 14, 16 e 18, mas não diz qual fuso foi usado no teste. Também não traz o resultado da volta com fuso negativo, que é o caso comum no Brasil. O README diz que a data volta exata, e o meu teste mostrou o contrário com o fuso padrão. Sem o número de versões que você usa, a afirmação vale só para o que foi rodado. Não testei autenticação por senha em arquivo, porque a base de teste usou autenticação de confiança local.
Onde a Wortic entra nisso?
O jsonW é publicado pela Wortic, e o código público fica no repositório developer-wortic/jsonw, com o README que cita os testes. Quem usa Claude ou ChatGPT encontra a ligação na página sobre como usar a Wortic dentro do Claude e do ChatGPT. A página para desenvolvedores tem as APIs abertas. Os planos da Wortic ficam na página de planos.
Perguntas frequentes
Com quais versões do PostgreSQL o jsonW funciona?
O README diz que foi provado nas versões 14, 16 e 18. Eu rodei só a 18.6, com seis linhas de teste. As versões 14 e 16 ficam como afirmação da documentação, sem prova minha.
Por que a data muda um dia na volta?
Com o fuso Brazil/East na sessão, a meia-noite UTC da data cai no dia anterior ao gravar. Com PGTZ=UTC ou TimeZone=UTC na URL, o md5 bateu com a origem.
Que erro aparece sem a URL do banco?
O wcon mostra primeiro uma mensagem sobre a API do Docker, e depois falhou com código 1. Defina WSQL_URL antes de rodar o comando.
Fontes
- README do jsonW, com os testes contra PostgreSQL
- AGENTS.md do jsonW, com as regras de datas
- Configuração do cliente no PostgreSQL 18
- Variáveis de ambiente do libpq no PostgreSQL 18
- Página para desenvolvedores da Wortic
Conheça: jsonW com PostgreSQL: ida e volta sem perda pelo COPY binário.
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
