Achatar JSON aninhado em tabela com chaves de notação de ponto

Cada propriedade aninhada recebe um caminho em notação de ponto, e as posições dos arrays viram segmentos numéricos; assim, um identificador de pedido pode ser acessado sempre como orders.0.id. O resultado é útil em planilhas, tabelas de preparação de bancos de dados, logs, ferramentas de mapeamento e qualquer fluxo que precise de caminhos previsíveis em vez de estruturas aninhadas.

Transforme estruturas aninhadas em caminhos previsíveis

Esta capacidade percorre cada propriedade de objeto e cada elemento de array, unindo todos os segmentos com um ponto. Um valor armazenado em um objeto customer e depois em uma propriedade name passa a ser customer.name. O primeiro elemento de um array orders é endereçado por orders.0, portanto seu identificador vira orders.0.id.

Cada folha é devolvida como uma linha com chave e valor, o que torna a saída fácil de exibir, filtrar ou transformar em colunas. Strings continuam strings, números continuam números, booleanos continuam booleanos e null permanece null. Objetos e arrays vazios são emitidos como valores, em vez de desaparecerem silenciosamente, para que a saída achatada ainda registre que esses caminhos existiam no documento de origem.

Prepare a entrada e interprete a saída

A raiz deve ser um objeto ou um array. Essa exigência evita uma chave vazia ambígua para strings, números, booleanos ou null isolados. Os nomes das propriedades do objeto são usados exatamente como fornecidos, enquanto os índices de array são escritos como segmentos numéricos iniciados em zero.

A resposta contém pairs, um array cujas entradas têm os campos key e value e que, por isso, pode ser tratado diretamente como linhas de tabela. Se a própria raiz for um objeto ou array vazio, a chave retornada será uma string vazia, e o valor preservará esse contêiner. Observe que pontos já presentes em um nome de propriedade original não são escapados.

Por exemplo, uma propriedade literal chamada user.name produz o mesmo caminho visível que um objeto user aninhado contendo name.

Use pares achatados em fluxos de dados

Os pares achatados funcionam bem como representação intermediária. Uma automação de planilha pode colocar chaves em uma coluna e valores em outra; uma rotina de ingestão pode pivotar caminhos selecionados em uma linha larga; e uma ferramenta de comparação pode indexar os pares por chave antes de verificar dois documentos. Segmentos numéricos de arrays também deixam registros repetidos explícitos, em vez de misturar valores de elementos diferentes.

Em documentos muito grandes, considere um pipeline de streaming ou específico do esquema, pois o achatamento cria uma linha para cada folha primitiva ou contêiner vazio do documento inteiro.