Esta página aborda os seguintes tópicos sobre o conector do Looker no Looker Studio:
- Configurações necessárias para cada tipo de instância do Looker
- Limites do conector do Looker
- Recursos do Looker Studio parcialmente compatíveis ou não compatíveis
- Orientações para solução de problemas
- Como informar um problema à equipe de suporte
Requisitos da instância do Looker
Para configurar uma fonte de dados do Looker usando o conector do Looker no Looker Studio, primeiro verifique se a instância do Looker atende aos seguintes requisitos:
- A instância precisa ser hospedada pelo Looker. O conector do Looker Studio não está disponível para instâncias do Looker hospedadas pelo cliente.
- O conector de BI do Looker Studio precisa estar ativado na seção Plataforma do painel Administrador da instância do Looker.
- As instâncias do Looker (original) com a configuração Ativar lista de permissões de IP habilitada podem precisar de configuração adicional. Entre em contato com o suporte para receber ajuda.
As instâncias do Looker (original) precisam atender aos seguintes requisitos de versão:
Provedor de hospedagem Versão mínima do Looker AWS, Azure 23.4 Google Cloud 22,16 O conector do Looker pode se conectar a uma instância do Looker (Google Cloud Core) com IP particular (acesso a serviços particulares) que está na mesma rede do Looker Studio no Looker Studio Pro ou nos relatórios do Looker usando o ID da instância do Looker. Para mais informações, consulte a página de documentação Como se conectar a uma instância de IP particular nos relatórios do Looker ou do Looker Studio Pro.
O conector do Looker, quando usado com o Looker Studio Pro ou relatórios do Looker, não pode se conectar a uma instância do Looker (Google Cloud Core) que esteja dentro de um perímetro do VPC Service Controls.
Algumas tarefas realizadas em relatórios criados com o conector do Looker exigem outras permissões, que são concedidas no Looker. Para mais informações, consulte Visão geral das permissões do conector do Looker.
Limites do conector do Looker
O conector do Looker tem as seguintes limitações, que podem restringir os tipos de instâncias e modelos do Looker a que você pode se conectar:
- O conector do Looker não pode se conectar a instâncias do Looker hospedadas pelo cliente.
- Modelos do Looker excepcionalmente grandes (geralmente aqueles com mais de 100 Análises) podem causar longos atrasos ou tempos limite durante o processo de criação da fonte de dados.
- O tempo limite de consulta é de 5 minutos. Os resultados de consultas executadas em fontes de dados do Looker são limitados a um máximo de 5.000 linhas.
- Os downloads de dados são limitados a 5.000 linhas.
Suporte aos recursos do Looker Studio
As fontes de dados do Looker podem não ser compatíveis ou ter compatibilidade parcial com os seguintes recursos do Looker Studio:
- Número de campos: é possível incluir até 100 dimensões e 100 métricas em uma visualização de tabela.
- Downloads, programações, alertas e exportações de dados:
- Downloads, programações, alertas e exportações de dados não são compatíveis com relatórios criados usando dados do Looker de uma instância do Looker (Google Cloud Core) que usa uma conexão de rede IP particular ou que está configurada para usar um endereço IP de nuvem privada virtual (VPC). Para saber mais sobre a rede de instâncias do Looker (Google Cloud Core), consulte a documentação Opções de rede do Looker (Google Cloud Core).
- Downloads, programações, alertas e exportações de dados não são compatíveis com relatórios criados usando dados do Looker de uma instância do Looker (original) configurada para usar uma lista de permissão de IP.
- Campos calculados: as fontes de dados criadas com o conector do Looker são compatíveis com algumas funções do Looker Studio para campos calculados. Essas funções só podem ser aplicadas a dimensões.
Funções compatíveis com campos calculados
Nome Tipo Descrição Sintaxe ABS
Aritmética Retorna o valor absoluto de um número. Saiba mais. ABS(X)
ACOS
Aritmética Retorna o inverso do cosseno de X. Saiba mais. ACOS(X)
ASIN
Aritmética Retorna o inverso do seno de X. Saiba mais. ASIN(X)
ATAN
Aritmética Retorna o inverso da tangente de X. Saiba mais. ATAN(X)
AVG
Agregação Retorna a média de todos os valores de X. Saiba mais. AVG(X)
CASE (Simple)
Condicional Compara input_expression
comexpression_to_match
de cada cláusula WHEN sucessiva e retorna o primeiroresult
em que essa comparação retornatrue
. Saiba mais.CASE input_expression WHEN expression_to_match THEN result [WHEN expression_to_match THEN result] [...] [ELSE result] END
CASE
Condicional Avalia a condition
de cada cláusula WHEN sucessiva e retorna o primeiroresult
em que acondition
é verdadeira. As cláusulas WHEN e ELSE restantes não são avaliadas. Se todas as condições forem falsas ou NULL, retornaráelse_result
se presente; se não estiver presente, retornaráNULL
. Saiba mais.CASE WHEN condition THEN result [WHEN condition THEN result] [...] [ELSE else_result] END
CAST
Diversos Transmita o campo ou a expressão para TYPE. Não são permitidos campos agregados em CAST. TYPE
pode serNUMBER
,TEXT
ouDATETIME
. Saiba mais.CAST(field_expression AS TYPE)
CEIL
Aritmética Retorna o número inteiro maior que X mais próximo. Por exemplo, se o valor de X for v, CEIL(X)
será maior ou igual a v. Saiba mais.CEIL(X)
COALESCE
Condicional Retorna o primeiro valor não ausente encontrado em uma lista de campos. Saiba mais. COALESCE(field_expression[,field_expression, ...])
CONCAT
Texto Retorna um texto que é a concatenação de X e Y. Saiba mais. CONCAT(X, Y)
CONTAINS_TEXT
Texto Retorna "true" se X contiver texto. Caso contrário, retorna "false". Diferencia maiúsculas de minúsculas. Saiba mais. CONTAINS_TEXT(X, text)
COS
Aritmética Retorna o cosseno de X. Saiba mais. COS(X)
COUNT_DISTINCT
Agregação Retorna o número de valores únicos de X. Saiba mais. COUNT_DISTINCT(X)
CURRENT_DATE
Data Retorna a data atual do fuso horário padrão. Saiba mais. CURRENT_DATE()
CURRENT_DATETIME
Data Retorna a data e a hora atuais de acordo com o fuso horário padrão. Saiba mais. CURRENT_DATETIME()
DATE
Data Produz um campo ou valor Date
com base em números ou em uma expressão ou campoDate & Time
. Saiba mais.DATE(year, month, day)
DATE_DIFF
Data Retorna a diferença em dias entre X e Y (X - Y). Saiba mais. DATE_DIFF(X, Y)
DATE_FROM_UNIX_DATE
Data Interpreta um número inteiro como o número de dias desde 01-01-1970. Saiba mais. DATE_FROM_UNIX_DATE(integer)
DATETIME
Data Produz um campo ou valor "Data e hora" com base em números. Saiba mais. DATETIME(year, month, day, hour, minute, second)
DATETIME_ADD
Data Adiciona um intervalo de tempo especificado a uma data. Os valores part
aceitos incluemSECOND
,MINUTE
,HOUR
,DAY
,MONTH
,YEAR
. Saiba mais.DATETIME_ADD(datetime_expression, INTERVAL integer part)
DATETIME_DIFF
Data Retorna o número de limites de intervalo entre duas datas. Os valores part
aceitos incluemSECOND
,MINUTE
,HOUR
,DAY
,MONTH
,YEAR
. Saiba mais.DATETIME_DIFF(date_expression, date_expression, part)
DATETIME_SUB
Data Subtrai um intervalo de tempo especificado de uma data. Os valores part
aceitos incluemSECOND
,MINUTE
,HOUR
,DAY
,MONTH
,YEAR
. Saiba mais.DATETIME_SUB(datetime_expression, INTERVAL integer part)
DATETIME_TRUNC
Data Trunca uma data com a granularidade especificada. Os valores part
aceitos incluemSECOND
,MINUTE
,HOUR
,DAY
,MONTH
,YEAR
. Saiba mais.DATETIME_TRUNC(date_expression, part)
DAY
Data Retorna o dia de uma data ou data e hora. Saiba mais. Day(date_expression)
EXTRACT
Data Retorna parte de uma data ou data e hora. Os valores part
aceitos incluemDAY
,MONTH
eYEAR
. Saiba mais.EXTRACT(part FROM date_expression)
FLOOR
Aritmética Retorna o número inteiro mais próximo menor que X. Por exemplo, se o valor X for v, FLOOR(X)
será igual ou menor que v. Saiba mais.FLOOR(X)
HOUR
Data Retorna a hora de uma data e hora. Saiba mais. HOUR(datetime_expression)
IF
Condicional Se condition
for verdadeiro, retornarátrue_result
, caso contrário, retornaráfalse_result
.false_result
não será avaliado secondition
for verdadeiro.true_result
não será avaliado secondition
for falso ou NULL. Saiba mais.IF(condition, true_result, false_result)
IFNULL
Condicional Retorna um resultado se a entrada for nula. Caso contrário, retorna a entrada. Saiba mais. IFNULL(input_expression, null_result)
LEFT_TEXT
Texto Retorna uma quantidade de caracteres do início de X. O número de caracteres é especificado por length. Saiba mais. LEFT_TEXT(X, length)
LENGTH
Texto Retorna o número de caracteres em X. Saiba mais. LENGTH(X)
LOG
Aritmética Retorna o logaritmo de base 2 de X. Saiba mais. LOG(X)
LOG10
Aritmética Retorna o logaritmo de base 10 de X. Saiba mais. LOG10(X)
LOWER
Texto Converte X em letras minúsculas. Saiba mais. LOWER(X)
MAX
Agregação Retorna o valor máximo de X. Saiba mais. MAX(X)
MEDIAN
Agregação Retorna a mediana de todos os valores de X. Saiba mais. MEDIAN(X)
MIN
Agregação Retorna o valor mínimo de X. Saiba mais. MIN(X)
MINUTE
Data Retorna o componente de minutos de uma data/hora especificada. Saiba mais. MINUTE(datetime_expression)
MONTH
Data Retorna o mês de um valor Date & Time
. Saiba mais.MONTH(date_expression)
NULLIF
Condicional Retorna NULL
se a entrada corresponder a uma expressão. Caso contrário, retorna a entrada. Saiba mais.NULLIF(input_expression, expression_to_match)
POWER
Aritmética Retorna o resultado de elevar X à potência Y. Saiba mais. POWER(X, Y)
REPLACE
Texto Retorna uma cópia de X com todas as ocorrências de Y em X substituídas por Z. Saiba mais. REPLACE(X, Y, Z)
RIGHT_TEXT
Texto Retorna uma quantidade de caracteres do fim de X. O número de caracteres é especificado por length. Saiba mais. RIGHT_TEXT(X, length)
ROUND
Aritmética Retorna X
arredondado paraY
dígitos de precisão. Saiba mais.ROUND(X, Y)
SECOND
Data Retorna o componente de segundos de uma data/hora especificada. Saiba mais. SECOND(datetime_expression)
SIN
Aritmética Retorna o seno de X. Saiba mais. SIN(X)
SQRT
Aritmética Retorna a raiz quadrada de X. X não pode ser negativo. Saiba mais. SQRT(X)
SUBSTR
Texto Retorna um texto que é uma substring de X. A substring começa no índice inicial e tem comprimento caracteres. Saiba mais. SUBSTR(X, start index, length)
SUM
Agregação Retorna a soma de todos os valores de X. Saiba mais. SUM(X)
TAN
Aritmética Retorna a tangente de X. Saiba mais. TAN(X)
TODAY
Data Retorna a data atual do fuso horário padrão. Saiba mais. TODAY()
UNIX_DATE
Data Retorna o número de dias desde 1970-01-01. Saiba mais. UNIX_DATE(date_expression)
UPPER
Texto Converte X em letras maiúsculas. Saiba mais. UPPER(X)
YEAR
Data Retorna o ano de uma determinada data. Saiba mais. YEAR(Date)
Solução de problemas
Problema | Resolução |
---|---|
O Looker Studio mostra a seguinte mensagem de erro: Autorização necessária |
Autorize o conector do Looker a vincular as contas necessárias, conforme descrito na documentação Acessar e interagir com dados do Looker no Looker Studio. |
O Looker Studio mostra um erro HTTP 400 |
|
O Looker Studio mostra a seguinte mensagem de erro: Não é possível se conectar a uma instância do Looker |
|
O Looker Studio mostra a seguinte mensagem de erro: Nenhuma análise encontrada |
Selecione outro modelo do Looker. |
Os gráficos de relatório atuais não funcionam |
|
O Looker Studio mostra um erro ao tentar buscar dados da Análise | Entre em contato com o suporte ou acesse a Comunidade do Looker Studio. |
Os gráficos não são renderizados em um relatório baixado | Peça ao administrador do Looker para conceder a você permissões download_with_limit ou download_without_limit nos modelos LookML subjacentes da fonte de dados (ou seja, da Análise do Looker). Essa permissão está disponível apenas para usuários do Looker Studio Pro. |
Os gráficos não são renderizados no arquivo exportado | Peça ao administrador do Looker para conceder a você permissões download_with_limit ou download_without_limit nos modelos LookML subjacentes da fonte de dados (ou seja, da Análise do Looker). Essa permissão está disponível apenas para usuários do Looker Studio Pro. |
Os gráficos não são renderizados na entrega de relatórios programados | Se você for o proprietário da entrega do relatório, não terá permissões suficientes do Looker para acessar pelo menos um dos modelos referenciados no relatório entregue. Peça ao administrador do Looker para conceder a você permissões schedule_look_emails nos modelos da LookML da fonte de dados. Essa permissão está disponível apenas para usuários do Looker Studio Pro.Se você for um destinatário de um relatório e receber essa mensagem, notifique o remetente. |
O Looker Studio mostra o seguinte erro ao baixar um relatório: Devido à falta de permissões, alguns gráficos que usam modelos do Looker não serão baixados. Peça ao administrador do Looker para conceder as permissões. |
Peça ao administrador do Looker para conceder a você permissões download_with_limit ou download_without_limit nos modelos da LookML do relatório. Essa permissão está disponível apenas para usuários do Looker Studio Pro. |
O Looker Studio mostra o seguinte erro ao programar a entrega de um relatório: Devido à falta de permissões, alguns gráficos que usam dados do Looker não vão aparecer no seu relatório programado. Peça ao administrador do Looker para conceder as permissões. |
Peça ao administrador do Looker para conceder a você permissões schedule_look_emails nos modelos LookML subjacentes do relatório. Essa permissão está disponível apenas para usuários do Looker Studio Pro. |
O Looker Studio mostra o seguinte erro na lista de programações de relatórios: Alguns dados do Looker podem estar ausentes nas entregas de relatórios. Peça ao admin do Looker que conceda permissões para enviar todos os dados neste relatório. |
Peça ao administrador do Looker para conceder a você permissões schedule_look_emails nos modelos LookML subjacentes do relatório. Essa permissão está disponível apenas para usuários do Looker Studio Pro. |
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 do Looker Studio.