Categorias

Transformador CSV

Transformar e processar dados CSV com operações de colunas, cálculos e conversões de tipo de dados. Exemplos de operações: • Renomear coluna: [{"type": "rename", "column": "nome_antigo", "new_name": "novo_nome"}] • Adicionar coluna calculada: [{"type": "add_column", "new_column": "total", "formula": "preco * quantidade"}] • Remover coluna: [{"type": "remove_column", "remove_column": "coluna_a_remover"}] • Converter tipo de dado: [{"type": "convert_type", "convert_column": "idade", "target_type": "number"}] • Calcular valores: [{"type": "calculate", "target_column": "total", "expression": "preco * imposto + entrega"}] • Filtrar linhas: [{"type": "filter_values", "filter_column": "status", "operator": "equals", "value": "ativo"}]

Click to upload file or drag and drop file here

Maximum file size: 10MB

Fatos principais

Categoria
Data Processing
Tipos de entrada
file, textarea, select, checkbox
Tipo de saída
file
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Transformador CSV é uma ferramenta eficiente para processar, limpar e manipular arquivos de dados estruturados, permitindo realizar cálculos, renomear colunas e converter tipos de dados de forma automatizada via comandos JSON.

Quando usar

  • Quando você precisa padronizar nomes de colunas em grandes conjuntos de dados CSV.
  • Ao realizar cálculos matemáticos complexos entre colunas antes de importar dados para outro sistema.
  • Para filtrar registros específicos ou remover colunas desnecessárias de um arquivo de exportação.

Como funciona

  • Faça o upload do seu arquivo CSV na interface da ferramenta.
  • Defina as operações desejadas (como renomear, calcular ou filtrar) utilizando o formato JSON na caixa de texto de transformações.
  • Configure as opções de saída, como o formato do arquivo final e o tratamento de erros.
  • Execute o processamento e baixe o arquivo CSV ou JSON resultante com as alterações aplicadas.

Casos de uso

Limpeza de bases de dados de clientes removendo colunas sensíveis ou desnecessárias.
Cálculo automático de totais de vendas aplicando impostos e taxas de entrega em planilhas de pedidos.
Conversão de tipos de dados, como transformar colunas de texto contendo números em formato numérico real para análise.

Exemplos

1. Cálculo de Faturamento Total

Analista de Dados
Contexto
Um analista possui um CSV de vendas com colunas de 'preco' e 'quantidade', mas precisa do valor total por linha.
Problema
Calcular o faturamento total multiplicando preço por quantidade e adicionar essa nova coluna ao arquivo.
Como usar
Carregue o arquivo e insira o comando de adição de coluna no campo de transformações.
Configuração de exemplo
[{"type": "add_column", "new_column": "total", "formula": "preco * quantidade"}]
Resultado
O arquivo CSV é gerado com uma nova coluna 'total' contendo o resultado do cálculo para cada linha.

2. Padronização de Nomes de Colunas

Gerente de Marketing
Contexto
Os arquivos de exportação de diferentes plataformas possuem nomes de colunas inconsistentes.
Problema
Renomear colunas para manter um padrão único antes de consolidar os dados em um dashboard.
Como usar
Utilize a operação de renomear para mapear os nomes antigos para os novos nomes padronizados.
Configuração de exemplo
[{"type": "rename", "column": "custo_clique", "new_name": "cpc"}, {"type": "rename", "column": "total_imps", "new_name": "impressoes"}]
Resultado
O arquivo resultante apresenta os cabeçalhos padronizados, facilitando a integração com outras ferramentas de BI.

Testar com amostras

json, csv, video

Hubs relacionados

FAQ

Quais formatos de saída são suportados?

Você pode exportar os dados processados em formato CSV, JSON ou gerar um relatório de resumo.

Como adiciono uma coluna calculada?

Utilize a operação 'add_column' no JSON, especificando o nome da nova coluna e a fórmula matemática desejada.

O que acontece se houver um erro no processamento de uma linha?

Você pode configurar o tratamento de erros para pular a linha, manter o valor original, definir como vazio ou interromper o processo.

É possível filtrar linhas específicas?

Sim, utilize a operação 'filter_values' definindo a coluna, o operador e o valor de referência para filtrar os dados.

Preciso de conhecimentos em programação para usar esta ferramenta?

Não, basta seguir a estrutura JSON fornecida nos exemplos para configurar as transformações de forma simples e direta.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/csv-transformer

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
csvFile file (Upload necessário) Sim -
transformations textarea Sim -
outputFormat select Não -
includeHeader checkbox Não -
handleErrors select Não -
errorHandling select Não -

Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/csv-transformer para obter filePath, depois filePath deve ser passado ao campo de arquivo correspondente.

Formato de resposta

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Arquivo: Arquivo

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-csv-transformer": {
      "name": "csv-transformer",
      "description": "Transformar e processar dados CSV com operações de colunas, cálculos e conversões de tipo de dados.

Exemplos de operações:
• Renomear coluna: [{\"type\": \"rename\", \"column\": \"nome_antigo\", \"new_name\": \"novo_nome\"}]
• Adicionar coluna calculada: [{\"type\": \"add_column\", \"new_column\": \"total\", \"formula\": \"preco * quantidade\"}]
• Remover coluna: [{\"type\": \"remove_column\", \"remove_column\": \"coluna_a_remover\"}]
• Converter tipo de dado: [{\"type\": \"convert_type\", \"convert_column\": \"idade\", \"target_type\": \"number\"}]
• Calcular valores: [{\"type\": \"calculate\", \"target_column\": \"total\", \"expression\": \"preco * imposto + entrega\"}]
• Filtrar linhas: [{\"type\": \"filter_values\", \"filter_column\": \"status\", \"operator\": \"equals\", \"value\": \"ativo\"}]",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=csv-transformer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Suporta links de arquivos URL ou codificação Base64 para parâmetros de arquivo.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]