Ir para a ferramenta
ViewCSV
Sem upload de arquivos

Mapear colunas do CSV

orders.csv· DADOS DE EXEMPLO15 linhas · 8 colunas

Cada linha é uma coluna de saída, na ordem do resultado. Escolha a coluna de origem, ou nenhuma para usar um valor fixo; o valor padrão preenche as células vazias.

Resultado
#order_idcustomercityproductquantityunit_priceorder_datestatus
1001041Laura CostaPorto AlegreDesk lamp6224.922026-01-15shipped
2001042Arthur AlvesFortalezaMonitor 27"1172.722026-02-11refunded
3001043Miguel CostaRio de JaneiroCoffee beans 1kg7165.862026-03-07shipped
4001044Gael RodriguesBelo HorizonteMonitor 27"1131.362026-04-23shipped
5001045Alice OliveiraPorto AlegreUSB-C cable8·2026-05-25shipped
6001046Helena SouzaSalvadorCoffee beans 1kg171.082026-06-08refunded
7001047 Laura Gomes Porto AlegreCoffee beans 1kg389.842026-07-16pending
8001048Théo OliveiraFortalezaNotebook A5749.502026-08-26shipped
9001049Helena RodriguesSalvadorDesk lamp354.272026-09-27paid
10001050Heitor SantosCuritibaDesk lamp6138.902026-01-05pending
11001051Helena FerreiraCuritibaUSB-C cable76.102026-02-03refunded
12001052Valentina PereiraBelo HorizonteChair, ergonomic3106.722026-03-09shipped
13001053Laura AlvesFortalezaNotebook A56239.222026-04-12pending
14001054Valentina SouzaSão PauloChair, ergonomic9154.442026-05-25pending
15001043Miguel CostaRio de JaneiroCoffee beans 1kg7165.862026-03-07shipped

Entrada: 15 linhas. Resultado: 15 linhas · 8 colunas.

Abra ou cole um CSV e cada coluna aparece como uma linha de saída, na ordem do resultado. Renomeie uma coluna no campo Coluna de saída, mova-a com Mover para cima e Mover para baixo, apague-a com Remover ou use Adicionar coluna para criar uma nova que copia uma coluna de origem ou traz um (valor fixo). O resultado é atualizado enquanto você edita; Baixar CSV salva o arquivo e Salvar mapeamento guarda o layout em um arquivo JSON para a próxima exportação. Os valores das células são copiados exatamente, e o arquivo é processado no seu navegador, sem upload.

Como mapear colunas para um novo layout

  1. Abra um arquivo .csv, .tsv ou .txt, arraste-o para a ferramenta ou cole as linhas. O delimitador é detectado; se precisar, ajuste-o, a codificação ou a opção A primeira linha tem os nomes das colunas em Configurações de importação.
  2. Edite a lista: cada linha é uma coluna de saída. Digite o novo cabeçalho nos campos Coluna de saída 1, Coluna de saída 2…, escolha a coluna de origem em Origem e reordene as linhas com Mover para cima e Mover para baixo.
  3. Remova as linhas de que você não precisa. As colunas que não aparecem mais em lugar nenhum são listadas abaixo da lista como fora do resultado.
  4. Confira a aba Resultado e depois clique em Baixar CSV, Copiar ou Abrir no editor para continuar trabalhando na tabela mapeada.

Salvar mapeamento baixa o layout como viewcsv-mapping.json. Na próxima vez, abra o novo arquivo e escolha Carregar mapeamento: as colunas são associadas pelo nome de origem, então o mesmo layout vale mesmo que a nova exportação traga as colunas em outra ordem.

O que dá para fazer com um mapeamento

RenomearMude o nome no campo Coluna de saída. Os nomes são usados exatamente como digitados, inclusive espaços e maiúsculas; o arquivo de origem não é alterado.
ReordenarO resultado segue a ordem da lista, de cima para baixo.
RemoverUse Remover em uma linha. A coluna dela fica fora do resultado; as outras colunas não são afetadas.
Copiar uma colunaAcrescente uma segunda linha com a mesma coluna em Origem, por exemplo para manter email e também gravá-la como login.
Adicionar uma coluna fixaEscolha (valor fixo) em Origem e digite um Valor. Todas as linhas recebem esse valor, por exemplo channel = webshop. Deixe vazio para criar uma coluna em branco exigida pelo sistema de destino.
Preencher células vaziasEm uma coluna com origem, Valor se estiver vazio substitui as células totalmente vazias, como um status ausente que passa a ser pending. Uma célula só com espaços não conta como vazia e é mantida.
RedefinirRestaura as colunas, os nomes e a ordem originais.

Regras que o mapeamento confere

  • Toda coluna de saída precisa de um nome, e os nomes precisam ser únicos. A comparação é exata: Email e email são nomes diferentes.
  • Pelo menos uma coluna precisa sobrar; um mapeamento pode gerar no máximo 250 colunas e 2 milhões de células.
  • O resultado é baixado no formato do próprio arquivo: mesmo delimitador, quebra de linha, marca de ordem de byte e codificação, quando o navegador consegue gravá-la, com aspas só onde necessário. Outras codificações antigas são salvas em UTF-8. Copiar sempre gera texto separado por vírgula.
  • Cabeçalhos em branco ou repetidos na origem já foram tornados únicos na importação (Column 3, name (2)), então você pode mapeá-los como qualquer outra coluna.
  • Os valores nunca são cortados nem convertidos: 001041 continua 001041.

Juntar duas colunas em uma, ou dividir uma em várias, não faz parte do mapeamento. Faça isso no editor de CSV, antes ou depois de mapear. Para empilhar arquivos que usam nomes de coluna diferentes, mapeie cada um para o mesmo layout e depois use Juntar arquivos CSV.

Solução de problemas

  • Toda coluna de saída precisa de um nome: uma linha está com o campo Coluna de saída vazio. Digite um nome ou remova a linha.
  • Um nome aparece duas vezes: duas linhas têm o mesmo nome de saída. Renomeie uma delas.
  • Um mapeamento carregado lista colunas ausentes: esses nomes de origem não existem neste arquivo, então as linhas correspondentes viraram colunas (valor fixo). Um Valor se estiver vazio salvo com elas agora é gravado em todas as linhas. Escolha a origem certa em Origem para cada uma.
  • O arquivo de mapeamento é recusado: ele não é um JSON válido, não tem uma lista columns ou lista mais de 250 colunas. Salve-o de novo com Salvar mapeamento.
  • Os cabeçalhos aparecem como Column 1, Column 2…: o arquivo não tem linha de cabeçalho, ou a opção A primeira linha tem os nomes das colunas está desativada. Digite os nomes de destino nos campos Coluna de saída.

Limites e privacidade

O mapeamento funciona com arquivos de até 25 MB, 100.000 linhas, 250 colunas e 2 milhões de células, todos mantidos na memória para que o resultado seja atualizado enquanto você edita. Arquivos maiores são recusados; divida-os antes com Dividir CSV e aplique o mapeamento salvo a cada parte.

O CSV e o mapeamento ficam nesta aba; nada é enviado para servidor.

Exemplo

Uma exportação de pedidos mapeada para um layout de importação: city é removida, status sobe na lista com pending como Valor se estiver vazio, as demais são renomeadas e uma coluna fixa Channel é adicionada. O preço vazio continua vazio porque não tem valor padrão.

CSV
order_id,customer,city,unit_price,status
001041,Ana Ruiz,Madrid,34.90,paid
001042,Ben Ito,Osaka,,
CSV
Order ID,Status,Customer name,Price,Channel
001041,paid,Ana Ruiz,34.90,webshop
001042,pending,Ben Ito,,webshop

Perguntas frequentes

Posso reaproveitar o mesmo mapeamento de colunas em toda exportação mensal?

Sim. Use Salvar mapeamento uma vez e depois Carregar mapeamento em cada arquivo novo. As colunas são associadas pelo nome de origem, não pela posição, e as que estiverem faltando são listadas para você corrigir.

O mapeamento altera os valores das minhas colunas?

Não. Os valores são copiados exatamente. As únicas células que mudam são as vazias em uma coluna com Valor se estiver vazio e as das colunas de valor fixo que você adicionar.

Posso juntar nome e sobrenome em uma coluna só?

Não nesta ferramenta: cada coluna de saída vem de uma única coluna de origem ou de um valor fixo. Combine os valores no editor de CSV e depois mapeie o resultado.

Padrões e referências