Pular para o conteúdo
Tecnologia

O prazo de cada chave do Redis sobrevive à exportação? Como o jsonW leva os 5 tipos e o TTL e traz de volta

O Redis virou memória e estado de agentes de IA, e isso põe mais dado importante em chaves com prazo de validade. Veja como o wcon do jsonW leva string, hash, list, set, zset e o TTL para um arquivo .jsw e devolve por MULTI/EXEC, com os limites ditos com clareza.

Por Equipe Wortic 11 min de leitura
O prazo de cada chave do Redis sobrevive à exportação? Como o jsonW leva os 5 tipos e o TTL e traz de volta

Em 6 de novembro de 2026, a Redis anunciou uma nova fase do Redis Iris, o mecanismo de contexto em tempo real para agentes de IA. Segundo o comunicado distribuído pela PRNewswire e publicado pelo Broadcast, o Iris passou a ter seis recursos: Intent Router, Agent Playbooks, Agent Memory, Context Gateway, Lens e Agent Mesh. O Unite.AI, em texto de 4 de novembro, conta que quatro estão em disponibilidade geral e dois em beta. O argumento do CEO, Rowan Trollope, é que agentes precisam de dados de aplicação em tempo real, estado de execução e comunicação entre serviços. Ou seja, o Redis deixa de ser só o cache da loja virtual e passa a guardar memória, estado e filas de sistemas que tomam decisões.

O que muda na prática para quem decide tecnologia

Quanto mais coisa importante mora no Redis, mais perguntas simples aparecem e mais difíceis de responder. Dá para copiar essas chaves para outro ambiente de teste? Dá para guardar uma foto delas para auditoria? Dá para migrar de Redis para Valkey, ou o contrário, sem perder o prazo de validade de cada chave? Um TTL perdido numa cópia pode transformar uma sessão que deveria expirar em dado eterno. Um hash lido como texto solto pode virar um problema de leitura meses depois.

O jsonW tem uma resposta direta para esse caso. O README do repositório oficial descreve o comando wcon redis, que tira as chaves do Redis ou do Valkey para um arquivo .jsw, e o wcon redis-gravar, que devolve o arquivo ao servidor. Pela tabela do README, a volta é gravada em MULTI/EXEC e cobre string, hash, list, set, zset e o TTL de cada chave.

O problema: uma chave do Redis tem tipo e prazo

Uma chave do Redis não é só um nome e um valor. Ela pode ser uma string, um hash, uma lista, um conjunto ou um conjunto ordenado, e pode ter prazo para expirar. O README do jsonW parte de uma queixa geral: hoje o mesmo dado passa por JSON para trafegar, por CSV ou Parquet para guardar, por um banco de vetores para a busca e por mais uma camada de permissão. Cada conversão custa tempo e memória, e às vezes custa o próprio dado. O AGENTS.md do projeto reforça a regra: não exporte para CSV ou JSON no meio do caminho, porque se perde tipo, zero à esquerda e precisão.

Para o Redis, o caminho do jsonW é um só: do servidor para o .jsw e de volta, sem formato intermediário.

O fluxo, do servidor ao arquivo e de volta

flowchart LR
    RD[(Redis ou Valkey)] --> W{{wcon redis}}
    W --> J[arquivo .jsw]
    J --> V[wjsw conferir]
    J --> G{{wcon redis-gravar}}
    G --> RD2[(Redis ou Valkey de destino)]

Na volta, o README informa que a gravação usa MULTI/EXEC. Pela documentação oficial do Redis, essa dupla de comandos faz o seguinte: os comandos entram numa fila depois do MULTI e só são executados quando o EXEC chega. Eles rodam em sequência, e nenhum pedido de outro cliente é atendido no meio da execução. Se a conexão cair antes do EXEC, nenhuma operação é executada.

sequenceDiagram
    autonumber
    participant A as wcon redis-gravar
    participant R as Redis ou Valkey
    A->>R: MULTI
    R-->>A: OK
    A->>R: comandos de cada chave (tipo e TTL)
    R-->>A: QUEUED
    A->>R: EXEC
    R-->>A: respostas de cada comando

O diagrama é uma leitura do que o README e a documentação do Redis dizem juntos. O README não detalha comando por comando o que o wcon envia dentro da transação.

Exemplo real, tirado do README

A credencial vai em arquivo, nunca na linha de comando. No Redis, o arquivo guarda só a senha. O exemplo do AGENTS.md leva todas as chaves que começam com sessao: para um arquivo:

WREDIS_CRED=~/.cred/redis wcon redis 127.0.0.1:6379 "sessao:*" sessoes.jsw
wjsw conferir sessoes.jsw
wcon redis-gravar sessoes.jsw 127.0.0.1:6379

As duas primeiras linhas aparecem nesses termos na documentação do projeto: a do wcon redis no AGENTS.md e a do wjsw conferir nas regras do mesmo arquivo, que mandam conferir depois de gravar. A resposta esperada do conferir é ok: N linhas, B blocos, sha256 e crc32c conferidos. A terceira linha é o comando de volta, na forma wcon redis-gravar arq.jsw host:porta descrita na tabela de bancos do README.

Comparação honesta com o que se usa hoje

  • Exportar para JSON ou CSV com um script. Resolve rápido e qualquer equipe entende. O custo é o que o README aponta: tipo, zero à esquerda e precisão podem se perder, e o prazo de cada chave precisa de tratamento à parte.
  • Ferramentas do próprio Redis. Para uma cópia fiel do servidor, elas existem e a documentação oficial é a referência. O README do jsonW não compara o wcon com elas, e este texto também não.
  • jsonW. Entrega um arquivo único com custódia (crc32c e SHA-256 em cadeia), que o wjsw conferir valida, e que pode ser lido depois pelo wjsw ou por um dos 10 SDKs. Em troca, é mais uma ferramenta para a equipe aprender, e o wcon roda em macOS e Linux. No Windows, o caminho é o WSL.

Economia e velocidade: o que o README mede e o que não mede

Os números publicados no README e em jsonw.org são estes: o arquivo ocupa 4,9 vezes menos espaço que o JSONL dos mesmos dados, e ler um campo de uma linha é 3.281 vezes mais rápido. A medição usou 100 mil registros, contra o mesmo conjunto em JSONL lido pelo leitor de JSON do próprio projeto. O README avisa que bibliotecas de JSON mais otimizadas diminuem a diferença de gravar e ler tudo, e que o ganho no acesso direto vem do formato em colunas. Dá para medir na própria máquina com wjsw medir.

Há limites que precisam ficar claros. Essa medição não é específica do Redis, e o README não traz números de memória do servidor, de tempo de migração nem de custo de nuvem para o wcon redis. Quem for decidir deve medir com as próprias chaves.

Qualidade do dado e verificação

O README diz que o jsonW foi provado contra o banco de verdade, com carga hostil (injeção, aspas, \0, acentos, emoji e texto da direita para a esquerda). Para o Redis, a tabela de provas cita o Redis 7, com os 5 tipos e o TTL. Isso é um registro do projeto, não uma garantia para todas as versões. Quem usa outra versão do Redis ou do Valkey deve repetir o teste em um ambiente separado antes de apostar em produção.

Um ponto da documentação oficial pede atenção na volta. Segundo a página de transações do Redis, um comando que falha depois do EXEC não impede a execução dos demais, e o Redis não faz rollback. Por isso, depois de qualquer restauração, vale comparar a contagem de chaves e uma amostra de valores e prazos com a origem. O README do jsonW não descreve como o wcon trata uma falha desse tipo, e a recomendação de conferir depois é uma boa prática, não uma promessa do projeto.

Segurança e permissão

O README afirma que o valor viaja como dado, com o tamanho na frente (no Redis, pelo protocolo RESP), nunca montado dentro de um comando, e que a senha vem de um arquivo, nunca da linha de comando nem da saída. Dentro do .jsw, a permissão mora no formato: colunas marcadas com +pessoal ou +escopo(x) saem nulas sem o escopo certo, e uma coluna tenant separa as linhas por cliente. Isso vale para quem lê o arquivo com o wjsw ver, o wjsw-cgi ou um SDK. O para-texto, que exporta tudo, não aplica a visão e deve ficar com quem já pode ver o arquivo inteiro.

Passo a passo para testar sem risco

  1. Suba uma cópia de teste do Redis ou do Valkey, com chaves de verdade e prazos variados.
  2. Guarde a senha em um arquivo com permissão restrita e aponte WREDIS_CRED para ele.
  3. Rode wcon redis com o padrão de chaves que interessa e gere o .jsw.
  4. Rode wjsw conferir e wjsw info para ver esquema, blocos, tamanho e hash.
  5. Restaure em um servidor vazio com wcon redis-gravar.
  6. Compare chaves, tipos, valores e TTL entre origem e destino. Só depois pense em usar no fluxo real.

Como a Wortic ajuda

O jsonW é criado e mantido pela Wortic, que roda nele os próprios sistemas. A licença é de uso sustentável: o uso é grátis dentro do seu produto, em quantos servidores quiser, e não vale revender o jsonW como serviço nem fazer engenharia reversa do núcleo. A documentação e os binários estão em jsonw.org e no repositório do projeto. Para um acordo comercial ou outra plataforma, o contato é pelo site da Wortic.

Perguntas frequentes

O jsonW consegue exportar o Redis com o TTL de cada chave?

Segundo o README do jsonW, sim. O comando wcon redis leva as chaves do Redis ou do Valkey para um arquivo .jsw, e o wcon redis-gravar devolve com MULTI/EXEC, cobrindo string, hash, list, set, zset e o TTL de cada chave. A prova citada no projeto usou o Redis 7.

Como exportar chaves do Redis para um arquivo sem perder o tipo?

Com o wcon redis, indicando host, porta e um padrão de chaves, como sessao:*. A senha fica em um arquivo apontado por WREDIS_CRED. O jsonW, mantido pela Wortic, evita o formato intermediário em CSV ou JSON, que o AGENTS.md aponta como causa de perda de tipo e precisão.

O jsonW funciona com Valkey?

O README lista Redis e Valkey na mesma linha da tabela de bancos, com os mesmos comandos. A prova de ida e volta citada foi feita no Redis 7. Para o Valkey, vale repetir o teste em ambiente separado antes de usar em produção.

A restauração do Redis pelo jsonW é atômica?

O README diz que a volta é gravada em MULTI/EXEC. Pela documentação do Redis, os comandos de uma transação rodam em sequência e isolados, e uma queda antes do EXEC não executa nada. Porém, o Redis não faz rollback de um comando que falha depois do EXEC. Por isso, convém conferir chaves e prazos após restaurar.

Como colocar a senha do Redis no wcon sem expor?

O README manda guardar a senha em um arquivo e apontar a variável WREDIS_CRED para ele. No Redis, o arquivo contém só a senha. A senha não deve ir na linha de comando nem em URL.

Quanto o jsonW economiza de disco e de tempo?

O README informa um arquivo 4,9 vezes menor que o JSONL e uma leitura de um campo 3.281 vezes mais rápida, medidas com 100 mil registros contra o JSONL lido pelo leitor de JSON do próprio projeto. Não são números específicos do Redis. O comando wjsw medir permite medir com os seus dados.

O wcon roda no Windows?

Segundo o README e o AGENTS.md, o wcon e o wremoto estão nos binários de macOS e Linux. No Windows, a orientação é rodar pelo WSL.

O que a Wortic faz com o jsonW?

A Wortic criou e mantém o jsonW, um modelo de dados com núcleo em C e SDKs em 10 linguagens, e diz rodar nele os próprios sistemas. O uso dentro do seu produto é grátis pela Licença de Uso Sustentável. Detalhes em jsonw.org e no repositório developer-wortic/jsonw.

Fontes

Conheça: jsonW com Redis e Valkey.

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.