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 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 Admin 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, sua 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 administração 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 vai 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.
Como ativar as 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 Admin do Looker, selecione a página de administração Análises de autoatendimento.
- Na página de administração 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 sua 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 saber mais 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 administração 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 Como ativar as APIs para oferecer suporte a uploads do Planilhas Google nesta página.
Como 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 administração 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 administração 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:
Noconsole Google Cloud 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 administração 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, selecioneo 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.
Como conferir os uploads de dados na instância do Looker
Se as análises de autoatendimento estiverem ativadas na sua instância, um administrador do Looker poderá usar a tabela Uploads de dados na página de administração 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 sua instância:
- O nome da 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 a ele
Como 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 administração Análises de autoatendimento seguindo estas etapas:
- Na seção Geral do menu Admin do Looker, selecione a página de administração Análises de autoatendimento.
- Na tabela Uploads de dados, clique no botão Excluir do upload de dados que você quer remover.
- Clique em Excluir na caixa de diálogo de confirmação.