O Looker é uma plataforma corporativa de Business Intelligence, aplicativos de dados e análise incorporada que ajuda a explorar e compartilhar insights em tempo real. Com o conector, é possível acessar os dados do Looker no Looker Studio adicionando uma Análise como fonte de dados em um relatório da ferramenta.
Para que os dados do Looker em um relatório do Looker Studio possam ser acessados, um usuário com função de administrador precisa ativar o conector do Looker Studio na página Conectores de BI no painel Administrador da instância do Looker. A ativação desse conector também permite monitorar o uso do conector do Looker na atividade do sistema.
Depois da ativação do conector na instância do Looker, os usuários do Looker Studio com pelo menos as permissões explore do Looker poderão usar o conector no Looker Studio para criar uma fonte de dados com base na Análise dessa instância. Os usuários do Looker Studio que têm pelo menos as permissões access_data e clear_cache_refresh do Looker poderão acessar os dados em um relatório do Looker Studio.
Consulte a página de documentação Termos e conceitos compartilhados entre o Looker e o Looker Studio para mais informações sobre as diferenças, semelhanças e nuances dos termos e conceitos nas duas ferramentas.
Usar o conector do Looker
explore.Você pode conectar uma Análise do Looker a uma nova fonte de dados. Siga estas etapas para criar uma fonte de dados que se conecta a uma Análise em uma instância do Looker usando o conector no Looker Studio:
- Conecte-se a uma instância do Looker e vincule suas contas do Looker e do Google.
- Selecione um modelo e uma Análise.
Conectar-se a uma instância do Looker
Para se conectar a uma instância do Looker, siga estas etapas:
- Clique em Adicionar dados na barra de ferramentas de um relatório.
- Na página Adicionar dados ao relatório, clique na guia Conectar aos dados.
- Em Conectores do Google, clique no conector do Looker.
- Insira o URL da instância do Looker que será a fonte dos seus dados. Esse é o URL que você usa para acessar o Looker no navegador.
- Quando o URL pertence a uma instância do Looker que não atende aos pré-requisitos, o Looker Studio mostra a mensagem "O URL do Looker é inválido ou não é compatível com a vinculação da conta. Use outro URL do Looker."
- Se você já tiver conectado uma instância do Looker como fonte de dados, o nome dela vai aparecer em Instâncias salvas do Looker. Se quiser, clique no nome de uma instância e avance até a seção que mostra como selecionar um modelo.
- Clique em Conectar conta do Looker.
- No menu pop-up de autorização, clique em Concordar e continuar para vincular as credenciais da sua Conta do Google às da conta do Looker. É possível fazer essa vinculação para cada instância do Looker conectada ao Looker Studio.
- No menu pop-up da instância do Looker, clique em AUTENTICAR.
Você já pode selecionar um par de modelo-Análise para conexão como uma fonte de dados do seu relatório.
Selecionar um modelo e uma Análise
Depois que você se conectar a uma instância do Looker, a lista de modelos associados a ela vai ser usada para preencher automaticamente um novo painel na janela Adicionar dados ao relatório, que se chama Modelos. Agora você pode selecionar um par de modelo-Análise para conexão como uma fonte de dados do seu relatório.
Para selecionar um modelo, siga estas etapas:
- No painel Modelos, role a lista de modelos preenchidos previamente ou clique no ícone de lupa
para abrir um campo de pesquisa em que é possível inserir o nome de um modelo específico. Passe o cursor sobre um dos itens para conferir como o nome do arquivo modelo aparece no projeto do Looker.
- Clique no nome para selecionar o modelo. Um novo painel vai ser preenchido com a lista de Análises associadas a ele.
- Para selecionar uma Análise, role a lista ou clique no ícone de lupa
exploreé declarado no arquivo modelo. - Para selecionar a Análise, clique no nome dela.
- Clique em Adicionar. Um menu pop-up aparece com informações sobre a Análise e o modelo selecionados da fonte de dados.
- Para confirmar sua seleção para essa fonte de dados, clique em ADICIONAR AO RELATÓRIO. Você também pode marcar a caixa Não mostrar novamente para impedir que esse menu pop-up apareça quando você editar essa fonte de dados.
para abrir um campo de pesquisa em que é possível inserir o nome de um modelo específico. Passe o cursor sobre um dos itens para conferir como o Pode levar alguns minutos para que a nova fonte seja adicionada ao relatório. As fontes de dados do Looker têm o formato nome da Análise do Looker - nome do modelo do Looker.
Acessar e editar a configuração da fonte de dados
explore.A configuração contém informações sobre quem pode acessar ou editar a fonte de dados, com que frequência os dados são atualizados, se os layouts da comunidade podem ser acessados e se os campos podem ser editados. Você também pode conferir e editar os campos que aparecem no painel Dados.
Para acessar a janela de configuração da fonte de dados, siga estas etapas:
1. Edite o relatório.
2. Abra a lista de fontes de dados no menu Recurso ou no painel Dados:
- No menu Recurso, selecione Gerenciar fontes de dados adicionadas. Clique no ícone
ao lado do nome da fonte de dados para abrir uma nova janela que mostra a configuração da fonte de dados do Looker.
- No painel Dados, passe o cursor sobre o logotipo do Looker
da fonte de dados que preferir. Clique no ícone de edição
para abrir uma sobreposição ajustável que mostra a configuração da fonte de dados do Looker. Para que a janela fique no tamanho original, clique na seta para a esquerda
ao lado do nome da fonte na parte de cima da sobreposição.
ao lado do nome da fonte de dados para abrir uma nova janela que mostra a configuração da fonte de dados do Looker.
da fonte de dados que preferir. Clique no ícone de edição 
ao lado do nome da fonte na parte de cima da sobreposição.3. Selecione Fechar na parte superior direita da janela para retornar ao relatório.
Saiba como editar uma fonte de dados.
Adicionar mais Análises do Looker
Quando a fonte de dados do relatório é conectada ao Looker, você pode adicionar mais Análises a ele como outras fontes de dados (mesmo que a Análise não pertença ao mesmo modelo do Looker que as outras fontes).
Para adicionar uma nova Análise do Looker ao relatório, siga as instruções na seção Usar o conector do Looker desta página.
- Para se conectar a outra instância do Looker, insira um URL diferente no painel Conectar a uma instância do Looker ou selecione outra instância na lista de instâncias salvas. Se a instância estiver associada a outra conta do Looker, você vai precisar autorizar a vinculação das suas contas do Looker e do Google.
- Para se conectar a um novo par de modelo-Análise de uma instância do Looker que você já usou para se conectar como uma fonte de dados, primeiro selecione o nome em Instâncias salvas e depois um novo modelo e Análise.
- Para se conectar a uma fonte de dados modelo-Análise, acesse a guia Minhas fontes de dados da página Adicionar dados ao relatório. As fontes de dados do Looker têm o formato nome da Análise do Looker - nome do modelo do Looker. Selecione uma nova fonte e clique em Adicionar.
Depois de adicionar a fonte de dados, atualize o relatório. A nova fonte vai aparecer no painel Dados. Clique no nome da fonte para expandi-la e arraste os campos para o relatório conforme necessário.
Adicionar campos e filtros aos gráficos nos relatórios
Quando você atualiza os dados no Looker Studio, eles também são atualizados no Looker como se você tivesse clicado em Limpar o cache e atualizar na Análise do Looker.
Os campos da sua fonte de dados do Looker são mostrados em um formato diferente. O seletor de campo assume um formato mais fácil de usar para a Análise e visualizações, dimensões, grupos de dimensão, medições (chamadas de métricas no Looker Studio) e agrupamentos. No Looker Studio, os campos aparecem no relatório no formato Looker-view-name field-name. O seletor de campo do Looker Studio lista as dimensões da Análise seguidas pelas métricas.
Se o LookML subjacente da Análise especificar rótulos para as visualizações (em uma Análise, um campo ou um agrupamento) ou para um grupo de dimensão, esses rótulos vão aparecer no relatório do Looker Studio.
Por exemplo, no Looker, uma Análise chamada Voos tem as visualizações Transportadoras, Destino, Voos e Origem. A visualização Transportadoras tem as dimensões Nome da transportadora, Código e Nome. Nenhum rótulo de visualização foi especificado:
Na fonte de dados correspondente do Looker chamada Voos – FAA, o Looker Studio mostra essas dimensões como Transportadoras Nome da transportadora, Código das transportadoras e Nome das transportadoras:
Saiba como editar campos nos relatórios.
Campos de detalhamento e links
Os campos de detalhamento e os links definidos com os parâmetros drill_fields e link do LookML estão disponíveis para os leitores de relatórios do Looker Studio no menu Detalhamento nos gráficos de tabela do Looker Studio.
Consulte a página de documentação Veja mais detalhes dos seus dados para saber como usar o detalhamento no Looker Studio.
Informações sobre o detalhamento no Looker Studio
- Os detalhamentos (campos de detalhamento e links) são compatíveis apenas com gráficos de tabela.
- Os detalhamentos (campos de detalhamento e links) são compatíveis somente com dimensões e grupos de dimensões do Looker.
- Os detalhamentos (campos de detalhamento e links) importados do Looker são somente leitura. Para fazer mudanças nas ações de detalhamento importadas, edite o modelo relacionado do LookML no Looker.
Filtros do LookML
Além dos filtros que os usuários podem aplicar nos relatórios do Looker Studio com base nos campos da fonte de dados do Looker, o Looker Studio indica quais campos foram definidos como filtros ou campos somente para filtros no LookML da fonte de dados do Looker.
Nos relatórios que usam uma fonte de dados do Looker, os filtros definidos com parâmetros do LookML são referenciados no Looker Studio, conforme descrito na tabela a seguir:
| Definição do LookML | Local do Looker Studio | Referência do Looker Studio |
|---|---|---|
conditionally_filter |
Editor de relatórios: Propriedades > Configuração > seção Filtro | Obrigatório sob certas condições |
| Gerenciador de filtros: coluna Tipo | Filtrar com condições | |
| Editor da fonte de dados: seção Filtros da fonte de dados | Filtrar com condições | |
always_filter |
Editor de relatórios: Propriedades > Configuração > seção Filtro | Sempre obrigatório |
| Gerenciador de filtros: coluna Tipo | Sempre filtrar | |
| Editor da fonte de dados: seção Filtros da fonte de dados | Sempre filtrar | |
parameter,filter |
Editor de relatórios: Propriedades > Configuração > seção Filtro agrupada com outros filtros no nível do gráfico em uso | |
| Editor de relatórios: Dados > nome da Análise > grupo de campos Somente campos para filtros | ||
| Editor da fonte de dados: seção Campos somente para filtros | ||
Se os parâmetros sql_always_where, sql_always_having ou access_filter estiverem incluídos no modelo LookML, eles serão aplicados à fonte de dados, mas não ficarão visíveis no Looker Studio.
Mais informações sobre filtros que são obrigatórios sempre ou sob certas condições
- Os filtros importados do Looker que são obrigatórios sempre ou sob certas condições não podem ser removidos de um gráfico.
- Os editores de relatórios podem fazer mudanças na condição ou no valor de uma cláusula de filtro, mas não no campo de filtro no Looker Studio. Para fazer alterações nos filtros do LookML importados, edite o modelo do LookML no Looker.
- O Looker Studio não oferece suporte a todas as expressões de filtro do Looker. Se um modelo do LookML definir um parâmetro
conditionally_filteroualways_filterque usa uma expressão de filtro não compatível, o Looker Studio vai mostrar a condição Nulo. Os editores de relatórios precisam atualizar manualmente as condições e os valores de filtro. As seguintes expressões de filtro são compatíveis:
| Tipo de expressão de filtro | Definição do LookML | Condição de filtro do Looker Studio | Valor de exemplo do Looker Studio |
|---|---|---|---|
| String | FOO |
Igual a (=) | FOO |
| String | EMPTY |
Igual a (=) | |
| String | NULL |
Nulo | |
| Data e hora | YYYY-MM-DD ou YYYY/MM/DD |
Igual a (=) |
2004-01-01 |
| Booleano | yes ou Yes |
Verdadeiro |
|
| Booleano | no ou No |
Falso |
|
| Booleano | TRUE |
Verdadeiro |
|
| Booleano | FALSE |
Falso |
|
| Número | 5 |
Igual a (=) |
5 |
| Número | NULL |
Nulo |
|
Mais informações sobre os campos somente para filtros
parameter cria um campo somente para filtros que pode ser usado para filtrar análises, Looks e painéis, mas que não pode ser adicionado a um conjunto de resultados. Os parâmetros do Looker Studio coletam e transmitem valores fornecidos pelo usuário para conectores e campos calculados.- Para fazer mudanças em campos importados somente para filtros, como especificar os valores que um usuário pode inserir, edite o modelo relacionado do LookML no Looker.
- Ao editar um filtro que usa um campo somente para filtros, os editores de relatórios precisam usar um operador AND e não podem incluir o mesmo campo somente para filtros. Os valores disponíveis são definidos no LookML da fonte de dados do Looker.
- O Looker Studio não é compatível com todos os tipos e valores de campos somente para filtros. Se um modelo do LookML definir parâmetros
parameteroufilterque usam um tipo sem suporte, o Looker Studio vai mostrar uma condição de filtro Nulo. Os editores de relatórios precisam atualizar manualmente as condições e os valores de filtro. Os seguintes tipos de campos somente para filtros são compatíveis:
| Parâmetro do LookML | Tipo de campo | Condição de filtro do Looker Studio | Valores de entrada compatíveis |
|---|---|---|---|
parameter |
string |
Todos | Qualquer valor de entrada do usuário ou somente valores predefinidos |
unquoted |
Todos | Qualquer valor de entrada do usuário ou somente valores predefinidos | |
date_time |
Igual a (=) | Qualquer data de entrada do usuário nos formatos AAAA-MM-DD ou AAAA/MM/DD | |
yesno |
Igual a (=) | Valores booleanos predefinidos | |
filter |
string |
Todos | Qualquer valor de entrada do usuário |
number |
Todos | Qualquer valor de entrada do usuário em formato numérico | |
yesno |
Igual a (=) | Valores booleanos predefinidos | |
date_time |
Igual a (=) | Qualquer data de entrada do usuário nos formatos AAAA-MM-DD ou AAAA/MM/DD | |
date |
Igual a (=) | Qualquer data de entrada do usuário nos formatos AAAA-MM-DD ou AAAA/MM/DD |
Controlar o acesso aos dados do Looker no Looker Studio
As fontes do Looker usam como padrão as credenciais de dados de leitor. Essa configuração não pode ser alterada.
Os leitores precisam fornecer as próprias credenciais para acessar o conjunto de dados do Looker. Quando um leitor fornece essas credenciais, a Conta do Google dele é vinculada à conta do Looker associada à instância do Looker conectada. Além disso, a conta de usuário do Looker precisa ter pelo menos as permissões access_data e clear_cache_refresh para os modelos de base da Análise conectada do Looker. Os administradores do Looker gerenciam as permissões dos usuários.
Os administradores de TI do Looker Studio também podem gerenciar a forma como os usuários compartilham relatórios fora da organização.
Revogar credenciais
Se você revogar suas credenciais, a fonte de dados não vai poder se conectar aos dados do Looker. Para acessar a Análise, será necessário reconectar a fonte de dados do Looker.
Saiba como definir e revogar suas credenciais de dados.
Acessar dados do Looker em um relatório
access_data e clear_cache_refresh para o modelo de base da Análise.Para acessar dados de uma fonte do Looker criada por outro usuário, vincule sua Conta do Google à conta referente à instância do Looker a que o relatório está vinculado.
Quando a mensagem Autorização necessária aparece em um gráfico, você precisa autorizar o conector do Looker a vincular as credenciais da sua Conta do Google às da instância do Looker que é mostrada no menu pop-up de autorização. Para autorizar o conector, siga estas etapas:
- Clique no link Autorizar agora no gráfico escolhido.
- No menu pop-up que pede a autorização no Looker Studio, clique em AUTORIZAR.
- No menu pop-up de autorização do Google, clique em Permitir e continuar.
Para desvincular suas contas do Google e do Looker, acesse a página Vinculação de contas no perfil da sua Conta do Google.
Limites do conector do Looker
Ele está disponível somente para instâncias hospedadas pelo Looker que têm o conector de BI do Looker Studio ativado. As seguintes versões mínimas do Looker são obrigatórias:
- Looker 23.6: instâncias do Looker (Google Cloud Core) que usam IP público OU IP público e privado
- Looker 23.4: instâncias do Looker (original) hospedadas no Google Cloud, na AWS e no Azure
- Looker 22.16: instâncias (originais) do Looker hospedadas no Google Cloud
As funções de programação de entregas de e-mail e downloads de relatórios são desativadas em relatórios com uma conexão de fonte de dados do Looker. A opção de realizar as ações está disponível, mas os relatórios entregues e baixados não terão dados.
Os campos calculados são desativados para fontes de dados do Looker.
Modelos excepcionalmente grandes (geralmente os que têm mais de 100 Análises) podem causar longos atrasos ou tempos limite durante o processo de criação da fonte de dados.
Pode haver no máximo 20 dimensões em uma tabela, que também pode conter métricas.
O tempo limite de consulta é de cinco minutos.
A permissão download_with_limit do Looker restringe o número de linhas que um usuário pode carregar no Looker Studio.
As consultas criadas com o conector do Looker têm um limite máximo de 5.000 linhas.
Solução de problemas
| Problema | Resolução |
|---|---|
| Erro HTTP 400 no Looker Studio |
|
| Não é possível conectar uma instância do Looker |
|
| Nenhuma Análise encontrada | Selecione outro modelo do Looker. |
| Os gráficos de relatório atuais não funcionam |
|
| O Looker Studio apresenta um erro ao tentar buscar dados da Análise | Entre em contato com o suporte ou acesse a Comunidade do Looker Studio. |
Informar um problema
Informe os problemas com o conector do Looker à equipe de suporte.
Se você é cliente do Looker Studio Pro e está com problemas relacionados a recursos do Looker Studio que não sejam o conector do Looker, entre em contato com o Cloud Customer Care.
Se você estiver usando a versão gratuita do Looker Studio, poste sua dúvida ou problema na Comunidade de Ajuda do Looker Studio.