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ões do Git.
Os admins 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 visualizar 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.20 ou mais recente para conexões do BigQuery ou o Looker 26.8 ou mais recente para conexões do Snowflake.
- Ter uma conexão com um banco de dados do BigQuery ou do Snowflake, e 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 Bancos de dados guia da página Conexões no menu de admin 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, abra a página Conexões do Looker, clique no botão Editar da conexão, clique para abrir a guia Configurações opcionais e verifique se a opção Ativar TDPs está ativada.
- Para conexões do Snowflake, um administrador de banco de dados precisa conceder
CREATE STAGEao papel do Looker. Para mais detalhes, consulte a página de documentação sobre como criar uma conexão do Looker com o Snowflake.
- 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.
Ativar análises de autoatendimento
Antes que os usuários possam criar análises de autoatendimento, um admin do Looker precisa configurar o recurso seguindo estas etapas:
- Na seção Geral do menu Admin do Looker, selecione a página de admin Análises de autoatendimento.
- Na página de admin Análises de autoatendimento, no menu suspenso Conexão padrão, selecione a conexão do BigQuery ou do Snowflake a ser usada para armazenar os dados das análises de autoatendimento. O Looker vai salvar os dados nesse banco de dados para as análises de autoatendimento na sua instância.
- Clique no botão Testar conexão para verificar se a conexão é válida e se ela tem TDPs ativadas para que possa 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 admin 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 que o Looker ofereça suporte ao upload de dados do Planilhas Google para conexões do BigQuery, 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 Conexão padrão menu suspenso da página de admin 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 que a especificada no Google Cloud projeto no menu suspenso Conexão padrão da página de admin 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 da página de admin Análises de autoatendimento.
No Google Cloud menu de navegação do 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 Google Cloud menu de navegação do 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 Google Cloud menu de navegação do 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 admin 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 o Google Cloud console Google Cloud Seletor de projetos aberto para selecionar 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).
Use o Google Cloud menu principal do console para navegar até APIs e serviços > Credenciais.
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 Admin.
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.
Visualizar os uploads de dados na instância do Looker
Se as análises de autoatendimento estiverem ativadas na sua instância, um admin do Looker poderá usar a tabela Uploads de dados na página de admin Análises de autoatendimento para visualizar 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, 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 admins do Looker excluam o upload de arquivo e a análise de autoatendimento associada
Os admins 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 admins do Looker, já que 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 admin do Looker pode remover um upload de dados da página de admin Análises de autoatendimento seguindo estas etapas:
- Na seção Geral do menu Admin do Looker, selecione a página de admin 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.