unpivot¶

fábrica

transforma múltiplas colunas em linhas — a normalização "wide para long", inversa do pivot.

quando usar¶

normalizar uma planilha ou export "wide" (uma coluna por mês/categoria) para o formato relacional "long" esperado por análises e joins
preparar dados vindos de sistemas legados que exportam métricas como colunas separadas, para agregação posterior
simplificar um dataset com dezenas de colunas de métrica em um formato de duas colunas (nome da métrica + valor)

campo	tipo	obrigatório	descrição
`value_columns`	lista	sim	colunas a "despivotar" — cada uma vira uma linha
`name_col`	string	não	nome da coluna resultante com o nome da coluna original · padrão: `nome`
`value_col`	string	não	nome da coluna resultante com o valor · padrão: `valor`

dado um dataset "wide":

regiao	jan	fev	mar
norte	100	150	130
sul	200	180	210

configuração:

{
  "value_columns": ["jan", "fev", "mar"],
  "name_col": "mes",
  "value_col": "valor"
}

resultado:

colunas não listadas em value_columns (como regiao) são preservadas e repetidas para cada linha gerada.

operação inversa: pivot

para o caminho contrário — transformar valores de uma coluna em novas colunas — use o nó pivot.