Com o recurso Análises de autoatendimento, os usuários do Looker podem fazer upload de arquivos CSV, XLS e XLSX para o Looker e consultar e visualizar os dados em uma análise detalhada do Looker sem precisar configurar um modelo LookML ou configurar o controle de versão do Git.
Os administradores do Looker podem selecionar a opção Análises de autoatendimento no menu Administrador do Looker para configurar o recurso Análises de autoatendimento e conferir os uploads de dados na instância.
Antes de começar
Para usar as análises de autoatendimento, a instância do Looker precisa atender aos seguintes requisitos:
- Executar o Looker 25.18 ou mais recente.
- Ter uma conexão com um banco de dados do BigQuery (consulte a página de documentação do Google BigQuery para saber como configurar uma conexão do BigQuery na instância do Looker). A conexão precisa ser configurada das seguintes maneiras:
- A conexão precisa ser configurada com o escopo Todos os projetos. Para verificar o escopo da conexão, consulte a coluna Escopo na guia Bancos de dados da página Conexões no menu de administrador do Looker. O valor do escopo do projeto da conexão não pode ser editado depois que a conexão é criada.
- A conexão precisa estar ativada para tabelas derivadas persistentes (TDPs). Para verificar se as TDPs estão ativadas na conexão do BigQuery, abra a página Conexões do Looker, clique no botão Editar da conexão do BigQuery, clique para abrir a guia Configurações opcionais e verifique se a opção Ativar TDPs está ativada.
- Para qualquer usuário que criar análises de autoatendimento, a conta de usuário do Looker precisa ter a permissão
upload_data, que permite que um usuário faça upload de arquivos CSV para sua instância.
Ativar análises de autoatendimento
Antes que os usuários possam criar análises de autoatendimento, um administrador do Looker precisa configurar o recurso seguindo estas etapas:
- Na seção Geral do menu Administrador do Looker, selecione a página de administrador Análises de autoatendimento.
- Na página de administrador Análises de autoatendimento, no menu suspenso Conexão padrão do BigQuery, selecione a conexão do BigQuery a ser usada para armazenar os dados das análises de autoatendimento. O Looker vai salvar os dados nesse banco de dados do BigQuery para as análises de autoatendimento na instância.
- Clique no botão Testar conexão para verificar se a conexão do BigQuery é válida e se ela tem TDPs ativadas para oferecer suporte a uploads de dados. Consulte a seção Antes de começar para informações sobre os requisitos de conexões para oferecer suporte a uploads de dados. Se o teste falhar, não será possível ativar os uploads de dados. Acesse a página de administrador Conexões para conferir mais detalhes sobre a conexão e testá-la ainda mais para saber onde ela está falhando.
- Clique no botão Ativar uploads de dados.
- Se você quiser que a instância do Looker ofereça suporte ao upload de dados do Planilhas Google, também precisará usar o Google Cloud console para ativar as APIs necessárias. Consulte a seção Ativar as APIs para oferecer suporte a uploads do Planilhas Google nesta página.
Ativar as APIs para oferecer suporte a uploads do Planilhas Google
Para oferecer suporte ao upload de dados do Planilhas Google, as seguintes APIs precisam ser ativadas no Google Cloud console por um usuário do IAM com a permissão roles/serviceusage.serviceUsageAdmin do IAM:
Essa API precisa ser ativada no Google Cloud projeto que hospeda a conexão do BigQuery especificada no menu suspenso Conexão padrão do BigQuery da página de administrador Análises de autoatendimento:
- API BigQuery: necessária para todas as operações do BigQuery
Essas APIs precisam ser ativadas no Google Cloud projeto associado à conta de serviço usada para fazer upload de dados (a conta de serviço usada para processos de TDP na conexão do BigQuery, que pode ou não ser a mesma do Google Cloud projeto especificado no menu suspenso Conexão padrão do BigQuery da página de administrador Análises de autoatendimento):
- API BigQuery: necessária para todas as operações do BigQuery
- API Google Sheets: necessária para recuperar os nomes de cada planilha em um documento do Planilhas Google
- API Google Drive: necessária para que o BigQuery leia arquivos do Drive
Siga estas etapas para ativar as APIs:
No Google Cloud console seletor de projetos aberto, selecione o projeto que hospeda a conexão do BigQuery especificada no menu suspenso Conexão padrão do BigQuery da página de administrador Análises de autoatendimento.
No menu de navegação do Google Cloud console, acesse APIs e serviços > Biblioteca e abra a API BigQuery.
Na página da API BigQuery, se a API ainda não estiver ativada, clique em Ativar.
Ainda na página da API BigQuery, no Google Cloud console seletor de projetos aberto, selecione o Google Cloud projeto associado à conta de serviço usada para fazer upload de dados (a conta de serviço usada para processos de TDP na conexão do BigQuery).
Na página da API BigQuery, se a API ainda não estiver ativada, clique em Ativar.
No menu de navegação do Google Cloud console, acesse APIs e serviços > Biblioteca e abra a API Google Sheets.
Na página da API Google Sheets, se a API ainda não estiver ativada, clique em Ativar.
No menu de navegação do Google Cloud console, acesse APIs e serviços > Biblioteca e abra a API Google Drive.
Na página da API Google Drive, se a API ainda não estiver ativada, clique em Ativar.
Ativar o OAuth para uploads do Planilhas Google
Depois de ativar as análises de autoatendimento e ativar as APIs para oferecer suporte a uploads do Planilhas Google, também é possível permitir que os usuários usem a navegação do Google Drive para selecionar documentos do Planilhas Google para uploads de dados.
Para ativar a navegação do Google Drive na instância do Looker, um usuário do IAM com os papéis necessários precisa criar um cliente OAuth no Google Cloud console e inserir as credenciais do OAuth na página de administrador Análises de autoatendimento na instância do Looker, conforme descrito no procedimento desta seção.
Para criar o cliente OAuth e inserir as credenciais na instância do Looker, siga estas etapas:
Noconsole, use oconsole seletor de projetos aberto para selecionar oprojeto associado à conta de serviço usada para fazer upload de dados (a conta de serviço usada para processos de TDP na conexão do BigQuery). Google Cloud Google Cloud Google Cloud
Use o menu principal doconsole para navegar até APIs e serviços > Credenciais. Google Cloud
Na página Credenciais , clique no menu suspenso Criar credenciais e selecione ID do cliente OAuth.
No menu suspenso Tipo de aplicativo, selecione Aplicativo da Web.
No campo Nome, insira um nome para o cliente OAuth, como
Looker upload data from Sheets.Na seção Origens JavaScript autorizadas, clique no botão Adicionar URI. Insira o URL da instância do Looker:
https://LOOKER_INSTANCE_URLClique em Criar.
Depois de clicar em Criar, uma janela Cliente OAuth criado será exibida. Essa janela mostra o ID e a chave secreta do cliente que o Google Cloud console criou para o cliente OAuth. Copie e anote esses valores.
Na instância do Looker, selecione Análises de autoatendimento na seção Geral do painel Administrador.
Na página Análises de autoatendimento, nos campos ID do cliente e Chave secreta do cliente, cole os valores que você copiou do Google Cloud console ao criar o cliente OAuth no Google Cloud console.
Clique em Salvar.
Agora, quando os usuários fizerem upload de dados usando a opção Importar da nuvem, o Looker vai mostrar a navegação do Google Drive para selecionar documentos do Planilhas Google.
Conferir os uploads de dados na instância do Looker
Se as análises de autoatendimento estiverem ativadas na instância, um administrador do Looker poderá usar a tabela Uploads de dados na página de administrador Análises de autoatendimento para conferir os dados que os usuários fizeram upload na instância.
A tabela Uploads de dados mostra as seguintes informações sobre os uploads de dados na instância:
- O nome da análise de autoatendimento, que também é um hiperlink que abre a análise de autoatendimento
- O proprietário do upload de dados
- A data em que os dados foram enviados
- Um botão Excluir que permite que os administradores do Looker excluam o upload de arquivo e a análise de autoatendimento associada
Os administradores do Looker podem abrir qualquer análise de autoatendimento na instância usando os links na tabela Uploads de dados. No entanto, a seção Análises de autoatendimento do menu Análise do Looker lista apenas as análises de autoatendimento que você possui ou que o proprietário compartilhou especificamente com você. O menu Análise não lista todas as análises de autoatendimento na instância para administradores do Looker, porque isso poderia tornar o menu Análise complicado.
Remover um upload de dados
O proprietário de um upload de dados pode remover o upload da página Editar análise de autoatendimento. Além disso, um administrador do Looker pode remover um upload de dados da página de administrador Análises de autoatendimento seguindo estas etapas:
- Na seção Geral do menu Administrador do Looker, selecione a página de administrador Análises de autoatendimento.
- Na tabela Uploads de dados, clique no botão Excluir do upload de dados que você quer remover.
- Clique em Copiar na caixa de diálogo de confirmação.