Como criar um pipeline de importação do Airtable para o Notion com mapeamento de esquema

Você quer mover dados do Airtable para o Notion, mas a importação CSV padrão perde tipos de campo, relações e fórmulas. Bases do Airtable e bancos de dados do Notion usam modelos de esquema diferentes: o Airtable usa registros vinculados e rollups, enquanto o Notion usa relações e rollups. Este artigo mostra como construir um pipeline de importação repetível que mapeia os tipos de campo do Airtable para os tipos de propriedade do Notion, para que seus dados cheguem intactos.

O pipeline usa a exportação CSV do Airtable, uma planilha de mapeamento de esquema e a importação CSV do Notion com seleção manual de tipo de propriedade. Você aprenderá a lidar com registros vinculados, anexos e campos de fórmula que não transferem diretamente.

Ao final, você poderá migrar qualquer base do Airtable para o Notion sem perder a estrutura dos dados ou precisar de ferramentas de terceiros.

O que o pipeline de importação Airtable para Notion faz

O pipeline é um processo manual que converte uma base do Airtable em um ou mais bancos de dados do Notion com esquema correspondente. Airtable e Notion compartilham muitos tipos de propriedade: texto, número, data, seleção, seleção múltipla, caixa de seleção, URL, e-mail, telefone e anexo. No entanto, os registros vinculados, rollups, lookups e fórmulas do Airtable não mapeiam diretamente para a importação CSV do Notion. Você deve reconstruí-los após a importação inicial.

O pipeline tem quatro estágios: exportar tabelas do Airtable como CSV, criar uma planilha de mapeamento de esquema, importar cada CSV no Notion definindo os tipos de propriedade e, em seguida, recriar relações, rollups e fórmulas dentro do Notion.

Pré-requisitos

Você precisa de uma conta no Airtable com a base que deseja migrar e um workspace no Notion onde tenha acesso “Pode editar”. Você também precisa de uma ferramenta de planilha como Google Sheets ou Excel para construir o mapa de esquema. Não são necessárias chaves de API ou ferramentas de integração de terceiros.

Etapas para construir o pipeline de importação com mapeamento de esquema

Etapa 1: Exportar cada tabela do Airtable como um CSV separado

1. Abra sua base do Airtable
   Selecione a primeira tabela que deseja migrar.
2. Clique no menu de três pontos na guia da tabela
   Escolha “Download CSV”. O Airtable exporta a visualização atual, incluindo todos os campos e linhas.
3. Repita para cada tabela
   Não use a exportação no nível da base. Exporte cada tabela individualmente para que os nomes das colunas e os tipos de campo permaneçam intactos.
4. Salve todos os arquivos CSV em uma pasta
   Nomeie-os claramente, por exemplo “Contatos.csv” e “Projetos.csv”.

Etapa 2: Construir uma planilha de mapeamento de esquema

1. Abra uma nova planilha
   Crie colunas: Nome do Campo no Airtable, Tipo do Campo no Airtable, Nome da Propriedade no Notion, Tipo da Propriedade no Notion e Observações.
2. Copie os nomes dos campos do primeiro CSV
   Abra o CSV em um editor de texto e liste todos os cabeçalhos de coluna na primeira linha.
3. Mapeie cada tipo do Airtable para um tipo do Notion
   Use este mapeamento:
   – Texto de linha única → Título ou Texto
   – Texto longo → Texto
   – Número → Número
   – Data → Data
   – Seleção única → Seleção
   – Seleção múltipla → Seleção múltipla
   – Caixa de seleção → Caixa de seleção
   – URL → URL
   – E-mail → E-mail
   – Telefone → Telefone
   – Anexo → Arquivos e mídia
   – Link para outro registro → (pular durante a importação, recriar como Relation depois)
   – Rollup → (pular durante a importação, recriar como Rollup depois)
   – Fórmula → (pular durante a importação, recriar como Fórmula depois)
4. Identifique quais campos pular durante a importação CSV
   Registros vinculados, rollups, lookups e fórmulas não aparecem no CSV ou aparecem como texto que não pode ser recriado. Marque-os como “Recriar após a importação”.

Etapa 3: Importar cada CSV no Notion

1. Crie uma nova página no Notion
   Navegue até o workspace ou teamspace onde deseja o banco de dados. Clique em “Adicionar uma página” e dê um nome.
2. Use o recurso de importação CSV
   Digite /import e selecione “CSV”. O Notion abre um seletor de arquivos. Escolha o primeiro arquivo CSV da sua pasta.
3. Defina os tipos de propriedade para cada coluna
   O Notion mostra uma prévia com cada coluna. Clique no menu suspenso de tipo de propriedade ao lado de cada nome de coluna. Selecione o tipo de propriedade correspondente do Notion de acordo com seu mapa de esquema. Por exemplo, altere “Texto” para “Número” para uma coluna numérica.
4. Clique em “Importar”
   O Notion cria um novo banco de dados com seus dados. Repita para cada arquivo CSV. Crie um banco de dados separado para cada tabela.

Etapa 4: Recriar relações, rollups e fórmulas

1. Adicione uma propriedade Relation ao banco de dados filho
   Abra o banco de dados que deve conter o registro vinculado. Clique em “Adicionar uma propriedade”, selecione “Relation” e escolha o banco de dados pai. Nomeie a propriedade, por exemplo “Projeto Relacionado”.
2. Vincule registros manualmente ou em massa
   Se seu CSV continha uma coluna com nomes de registros vinculados, você pode combiná-los copiando o nome no campo Relation. Para conjuntos de dados grandes, use o recurso “Link database” do Notion com uma coluna de consulta para corresponder IDs.
3. Adicione uma propriedade Rollup
   Após definir a Relation, adicione uma propriedade Rollup. Configure-a para agregar um campo numérico ou de texto do banco de dados relacionado usando SOMA, CONT.SE ou outra agregação.
4. Recrie propriedades de fórmula
   Abra o banco de dados, adicione uma propriedade Fórmula e escreva a fórmula usando a sintaxe de fórmulas do Notion. Fórmulas do Airtable que usam funções como SE, DATETIME_DIFF ou CONCATENAR têm equivalentes diretos no Notion.

Armadilhas comuns no mapeamento de esquema e como evitá-las

Registros vinculados exportados como texto em vez de IDs

A exportação CSV do Airtable grava registros vinculados como o nome de exibição do registro vinculado, não o ID do registro. Ao importar para o Notion, essa coluna se torna texto simples. Você não pode converter texto em uma propriedade Relation após a importação. A solução é pular essa coluna durante a importação e adicionar a propriedade Relation depois, vinculando manualmente os registros usando os nomes de texto como referência.

Campos de anexo exportados como URLs que o Notion não pode importar

O Airtable exporta anexos como URLs separados por vírgula em uma única célula. A importação CSV do Notion não analisa esses URLs em propriedades de Arquivos e mídia. A alternativa é pular a coluna de anexo durante a importação e usar a API do Notion ou o recurso de arrastar e soltar do aplicativo desktop para reanexar arquivos. Para conjuntos de dados pequenos, você pode reanexar arquivos manualmente.

Campos de fórmula exportados como valores calculados, não a fórmula

O CSV do Airtable mostra o resultado de uma fórmula, não a expressão da fórmula em si. Você deve recriar cada fórmula no Notion após a importação. Mantenha sua base do Airtable aberta como referência ao escrever fórmulas no Notion.

Campos de rollup exportados como valores agregados que perdem sua origem

Um rollup no Airtable mostra um valor calculado a partir de um registro vinculado. O CSV contém apenas esse valor calculado, não o relacionamento. Você deve reconstruir a Relation primeiro e depois adicionar uma propriedade Rollup no Notion para calcular o mesmo valor.

Tipos de campo do Airtable vs tipos de propriedade do Notion: referência de mapeamento

Tipo de campo no Airtable	Tipo de propriedade no Notion	Observações
Texto de linha única	Título ou Texto	Mapeie o campo principal para Título
Texto longo	Texto	Nenhuma configuração extra necessária
Número	Número	Defina o formato do número após a importação
Data	Data	Formato de data e fuso horário
Seleção única	Seleção	As opções devem ser recriadas no Notion
Seleção múltipla	Seleção múltipla	As opções devem ser recriadas no Notion
Caixa de seleção	Caixa de seleção	Valores verdadeiro/falso mapeiam diretamente
URL	URL	Nenhuma configuração extra necessária
E-mail	E-mail	Nenhuma configuração extra necessária
Telefone	Telefone	Nenhuma configuração extra necessária
Anexo	Arquivos e mídia	Recriar após a importação
Link para outro registro	Relation	Recriar após a importação
Rollup	Rollup	Recriar após a importação
Lookup	Rollup ou Fórmula	Recriar após a importação
Fórmula	Fórmula	Recriar após a importação
Duração	Número com formato	Converter para minutos ou horas
Classificação	Número	Use uma propriedade Número com um emoji de estrela no nome

Agora você pode exportar qualquer base do Airtable, mapear seu esquema para os tipos de propriedade do Notion e importar os dados sem perder a estrutura. Use a planilha de mapeamento de esquema para cada migração para evitar campos incompatíveis. Para bases grandes com mais de 10 tabelas, considere usar a API do Notion para automatizar a etapa de religação das relações após a importação CSV.