Looker kann zeitbasierte Daten verständlicher machen, indem sie in andere Zeitzonen konvertiert werden. Nutzer können Abfrageergebnisse sehen und Filter mit zeitbasierten Daten erstellen, die in ihre lokalen Zeitzonen konvertiert werden. Ein Nutzer in New York, der sich Daten ansieht, die in Kalifornien erstellt wurden, muss beispielsweise nicht manuell drei Stunden abziehen, um seine Abfragen zu filtern oder zu interpretieren.
Looker konvertiert zeitbasierte Daten, wenn SQL-Code während einer Abfrage für einen Look, ein Explore oder ein Dashboard generiert wird. Die zugrunde liegenden Daten sind davon nicht betroffen. Stattdessen werden die Abfrageergebnisse mit den Zeitzoneneinstellungen von Looker konvertiert. Das bedeutet auch, dass bei Abfragen, die mit SQL Runner ausgeführt werden, keine zeitbasierten Daten konvertiert werden.
In Looker gibt es mehrere Einstellungen, die angeben, wie zeitbasierte Daten konvertiert werden sollen:
- Systemzeitzone
- Zeitzone der Datenbank
- Nutzerspezifische Zeitzonen
- Zeitzone der Anwendung
- Zeitzone der Abfrage
convert_tzLookML-ParametersqlLookML-Parameter
Systemzeitzone
Die Systemzeitzone ist die Zeitzone, für die der Server konfiguriert ist, auf dem Looker ausgeführt wird. In der internen Datenbank von Looker, in der die Informationen aus den Systemaktivitäts-Explores gespeichert sind, werden zeitbasierte Daten in der Systemzeitzone gespeichert.
Die Systemzeitzone kann nicht über die Looker-Anwendung konfiguriert werden. Bei von Looker gehosteten Instanzen ist die Systemzeitzone immer auf UTC festgelegt. Bei vom Kunden gehosteten Instanzen kann die Systemzeitzone anders sein. Das Ändern der Systemzeitzone ist nicht einfach und wird nicht empfohlen.
Wenn Sie Zeitstempel in einem Systemaktivitäts-Explore anpassen müssen, verwenden Sie Tabellenberechnungen, um zeitangepasste Spalten zu erstellen. Wenn Sie beispielsweise von UTC in EST konvertieren möchten, können Sie eine Spalte mit der Tabellenberechnung add_hours(-5, ${time}) erstellen.
Da Tabellenberechnungen ausgeführt werden, nachdem die Abfrageergebnisse zurückgegeben wurden, können sie nicht verwendet werden, um Daten nach bestimmten Zeitkomponenten (z. B. Tageszeit oder Wochentag) zu gruppieren oder zu pivotieren. Wenn Sie Systemaktivitäts-Zeitstempel für Visualisierungen anpassen möchten, für die eine Pivotierung oder Gruppierung nach Zeitkomponenten erforderlich ist, verwenden Sie stattdes benutzerdefinierte Dimensionen. Benutzerdefinierte Dimensionen werden vor der Visualisierung verarbeitet, was eine korrekte Gruppierung ermöglicht. Wenn Sie beispielsweise Daten von UTC in GMT-3 umwandeln möchten, erstellen Sie zuerst eine benutzerdefinierte Dimension für die angepasste Zeit. Verwenden Sie dazu den Looker-Ausdruck add_hours(-3, ${user_facts.last_ui_login_hour}). Anschließend erstellen Sie weitere benutzerdefinierte Dimensionen, um den erforderlichen Wochentag oder die erforderliche Stunde basierend auf diesem angepassten Zeitfeld zu extrahieren.
Zeitzone der Datenbank
Wenn Sie eine Verbindung zu einer Datenbank hinzufügen, legen Sie auf der Seite Verbindungseinstellungen den Wert für die Zeitzone der Datenbank fest.
Diese Einstellung gibt die Zeitzone an, in der sich Ihre Datenbank befindet. Das ist in der Regel die koordinierte Weltzeit (UTC). Wenn Sie einen anderen Wert als die Zeitzone Ihrer Datenbank festlegen, kann das zu unerwarteten Ergebnissen führen.
Nutzerspezifische Zeitzonen
Die wichtigste Einstellung für die Konvertierung zeitbasierter Daten ist die Option Nutzerspezifische Zeitzonen. Sie finden sie im Bereich Admin von Looker auf der Seite Allgemeine Einstellungen.
Sie können Nutzerspezifische Zeitzonen aktivieren oder deaktivieren:
- Wenn die Option aktiviert ist, wird jedem Looker-Nutzer eine Zeitzone zugewiesen. Diese Zeitzone gibt an, wie die Abfrageergebnisse angezeigt werden.
- Wenn die Option deaktiviert ist, haben Nutzer keine individuellen Zeitzonen, die ihren Konten zugewiesen sind. Stattdessen werden alle Abfragen mit dem Wert Zeitzone der Abfrage ausgeführt.
Wenn Nutzerspezifische Zeitzonen aktiviert ist, kann ein Nutzer seine Zeitzone auf der Seite Konto festlegen. Looker-Administratoren können Nutzern auf der Seite Nutzer Zeitzonen zuweisen. Wenn für einen Nutzer keine Zeitzone festgelegt ist, wird für sein Konto standardmäßig die Einstellung Zeitzone der Anwendung von Looker verwendet.
Wenn ein Nutzer eine Abfrage erstellt, wird sie in der Zeitzone des Nutzers erstellt. Wenn eine Abfrage zeitbasierte Daten zurückgibt, konvertiert Looker die Daten aus der Zeitzone der Datenbank in die Zeitzone des Nutzers. Wenn ein Nutzer zeitbezogene Filterwerte in einer Abfrage verwendet, konvertiert Looker die Filterwerte in die Zeitzone der Datenbank.
Wenn Sie diese Option aktivieren, wird in Explores und Looks außerdem ein Drop-down-Menü Zeitzone angezeigt.
Folgende Optionen sind in diesem Drop-down-Menü verfügbar:
- Zeitzone der einzelnen Tiles (nur Dashboards): Alle Abfragen werden in der Zeitzone ausgeführt, in der sie gespeichert wurden.
- Zeitzone des Betrachters: Alle Abfragen werden in der aktuellen Zeitzoneneinstellung des Nutzers ausgeführt.
- Eine Liste aller einzelnen Zeitzonen, die Nutzer manuell auswählen können.
Für alle Abfragen wird standardmäßig die Zeitzone verwendet, mit der die Abfrage erstellt wurde. Wenn Alice beispielsweise eine Abfrage mit der Zeitzone „America/Los Angeles“ erstellt und sie an Bob sendet, sieht Bob die Abfrage mit der Zeitzone „America/Los Angeles“, auch wenn seine Zeitzone auf „America/New York“ festgelegt ist. Auch beim Drilldown wird standardmäßig die Zeitzone verwendet, mit der die Abfrage erstellt wurde.
Wenn Nutzer eine Abfrage ansehen, können sie die Zeitzone über das Drop-down-Menü überschreiben und die Zeitzone des Betrachters oder eine andere Zeitzone für diese Abfrage oder die Abfragen dieses Dashboards auswählen.
Wichtige Hinweise zu nutzerspezifischen Zeitzonen
Wenn Sie Nutzerspezifische Zeitzonen aktivieren, sehen Nutzer in verschiedenen Zeitzonen möglicherweise unterschiedliche Daten.
Die genauen Stunden, aus denen sich der Zeitraum last month zusammensetzt, unterscheiden sich beispielsweise je nach Zeitzone. Nutzer sehen daher möglicherweise unterschiedliche Datenwerte, wenn sie sich in verschiedenen Zeitzonen befinden, aber beide nach last month filtern.
Zeitzone der Anwendung
Die Einstellung Zeitzone der Anwendung kann im Bereich Admin von Looker auf der Seite Allgemeine Einstellungen konfiguriert werden.
Die Zeitzone der Anwendung ist die Standardzeitzone für die Bereitstellung von Inhalten. Die für die Bereitstellung von Inhalten verwendete Zeitzone hat keine Auswirkungen auf zeitbasierte Daten, die von einer Abfrage zurückgegeben werden. Sie wirkt sich nur auf den Zeitpunkt aus, zu dem eine Datenbereitstellung gesendet wird.
Wenn Sie die Option Nutzerspezifische Zeitzonen aktivieren, ist die Zeitzone der Anwendung die Standardzeitzone für Nutzer, für deren Konten kein Zeitzonenwert festgelegt ist.
Zeitzone der Abfrage
Die Option Zeitzone der Abfrage wird nur angezeigt, wenn Sie Nutzerspezifische Zeitzonen deaktiviert haben. In diesem Fall legen Sie den Wert für Zeitzone der Abfrage fest, wenn Sie auf der Seite Verbindungseinstellungen eine Verbindung zu einer Datenbank hinzufügen.
Wenn Sie Nutzerspezifische Zeitzonen deaktivieren,wird für alle Abfragen zeitbasierter Daten die Zeitzone der Abfrage verwendet. Looker konvertiert alle zeitbasierten Daten aus der Zeitzone der Datenbank in die Zeitzone der Abfrage.
LookML-Parameter convert_tz
Looker führt standardmäßig eine Zeitzonenkonvertierung durch. Wenn Sie die Zeitzonenkonvertierung für ein einzelnes Feld deaktivieren möchten, können Sie den LookML-Parameter convert_tz verwenden. Beispiel:
dimension_group: created {
type: time
timeframes: [time, date]
convert_tz: no
}
Weitere Informationen finden Sie auf der convert_tz Dokumentationsseite zum Parameter.
LookML-Parameter sql
Sie können die Zeitzonenkonvertierung auch manuell definieren, indem Sie die Funktionen des Datenbankdialekts im sql-Parameter in einer LookML-Dimension verwenden. Wenn Sie beispielsweise die Zeitzonenkonvertierung in MySQL manuell definieren möchten, können Sie den folgenden LookML-Code verwenden:
dimension_group: created {
type: time
timeframes: [time, date]
sql: CONVERT_TZ(${TABLE}.created_at,'UTC','PST') ;;
}
Hinweise zum MySQL-Dialekt
Für MySQL ist eine Zeitzonentabelle erforderlich, damit die Funktion zur Zeitzonenkonvertierung funktioniert. Diese kann von einem Administrator ausgeführt werden. Weitere Informationen finden Sie in der MySQL-Dokumentation.
Hinweise zum Postgres-Dialekt
Looker verwendet die Treibereinstellung, um die Zielzeitzone auszuwählen. Dies kann sich auf die Verarbeitung von Abfragen in SQL Runner im Vergleich zu pgAdmin auswirken, da Looker das aktuelle Datum und die aktuelle Uhrzeit in der ausgewählten Zeitzone verwendet.
Unterstützung von Datenbankdialekten für die Zeitzonenkonvertierung
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 neuesten Version von Looker 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.x - 0.17.x | |
| 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 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 |