Looker può semplificare la comprensione dei dati basati sul tempo convertendoli in fusi orari diversi. Gli utenti possono visualizzare i risultati delle query e creare filtri con dati basati sul tempo che vengono convertiti nei fusi orari locali. Ad esempio, un utente di New York che visualizza i dati creati in California non deve sottrarre manualmente tre ore per filtrare o interpretare le query.
Looker converte i dati basati sul tempo quando genera SQL durante una query per un Look, un'esplorazione o una dashboard. I dati sottostanti non sono interessati; piuttosto, i risultati della query vengono convertiti utilizzando le impostazioni del fuso orario di Looker. Questo significa anche che le query eseguite utilizzando SQL Runner non convertono i dati basati sul tempo.
Diverse impostazioni all'interno di Looker specificano come convertire i dati basati sul tempo:
- Fuso orario del sistema
- Fuso orario database
- Fusi orari specifici degli utenti
- Fuso orario applicazione
- Fuso orario query
convert_tzparametro LookMLsqlparametro LookML
Fuso orario del sistema
Il fuso orario del sistema è il fuso orario in cui è configurato il server che esegue Looker. Il database interno di Looker, in cui sono archiviate le informazioni disponibili nelle esplorazioni di i__looker e dell'attività di sistema, archivia i dati basati sul tempo nel fuso orario del sistema.
Il fuso orario del sistema non è configurabile tramite l'applicazione Looker. Per le istanze ospitate da Looker, il fuso orario del sistema è sempre impostato su UTC. Le istanze ospitate dal cliente potrebbero trovarsi in un fuso orario diverso del sistema. La modifica del fuso orario del sistema non è semplice e non è consigliata. Se devi modificare i timestamp in un'i__looker o in un'esplorazione di attività di sistema, Looker consiglia di utilizzare i calcoli tabulari per creare colonne aggiustate in base al tempo. Ad esempio, per convertire da UTC a EST, puoi creare una colonna con il calcolo tabulare add_hours(-5, ${time}).
Fuso orario database
Quando aggiungi una connessione a un database, imposti il valore per Database Time Zone nella pagina Impostazioni connessione.
Questa impostazione rappresenta il fuso orario in cui si trova il database, che in genere è Coordinated Universal Time (UTC). L'impostazione di questo valore su un valore diverso dal fuso orario in cui si trova il database potrebbe portare a risultati imprevisti.
Fusi orari specifici degli utenti
L'impostazione più significativa per la conversione dei dati in base al tempo è l'opzione Fuso orario specifico dell'utente, che si trova nella pagina Impostazioni generali nella sezione Amministrazione di Looker.
Puoi attivare o disattivare i Fusi orari specifici dell'utente:
- Quando questa opzione è abilitata, a ogni utente di Looker viene assegnato un fuso orario che specifica l'aspetto dei risultati della query.
- Quando questa opzione è disattivata, agli utenti non vengono assegnati fusi orari individuali ai loro account. Tutte le query vengono invece eseguite utilizzando il valore Fuso orario query.
Con l'opzione Fusi orari specifici dell'utente attivata, l'utente può impostare il proprio fuso orario nella pagina Account oppure gli amministratori di Looker possono assegnare i fusi orari agli utenti nella pagina Utenti. Se per un utente non è impostato un fuso orario, per impostazione predefinita il suo account utilizza l'impostazione Fuso orario applicazione di Looker.
Ogni volta che un utente crea una query, questa viene creata nel relativo fuso orario. Di conseguenza, quando una query restituisce dati basati sul tempo, Looker li converte dal fuso orario del database nel fuso orario dell'utente. Quando un utente utilizza valori di filtro relativi al tempo in una query, Looker converte i valori del filtro in Database Time Zone.
Inoltre, quando abiliti questa opzione, Looker visualizza un menu a discesa Fuso orario in Esplorazioni e Look.
Le opzioni di questo menu a discesa sono:
- Fuso orario di ogni riquadro (solo dashboard): tutte le query vengono eseguite nel fuso orario in cui sono state salvate.
- Fuso orario del visualizzatore: tutte le query vengono eseguite nell'impostazione del fuso orario attuale dell'utente.
- Un elenco di ogni singolo fuso orario, che gli utenti possono scegliere manualmente in base alle proprie esigenze.
Per impostazione predefinita, per tutte le query viene utilizzato il fuso orario in cui è stata creata. In altre parole, se Alice crea una query con il fuso orario "America/Los Angeles" e la invia a Roberto, Roberto visualizzerà la query con il fuso orario "America/Los Angeles", anche se il fuso orario di Roberto è impostato su "America/New York". Analogamente, l'impostazione predefinita di visualizzazione in dettaglio è il fuso orario in cui è stata creata la query.
Ogni volta che visualizzano una query, gli utenti possono utilizzare il menu a discesa per ignorare il fuso orario, scegliendo il Fuso orario del visualizzatore o un fuso orario diverso per la query o l'insieme di query della dashboard.
Aspetti da considerare per i fusi orari specifici degli utenti
Quando attivi Fusi orari specifici degli utenti, gli utenti di fusi orari diversi potrebbero vedere i dati in modo diverso.
Ad esempio, le ore esatte che compongono il periodo di tempo last month variano da un fuso orario all'altro, quindi gli utenti potrebbero vedere valori dei dati diversi se si trovano in fusi orari diversi ma filtrano entrambi in base a last month.
Fuso orario applicazione
L'impostazione Fuso orario applicazione può essere configurata nella pagina Impostazioni generali della sezione Amministrazione di Looker.
Fuso orario applicazione è il fuso orario predefinito per i caricamenti di contenuti. Il fuso orario utilizzato per il caricamento dei contenuti non influisce sui dati basati sull'ora restituiti da una query, ma solo sul momento in cui viene inviato un caricamento dei dati.
Se attivi l'opzione Fuso orario specifico dell'utente, Fuso orario applicazione sarà il fuso orario predefinito per gli utenti per i quali non è stato impostato un valore per il fuso orario nei propri account.
Fuso orario query
L'opzione Fuso orario query viene visualizzata solo se hai disabilitato Fuso orario specifico dell'utente. In questo caso, imposti il valore Fuso orario query quando aggiungi una connessione a un database nella pagina Impostazioni connessione.
Se disattivi i Fuso orario specifico dell'utente,tutte le query di dati basati sull'ora utilizzano il Fuso orario delle query e Looker converte tutti i dati basati sul tempo dal Fuso orario del database al Fuso orario delle query.
convert_tz parametro LookML
Looker esegue la conversione del fuso orario per impostazione predefinita. Per disattivare la conversione del fuso orario per un singolo campo, puoi utilizzare il parametro LookML convert_tz. Ad esempio:
dimension_group: created {
type: time
timeframes: [time, date]
convert_tz: no
}
Per saperne di più, consulta la pagina della documentazione relativa al parametro convert_tz.
sql parametro LookML
Puoi anche definire manualmente la conversione del fuso orario utilizzando le funzioni del dialetto del database all'interno del parametro sql in una dimensione LookML. Ad esempio, per definire manualmente la conversione del fuso orario in MySQL, puoi utilizzare il seguente LookML:
dimension_group: created {
type: time
timeframes: [time, date]
sql: CONVERT_TZ(${TABLE}.created_at,'UTC','PST') ;;
}
Note dialetto MySQL
MySQL richiede una tabella del fuso orario affinché la relativa funzione di conversione del fuso orario funzioni. Questa operazione può essere eseguita da un amministratore. Per saperne di più, consulta la documentazione di MySQL.
Note del dialetto Postgres
Looker utilizza l'impostazione del driver per selezionare il fuso orario di destinazione. Ciò potrebbe influire sulla modalità di elaborazione delle query in SQL Runner rispetto a pgAdmin, perché Looker utilizzerà la data/ora corrente nel fuso orario selezionato.
Supporto dei dialetti del database per la conversione del fuso orario
Affinché Looker possa convertire i fusi orari nel tuo progetto Looker, il dialetto del tuo 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? |
|---|---|
| Valanga Actia | No |
| Amazon Athena | Sì |
| Amazon Aurora MySQL | Sì |
| Amazon Redshift | Sì |
| Druid Apache | No |
| Apache Druid 0.13 o versioni successive | Sì |
| Apache Druid 0.18 o versioni successive | Sì |
| Apache Hive 2.3 o versioni successive | Sì |
| Apache Hive 3.1.2 o versioni successive | Sì |
| Apache Spark 3 e versioni successive | Sì |
| ClickHouse | No |
| Cloudera Impala 3.1 o versioni successive | Sì |
| Cloudera Impala 3.1 o versioni successive con driver nativo | Sì |
| Cloudera Impala con driver nativo | Sì |
| DataVirtuality | No |
| Databricks | Sì |
| Denodo 7 | No |
| Denodo 8 | No |
| Dremio | Sì |
| Dremio 11+ | Sì |
| Exasol | No |
| Firebolt | No |
| SQL precedente di Google BigQuery | No |
| SQL standard di Google BigQuery | Sì |
| Google Cloud PostgreSQL | Sì |
| Google Cloud SQL | Sì |
| Google Spanner | Sì |
| Greenplum | Sì |
| HyperSQL | No |
| Netezza di IBM | Sì |
| MariaDB | Sì |
| PostgreSQL Microsoft Azure | Sì |
| Database SQL di Microsoft Azure | Sì |
| Microsoft Azure Synapse Analytics | Sì |
| Microsoft SQL Server 2008 e versioni successive | No |
| Microsoft SQL Server 2012 o versioni successive | No |
| Microsoft SQL Server 2016 | Sì |
| Microsoft SQL Server 2017 o versioni successive | Sì |
| MongoBI | No |
| MySQL | Sì |
| MySQL 8.0.12 o versioni successive | Sì |
| Oracle | Sì |
| Oracle ADWC | Sì |
| PostgreSQL 9.5 e versioni successive | Sì |
| PostgreSQL pre-9.5 | Sì |
| PrestoDB | Sì |
| PrestoSQL | Sì |
| SAP HANA 2 o versioni successive | No |
| SingleStore | Sì |
| SingleStore 7+ | Sì |
| Snowflake | Sì |
| Teradata | No |
| Trino | Sì |
| Vettore | No |
| Vertica | Sì |