Você pode migrar dados para os relatórios do Looker de qualquer fonte que forneça arquivos CSV (valores separados por vírgula). É possível fazer upload de arquivos CSV diretamente do seu computador.
Criar uma fonte de dados de arquivo CSV
Os relatórios do Looker armazenam arquivos CSV enviados em conjuntos de dados. Um conjunto de dados pode conter um ou mais arquivos CSV com os mesmos cabeçalhos de coluna. Uma fonte de dados de arquivo CSV pode conter um ou mais conjuntos de dados.
Para criar uma fonte de dados de arquivo CSV, siga estas etapas:
- Abra um relatório do Looker.
- Clique no botão Criar e selecione Fonte de dados.
- Selecione o conector do Google Upload de arquivo CSV.
- Clique no botão Adicionar conjunto de dados para criar um novo.
- Também é possível arrastar um ou mais arquivos CSV para a seção Conjuntos de dados disponíveis. O relatório do Looker vai criar um novo conjunto de dados com os arquivos enviados.
- Quando terminar de fazer upload dos arquivos, clique no botão Conectar.
Os dados enviados são armazenados no Cloud Storage. Essa configuração de armazenamento oferece muitos benefícios, incluindo a capacidade de acessar e fazer o download dos seus dados da nuvem e de usar outros serviços do Google Cloud com eles.
Saiba mais sobre o Cloud Storage.
Adicionar arquivos CSV a um conjunto de dados
É possível fazer o upload de vários arquivos para um conjunto de dados, desde que os cabeçalhos das colunas sejam correspondentes. Quando você adiciona novos arquivos, esses dados são anexados ao conjunto de dados. Isso permite que você atualize seus dados com o tempo.
Para adicionar arquivos CSV a um conjunto de dados, siga estas etapas:
- Abra um relatório do Looker.
- Clique na guia Origens de dados.
- Selecione a fonte de dados que contém seus arquivos CSV.
- Clique em Editar conexão.
- Na seção Conjuntos de dados disponíveis, selecione o conjunto de dados de que você quer adicionar arquivos.
- Clique no botão Adicionar arquivo.
- Você também pode arrastar um ou mais arquivos CSV para a seção Arquivos no conjunto de dados.
- Depois de terminar o upload dos arquivos, clique no botão Reconectar.
Compartilhamento de conjuntos de dados
Os conjuntos de dados criados pertencem a você e não podem ser compartilhados. No entanto, depois de criar uma fonte de dados com base no seu conjunto, você pode compartilhar essa fonte com outros usuários. Isso significa que seus conjuntos de dados podem ser usados em fontes de dados compartilhadas e relatórios, mas só você pode acessar o conjunto de dados propriamente dito.
Formato do arquivo de upload
Confirme se os arquivos enviados estão formatados corretamente. Caso não estejam, poderá ocorrer erros durante o upload, ou os dados talvez não apareçam de maneira correta nos seus relatórios.
Uma causa comum de erros de conteúdo é o uso indevido de separadores, aspas e caracteres de quebra de linha nos dados enviados. Entender como o upload de arquivos CSV lida com esses elementos pode evitar problemas no futuro.
Codificação UTF-8
Seu arquivo de upload precisa estar na codificação UTF-8. Essa é uma codificação padrão para a maioria dos aplicativos na Web.
No entanto, se você estiver exportando dados de determinados produtos para computador, como o Microsoft Excel™, talvez seja necessário converter seu arquivo para UTF-8 antes de fazer o upload para um relatório do Looker. Caso contrário, o relatório do Looker poderá retornar uma mensagem de erro, como File is Invalid..
Somente dados tabulares
O upload de arquivos CSV só pode importar arquivos de dados tabulares. Isso significa que os arquivos precisam ter uma estrutura regular de linhas e colunas. Cada linha precisa ter o mesmo número de colunas, mesmo que não haja dados em uma determinada célula na tabela. A tentativa de fazer o upload de um arquivo com células mescladas ou uma estrutura inconsistente gera um erro de upload.
Separadores
Todos os campos dos seus dados precisam ser separados uns dos outros por vírgulas.
Se os dados reais em um campo que você quer enviar contiverem vírgulas, esse campo precisará estar entre aspas. Se os dados incluírem aspas duplas, você poderá colocar o campo entre aspas simples.
Linha de cabeçalho
A primeira linha do arquivo precisa ser uma linha de cabeçalho. Ela indica como o relatório do Looker deve nomear seus campos. Os nomes de campo precisam ser exclusivos. Sendo assim, não é possível ter valores duplicados na linha de cabeçalho.
Os nomes de coluna precisam:
- conter apenas letras, números ou sublinhados. Outra pontuação ou caracteres especiais não são permitidos;
- começar com uma letra ou sublinhado;
- ter no máximo 128 caracteres.
A linha de cabeçalho também precisa seguir as regras para separadores.
Quebras de linha
Toda linha do arquivo precisa terminar com uma quebra de linha. O upload de arquivos CSV não permite quebras de linha nos seus dados, mesmo que elas sejam isoladas por aspas.
Solução de problemas
As seções a seguir descrevem erros comuns que podem aparecer ao fazer upload de arquivos CSV.
Erro: o arquivo é inválido
Se o Looker mostrar o erro File is Invalid depois de tentar fazer upload de um arquivo CSV, verifique as seguintes causas possíveis:
- O arquivo contém caracteres UTF-8 inválidos.
- O arquivo não está no formato CSV. Por exemplo, se você renomear um arquivo PDF para usar a extensão ".csv", o relatório do Looker não poderá analisar o arquivo corretamente.
Limites do upload de arquivos CSV
O upload de arquivos CSV está sujeito a estes limites:
- 1.000 conjuntos de dados por usuário
- 2 GB de armazenamento total por usuário
- 100 uploads por conjunto de dados por dia
- Arquivos de até 100 MB por conjunto de dados