JSON a SQL: de um payload para uma tabela que você pode

Como os tipos são mapeados de JSON a SQL

• Strings → `TEXT` (`VARCHAR(n)` quando você conhece o orçamento de comprimento).
• Números inteiros → `INTEGER` / `BIGINT`, decimais → `NUMERIC` em vez de ponto flutuante, especialmente para dinheiro.
• Booleanos → `BOOLEAN`.
• Objetos e arrays aninhados → `JSONB` no PostgreSQL, `JSON` no MySQL 8 — ou normalize-os em tabelas filhas quando os dados vieram para ficar.
• Chaves ausentes → colunas anuláveis, nunca um padrão que falsifica um valor.

Uma tabela gerada é um excelente ponto de partida e uma migração terrível. Escreva o esquema desejado e use o SQL gerado como referência para nomes e tipos de colunas.

Escapar não é opcional

Strings em JSON normalmente contêm apóstrofos — `O’Brien`, `it's done` — e coladas em SQL à mão elas terminam a string literal mais cedo e quebram a instrução. As instruções INSERT geradas duplicam todas as aspas corretamente, que é a coisa mais útil que a conversão faz para você. Para inserções em massa, envolva as linhas em uma instrução para que o banco de dados possa gravar em lote em vez de confirmar por linha.

Bons usos, maus usos

Dados de equipamentos para testes, uma cópia local de uma exportação API, propagação de um ambiente de demonstração e resposta a uma pergunta única em SQL se beneficiam de uma conversão de JSON para SQL. O gerenciamento do esquema de produção não: as migrações precisam de revisão, índices, restrições e um caminho de reversão. Gere a tabela e escreva à mão a migração enviada.

Matrizes e objetos: achatar ou armazenar?

Se um array for uma lista fixa de escalares, uma tabela filha com uma chave estrangeira mantém as consultas simples. Se for uma carga genuinamente dinâmica – corpos de webhook, metadados de terceiros – armazená-la como `JSONB` e indexar os caminhos que você consulta é a escolha pragmática. Decida como você irá consultá-lo: tudo o que você filtrar ou juntar pertencerá a uma coluna.

Execute-o no navegador

Exportações de banco de dados e dumps API são exatamente as cargas que não devem ser carregadas em um serviço desconhecido. A conversão de JSON para SQL aqui acontece inteiramente na página, então a declaração que você copia é construída a partir de dados que nunca saíram da sua máquina, e a ferramenta ainda funciona offline.