Por que o Notion diz ‘Database Cannot Be Imported’ ao importar CSV com codificação BOM
🔍 WiseChecker

Por que o Notion diz ‘Database Cannot Be Imported’ ao importar CSV com codificação BOM

Ao tentar importar um arquivo CSV no Notion como banco de dados, você pode ver a mensagem de erro: “Database Cannot Be Imported”. Isso geralmente acontece quando o arquivo CSV usa codificação Byte Order Mark (BOM). A ferramenta de importação do Notion não suporta totalmente arquivos UTF-8 BOM, fazendo com que ela interprete mal a primeira linha como dados malformados. Este artigo explica por que a codificação BOM dispara a falha de importação e fornece etapas claras para corrigir e evitar o erro.

Principais conclusões: Corrigindo erros de importação CSV BOM no Notion

  • Salvar como > CSV UTF-8 (delimitado por vírgulas): Remove o marcador BOM e permite que o Notion leia a linha de cabeçalho corretamente.
  • Bloco de Notas > Arquivo > Salvar como > Codificação: UTF-8: Salva novamente o arquivo sem BOM usando um editor de texto simples.
  • Converter CSV usando Notepad++ > Codificação > Codificar em UTF-8: Remove o BOM de arquivos existentes sem alterar os dados.

ADVERTISEMENT

Por que um CSV codificado com BOM falha ao importar no Notion

O Byte Order Mark (BOM) é um caractere Unicode (U+FEFF) colocado no início de um arquivo de texto para indicar a extremidade da codificação. Quando um arquivo CSV é salvo com codificação UTF-8 BOM, o BOM aparece como uma sequência oculta de três bytes (EF BB BF) no início do arquivo. O analisador de importação de banco de dados do Notion espera que a primeira linha contenha cabeçalhos de coluna sem nenhum prefixo invisível. Quando o analisador encontra os bytes BOM, ele os trata como parte do valor da primeira célula. Isso corrompe a linha de cabeçalho e o mecanismo de importação não consegue determinar um esquema válido. Como resultado, o Notion rejeita o arquivo inteiro com o erro genérico “Database Cannot Be Imported”.

Muitos aplicativos de planilha, incluindo Microsoft Excel e Google Sheets, salvam arquivos CSV com codificação UTF-8 BOM por padrão. Isso é especialmente comum ao exportar dados de locais não ingleses ou quando os dados originais contêm caracteres especiais como letras acentuadas, travessões ou símbolos de moeda. Embora a codificação BOM ajude outros softwares a identificar o arquivo como UTF-8, ela cria um problema de compatibilidade com o Notion.

A causa raiz técnica

O Notion usa um analisador CSV rigoroso que lê a primeira linha como a definição das colunas do banco de dados. Os bytes BOM não são removidos antes da análise. Como o BOM não é um caractere imprimível, o analisador vê uma primeira célula malformada que pode aparecer como vazia ou como um caractere não reconhecido. Quando o analisador falha ao criar propriedades de coluna a partir da primeira linha, ele interrompe a importação e mostra o erro. Isso não é um bug do Notion, mas uma escolha de design deliberada para manter a integridade dos dados. O Notion espera UTF-8 sem BOM, que é o padrão para aplicativos baseados na web.

Etapas para converter um CSV codificado com BOM para importação no Notion

Você pode corrigir o arquivo CSV removendo o marcador BOM usando qualquer um dos métodos abaixo. Cada método funciona no Windows 10 e Windows 11. Escolha o que se adequa ao seu fluxo de trabalho.

Método 1: Salvar novamente o CSV usando Excel

  1. Abra o arquivo CSV no Excel
    Inicie o Microsoft Excel. Clique em Arquivo > Abrir e selecione seu arquivo CSV. O Excel lê o BOM corretamente, então os dados aparecem normais.
  2. Clique em Arquivo > Salvar como
    Na caixa de diálogo Salvar como, clique no menu suspenso Salvar como tipo.
  3. Selecione CSV UTF-8 (delimitado por vírgulas) (csv)
    Esta opção salva o arquivo com codificação UTF-8 sem BOM. Não escolha a opção genérica CSV (delimitado por vírgulas), pois ela pode usar codificação ANSI e corromper caracteres especiais.
  4. Clique em Salvar
    Se solicitado sobre compatibilidade, clique em Sim. Feche o arquivo e reabra-o no Notion. Vá para o espaço de trabalho do Notion, clique em Importar, selecione CSV e faça upload do novo arquivo.

Método 2: Remover BOM usando Bloco de Notas

  1. Abra o arquivo CSV no Bloco de Notas
    Clique com o botão direito no arquivo CSV e escolha Abrir com > Bloco de Notas. O BOM é invisível, mas o arquivo abre normalmente.
  2. Clique em Arquivo > Salvar como
    Na caixa de diálogo Salvar como, localize o menu suspenso Codificação na parte inferior.
  3. Altere a codificação para UTF-8
    Selecione UTF-8 no menu suspenso. Isso salva o arquivo sem o prefixo BOM. Não selecione UTF-8 com BOM.
  4. Clique em Salvar
    Substitua o arquivo original ou crie uma nova cópia. Abra o Notion e importe o arquivo salvo.

Método 3: Usar Notepad++ para remover BOM

  1. Abra o arquivo CSV no Notepad++
    Instale o Notepad++ se necessário. Abra o arquivo via Arquivo > Abrir.
  2. Verifique a codificação atual
    Olhe na barra de status na parte inferior. Se você vir UTF-8-BOM, o arquivo tem o marcador.
  3. Clique em Codificação > Codificar em UTF-8
    Este comando remove o BOM e converte o arquivo para UTF-8 simples. A barra de status muda para UTF-8 sem BOM.
  4. Salve o arquivo
    Pressione Ctrl+S. O arquivo agora está livre de BOM. Importe-o para o Notion.

ADVERTISEMENT

Se o Notion ainda mostrar o erro de importação após a conversão

O CSV contém um Byte Order Mark que não foi totalmente removido

Alguns editores de texto ou conversores online podem adicionar o BOM de volta se você escolher a opção de codificação errada. Verifique a codificação do arquivo usando Notepad++ ou um editor hexadecimal. No Notepad++, abra o arquivo e verifique a barra de status. Se ainda disser UTF-8-BOM, repita a conversão usando o comando Codificar em UTF-8. Em seguida, salve novamente.

A primeira linha tem cabeçalhos de coluna vazios ou duplicados

Mesmo após remover o BOM, o Notion pode rejeitar o arquivo se a primeira linha contiver células vazias, cabeçalhos duplicados ou caracteres não suportados. Abra o CSV no Excel. Certifique-se de que cada coluna tenha um cabeçalho único e não vazio. Remova espaços iniciais ou finais nos nomes dos cabeçalhos. Salve novamente como CSV UTF-8 (delimitado por vírgulas).

O arquivo CSV usa um delimitador diferente de vírgula

O Notion espera valores separados por vírgula. Se o arquivo usar ponto e vírgula, tabulação ou pipe, a importação falhará. Abra o arquivo no Bloco de Notas. Verifique se as colunas estão separadas por vírgulas. Se não, use o Excel para reexportar com delimitadores de vírgula. No Excel, vá em Arquivo > Opções > Avançado. Em Opções de edição, desmarque a caixa Usar separadores do sistema. Defina Separador decimal como ponto e Separador de milhares como vírgula. Em seguida, salve como CSV UTF-8.

Importação de CSV no Notion: Codificação BOM vs UTF-8 sem BOM

Item UTF-8 com BOM UTF-8 sem BOM
Assinatura do arquivo Começa com os bytes EF BB BF Nenhum byte de prefixo
Suporte à importação do Notion Não suportado — causa erro “Database Cannot Be Imported” Totalmente suportado — importa como banco de dados com cabeçalhos corretos
Padrão no Excel Sim, ao usar Salvar como > CSV UTF-8 (delimitado por vírgulas) Apenas se salvo manualmente via Bloco de Notas ou Notepad++
Manipulação de caracteres especiais Preserva caracteres acentuados, símbolos e travessões Preserva os mesmos caracteres sem o prefixo BOM
Compatibilidade com outros aplicativos Funciona na maioria dos editores de texto e aplicativos web Funciona em todos os aplicativos, incluindo o Notion

Agora você pode converter qualquer arquivo CSV codificado com BOM para um formato que o Notion aceita. Use a opção Salvar como CSV UTF-8 no Excel ou o comando Codificar em UTF-8 no Notepad++. Após a conversão, a importação deve ser bem-sucedida e criar um novo banco de dados com suas colunas intactas. Para arquivos grandes, faça a conversão em lote usando um script PowerShell que remove o BOM de vários CSVs de uma vez. Isso economiza tempo quando você trabalha com exportações regulares de dados de sistemas corporativos.

ADVERTISEMENT