Configurações de administrador: análises detalhadas de autoatendimento

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.

Observação: o recurso Análises detalhadas de autoatendimento está em pré-lançamento com suporte limitado. Compartilhe seu feedback para nos ajudar a melhorar. Para informar bugs ou problemas, envie um e-mail para [e-mail] com os seguintes detalhes:

• Uma descrição clara do problema e do comportamento esperado
• Etapas para a reprodução do problema
• Outros detalhes relevantes

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

Importante:

• Para oferecer suporte ao recurso Análise detalhada de autoatendimento, ao fazer upgrade para o Looker 25.20, sua instância do Looker adiciona a permissão upload_data a qualquer papel ou conjunto de permissões que contenha a permissão explore, incluindo conjuntos de permissões personalizados. Se você ativar os uploads de dados em uma instância do Looker, qualquer usuário com a permissão upload_data poderá fazer upload de dados para criar análises detalhadas de autoatendimento na sua instância.
• Tenha cuidado ao mudar as configurações na página de administrador Análises detalhadas de autoatendimento se a instância já tiver análises detalhadas de autoatendimento:
  • Se você desativar os uploads de dados, os usuários não poderão mais acessar as análises detalhadas de autoatendimento no menu Analisar, e os Looks ou painéis que dependem dos dados poderão ser afetados.
  • Se você mudar a conexão do BigQuery, as análises detalhadas de autoatendimento na sua instância poderão ser afetadas, assim como os Looks ou painéis que dependem dos dados delas.

Antes que os usuários possam criar análises detalhadas de autoatendimento, um administrador do Looker precisa configurar o recurso seguindo estas etapas:

1. Na seção Geral do menu Administrador do Looker, selecione a página de administrador Análises detalhadas de autoatendimento.
2. 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.
3. 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.
4. Clique no botão Ativar uploads de dados.
5. Se você quiser que sua instância do Looker ofereça suporte ao upload de dados das Planilhas Google, 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 Sheets nesta página.

Como ativar as APIs para oferecer suporte a uploads das Planilhas Google

Para permitir o upload de dados do Google Sheets, 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 Planilhas Google: necessária para recuperar os nomes de cada planilha em um documento das Planilhas Google.
  • API Google Drive: necessária para o BigQuery ler arquivos do Drive.

Siga estas etapas para ativar as APIs:

1. 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.

2. No menu de navegação do console Google Cloud , acesse APIs e serviços > Biblioteca e abra a API BigQuery.

   Acessar a API BigQuery

3. Na página da API BigQuery, se ela ainda não estiver ativada, clique em Ativar.

4. 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).

5. Na página da API BigQuery, se ela ainda não estiver ativada, clique em Ativar.

6. No menu de navegação do console Google Cloud , acesse APIs e serviços > Biblioteca e abra a API Google Sheets.

   Acessar a API Google Sheets

7. Na página da API Google Sheets, se a API ainda não estiver ativada, clique em Ativar.

8. No menu de navegação do console Google Cloud , acesse APIs e serviços > Biblioteca e abra a API Google Drive.

   Acessar a API Google Drive

9. Na página da API Google Drive, clique em Ativar se a API ainda não estiver ativada.

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
• 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.

Remover um upload de dados

O proprietário de um upload de dados pode remover o upload da página Editar análise detalhada de autoatendimento. 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:

1. Na seção Geral do menu Administrador do Looker, selecione a página de administrador Análises detalhadas de autoatendimento.
2. Na tabela Uploads de dados, clique no botão Excluir do upload que você quer remover.
3. Clique em Copiar na caixa de diálogo de confirmação.