A partir da versão 1.13, o N8N introduziu uma funcionalidade que promete simplificar a coleta e o gerenciamento de dados dentro da própria ferramenta de automação: o Data Tables. Esta funcionalidade, que funciona como um banco de dados integrado, elimina a necessidade de recorrer a serviços externos (como Google Sheets ou bancos de dados tradicionais) para cenários mais simples.
Neste artigo, vamos explorar o funcionamento completo do Data Tables, desde a criação da tabela até a manipulação de dados usando os nós dedicados no seu workflow.
1. Configuração e Criação da Tabela
O primeiro passo é garantir que você esteja utilizando o N8N na versão 1.13 ou superior, pois o recurso Data Tables não está disponível em versões anteriores.
Acessando a Funcionalidade
Para acessar o Data Tables, basta procurar o item “Data Tables” na barra lateral da sua interface N8N. A partir daí, você pode começar a criar e gerenciar suas tabelas.
Criando sua Primeira Tabela
Ao criar uma nova Data Table, é crucial seguir as boas práticas de nomenclatura de banco de dados.
- Nome da Tabela: O ideal é utilizar um nome simples, sem caracteres especiais e espaçamentos. Por exemplo, em vez de “Lista de Usuários”, utilize “usuarios”.
- Colunas Padrão: Ao criar a tabela, o N8N automaticamente adiciona colunas essenciais para o gerenciamento de dados:
- ID: Identificador único da linha.
- Created At: Data e hora de criação do registro.
- Updated At: Data e hora da última atualização do registro.
Definindo Colunas Personalizadas
Você pode adicionar colunas que representam os dados que deseja armazenar. Ao criar uma nova coluna, é necessário definir o seu Tipo de Dados:
| Tipo de Dado | Uso |
| String | Texto (nomes, e-mails, descrições) |
| Number | Números (idade, quantidade, valores) |
| Boolean | Verdadeiro ou Falso (status ativo/inativo, sim/não) |
| Date Time | Data e Tempo (registro de horário, data de nascimento) |
Exportar para as Planilhas
Após a definição, você já pode inserir dados manualmente na visualização da tabela, como faria em uma planilha simples.
2. Manipulação de Dados com Nós (Nodes) no Workflow
A verdadeira utilidade do Data Tables está na integração com os workflows do N8N, permitindo automatizar a leitura, escrita e exclusão de dados. Os nós do Data Table são encontrados com uma etiqueta “Beta”, indicando que a funcionalidade está em constante evolução.
2.1. Nó Get Rows (Consultar)
O nó Get Rows é usado para ler informações da tabela.
- Função: Retorna todas as linhas da tabela ou um subconjunto de linhas baseado em condições.
- Filtro: Permite adicionar condições (filtros) para buscar dados específicos, como “ID igual a 5” ou “idade maior que 30”.
- Limite: Você pode definir um limite para o número de linhas retornadas.
2.2. Nó Insert Rows (Inserir)
O nó Insert Rows é utilizado para adicionar novos registros na tabela.
- Função: Insere uma ou mais novas linhas de dados.
- Configuração: Você mapeia as colunas da sua tabela (nome, e-mail, idade, etc.) com os dados de entrada do seu workflow.
2.3. Nó Update Rows (Atualizar)
O nó Update Rows permite modificar dados já existentes.
- Função: Atualiza uma ou mais linhas que atendam a uma condição específica.
- Filtro (Condição): É essencial definir uma condição de filtro, geralmente o ID, para garantir que apenas a linha desejada seja modificada.
- Dados a Atualizar: Você só precisa preencher as colunas que deseja alterar; as demais colunas permanecem inalteradas.
2.4. Nó Upsert Rows (Atualizar ou Inserir)
Este é um dos nós mais poderosos, combinando a lógica de atualização e inserção em um único passo.
- Função: O nó tenta atualizar um registro se ele já existir (baseado na condição de filtro). Se o registro não for encontrado, ele insere um novo.
- Exemplo: Se você filtrar por um e-mail específico:
- Se o e-mail existir, o registro é atualizado.
- Se o e-mail não existir, um novo registro é criado.
2.5. Nó Delete Rows (Deletar)
O nó Delete Rows é usado para remover registros da tabela.
- Função: Remove uma ou mais linhas que correspondam à condição de filtro.
- Cuidado: Defina sempre uma condição precisa (como o ID exato) para evitar a exclusão acidental de múltiplos registros.
2.6. Nós Condicionais (If Row Exists / If Row Not Exists)
Esses nós de fluxo de controle verificam a existência de um dado antes de prosseguir. Embora a funcionalidade possa ser replicada com o nó Get Rows e uma verificação posterior, eles oferecem uma alternativa direta:
- If Row Exists: O workflow segue um caminho se a linha (que atende ao filtro) for encontrada.
- If Row Not Exists: O workflow segue um caminho se nenhuma linha (que atende ao filtro) for encontrada.
3. Conclusão: Casos de Uso e Potencial
O Data Tables é um recurso empolgante, mas no momento, em fase beta, ele se apresenta como uma solução simples e eficaz para nichos específicos.
Quando utilizar o Data Tables do N8N:
- Formulários Simples: Coletar dados de formulários internos ou de landing pages sem a necessidade de uma base de dados externa.
- Registro Temporário: Armazenar temporariamente informações necessárias para a execução de um workflow ou cache de dados.
- Controle Básico: Gerenciar pequenas listas de usuários, tokens de acesso ou configurações de automação.
A principal vantagem é a eliminação da dependência de serviços externos para a persistência de dados básicos. Embora ainda não ofereça funcionalidades avançadas (como relacionamento entre tabelas, importação/exportação de dados facilitada ou ferramentas visuais complexas), a tendência é que o N8N continue a evoluir este recurso, tornando-o cada vez mais robusto e capaz de lidar com cenários de automação mais complexos no futuro.
