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

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 conferir os uploads de dados na instância.

Antes de começar

Para usar as análises detalhadas 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 STAGE ao 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 detalhadas 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.

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

Como ativar as análises detalhadas de autoatendimento

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

  1. Na seção Geral do menu Admin do Looker, selecione a página de admin Análises detalhadas de autoatendimento.
  2. Na página de admin Análises detalhadas 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 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 opção Uploads de dados para verificar se a conexão padrão é válida e se a conexão está ativada para tabelas derivadas persistentes (TDPs). Consulte a seção Antes de começar para conferir os requisitos de conexão. Se o teste falhar, não será possível ativar os uploads de dados. Acesse a página de admin Conexões para resolver problemas na conexão.
  4. Se o teste for aprovado, ative a opção Uploads de dados para ativar o recurso de análises detalhadas de autoatendimento.
  5. Se você quiser que a instância do Looker ofereça suporte ao upload de dados do Planilhas Google:
    • Verifique se você configurou uma conexão do BigQuery para análises detalhadas de autoatendimento. Os uploads do Planilhas Google são compatíveis apenas com conexões do BigQuery.
    • Use o Google Cloud console para ativar as APIs necessárias para oferecer suporte a uploads do Planilhas Google.
    • Opcionalmente, ative o OAuth para uploads do Planilhas Google se quiser permitir que os usuários usem a navegação do Google Drive para selecionar um arquivo do Planilhas Google para upload de dados.
    • Clique no botão Testar ao lado da opção Importação de dados do Planilhas Google para executar um teste específico para uploads do Planilhas Google.
    • Ative a opção Importação de dados do Planilhas Google. As opções Uploads de dados e Importação de dados do Planilhas Google precisam estar ativadas para fazer upload de dados do Planilhas Google.

Como 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 consolenum 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 detalhadas 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 que é especificado no menu suspenso Conexão padrão da página de admin 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 do Planilhas Google
    • API Google Drive: necessária para que o BigQuery leia arquivos do Drive

Siga estas etapas para ativar as APIs:

  1. No Google Cloud console Abrir seletar de projetos, 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 detalhadas de autoatendimento.

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

    Acessar a API BigQuery

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

  4. Ainda na página da API BigQuery, no Google Cloud console Abrir seletor de projetos, 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).

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

  6. No menu de navegação do Google Cloud console, 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 Google Cloud console, 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 a API 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 Private Service Connect (PSC), você precisará realizar uma etapa extra para oferecer suporte a uploads do Planilhas Google.

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

Como ativar o OAuth para uploads do Planilhas Google

Depois de ativar as análises detalhadas de autoatendimento, as APIs para oferecer suporte a uploads do Planilhas Google e a opção Importação de dados do Planilhas Google, você também pode 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 OAuth na página de admin Análises detalhadas 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:

  1. Noconsole, use o Google Cloud console Google Cloud Abrir seletor de projetos 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).

    Acessar o Google Cloud console

  2. Use o menu principal doconsole para navegar até APIs e serviços > Credenciais. Google Cloud

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

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

  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 Google Cloud console ao criar o cliente OAuth no Google Cloud console.

  11. Clique em Salvar.

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

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

Como conferir os uploads de dados na instância do Looker

Se as análises detalhadas 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 detalhadas 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 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 que os admins do Looker excluam o upload de arquivo e a análise detalhada de autoatendimento associada a ele

Os admins 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 Análise detalhada do Looker lista apenas as análises detalhadas de autoatendimento que você possui ou que o proprietário compartilhou especificamente com você. O menu Análise detalhada não lista todas as análises detalhadas de autoatendimento na instância para admins do Looker, porque isso poderia tornar o menu Análise detalhada complicado.

Como 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 admin do Looker pode remover um upload de dados da página de admin Análises detalhadas de autoatendimento seguindo estas etapas:

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