Importador em Massa de Dados de Arquivo CSV para Banco de Dados MySQL - Fluxo de trabalho n8n

Engenheiros e Analistas de Dados que precisam de soluções de ETL rápidas.
Usuários que executam instâncias n8n auto-hospedadas (self-hosted) e que necessitam de acesso ao sistema de arquivos local.
Desenvolvedores que buscam modelos n8n confiáveis para sincronização de banco de dados.
Qualquer pessoa que procure métodos eficientes para usar um nó n8n para operações de banco de dados de alto volume.

A migração e ingestão de dados continuam sendo desafios centrais para administradores de sistemas. Este fluxo de trabalho n8n confiável resolve o problema de integrar arquivos CSV grandes e locais em um banco de dados relacional de forma rápida e eficiente. Ao combinar a capacidade de leitura de arquivos de um nó n8n dedicado com os poderosos recursos de transformação do nó Spreadsheet File (Arquivo de Planilha), os dados são perfeitamente estruturados antes de chegarem ao banco de dados MySQL.

Este fluxo de trabalho n8n específico foi projetado para velocidade e confiabilidade, tornando-o um dos modelos n8n mais úteis para importações de dados agendadas ou manuais. Ele garante a integridade dos dados estruturados ao interagir com seu backend de banco de dados.

Este fluxo de trabalho n8n executa um pipeline de dados simplificado em quatro etapas:

1. Iniciação: O processo começa com o gatilho (trigger) Manual Trigger do n8n, permitindo que o usuário inicie a importação manualmente sempre que novos dados CSV estiverem prontos.


2. Extração (Leitura de Arquivo): O nó Read From File do n8n acessa o arquivo CSV localizado no sistema de arquivos local do servidor n8n (/home/node/.n8n/concerts-2023.csv), extraindo o conteúdo binário.


3. Transformação (Análise de CSV): Os dados são imediatamente passados para o nó Convert To Spreadsheet do n8n. Esta etapa crucial analisa o arquivo binário em itens JSON estruturados, preparando os campos de dados para a inserção SQL.


4. Carga (Inserção MySQL): Por fim, o nó Insert into MySQL do n8n executa uma operação de inserção em lote (bulk insert). Ele pega os itens JSON estruturados e os mapeia diretamente para a tabela de destino do banco de dados (concerts2023csv), completando todo o fluxo de trabalho n8n.

Para implantar e utilizar este fluxo de trabalho n8n eficiente, siga estas etapas:

1. Importação: Copie o JSON do fluxo de trabalho n8n e cole-o no seu editor n8n através do menu 'Novo' -> 'Importar de JSON'.


2. Configuração de Credenciais MySQL: Abra o nó 'Insert into MySQL' do n8n e configure as credenciais MySQL necessárias, referenciando o ID da credencial armazenada (ex: 'MySQL n8n articles').


3. Preparação do Arquivo Local: Certifique-se de que o arquivo CSV que você deseja importar (ex: concerts-2023.csv) esteja localizado no local específico definido no nó 'Read From File' do n8n (/home/node/.n8n/concerts-2023.csv). Nota: Este caminho pressupõe uma configuração de ambiente n8n auto-hospedado.


4. Execução: Clique no botão 'Executar Fluxo de Trabalho' no gatilho Manual Trigger do n8n para rodar o processo e verificar se os dados foram importados com sucesso para sua tabela MySQL.

Ao clicar em 'executar' (gatilho Manual Trigger do n8n): Serve como ponto de partida para o fluxo de trabalho n8n, executando a importação sob demanda.
Read From File (nó Read Binary File do n8n): Essencial para acessar dados armazenados localmente no servidor n8n. Configuração chave: Caminho do arquivo definido como /home/node/.n8n/concerts-2023.csv.
Convert To Spreadsheet (nó Spreadsheet File do n8n): Responsável por transformar o conteúdo bruto do arquivo binário em itens de dados utilizáveis e estruturados (formato JSON). A configuração garante que os dados brutos sejam lidos como strings para um tratamento de tipo confiável.
Insert into MySQL (nó MySQL do n8n): O nó de ação final do n8n. Ele é configurado para realizar uma operação de inserção na tabela concerts2023csv, mapeando colunas específicas: Date, Band, ConcertName, Country, City, Location, LocationAddress. Requer credenciais MySQL válidas para funcionar.