Passar para o conteúdo principal

CSV Upload

Entenda o CSV Upload: como criar uma conexão, criar/configurar tabelas e gerenciar arquivos da tabela.

Atualizado há mais de 2 meses

O provider CSV Upload oferece uma maneira prática de carregar dados no formato de arquivos CSV para a plataforma Uncover. Ele se diferencia dos demais em alguns aspectos, descritos a seguir.

Enquanto outros providers contam com tabelas pré-definidas (como o Facebook Marketing) ou descobrem automaticamente as tabelas na fonte de conexão (como o Google Sheets), no provider CSV Upload, a criação das tabelas é feita diretamente na plataforma. O upload de dados para essas tabelas também ocorre de forma manual. Além disso, é possível consultar dados previamente submetidos e removê-los quando necessário.

Arquivos aceitos

Os arquivos aceitos por este provider devem atender aos seguintes requisitos:

  • Estar no formato .csv (arquivos comprimidos não são suportados);

  • Utilizar encoding UTF-8 (com ou sem BOM) ou LATIN-1 (ISO-8859-1);

  • Conter um cabeçalho com os nomes das colunas na primeira linha.

Criação de Connection

Antes de conectar um arquivo CSV, é necessário criar uma conexão com este provider. Para isso:

  1. No menu lateral, clique em Data Sources e, em seguida, em + New Connection — ou clique diretamente no botão “+” ao lado de Data Sources;

  2. Selecione o provider CSV Upload;

  3. Opcionalmente, defina um nome para identificar a conexão e selecione o separador utilizado nos arquivos que serão integrados; Importante ressaltar que o separador selecionado aqui deve ser mantido como padrão em todos os arquivos adicionados dentro dessa conexão.

  4. Com a conexão criada, é possível adicionar arquivos CSV para que sejam sincronizados na plataforma.

Adicionando Tables

Ao criar uma conexão, clique no botão Add Tables para adicionar tabelas à conexão recém-criada. Caso prefira fazer isso em outro momento, também é possível adicionar tabelas pela página Data Sources:

  1. Na página Data Sources, localize a conexão desejada (o nome definido na etapa de criação da connection facilita bastante esse processo);

  2. Na linha da conexão, clique no ícone “” à esquerda;

  3. Clique em Add Tables.

O primeiro arquivo CSV adicionado a uma conexão será considerado o arquivo base, responsável por definir os separadores de decimais e milhar e as colunas disponíveis na plataforma.

Se arquivos adicionados posteriormente utilizarem um padrão diferente de separadores, a integração será bloqueada. Caso um arquivo tenha colunas ausentes em relação ao arquivo base, seus valores serão preenchidos como nulos. Já colunas extras serão ignoradas.

No momento da criação da tabela, é necessário definir um nome único para a submissão do primeiro arquivo CSV. Tanto o nome da tabela quanto os nomes das colunas devem conter apenas os seguintes caracteres:

  • Letras

  • Espaços

  • Números

  • Traços ( - )

  • Underscores ( _ )

Em seguida, com a tabela selecionada, ela deve ser configurada para definir:

  • O tipo de dado esperado em cada coluna;

  • A coluna de data dos dados;

  • Formato da data;

  • O fuso horário dessa coluna;

  • Os separadores decimais e de milhar utilizados no arquivo.

Gestão dos arquivos das tabelas

Na plataforma Uncover, uma tabela do provider CSV pode ser composta por múltiplos arquivos. Os dados disponíveis na tabela correspondem à concatenação de todos os arquivos CSV adicionados a ela — ou seja, cada novo upload na mesma tabela adiciona novas linhas.

Para visualizar e gerenciar os arquivos que compõem uma tabela CSV, acesse a página Manage Files da tabela desejada:

  1. Na página Data Sources, localize a tabela e clique no menu ⁝;

  2. Clique em Manage Files.

Nessa página, é possível visualizar os arquivos que compõem a tabela, adicionar novos arquivos, remover arquivos existentes ou fazer o download de arquivos individuais. Ao apagar um arquivo, todos os dados contidos nele são removidos da tabela.

Ainda com dúvidas? Nossa equipe está pronta para ajudar! Fale conosco pelo Suporte Intercom ou envie um e-mail para [email protected]

Respondeu à sua pergunta?