Skip to main content

Enviando dados

Enviando dados

Se um administrador configurou envios, você pode enviar dados CSV clicando no ícone Upload no canto superior direito da página da coleção.

Enviar dados CSVEnviar dados CSV

Criar, adicionar ou substituir modelos com envios

Ao enviar um arquivo CSV, o Analytics pode solicitar que você selecione um destino para esse envio (dependendo se existem outros envios).

Se seu CSV tiver as mesmas colunas de um modelo de um arquivo enviado anteriormente, você pode adicionar dados a esse modelo. Caso contrário, pode criar um novo modelo. Se desejar:

O Analytics criará um modelo que conterá os dados CSV, além da tabela subjacente do modelo.

Os envios estarão disponíveis apenas se seu administrador tiver habilitado envios para seu Analytics, e você estiver em um grupo com acesso irrestrito ao schema usado para armazenar esses envios. Veja Enviando dados.

Adicionando a um modelo criado por um envio

Você pode enviar dados CSV adicionais para um modelo existente criado por um envio anterior.

Adicionar dados a modelo criado por envioAdicionar dados a modelo criado por envio

O CSV enviado deve ter o mesmo nome, ordem e tipo de coluna do modelo. O Analytics verificará a primeira linha como cabeçalho para confirmar que os nomes das colunas são iguais. Portanto, se você dividir um arquivo CSV grande em vários arquivos menores, inclua a linha de cabeçalho em todos os arquivos.

Ao adicionar, o Analytics simplesmente insere as linhas na tabela subjacente, atualizando o modelo correspondente. Se houver linhas duplicadas entre os envios, o Analytics as manterá.

O ícone de upload só ficará visível em modelos criados por envios.

Substituindo os dados de um modelo enviado

Em vez de excluir um modelo e recriá-lo, você pode substituir os dados subjacentes com uma planilha atualizada.

Assim como na adição a modelos enviados, substituir os dados CSV requer que as colunas e os cabeçalhos correspondam.

Se você excluir a tabela enviada, não poderá substituir os dados do modelo.

Geração automática da chave primária

Ao enviar um CSV, o Analytics criará uma coluna de chave primária única, chamada _mb_row_id, como a primeira (mais à esquerda) coluna da tabela do CSV enviada. Essa coluna _mb_row_id conterá números inteiros gerados automaticamente. O Analytics também ignorará quaisquer colunas no envio com o mesmo nome que a coluna de chave primária gerada automaticamente (por exemplo, _MB row-ID no CSV será tratado como _mb_row_id ou _MB_ROW_ID no banco de dados).

Se você não quiser essa coluna de ID gerada automaticamente, pode removê-la do modelo criado pelo Analytics. Acesse o modelo, clique no ícone de informação i, em seguida em Detalhes do modelo. Na página de detalhes do modelo, clique no botão Editar definição. Na seção Dados do construtor de consultas, clique na seta para baixo ao lado da tabela, desmarque a coluna de ID adicionada e salve suas alterações.

Erros de tipo de dado

O Analytics tentará identificar o tipo de dado de cada coluna, mas se alguns valores forem diferentes dos demais, pode não reconhecer corretamente o tipo. Por exemplo, se uma coluna começa com números inteiros como 100, 130, 140 e depois aparecem valores float como 105.5, o Analytics pode rejeitar o envio. Para corrigir, ajuste o formato na planilha para que todos os valores estejam no mesmo formato, por exemplo, transformando os inteiros em floats (100.00, 130.00, 140.00, etc.) antes de enviar.

Limite de tamanho do arquivo

Arquivos CSV não podem ultrapassar 50 MB.

Embora o Analytics limite os envios a 50 MB, o servidor que você utiliza para rodar o Analytics pode impor um limite menor. Por exemplo, o limite padrão para upload de cliente no NGINX é 1 MB. Portanto, pode ser necessário alterar as configurações do servidor para permitir uploads de até 50 MB. Usuários do Analytics Cloud não precisam se preocupar com isso.

Se você tiver um arquivo maior que 50 MB, a solução é dividir os dados em múltiplos arquivos e adicionar esses arquivos a um modelo existente. Cada arquivo enviado deve conter uma linha de cabeçalho (nomes das colunas), então, ao dividir, lembre-se de incluir essa linha em todos os arquivos.

Formatos de data

Atualmente, o Analytics reconhece datas e datetimes em strings enviadas via CSV somente nos seguintes formatos:

Datas

Representa ano, mês e dia sem informação de tempo.

Formato: yyyy-MM-dd

Exemplo: 2023-01-01

Datetimes

Representa ano, mês, dia e hora. Minutos, segundos e frações de segundos são opcionais.

Formato: yyyy-MM-ddTHH:mm:ss.SSS. O separador “T” também pode ser um espaço (“ “).

Exemplos:

  • 2023-01-01 00
  • 2023-01-01 00:00:00.000
  • 2023-01-01T00:00:00.000
  • 2023-01-01 00:00:00.0000000

Datetimes com deslocamento

Representa datetime com deslocamento em relação ao Tempo Universal Coordenado (UTC). Minutos e segundos no deslocamento são opcionais.

Formatos:

Formatos datetime:

  • yyyy-MM-ddTHH:mm
  • yyyy-MM-ddTHH:mm:ss
  • yyyy-MM-ddTHH:mm:ss.SSS (com qualquer quantidade de S’s)

O separador “T” também pode ser um espaço (“ “).

Deslocamentos:

  • Z (para UTC)
  • +HH ou -HH
  • +HH:mm ou -HH:mm
  • +HH:mm:ss ou -HH:mm:ss

Exemplos:

  • 2023-01-01 00:00:00+00:00:00
  • 2023-01-01T00:00:00+00:00:00

Excluindo modelos e tabelas criados por envios

Excluindo modelos criados por envios

A exclusão de tabelas enviadas está disponível apenas nos planos Pro e Enterprise (tanto self-hosted quanto no Analytics Cloud).

Você pode mover um modelo para a Lixeira clicando nos três pontos no canto superior direito e selecionando Mover para a Lixeira.

Para excluir um modelo permanentemente, veja Excluindo itens permanentemente.

Excluindo tabelas criadas por envios

A exclusão de tabelas enviadas está disponível apenas nos planos Pro e Enterprise (tanto self-hosted quanto no Analytics Cloud).

Para excluir tabelas criadas por envios, vá em Configurações do administrador > Configurações > Uploads.

Em Gerenciar envios, o Analytics listará as tabelas subjacentes aos modelos.

Ao excluir a tabela, o Analytics oferecerá a opção de Também enviar todos os modelos e perguntas baseados nesta tabela para a lixeira.

Leitura adicional


Leia a documentação para outras versões do Analytics.