explodir array¶

fábrica

transforma cada elemento de uma coluna do tipo lista/array em uma linha separada — a operação clássica de "unnest".

quando usar¶

normalizar uma coluna de tags/categorias (ex: ["premium", "ativo"]) em uma linha por tag
explodir os itens de um pedido (array de produtos) em uma linha por item, mantendo os dados do pedido
preparar dados de uma fonte mongodb ou api que retorna listas aninhadas para análise relacional

configuração¶

campo	tipo	obrigatório	descrição
`source_field`	string	sim	coluna do tipo array a explodir
`alias`	string	não	nome da nova coluna com o valor de cada elemento · padrão: nome da coluna original
`keep_other_columns`	bool	não	mantém as demais colunas da linha original repetidas para cada elemento · padrão: `true`

exemplo¶

dado um dataset:

pedido_id	itens
1	`["caneta", "caderno"]`
2	`["mochila"]`

configuração:

{
  "source_field": "itens",
  "alias": "item",
  "keep_other_columns": true
}

resultado:

pedido_id	item
1	caneta
1	caderno
2	mochila

cada elemento do array vira uma linha própria, com as demais colunas (pedido_id) repetidas.

apenas o valor, sem as outras colunas

se você só precisa da lista de valores explodidos, sem o contexto das demais colunas, configure keep_other_columns: false — o resultado terá apenas a coluna do elemento explodido.