convert_tz

Uso

view: view_name {
  dimension: field_name {
    convert_tz: yes | no
  }
}

Hierarquia Ver arquivo view Tipo de campo convert_tz

Possíveis tipos de campo Dimensão, grupo de dimensão, medição, filtro, parâmetro Aceita Um booleano (sim ou não)

Definição

O Looker tem várias configurações de fuso horário que convertem dados baseados em tempo entre diferentes fusos horários. O Looker faz a conversão de fuso horário por padrão. Se você não quiser que o Looker faça uma conversão de fuso horário para um campo específico de dimension, dimension_group (com type: time) ou filter, use o parâmetro convert_tz. Esse parâmetro pode ser útil para campos que já foram convertidos para o fuso horário apropriado ou em algumas situações avançadas em que você precisa evitar uma conversão dupla de fuso horário.

Em geral, os cálculos de tempo (diferenças, durações etc.) só funcionam corretamente quando você opera com valores de tempo convertidos para o mesmo fuso horário. É importante considerar os fusos horários ao escrever em LookML.

Exemplos

Não realizar a conversão de fuso horário para o grupo de dimensões local_created:

dimension_group: local_created {
  type: time
  timeframes: [time, date, week, month]
  sql: ${TABLE}.local_created_at ;;
  convert_tz: no
}

Informações importantes

convert_tz: no se aplica apenas a uma dimensão, não a um filtro que usa a dimensão. Em outras palavras, os filtros sempre realizam a conversão de fuso horário. Quando você especifica convert_tz: no, os valores de dados baseados em tempo são exibidos no fuso horário do banco de dados, mas são filtrados usando o fuso horário da consulta.

Como os filtros sempre fazem a conversão de fuso horário, uma diferença entre o fuso horário do banco de dados e o da consulta pode fazer com que os dados sejam incluídos ou excluídos de um conjunto de dados de forma inesperada. Para evitar isso, verifique se o fuso horário da consulta está definido com o mesmo valor do fuso horário do banco de dados.

Se a opção Fusos horários específicos do usuário estiver ativada, defina o menu suspenso de fuso horário (localizado ao lado do botão Executar em Análises, Looks e painéis) com o mesmo valor do fuso horário do banco de dados. Se os fusos horários específicos dos usuários estiverem desativados, defina o fuso horário de consultas com o mesmo valor do fuso horário do banco de dados.

Se você estiver usando filtros personalizados, mantenha a conversão de fuso horário ativada para garantir comparações de datas válidas. Se você desativar a conversão de fuso horário com convert_tz: no e incluir o campo em um filtro personalizado, suas comparações de data poderão ser inválidas.

Suporte do dialeto do banco de dados para conversão de fuso horário

Para que o Looker converta fusos horários no seu projeto, o dialeto do banco de dados precisa ser compatível com a conversão de fuso horário. A tabela a seguir mostra quais dialetos são compatíveis com a conversão de fuso horário na versão mais recente do Looker:

Dialeto	Compatível?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
ClickHouse 26+
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Dremio 26+ with Arrow Flight SQL
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud AlloyDB for PostgreSQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MongoSQL
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica