Utilizzo
view: view_name {
dimension: field_name {
convert_tz: yes | no
}
}
|
Gerarchia
convert_tz |
Tipi di campi possibili
Dimensione, Gruppo di dimensioni, Misura, Filtro, Parametro
Accetta
Un valore booleano (sì o no)
|
Definizione
Looker dispone di varie impostazioni del fuso orario che convertono i dati basati sul tempo tra fusi orari diversi. Looker esegue la conversione del fuso orario per impostazione predefinita. Se non vuoi che Looker esegua una conversione del fuso orario per un determinato campo dimension, dimension_group (con type: time) o filter, puoi utilizzare il parametro convert_tz. Questo può essere utile per i campi già convertiti nel fuso orario appropriato o in alcune situazioni avanzate in cui è necessario evitare una doppia conversione del fuso orario.
In generale, i calcoli temporali (differenze, durate e così via) funzionano correttamente solo quando operi su valori temporali tutti convertiti nello stesso fuso orario. Quando scrivi LookML, è importante tenere presente i fusi orari.
Esempi
Non eseguire la conversione del fuso orario per il gruppo di dimensioni local_created:
dimension_group: local_created {
type: time
timeframes: [time, date, week, month]
sql: ${TABLE}.local_created_at ;;
convert_tz: no
}
Aspetti da considerare
convert_tz: no si applica solo a una dimensione, non a un filtro che utilizza la dimensione. In altre parole, i filtri eseguono sempre la conversione del fuso orario. Quando specifichi convert_tz: no, i valori dei dati basati sul tempo vengono visualizzati nel fuso orario del database, ma vengono filtrati utilizzando il fuso orario delle query.
Poiché i filtri eseguono sempre la conversione del fuso orario, una differenza tra il fuso orario del database e quello della query potrebbe causare l'inclusione o l'esclusione imprevista dei dati da un set di dati. Per evitare questo problema, assicurati che il fuso orario query sia impostato sullo stesso valore del fuso orario database.
Se l'opzione Fusi orari specifici degli utenti è attivata, imposta il menu a discesa del fuso orario (situato accanto al pulsante Esegui in Esplora, Look e dashboard) sullo stesso valore del fuso orario del database. Se l'opzione Fusi orari specifici degli utenti è disattivata, imposta il fuso orario query sullo stesso valore del fuso orario del database.
Se utilizzi filtri personalizzati, mantieni attiva la conversione del fuso orario per garantire confronti di date validi. Se disattivi la conversione del fuso orario con convert_tz: no e includi il campo in un filtro personalizzato, i confronti tra date potrebbero non essere validi.
Supporto del dialetto del database per la conversione del fuso orario
Affinché Looker converta i fusi orari nel tuo progetto Looker, il dialetto del database deve supportare la conversione del fuso orario. La tabella seguente mostra quali dialetti supportano la conversione del fuso orario nell'ultima release di Looker:
| Dialetto | Supportata? |
|---|---|
| Actian Avalanche | |
| Amazon Athena | |
| Amazon Aurora MySQL | |
| Amazon Redshift | |
| Amazon Redshift 2.1+ | |
| Amazon Redshift Serverless 2.1+ | |
| Apache Druid | |
| Apache Druid 0.13+ | |
| Apache Druid 0.18+ | |
| Apache Hive 2.3+ | |
| Apache Hive 3.1.2+ | |
| Apache Spark 3+ | |
| ClickHouse | |
| 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+ | |
| Exasol | |
| Google BigQuery Legacy SQL | |
| Google BigQuery Standard SQL | |
| 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 | |
| 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 |