Link rápido das páginas associadas

Esta página descreve como ativar e usar a opção de link rápido Páginas associadas no menu de roda dentada Ações de exploração no Looker. A opção Páginas associadas abre o Google Sheets e inicia uma ligação do Google Sheets à análise detalhada do Looker. Em seguida, pode criar relatórios, tabelas dinâmicas ou gráficos na folha de cálculo do Google Sheets recém-criada com os campos da análise detalhada do Looker selecionada.

Antes de começar

Para usar o link rápido Páginas associadas, precisa do seguinte:

  • Uma instância do Looker que foi ativada e configurada para a funcionalidade por um administrador, conforme descrito na secção Ativar e configurar o link rápido das páginas associadas nesta página
  • Uma conta de utilizador do Looker com a autorização explore para os modelos LookML que quer associar ao Sheets
  • Uma Conta Google com o mesmo endereço de email associado à sua conta do Looker

Se o administrador do Looker tiver ativado a funcionalidade, pode iniciar uma associação entre o Google Sheets e qualquer opção Explorar à qual tenha acesso:

  1. Inicie sessão no Looker com o endereço de email associado à sua Conta Google.

  2. No Looker, navegue para a exploração que quer usar como origem de dados.

  3. Clique no ícone de roda dentada Explorar ações e selecione Folhas associadas.

  4. Quando usar esta funcionalidade pela primeira vez, é-lhe pedido que autorize o Looker a aceder à sua Conta Google. Escolha a Conta Google que quer usar. O endereço de email da Conta Google tem de corresponder ao endereço de email associado à sua conta de utilizador do Looker.

  5. Reveja as autorizações solicitadas no ecrã de consentimento e clique em Permitir.

  6. É aberto um novo separador do navegador para aceder ao Google Sheets e é apresentado um diálogo a perguntar se quer associar a sua Conta Google à conta do Looker. Clique em Associar conta.

A folha de cálculo do Google Sheets está agora associada à opção Explorar do Looker a partir da qual começou. Na folha de cálculo do Google Sheets, pode adicionar campos da funcionalidade Explorar, criar Tabelas Dinâmicas, criar gráficos e aplicar fórmulas para analisar os dados da sua funcionalidade Explorar do Looker.

Consulte a página de documentação Usar as páginas associadas para o Looker para mais informações sobre a criação de consultas nas páginas associadas.

Ativar e configurar o link rápido das páginas associadas

Para ativar o link rápido Páginas associadas no menu de engrenagem Ações de exploração, a sua instância do Looker tem de cumprir os seguintes requisitos:

Para ativar a opção Folhas associadas no menu de engrenagem Ações de exploração numa instância do Looker, um administrador tem de realizar estas tarefas gerais, que são descritas nas secções seguintes:

Ativar a API Google Sheets na Google Cloud consola

O link rápido Folhas associadas usa a API Google Sheets, pelo que esta API tem de estar ativada no mesmo projeto que vai usar para criar o cliente OAuth. A API Google Sheets pode ser ativada por um utilizador do IAM com a autorização roles/serviceusage.serviceUsageAdmin do IAM.

Siga estes passos para ativar a API Google Sheets:

  1. No Google Cloud menu de navegação da consola, aceda a APIs e serviços > Biblioteca e abra a API Google Sheets.

    Aceda à API Google Sheets

  2. Na Google Cloud consola Abrir seletor de projetos, selecione o projeto que quer usar para se ligar ao Google Sheets a partir das suas explorações do Looker. Tem de usar o mesmo Google Cloud projeto da consola durante todo o procedimento de configuração do link rápido do Connected Sheets para que a API Google Sheets seja ativada no mesmo projeto onde configura o OAuth.

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

Crie o cliente OAuth

Um utilizador do IAM com as funções necessárias tem de criar um cliente OAuth.

Pode configurar o cliente OAuth em qualquer Google Cloud projeto que quiser. No entanto, a API Google Sheets tem de estar ativada neste mesmo projeto.

Para criar o cliente e as respetivas credenciais, siga estes passos:

  1. Na Google Cloud consola, use o Google Cloud seletor de projetos da consola para abrir o mesmo projeto onde ativou a API Google Sheets.

    Aceda à Google Cloud consola

  2. Use o menu principal da Google Cloud consola para navegar para APIs e serviços > Credenciais.

  3. Na página Credenciais, clique no menu pendente Criar credenciais e, de seguida, selecione ID de cliente OAuth.

  4. No menu pendente Tipo de aplicação, selecione Aplicação Web.

  5. No campo Nome, introduza um nome para o cliente OAuth, como Looker to Connected Sheets.

  6. Na secção URIs de redirecionamento autorizados, clique no botão Adicionar URI. Adicione o seguinte URI:

    https://LOOKER_INSTANCE_URL/oauth2callback

  7. Clique no botão Adicionar URI para adicionar também o seguinte URI:

    https://LOOKER_INSTANCE_URL/external_oauth/redirect

  8. Clique em Criar.

  9. Depois de clicar em Criar, é apresentada uma janela Cliente OAuth criado. Esta janela apresenta o ID de cliente e o segredo do cliente que a consola Google Cloud criou para o seu cliente OAuth. Copie e tome nota destes valores, uma vez que são necessários quando configurar a opção de link rápido Ativar folhas ligadas.

Configurar a opção de link rápido Ativar páginas associadas

Depois de ativar a API Google Sheets na Google Cloud consola e criar o cliente OAuth na Google Cloud consola, pode ativar o link rápido Folhas associadas na sua instância do Looker seguindo estes passos:

  1. Na sua instância do Looker, selecione Conetores de BI na secção Plataforma do painel Administração.
  2. Ative o botão Google Sheets se ainda não estiver ativado.
  3. Ative o interruptor aninhado Ativar link rápido do Connected Sheets.
  4. Nos campos ID de cliente e Segredo do cliente, cole os valores que copiou da Google Cloud consola quando criou o cliente OAuth na Google Cloud consola.
  5. Clique em Guardar.

A opção Páginas associadas no menu de engrenagem Ações de exploração está agora configurada para a sua instância do Looker.

Migrar do programa de teste-piloto

Se a sua organização participou no programa piloto anterior para a funcionalidade Abrir no Sheets, a sua instância do Looker usou um cliente OAuth gerido centralmente que foi fornecido pelo Looker. Esta configuração está a ser descontinuada a favor do método mais seguro e escalável em que cada administrador do Looker configura o seu próprio cliente OAuth para a respetiva instância do Looker. Os clientes do teste-piloto existentes devem fazer a transição para esta nova configuração para garantir a funcionalidade contínua.

Para migrar para a nova versão, um administrador tem de configurar o cliente OAuth da sua organização na Google Cloud consola e, em seguida, configurar as credenciais na página de administração dos conectores de BI do Looker. Os passos são os mesmos que os da configuração inicial, que estão descritos nestas secções desta página:

Depois de um administrador concluir estes passos, a sua instância vai usar automaticamente o novo fluxo OAuth gerido pelo cliente. A funcionalidade do teste-piloto anterior e a respetiva dependência do cliente OAuth gerido pelo Looker vão deixar de estar ativas.

Resolução de problemas

  • Erro de falta de correspondência de email: se encontrar um erro durante o passo de autenticação da Google, certifique-se de que a Conta Google que está a selecionar tem exatamente o mesmo endereço de email que a sua conta de utilizador do Looker.
  • Opção"Folhas ligadas" não visível: esta opção é apresentada no menu de engrenagem Ações de exploração apenas se o administrador do Looker tiver ativado a funcionalidade nas definições dos conectores de BI. Contacte o administrador do Looker para receber assistência.
  • Google Cloud Autorizações da consola: o administrador que configura o cliente OAuth e o ecrã de consentimento tem de ter as autorizações roles/oauthconfig.editor e roles/serviceusage.serviceUsageAdmin no Google Cloud projeto.
  • Para outros problemas ou feedback durante o período de pré-visualização pública, envie um email para looker-connected-sheets-external@google.com.