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, importar Planilhas Google ou se conectar diretamente a tabelas de banco de dados para consultar e visualizar 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 as fontes de dados de autoatendimento na instância. A página de administrador Análises detalhadas de autoatendimento contém as seguintes guias:

• Tabelas de banco de dados: ative a opção Permitir a conexão com tabelas de banco de dados para que os usuários possam criar modelos de dados com tabelas de banco de dados usando a tela de modelagem visual.
• Uploads e importações: configure conexões de banco de dados para uploads de dados de autoatendimento, ative a importação de dados do Google Planilhas e configure as credenciais do OAuth para o Google Planilhas.
• Histórico de auditoria: veja e gerencie as Análises detalhadas de autoatendimento na instância usando a tabela Fontes de dados.

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 versões mais recentes para conexões do BigQuery, o Looker 26.8 ou versões mais recentes para conexões do Snowflake ou o Looker 26.14 ou versões mais recentes para se conectar a tabelas de banco de dados com a tela de modelagem visual.
• 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 BigQuery que usam autenticação com OAuth, os usuários precisam ter permissão para visualizar tabelas no esquema de rascunho para ver os dados enviados. Essa configuração é a mesma necessária para que os usuários usem tabelas derivadas permanentes (PDTs) com uma conexão OAuth.
• 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 que um usuário crie análises detalhadas de autoatendimento com arquivos enviados, a conta de usuário do Looker precisa ter a permissão upload_data. Para usuários que estão criando análises detalhadas de autoatendimento com base em tabelas de banco de dados, a conta de usuário precisa ter a permissão create_self_service_from_table.

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.

Como ativar conexões com tabelas de banco de dados

Para permitir que os usuários se conectem diretamente às tabelas de banco de dados e criem modelos usando a tela de modelagem visual, siga 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, selecione a guia Tabelas de banco de dados.
3. Ative a opção Permitir a conexão com tabelas de banco de dados.

Como ativar uploads de arquivos e importações do Google Planilhas

Antes que os usuários possam fazer upload de arquivos ou importar planilhas Google para criar análises detalhadas de autoatendimento, um administrador do Looker precisa configurar o recurso na guia Uploads e importações seguindo estas etapas:

1. Na seção Geral do menu Administrador do Looker, selecione a página de administrador Análises detalhadas de autoatendimento e abra a guia Uploads e importações.
2. Se você quiser permitir que os usuários escolham entre várias conexões para fazer upload de dados, ative a opção Governança avançada de conexões. Consulte a seção Governança avançada de conexões para mais informações.
3. Configure uma ou mais conexões para uploads por autoatendimento:
   • Se a opção Conexão padrão única estiver ativada: no menu suspenso Conexão padrão, selecione a conexão 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.
   • Se a Governança de conexão avançada estiver ativada: na tabela Conexões, encontre a conexão ou as conexões que você quer usar para uploads por conta própria e ative a opção Ativação do upload de dados para cada conexão que vai aceitar uploads de dados. Quando um usuário cria uma Análise independente, o Looker permite que ele escolha em uma lista de conexões ativadas a que tem acesso e salve os dados no banco de dados especificado.

4. Clique no botão Testar para verificar a configuração da conexão:

   • Se a opção Conexão única padrão estiver ativada, clique no botão Testar ao lado da chave Uploads de dados para verificar se a conexão padrão é válida e se está ativada para tabelas derivadas permanentes (PDTs). Consulte a seção Antes de começar para ver os requisitos de conexão.
   • Se a governança de conexão avançada estiver ativada, clique no botão Testar ao lado de cada conexão ativada na tabela Conexões.

   Se o teste falhar, não será possível ativar os uploads de dados para essa conexão. Acesse a página de administrador Conexões para resolver problemas de conexão.

5. Se os testes forem aprovados, ative a opção Uploads de dados para habilitar o recurso de análises detalhadas de autoatendimento.

6. Se você quiser que sua instância do Looker ofereça suporte ao upload de dados do Google Planilhas, faça o seguinte:

   • 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.
   • Teste e ative os uploads do Google Planilhas:
     • Se a opção Conexão padrão única estiver ativada: clique no botão Testar ao lado da chave Importação de dados das Planilhas Google para testar a conexão dos uploads das Planilhas Google. Se o teste for aprovado, ative a opção Importação de dados do Google Planilhas.
     • Se a Governança de conexão avançada estiver ativada: clique no botão Testar para Importações do Google Planilhas na tabela Conexões de cada conexão que você quer ativar para uploads do Google Planilhas. Se o teste de uma conexão for aprovado, ative a opção Importações do Google Planilhas para ela. As opções Uploads de dados e Importações do Google Planilhas precisam estar ativadas para que uma conexão faça 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, selecione a guia Uploads e importações e, 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 opção Uploads de dados para verificar a conexão, além da configuração do Google Sheets.

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

Governança de conexão avançada

Por padrão, as análises detalhadas de autoatendimento são salvas em uma única conexão de banco de dados padrão especificada por um administrador do Looker. No entanto, se você ativar a opção Governança de conexão avançada na página de administrador Análises independentes, poderá configurar sua instância com várias conexões de banco de dados para armazenar dados de Análises independentes. Em Governança avançada de conexão, apenas os usuários com permissão em uma conexão permitida podem selecionar essa conexão para armazenar e consultar os dados enviados.

Como ativar várias conexões

Quando a governança avançada de conexões está ativada, a página de administrador Análises detalhadas de autoatendimento mostra uma tabela Conexões com todas as conexões de banco de dados na sua instância que atendem aos requisitos para análises detalhadas de autoatendimento. Nessa tabela, um administrador do Looker pode realizar as seguintes ações para cada conexão:

• Ative ou desative fluxos de upload específicos usando os botões na coluna Ativação do upload de dados (para uploads de arquivos) e na coluna Importações do Google Planilhas (para uploads do Google Planilhas).
• Para testar a validade da conexão e o status da tabela derivada persistente (PDT), clique no botão Testar na coluna Ativação do upload de dados e teste a conexão para configuração de uploads do Google Sheets.

Seleção de conexão durante o upload

Quando um usuário inicia um upload de dados usando a guia Fazer upload do local ou Importar da nuvem na caixa de diálogo Criar fonte de dados, a primeira etapa é selecionar uma conexão. Os usuários podem selecionar uma opção em uma lista suspensa de conexões permitidas. O Looker filtra essa lista para que um usuário veja apenas as conexões configuradas para serem usadas por modelos em que ele tem a permissão upload_data. O usuário não pode fazer upload de dados para nenhuma outra conexão.

Permissões de usuário e acesso à conexão

Em Governança avançada de conexões, o acesso contínuo aos uploads de dados por conta própria é estritamente vinculado à conexão de banco de dados subjacente:

• Acesso contínuo aos uploads atuais: a maioria das ações do usuário em um upload de dados após a criação exige acesso contínuo à conexão subjacente. Se o acesso de um usuário a uma conexão de banco de dados for revogado, ele não poderá mais visualizar, consultar, editar ou compartilhar as análises detalhadas de autoatendimento que usam essa conexão, mesmo que tenha feito o upload dos dados originalmente. A análise detalhada independente vai continuar funcionando para outros usuários que ainda têm acesso à conexão.
• Acesso a consultas: para continuar tendo acesso a consultas em uma Análise independente, o usuário precisa ter a permissão access_data em pelo menos um modelo LookML configurado para usar a conexão de banco de dados subjacente para esse upload.
• Compartilhamento de Análises independentes: os usuários só podem compartilhar uma Análise independente com outros usuários ou grupos que tenham a permissão access_data em um modelo LookML configurado para usar a conexão de banco de dados subjacente para esse upload.

Permissões de administrador

Os administradores do Looker (usuários designados com a função de administrador do Looker) têm a permissão upload_data em todos os modelos da instância. Os administradores podem ver quais fontes de dados existem em uma instância do Looker, mas, para acessar ou editar uma Análise independente, o administrador precisa receber um papel com acesso a esse modelo específico de autoatendimento.

Desativar a governança de conexão avançada

Se você decidir desativar a governança de conexão avançada em uma instância em que ela estava ativada, saiba das seguintes implicações:

• Autorização flexível: o modelo de autorização se torna mais permissivo. Como a governança no nível da conexão não é mais aplicada, os uploads de dados de autoatendimento podem ser compartilhados com qualquer usuário na instância.
• Acesso a consultas: os usuários poderão continuar consultando os uploads de dados de autoatendimento a que tinham acesso antes da desativação da governança avançada de conexões.
• Mudanças de função: os controles da governança de conexão são desativados, o que significa que as mudanças futuras de função ou permissão não vão restringir o acesso aos uploads de dados de autoatendimento atuais.
• Requisito de conexão padrão: quando a Governança avançada de conexão está desativada, os usuários só podem fazer upload de dados para a única conexão selecionada no menu suspenso Conexão padrão. Se a instância usou apenas uploads de autoatendimento enquanto a Governança de conexão avançada estava ativada, talvez uma conexão padrão ainda não tenha sido selecionada. Um administrador do Looker precisa selecionar e testar uma conexão padrão ao reverter para manter os uploads de autoatendimento operacionais.

Visualizar as fontes 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á selecionar a guia Histórico de auditoria na página de administração Análises detalhadas de autoatendimento para conferir a tabela Fontes de dados, que lista as Análises detalhadas de autoatendimento criadas pelos usuários na instância.

A tabela Fontes de dados mostra as seguintes informações sobre as fontes de dados de autoatendimento na sua instância:

• O nome da Análise independente, que também é um hiperlink que abre a Análise independente
• O proprietário da fonte de dados
• A data de criação da fonte de dados
• Um botão Excluir que permite aos administradores do Looker excluir a fonte de dados e a Análise independente associada.

Os administradores do Looker podem abrir qualquer Análise independente na instância usando os links na tabela Fontes 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 uma fonte de dados

O proprietário de uma fonte de dados pode remover a fonte de dados da página Editar Análise independente. Além disso, um administrador do Looker pode remover uma fonte de dados da página de administração 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. Selecione a guia Histórico de auditoria.
3. Na tabela Fontes de dados, clique no botão Excluir da fonte que você quer remover.
4. Clique em Copiar na caixa de diálogo de confirmação.