O Looker pode converter dados baseados em tempo em diferentes fusos horários para facilitar a compreensão. Os usuários podem ver os resultados da consulta e criar filtros com dados baseados no horário que são convertidos para o fuso horário local. Por exemplo, um usuário em Nova York que visualiza dados criados na Califórnia não precisa subtrair manualmente três horas para filtrar ou interpretar as consultas.
O Looker converte dados baseados em tempo quando gera SQL durante uma consulta para um Look, uma Análise ou um dashboard. Os dados subjacentes não são afetados. em vez disso, os resultados são convertidos usando as configurações de fuso horário do Looker. Isso também significa que as consultas executadas com o SQL Runner não convertem dados baseados em tempo.
Várias configurações no Looker especificam como converter dados baseados em tempo:
- Fuso horário do sistema
- Fuso horário do banco de dados
- Fusos horários específicos do usuário
- Fuso horário do aplicativo
- Fuso horário da consulta
convert_tz
parâmetro do LookMLsql
parâmetro do LookML
Fuso horário do sistema
O fuso horário do sistema é o fuso para o qual o servidor que executa o Looker está configurado. O banco de dados interno do Looker, que armazena as informações disponíveis nas Análises de i__looker
e Atividade do sistema, armazena dados baseados em tempo no fuso horário do sistema.
O fuso horário do sistema não pode ser configurado pelo aplicativo Looker. Para instâncias hospedadas pelo Looker, o fuso horário do sistema é sempre definido como UTC. As instâncias hospedadas pelo cliente podem estar em um fuso horário diferente do sistema. Mudar o fuso horário do sistema não é trivial e não é recomendado. Se você precisar ajustar os carimbos de data/hora em uma i__looker
ou em uma Análise de atividades do sistema, o Looker recomenda usar cálculos de tabela para criar colunas ajustadas pelo tempo. Por exemplo, para converter de UTC para EST, você pode criar uma coluna com o cálculo de tabela add_hours(-5, ${time})
.
fuso horário do banco de dados
Ao adicionar uma conexão a um banco de dados, você define o valor do Fuso horário do banco de dados na página Configurações de conexão.
Essa configuração representa o fuso horário do seu banco de dados, que normalmente é o Tempo Universal Coordenado (UTC). Definir esse valor como qualquer coisa que não seja o fuso horário do seu banco de dados pode gerar resultados inesperados.
fusos horários específicos dos usuários
A configuração mais importante para a conversão de dados baseada em tempo é a opção Fusos horários específicos do usuário, que está na página Configurações gerais na seção Administrador do Looker.
É possível ativar ou desativar os fusos horários específicos do usuário:
- Quando ativado, cada usuário do Looker recebe um fuso horário, que especifica a aparência dos resultados da consulta.
- Quando desativado, os usuários não têm fusos horários individuais atribuídos às contas. Em vez disso, todas as consultas são executadas usando o valor Fuso horário da consulta.
Com a opção Fusos horários específicos do usuário ativada, um usuário pode definir o fuso horário na página Conta, ou os administradores do Looker podem atribuir fusos horários aos usuários na página Usuários. Se um fuso horário não estiver definido para um usuário, a conta dele vai usar a configuração de fuso horário do aplicativo do Looker.
Sempre que um usuário cria uma consulta, ela é criada no fuso horário dele. Como resultado, quando uma consulta retorna dados baseados em tempo, o Looker converte os dados do fuso horário do banco de dados para o fuso horário do usuário. Quando um usuário usa valores de filtro relacionados ao tempo em uma consulta, o Looker converte os valores do filtro para o Fuso horário do banco de dados.
Além disso, quando você ativa essa opção, o Looker mostra um menu suspenso de Fuso horário em Análises e Looks.
As opções no menu suspenso são:
- Fuso horário de cada bloco (somente painéis): todas as consultas são executadas no fuso horário em que foram salvas.
- Fuso horário do leitor: todas as consultas são executadas na configuração de fuso horário atual do usuário.
- Uma lista de cada fuso horário, que os usuários podem escolher manualmente se quiserem.
Todas as consultas usam o fuso horário em que foram criadas. Em outras palavras, se Alice criar uma consulta com o fuso horário "América/Los Angeles" e enviar para Bob, ele vai receber a consulta com o fuso horário "América/Los Angeles", mesmo que o fuso horário dele esteja definido como "América/Nova York". Da mesma forma, o detalhamento sempre usa o fuso horário usado para criar a consulta.
Sempre que uma consulta é visualizada, os usuários podem usar o menu suspenso para substituir o fuso horário, escolhendo o Fuso horário do espectador ou qualquer outro fuso horário para essa consulta ou para o conjunto de consultas do painel.
Considerações sobre fusos horários específicos dos usuários
Quando você ativa os Fusos horários específicos do usuário, os dados podem aparecer de forma diferente para usuários em fusos horários diferentes.
Por exemplo, as horas exatas que compõem o período last month
são diferentes entre os fusos horários. Assim, os usuários podem ver valores de dados diferentes se estiverem em fusos horários diferentes, mas estiverem filtrando por last month
.
fuso horário do aplicativo
A configuração Fuso horário do aplicativo pode ser definida na página Configurações gerais da seção Administrador do Looker.
O fuso horário do aplicativo é o padrão para envios de conteúdo. O fuso horário usado para envio de conteúdo não afeta os dados baseados em tempo retornados por uma consulta. afeta apenas o horário em que a entrega de dados é enviada.
Se você ativar a opção Fusos horários específicos do usuário, o Fuso horário do aplicativo será o fuso horário padrão dos usuários que não têm um valor de fuso horário definido para as contas.
fuso horário de consultas
A opção Fuso horário da consulta só aparece se você tiver desativado os Fusos horários específicos do usuário. Nesse caso, defina o valor do Fuso horário da consulta ao adicionar uma conexão a um banco de dados na página Configurações da conexão.
Se você desativar os Fusos horários específicos do usuário, todas as consultas de dados baseados em tempo vão usar o Fuso horário da consulta, e o Looker vai converter todos os dados baseados em tempo do Fuso horário do banco de dados para o Fuso horário da consulta.
convert_tz
Parâmetro do LookML
O Looker faz a conversão de fuso horário por padrão. Para desativar a conversão de fuso horário de um campo individual, use o parâmetro convert_tz
do LookML. Exemplo:
dimension_group: created {
type: time
timeframes: [time, date]
convert_tz: no
}
Para mais informações, consulte a página de documentação do parâmetro convert_tz
.
Parâmetro do LookML sql
Também é possível definir manualmente a conversão de fuso horário usando as funções do dialeto do seu banco de dados no parâmetro sql
em uma dimensão do LookML. Por exemplo, para definir manualmente a conversão de fuso horário no MySQL, use o seguinte LookML:
dimension_group: created {
type: time
timeframes: [time, date]
sql: CONVERT_TZ(${TABLE}.created_at,'UTC','PST') ;;
}
Observações sobre o dialeto do MySQL
O MySQL exige uma tabela de fuso horário para que a função de conversão de fuso horário funcione. Isso pode ser feito por um administrador. Leia mais na documentação do MySQL.
Notas do dialeto do Postgres
O Looker usa a configuração do motorista para selecionar o fuso horário desejado. Isso pode afetar a forma como as consultas são processadas no SQL Runner em comparação com o pgAdmin, porque o Looker usará a data e hora atual no fuso horário selecionado.
Suporte a dialetos do banco de dados para conversão de fuso horário
Para que o Looker converta os fusos horários no projeto, o dialeto do banco de dados precisa oferecer suporte à conversão desse fuso horário. A tabela a seguir mostra os dialetos compatíveis com a conversão de fuso horário na versão mais recente do Looker:
Dialeto | Compatível? |
---|---|
Avalanche Actian | Não |
Amazon Athena | Sim |
MySQL do Amazon Aurora | Sim |
Amazon Redshift | Sim |
Apache Druid | Não |
Apache Druid 0.13 ou mais recente | Sim |
Apache Druid 0.18 ou superior | Sim |
Apache Hive 2.3 ou superior | Sim |
Apache Hive 3.1.2 ou posterior | Sim |
Apache Spark 3 ou mais recente | Sim |
ClickHouse | Não |
Cloudera Impala 3.1 ou mais recente | Sim |
Cloudera Impala 3.1+ com driver nativo | Sim |
Cloudera Impala com driver nativo | Sim |
DataVirtuality | Não |
Databricks | Sim |
Denodo 7 | Não |
Denodo 8 | Não |
Dremio | Sim |
Dremio 11 ou mais recente | Sim |
Exasol | Não |
Bola de fogo | Não |
SQL legado do Google BigQuery | Não |
SQL padrão do Google BigQuery | Sim |
PostgreSQL do Google Cloud | Sim |
Google Cloud SQL | Sim |
Google Spanner | Sim |
Greenplum | Sim |
HyperSQL | Não |
IBM Netezza | Sim |
MariaDB | Sim |
PostgreSQL do Microsoft Azure | Sim |
Banco de Dados SQL do Microsoft Azure | Sim |
Análises do Microsoft Azure Synapse | Sim |
Microsoft SQL Server 2008 ou mais recente | Não |
Microsoft SQL Server 2012 ou mais recente | Não |
Microsoft SQL Server 2016 | Sim |
Microsoft SQL Server 2017 ou mais recente | Sim |
MongoBI | Não |
MySQL | Sim |
MySQL 8.0.12 ou mais recente | Sim |
Oracle | Sim |
ADWC da Oracle | Sim |
PostgreSQL 9.5 ou mais recente | Sim |
PostgreSQL anterior à 9.5 | Sim |
PrestoDB | Sim |
PrestoSQL | Sim |
SAP HANA 2 ou posterior | Não |
SingleStore | Sim |
SingleStore 7+ | Sim |
Snowflake | Sim |
Teradata | Não |
Trino | Sim |
Vetor | Não |
Vertica | Sim |