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ões 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 conferir 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.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, que 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 ela é criada.
  • A conexão precisa estar ativada para tabelas derivadas persistentes (TDPs). Para verificar se os PDTs estão ativados 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 PDTs está ativada.
  • Para conexões do Snowflake, um administrador de banco de dados precisa conceder CREATE STAGE à função do Looker. Para mais detalhes, consulte a página de documentação sobre como criar uma conexão do Looker com o Snowflake.
• 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.

Observe as seguintes limitações para fazer upload de dados do Google Planilhas:

• As instâncias do Looker (Google Cloud Core) que usam o Private Service Connect não são compatíveis com o fluxo OAuth para uploads do Google Sheets. Essas instâncias precisam usar o fluxo de URL manual para fazer upload de dados das Planilhas Google.
• As instâncias do Looker (Google Cloud Core) que usam o VPC Service Controls não são compatíveis com uploads das Planilhas Google.

Como ativar as análises de autoatendimento

Importante:

• Para oferecer suporte ao recurso Análise independente, 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 independente se a instância já tiver análises detalhadas independentes:
  • 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 dashboards que dependem dos dados poderão ser afetados.
  • Se você mudar a conexão padrão para as Análises detalhadas de autoatendimento, todas as Análises detalhadas de autoatendimento na sua instância poderão ser afetadas, assim como os Looks ou dashboards 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, selecione a conexão do BigQuery ou do Snowflake que será usada para armazenar os dados das análises detalhadas de autoatendimento. O Looker vai salvar os dados nesse banco de dados para as Análises detalhadas de autoatendimento na sua instância.
3. Clique no botão Testar ao lado da chave Uploads de dados para verificar se a conexão padrão é válida e se ela está ativada para tabelas derivadas permanentes (PDTs). Consulte a seção Antes de começar para ver os requisitos de conexão. Se o teste falhar, não será possível ativar os uploads de dados. Acesse a página de administrador Conexões para resolver problemas de conexão.
4. Se o teste for aprovado, ative a opção Uploads de dados para habilitar o recurso de análises detalhadas de autoatendimento.
5. Se você quiser que sua instância do Looker ofereça suporte ao upload de dados das Planilhas Google:
   • Verifique se você configurou uma conexão do BigQuery para análises detalhadas de autoatendimento. Os uploads do Google Planilhas são compatíveis apenas com conexões do BigQuery.
   • Use o console Google Cloud para ativar as APIs necessárias para oferecer suporte a uploads do Google Sheets.
   • Se quiser permitir que os usuários usem a navegação do Google Drive para selecionar um arquivo das Planilhas Google e fazer upload de dados, ative o OAuth para uploads das Planilhas Google.
   • Clique no botão Testar ao lado da opção Importação de dados das Planilhas Google para executar um teste específico para uploads das Planilhas Google.
   • Ative a opção Importação de dados do Google Planilhas. As opções Uploads de dados e Importação de dados do Google Planilhas precisam estar ativadas para fazer upload de dados do Google Planilhas.

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

Para permitir que o Looker faça upload de dados do Google Sheets para conexões do BigQuery, 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 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 da página de administrador Análises detalhadas 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 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 , abra o seletor de projetos e escolha o projeto que hospeda a conexão do BigQuery especificada no menu suspenso Conexão padrão 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, se ela ainda não estiver ativada, clique em Ativar.

Configuração para instâncias do Private Service Connect

Se a instância do Looker (Google Cloud Core) usar o Private Service Connect (PSC), você precisará realizar uma etapa extra para oferecer suporte aos envios do Google Sheets.

Para permitir que o Looker acesse a API Google Sheets, publique o Google Sheets como um serviço usando o Private Service Connect e adicione o Google Sheets à configuração de FQDN local no Looker (Google Cloud core). Ao configurar o FQDN local, use sheets.googleapis.com no campo FQDN local e o URI de anexo do serviço publicado no campo URI de anexo do serviço de destino. Para instruções, consulte a documentação Conectar-se a serviços publicados usando o FQDN local.

Ativar o OAuth para uploads do Google Planilhas

Importante:as instâncias do Looker (Google Cloud Core) que usam o Private Service Connect não são compatíveis com o fluxo OAuth para uploads do Google Sheets. Essas instâncias precisam usar o fluxo de URL manual para fazer upload de dados das Planilhas Google.

Depois de ativar as análises detalhadas de autoatendimento, ativar as APIs para oferecer suporte a uploads do Google Planilhas e ativar a opção Importação de dados 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.

Observação: antes de gerar suas credenciais OAuth, o Google exige que você configure uma tela de permissão OAuth, que permite aos usuários escolher como conceder acesso aos dados particulares deles. Se você ainda não tiver configurado uma tela de permissão OAuth para o projeto do console Google Cloud selecionado, o console Google Cloud vai mostrar um aviso com um botão Configurar tela de permissão. Clique no botão e siga o procedimento na página de documentação do Workspace Configurar a tela de permissão OAuth e escolher escopos. Depois, retorne a este procedimento.

Para criar o cliente OAuth e inserir as credenciais na sua instância do Looker, siga estas etapas:

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

   Acesse o console do Google Cloud

2. Use o menu principal do console Google Cloud para acessar APIs e serviços > Credenciais.

3. Na página Credenciais, clique no menu suspenso Criar credenciais e selecione ID do cliente OAuth.

4. No menu suspenso Tipo de aplicativo, selecione Aplicativo da Web.

5. No campo Nome, insira um nome para o cliente OAuth, como Looker upload data from Sheets.

6. Na seção Origens JavaScript autorizadas, clique no botão Adicionar URI. Insira o URL da instância do Looker:

   https://LOOKER_INSTANCE_URL
   

7. Clique em Criar.

8. Depois de clicar em Criar, uma janela Cliente OAuth criado vai aparecer. Essa janela mostra o ID e a chave secreta do cliente que o Google Cloud console criou para seu cliente OAuth. Copie e anote esses valores.

9. Na sua instância do Looker, selecione Análises detalhadas de autoatendimento na seção Geral do painel Administrador.

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

11. Clique em Salvar.

12. Clique no botão Testar ao lado da opção Importação de dados do Google Sheets para testar a configuração do OAuth e do upload do Google Sheets. Você também pode clicar no botão Testar ao lado da chave Uploads de dados para verificar a conexão, além da configuração do Google Sheets.

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 das Planilhas Google.

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 independente, que também é um hiperlink que abre a Análise independente
• 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 independente associada.

Os administradores do Looker podem abrir qualquer Análise independente 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 são de sua propriedade ou que o proprietário compartilhou especificamente com você. O menu Análise não lista todas as Análises independentes 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 independente. 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.