> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Importações

> Importe dados em massa para suas coleções a partir de arquivos CSV ou XLSX

O recurso de importação permite carregar dados em massa para suas coleções a partir de arquivos **CSV** ou **XLSX** (Excel). Você pode importar dados para uma coleção existente ou criar uma nova coleção durante o processo.

<Frame caption="Seção de importações do Databases">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/imports.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=48da8b652294743341dfdc81dab4da4c" alt="Página de importações com botão Nova Importação e estado vazio indicando que não há importações ainda" width="3024" height="1730" data-path="assets/images/datum/imports.png" />
</Frame>

## Importando para uma coleção existente

Clique no ícone de importação na barra lateral esquerda e depois em **+ Nova Importação** para abrir o assistente.

<Frame caption="Assistente de importação: seleção de coleção e upload de arquivo">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/import-wizard.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=604cd039bea9ef98d61a0d7202a7ae63" alt="Assistente de importação mostrando a etapa 1 com as opções Usar Existente e Criar Novo, seletor de coleção e zona de upload de arquivo" width="3024" height="1730" data-path="assets/images/datum/import-wizard.png" />
</Frame>

O assistente tem **5 etapas**:

<Steps>
  <Step title="Carregar Arquivo">
    Certifique-se de que **Usar Existente** está selecionado, escolha a coleção de destino no menu suspenso e arraste seu arquivo CSV ou XLSX para a zona de upload (ou clique para selecioná-lo).

    <Note>
      Tamanho máximo do arquivo: **500 MB**. Formatos suportados: **CSV** e **XLSX**.
    </Note>
  </Step>

  <Step title="Revisar Mapeamentos">
    Mapeie cada campo da coleção para uma coluna no arquivo CSV. O assistente detecta automaticamente correspondências (ex.: um campo `email` é mapeado automaticamente). Para cada campo você pode selecionar um **Subtipo** (Texto Geral, Número de ID) e um **País** quando aplicável. As colunas CSV que você não mapear aparecerão na seção **Colunas CSV não utilizadas** e serão ignoradas.
  </Step>

  <Step title="Configurar Opções">
    Opcionalmente, ative **Habilitar detecção de duplicatas** para que o Databases verifique registros existentes e evite duplicatas durante a importação.
  </Step>

  <Step title="Pré-visualizar Dados">
    Revise uma pré-visualização das primeiras linhas. Você verá contadores de linhas válidas, erros e duplicatas. Clique em qualquer linha para ver os detalhes do erro.
  </Step>

  <Step title="Revisar e Confirmar">
    Revise o resumo final com os detalhes do arquivo, coleção de destino, mapeamentos de colunas e campos ignorados. Clique em **Iniciar Importação** para executar a importação.
  </Step>
</Steps>

## Importando criando uma nova coleção

<Steps>
  <Step title="Carregar Arquivo">
    Clique em **+ Nova Importação**, selecione **Criar Novo**, insira o nome da nova coleção e faça o upload do seu arquivo CSV ou XLSX.
  </Step>

  <Step title="Definir Campos">
    O Databases inferirá automaticamente os tipos de campo a partir das colunas do arquivo. Você pode ajustar os tipos manualmente se necessário.
  </Step>

  <Step title="Configurar Opções">
    Opcionalmente, ative a detecção de duplicatas.
  </Step>

  <Step title="Pré-visualizar Dados">
    Revise a pré-visualização das linhas e verifique se os dados e tipos estão corretos.
  </Step>

  <Step title="Revisar e Confirmar">
    Revise o resumo final e clique em **Iniciar Importação**.
  </Step>
</Steps>

## Histórico de importações

Todas as importações concluídas são exibidas na seção Importações com seu status. A partir daqui você pode acompanhar o progresso de importações em andamento e revisar os resultados de importações anteriores.