Com o recurso Análises detalhadas 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 o controle de versão do Git.
Os administradores do Looker podem selecionar a opção Análises detalhadas de autoatendimento no menu Administrador do Looker para configurar o recurso Análises detalhadas de autoatendimento e ver os uploads de dados na instância.
Antes de começar
Para usar as análises detalhadas independente, sua instância do Looker precisa atender aos seguintes requisitos:
- Executar o Looker 25.18 ou uma versão 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 sua 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 (PDTs). Para verificar se as PDTs 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 PDTs está ativada.
- Para criar análises detalhadas de autoatendimento, a conta de usuário do Looker precisa ter a permissão
upload_data, que permite fazer upload de arquivos CSV para a instância.
Como ativar as análises detalhadas de autoatendimento
Antes que os usuários possam criar análises detalhadas 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 detalhadas de autoatendimento.
- Na página de administrador Análises detalhadas de autoatendimento, no menu suspenso Conexão padrão do BigQuery, selecione a conexão do BigQuery que será usada para armazenar os dados das análises detalhadas de autoatendimento. O Looker salva os dados nesse banco de dados do BigQuery para as análises detalhadas 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 PDTs 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 fazer upload de dados de suporte. 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 sua conexão e testar a conexão para saber onde ela está falhando.
- Clique no botão Ativar uploads de dados.
- Se você quiser que sua instância do Looker ofereça suporte ao upload de dados do Google Planilhas, também será necessário usar o console Google Cloud para ativar as APIs necessárias. Consulte a seção Como ativar as APIs para oferecer suporte a uploads do Google Planilhas nesta página.
Como ativar as APIs para oferecer suporte a uploads do Google Planilhas
Para permitir o upload de dados do Google Planilhas, as seguintes APIs precisam ser ativadas no console Google Cloud por um usuário do IAM com a permissão roles/serviceusage.serviceUsageAdmin do IAM:
Essa API precisa ser ativada no projeto Google Cloud que hospeda a conexão do BigQuery especificada no menu suspenso Conexão padrão do BigQuery da página de administrador Análises detalhadas de autoatendimento:
- API BigQuery: necessária para todas as operações do BigQuery
Essas APIs precisam estar ativadas no projeto Google Cloud associado à conta de serviço usada para fazer upload de dados (a conta de serviço usada para processos de PDT na sua conexão do BigQuery, que pode ou não ser a mesma do projeto Google Cloud especificado no menu suspenso Conexão padrão do BigQuery da página de administrador Análises detalhadas de autoatendimento):
- API BigQuery: necessária para todas as operações do BigQuery
- API Google Planilhas: necessária para recuperar os nomes de cada página em um documento do Google Planilhas.
- API Google Drive: necessária para o BigQuery ler arquivos do Drive.
Siga estas etapas para ativar as APIs:
No console Google Cloud , clique em Abrir seletor de projetos e escolha o projeto que tem a conexão do BigQuery especificada no menu suspenso Conexão padrão do BigQuery da página de administrador Análises detalhadas de autoatendimento.
No menu de navegação do console Google Cloud , acesse APIs e serviços > Biblioteca e abra a API BigQuery.
Na página da API BigQuery, se ela ainda não estiver ativada, clique em Ativar.
Ainda na página da API BigQuery, no console Google Cloud , abra o seletor de projetos e escolha o projeto Google Cloud associado à conta de serviço usada para fazer upload de dados (a conta de serviço usada para processos de PDT na sua conexão do BigQuery).
Na página da API BigQuery, se ela ainda não estiver ativada, clique em Ativar.
No menu de navegação do console Google Cloud , 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 console Google Cloud , acesse APIs e serviços > Biblioteca e abra a API Google Drive.
Na página da API Google Drive, clique em Ativar se a API ainda não estiver ativada.
Como ativar o OAuth para uploads do Google Planilhas
Depois de ativar as análises detalhadas de autoatendimento e ativar as APIs para oferecer suporte a uploads do Google Planilhas, você também pode permitir que os usuários usem a navegação do Google Drive para selecionar documentos do Google Planilhas para uploads de dados.
Para ativar a navegação do Google Drive na sua instância do Looker, um usuário do IAM com as funções necessárias precisa criar um cliente OAuth no console Google Cloud e inserir as credenciais OAuth na página de administrador Análises detalhadas de autoatendimento na sua instância do Looker, conforme descrito no procedimento desta seção.
Para criar o cliente OAuth e inserir as credenciais na sua instância do Looker, siga estas etapas:
No console Google Cloud , use o Seletor de projetos do console Google Cloud para selecionar o projeto Google Cloud associado à conta de serviço usada para fazer upload de dados (a conta de serviço usada para processos de PDT na sua conexão do BigQuery).
Use o menu principal do console Google Cloud para acessar 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 vai aparecer. Essa janela mostra o ID do cliente e chave secreta do cliente que o Google Cloud console criou para seu cliente OAuth. Copie e anote esses valores.
Na sua instância do Looker, selecione Análises detalhadas de autoatendimento na seção Geral do painel Administrador.
Na página Análises detalhadas de autoatendimento, nos campos ID do cliente e Chave secreta do cliente, cole os valores que você copiou do console do Google Cloud ao criar o cliente OAuth no console do Google Cloud .
Clique em Salvar.
Agora, quando os usuários fazem upload de dados usando a opção Importar da nuvem, o Looker mostra a navegação do Google Drive para selecionar documentos do Google Planilhas.
Como acessar os uploads de dados na sua instância do Looker
Se as análises detalhadas 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 detalhadas de autoatendimento para conferir os dados que seus usuários enviaram 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 detalhada de autoatendimento, que também é um hiperlink que abre a análise detalhada de autoatendimento
- O proprietário do upload de dados
- A data em que os dados foram enviados
- Um botão Excluir que permite aos administradores do Looker excluir o upload de arquivo e a análise detalhada independente associada.
Os administradores do Looker podem abrir qualquer análise detalhada de autoatendimento na instância usando os links na tabela Uploads de dados. No entanto, a seção Análises detalhadas de autoatendimento do menu Analisar do Looker lista apenas as análises detalhadas de autoatendimento que pertencem a você 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 o recurso "Explorar por conta própria". Além disso, um administrador do Looker pode remover um upload de dados da página de administrador Análises detalhadas de autoatendimento seguindo estas etapas:
- Na seção Geral do menu Administrador do Looker, selecione a página de administrador Análises detalhadas de autoatendimento.
- Na tabela Uploads de dados, clique no botão Excluir do upload que você quer remover.
- Clique em Copiar na caixa de diálogo de confirmação.