Nutzung
view: view_name {
dimension: field_name {
convert_tz: yes | no
}
}
|
Hierarchie
convert_tz |
Mögliche Feldtypen
Dimension, Dimensionsgruppe, Messwert, Filter, Parameter
Akzeptiert
Ein boolescher Wert („Ja“ oder „Nein“)
|
Definition
Looker bietet verschiedene Zeitzoneneinstellungen, mit denen zeitbasierte Daten zwischen verschiedenen Zeitzonen konvertiert werden können. In Looker erfolgt die Zeitzonenumwandlung standardmäßig. Wenn Looker für ein bestimmtes dimension-, dimension_group-Feld (mit type: time) oder filter-Feld keine Zeitzonenkonvertierung durchführen soll, können Sie den Parameter convert_tz verwenden. Das kann nützlich sein, wenn Felder bereits in die entsprechende Zeitzone konvertiert wurden oder in einigen erweiterten Situationen, in denen Sie eine doppelte Zeitzonenkonvertierung vermeiden müssen.
Im Allgemeinen funktionieren Zeitberechnungen (Differenzen, Zeiträume usw.) nur dann richtig, wenn Sie mit Zeitwerten arbeiten, die alle in dieselbe Zeitzone umgerechnet wurden. Beim Schreiben von LookML ist es wichtig, Zeitzonen zu berücksichtigen.
Beispiele
Keine Zeitzonenumwandlung für die Dimensionsgruppe local_created durchführen:
dimension_group: local_created {
type: time
timeframes: [time, date, week, month]
sql: ${TABLE}.local_created_at ;;
convert_tz: no
}
Wichtige Punkte
convert_tz: no wird nur auf eine Dimension angewendet, nicht auf einen Filter, der die Dimension verwendet. Mit anderen Worten: Bei Filtern wird immer eine Zeitzonenkonvertierung durchgeführt. Wenn Sie convert_tz: no angeben, werden zeitbasierte Datenwerte in der Datenbankzeitzone angezeigt, aber mit der Abfragezeitzone gefiltert.
Da bei Filtern immer eine Zeitzonenkonvertierung erfolgt, kann es bei einer Differenz zwischen der Zeitzone der Datenbank und der Zeitzone der Abfrage dazu kommen, dass Daten unerwartet in ein Dataset ein- oder daraus ausgeschlossen werden. Um dies zu vermeiden, muss die Zeitzone der Abfrage auf denselben Wert wie die Zeitzone der Datenbank festgelegt werden.
Wenn Nutzerspezifische Zeitzonen aktiviert ist, legen Sie im Drop-down-Menü für die Zeitzone (neben der Schaltfläche Ausführen in Explores, Looks und Dashboards) denselben Wert wie für die Zeitzone der Datenbank fest. Wenn Nutzerspezifische Zeitzonen deaktiviert ist, legen Sie die Zeitzone der Abfrage auf denselben Wert wie die Zeitzone der Datenbank fest.
Wenn Sie benutzerdefinierte Filter verwenden, lassen Sie die Zeitzonenkonvertierung aktiviert, um gültige Datumsvergleiche zu ermöglichen. Wenn Sie die Zeitzonenkonvertierung mit convert_tz: no deaktivieren und das Feld in einen benutzerdefinierten Filter einfügen, sind Ihre Datumsvergleiche möglicherweise ungültig.
Unterstützung von Datenbankdialekten für die Zeitzonenumwandlung
Damit Looker Zeitzonen in Ihrem Looker-Projekt konvertieren kann, muss Ihr Datenbankdialekt die Zeitzonenkonvertierung unterstützen. In der folgenden Tabelle ist zu sehen, welche Dialekte die Zeitzonenkonvertierung in der aktuellen Looker-Version unterstützen:
| Dialekt | Unterstützt? |
|---|---|
| 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 |