Conversor JSON ⇔ CSV

O que é o Conversor JSON ⇔ CSV?

O Conversor JSON ⇔ CSV é uma ferramenta para converter entre o formato JSON — comumente usado em APIs da web e programação — e o formato CSV — amplamente utilizado em softwares de planilhas e sistemas empresariais.Enquanto o JSON pode representar dados estruturados usando objetos e matrizes, o CSV é um formato tabular simples composto por linhas e colunas, o que o torna adequado para importação para o Excel ou planilhas, revisão de dados em lista e transferência de dados para outros sistemas.Você pode usar essa ferramenta quando quiser salvar um JSON recuperado de uma API como um arquivo CSV ou quando quiser converter dados de lista em CSV para JSON, que possa ser processado por JavaScript ou por uma API.

Ao converter de JSON para CSV, geralmente você fornece uma matriz de objetos que contêm os mesmos tipos de campos. Por exemplo, se você tiver um JSON contendo vários objetos de produto com campos como nome, preço e estoque, cada chave se torna um cabeçalho de coluna no CSV, e cada objeto é exibido como uma única linha. Mesmo que um campo esteja presente apenas em algumas linhas, todas as chaves são coletadas para criar colunas, e as células sem valores são tratadas como em branco. Objetos aninhados podem ser expandidos em nomes de colunas, como `address.city`, ativando a opção “Expandir JSON aninhado usando notação de ponto”.

Ao converter de CSV para JSON, trate a primeira linha como nomes de colunas e converta as linhas a partir da segunda em um objeto. Como todos os valores no CSV são representados como strings, ativar a “Inferência de Tipo” permite converter 123 em um número, true ou false em booleanos e null em null.Para dados em que os zeros à esquerda são importantes — como códigos de produtos ou CEPs —, os valores devem ser mantidos como strings; portanto, recomenda-se desativar a inferência de tipo nesses casos.

Os delimitadores CSV suportam não apenas vírgulas, mas também tabulações, ponto-e-vírgulas e barras verticais. Se você selecionar tabulações, o arquivo poderá ser usado como um arquivo TSV.Se uma célula contiver vírgulas, quebras de linha ou aspas duplas, os dados serão colocados entre aspas duplas de acordo com as regras padrão do CSV, e quaisquer aspas duplas dentro dos dados serão duplicadas antes da saída. Isso permite que o sistema lide com dados que contenham texto ou descrições que, de outra forma, seriam facilmente corrompidos por uma simples substituição de string.

O processo de conversão desta ferramenta é realizado dentro do navegador usando JavaScript; ela não envia os arquivos JSON ou CSV inseridos para um servidor para conversão. Mesmo ao lidar com dados de clientes ou dados internos, você pode evitar o envio de dados para servidores externos. No entanto, tome precauções específicas em relação a dispositivos compartilhados, extensões de navegador e à segurança do próprio dispositivo. Conjuntos de dados muito grandes consomem uma quantidade significativa de memória do navegador; portanto, divida os dados conforme necessário.

Principais recursos

• É possível converter uma matriz de objetos JSON para CSV ou TSV.
• É possível converter arquivos CSV e TSV em uma matriz de objetos JSON.
• Aceita delimitadores como vírgula, tabulação, ponto-e-vírgula e barra vertical.
• É possível expandir objetos JSON aninhados em colunas com notação por pontos.
• Ao converter de CSV para JSON, o sistema pode inferir os tipos de valores numéricos, booleanos e valores nulos.
• É possível ativar ou desativar a exibição formatada do JSON.
• Você pode copiar os resultados ou salvá-los como arquivos CSV, TSV ou JSON.
• Os dados inseridos são processados no próprio navegador, em vez de serem enviados ao servidor. Conversões que exigem muitos recursos são executadas por meio de Web Workers, e o sistema foi projetado para minimizar interrupções na interação do usuário, mesmo enquanto o processamento está em andamento.

Como usar o conversor JSON ⇔ CSV

1. Selecione a direção da conversão entre “JSON → CSV” ou “CSV → JSON”.
2. Cole os dados no campo de entrada ou selecione um arquivo JSON, CSV ou TSV.
3. Selecione as configurações necessárias, como o delimitador CSV, a expansão de aninhamento JSON e a inferência de tipo para valores CSV.
4. Clique em “Converter” para exibir os resultados. Se a área de resultados estiver fora da tela, ela será automaticamente rolada para ficar visível.
5. Revise o conteúdo e use “Copiar resultados” ou “Baixar”.
6. Para reduzir a carga no seu dispositivo ao trabalhar com grandes conjuntos de dados, ative o “Modo de Baixa Carga”. Enquanto o processamento estiver em andamento, você pode usar o indicador de progresso e o botão “Pausar Processamento”.
7. Se você quiser converter na direção oposta, use “Inverter a direção da conversão” para mover o resultado para o lado da entrada e continuar a conversão.

Precauções de uso

• A conversão de JSON para CSV destina-se a dados que podem ser convertidos para um formato tabular; ela não consegue representar totalmente matrizes hierárquicas complexas.
• Quando a inferência de tipo CSV está ativada, valores como 00123 são tratados como cadeias de caracteres em vez de números; portanto, valores que começam com zero são automaticamente tratados como cadeias de caracteres.
• Ao converter de CSV para JSON, use a primeira linha como nomes de colunas. Como nomes de colunas duplicados serão sobrescritos pelos valores subsequentes, certifique-se de que os nomes das colunas sejam únicos.
• Como grandes quantidades de dados podem afetar a memória do dispositivo e o tempo de processamento, procure manter o tamanho do arquivo abaixo de 20 MB.

Perguntas frequentes sobre o conversor JSON ⇔ CSV

Que tipo de JSON devo inserir para convertê-lo em CSV?

Geralmente, você insere uma matriz de objetos. Mesmo um único objeto pode ser convertido em uma única linha de dados CSV.

O JSON aninhado também pode ser convertido para CSV?

Sim. Se você ativar a opção “Expandir JSON aninhado usando notação de ponto”, poderá expandi-lo em nomes de colunas, como endereço.cidade.

O que acontece com o JSON que contém matrizes?

Arrays dentro de objetos são gerados como strings JSON para que caibam em uma única célula do CSV. Recomendamos organizar a estrutura de dados multidimensionais complexos com antecedência.

Os dados serão convertidos em valores numéricos durante a conversão de CSV para JSON?

Quando a inferência de tipos está ativada, valores numéricos comuns, como `true`, `false` e `null`, são convertidos para seus respectivos tipos JSON. Quando desativada, todos eles são tratados como strings.

Os valores com zeros à esquerda, como 00123, podem ser mantidos?

Sim. Mesmo quando a inferência de tipos está ativada, garantimos que valores no formato inteiro com zeros à esquerda sejam armazenados como strings.

Ele também suporta TSV?

Sim. Se você selecionar “Tabulação (TSV)” como delimitador, poderá converter entre JSON e TSV.

É possível converter arquivos CSV que contenham vírgulas ou quebras de linha dentro das células?

Desde que os dados estejam entre aspas duplas, de acordo com as regras do CSV, o sistema pode interpretar vírgulas, quebras de linha e aspas duplas dentro das células.

Os arquivos JSON e CSV são enviados ao servidor?

Não. O carregamento e a conversão de arquivos são feitos por JavaScript no navegador.

Posso salvar os resultados da tradução como um arquivo?

Sim. Dependendo da direção da conversão, você pode baixar arquivos nos formatos .csv, .tsv ou .json.

Como é determinada a ordem das colunas em um arquivo CSV?

Reúna as chaves que aparecem no JSON em ordem, começando pelo primeiro objeto, e, se uma nova chave aparecer, adicione-a ao final.

A primeira linha do arquivo CSV é obrigatória?

Ao converter de CSV para JSON, a primeira linha é usada como chaves JSON; portanto, é necessária uma linha de cabeçalho contendo os nomes das colunas.

Posso converter arquivos do Excel diretamente?

Esta ferramenta é compatível com arquivos JSON, CSV e TSV. Salve os arquivos .xlsx como arquivos CSV antes de usá-los.

O que devo fazer se o navegador ficar lento ao lidar com arquivos grandes?

Quando o Modo de Baixa Carga está ativado, o processamento é dividido em partes menores, com pausas entre elas. Além disso, como o processamento da conversão é executado em um Web Worker, é menos provável que a tela congele, e você pode interromper o processo usando o botão “Interromper” enquanto ele estiver em execução.