Você pode importar dados para o Studio no Looker de qualquer fonte que ofereça arquivos CSV (valores separados por vírgula). Você pode fazer upload de arquivos CSV diretamente do seu computador.
Criar uma fonte de dados de arquivo CSV
O Studio no Looker armazena 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 origem de dados de arquivo CSV pode conter um ou mais conjuntos de dados.
Para criar uma nova fonte de dados de arquivo CSV, siga estas etapas:
- Faça login no Studio no Looker.
- Clique no botão Criar e selecione Fonte de dados.
- Selecione o conector do Google Upload de arquivo CSV.
- Crie um novo conjunto de dados clicando no botão Adicionar conjunto de dados.
- Também é possível arrastar um ou mais arquivos CSV para a seção Conjuntos de dados disponíveis. O Studio no Looker vai criar um novo conjunto de dados com os arquivos enviados.
- Quando terminar de fazer o upload dos arquivos, clique no botão Conectar.
Os dados enviados são armazenados no Cloud Storage. Essa configuração de armazenamento oferece muitas vantagens, incluindo a capacidade de acessar e fazer o download de dados da nuvem e usar outros Google Cloud serviços com esses dados.
Saiba mais sobre o Cloud Storage.
Adicionar arquivos CSV a um conjunto de dados
É possível fazer 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 passar do tempo.
Para adicionar arquivos CSV a um conjunto de dados, siga estas etapas:
- Faça login no Studio no 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.
- Quando terminar de fazer o upload dos arquivos, clique no botão Reconectar.
Como compartilhar 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
Verifique se os arquivos enviados estão formatados corretamente. Caso contrário, 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
O 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 um determinado produto para computador, como o Microsoft Excel™, talvez seja necessário converter seu arquivo para UTF-8 antes de fazer o upload usando o Studio no Looker. Caso contrário, o Studio no Looker pode 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. Essa linha vai informar ao Studio no Looker como 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. Outros sinais de 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
Cada 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 ocorrer ao fazer upload de arquivos CSV.
Erro: o arquivo é inválido
Se o Studio no Looker mostrar o erro File is Invalid após tentar fazer o upload de um arquivo CSV, verifique as seguintes causas possíveis:
- O arquivo contém caracteres UTF-8 inválidos.
- O arquivo não é um arquivo CSV. Por exemplo, se você renomear um arquivo PDF para usar a extensão ".csv", o Studio no Looker não vai conseguir analisar o arquivo corretamente.
Limites do upload de arquivos CSV
O upload de arquivos CSV está sujeito aos seguintes 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