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 convertiti nei fusi orari locali. Ad esempio, un utente a 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, ma i risultati delle query vengono convertiti utilizzando le impostazioni del fuso orario di Looker. Ciò 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 è quello per il quale è configurato il server che esegue Looker. Il database interno di Looker, in cui sono archiviate le informazioni disponibili nelle esplorazioni di i__looker e delle 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 di sistema diverso. Modificare il fuso orario di sistema non è banale e non è consigliato. Se devi modificare i timestamp in i__looker o in un'esplorazione dell'attività di sistema, Looker consiglia di utilizzare i calcoli tabulari per creare colonne con aggiustamento 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, imposta 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 è Tempo coordinato universale (UTC). L'impostazione di questo valore su un valore diverso dal fuso orario in cui si trova il database potrebbe comportare risultati imprevisti.
Fusi orari specifici degli utenti
L'impostazione più significativa per la conversione dei dati basati sul tempo è l'opzione Fusi orari specifici degli utenti, che si trova nella pagina Impostazioni generali della sezione Amministratore di Looker.
Puoi attivare o disattivare Fusi orari specifici degli utenti:
- 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 sono assegnati singoli fusi orari agli account. Tutte le query vengono invece eseguite utilizzando il valore Query Time Zone.
Quando l'opzione Fusi orari specifici degli utenti è abilitata, un utente può impostare il proprio fuso orario sulla pagina del proprio account oppure gli amministratori di Looker possono assegnare fusi orari agli utenti nella pagina Utenti. Se per un utente non è impostato un fuso orario, il suo account utilizzerà per impostazione predefinita l'impostazione di Looker Fuso orario applicazione di Looker.
Ogni volta che un utente crea una query, questa viene creata nel fuso orario dell'utente. Di conseguenza, quando una query restituisce dati basati sul tempo, Looker converte i dati dal fuso orario del database al fuso orario dell'utente. Quando un utente utilizza valori di filtro correlati al tempo in una query, Looker converte i valori del filtro nel fuso orario del database.
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 per le dashboard): tutte le query vengono eseguite nel fuso orario con cui sono state salvate.
- Fuso orario del visualizzatore: tutte le query vengono eseguite nel fuso orario attuale dell'utente.
- Un elenco di ogni singolo fuso orario, che gli utenti possono scegliere manualmente.
Per impostazione predefinita, tutte le query utilizzano il fuso orario con cui è stata creata la query. In altre parole, se Alice crea una query con fuso orario "America/Los Angeles" e la invia a Roberto, Mario la visualizzerà con il fuso orario "America/Los Angeles", anche se il fuso orario di Roberto è impostato su "America/New York". Allo stesso modo, per impostazione predefinita viene sempre impostato il fuso orario con 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 per l'insieme di query della dashboard.
Aspetti da considerare in relazione ai fusi orari specifici degli utenti
Quando attivi i Fusi orari specifici degli utenti, gli utenti che si trovano in fusi orari diversi potrebbero vedere i dati in modo diverso.
Ad esempio, le ore esatte che compongono il periodo di tempo last month sono diverse a seconda del fuso orario, 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 nella sezione Amministratore di Looker.
Il fuso orario applicazione è il fuso orario predefinito per le pubblicazioni di contenuti. Il fuso orario utilizzato per le importazioni dei contenuti non influisce sui dati basati sul tempo restituiti da una query, ma solo sul momento in cui viene inviata un'importazione dei dati.
Se attivi l'opzione Fusi orari specifici degli utenti, Fuso orario applicazione è il fuso orario predefinito per gli utenti che non hanno impostato un valore per il fuso orario per i propri account.
Fuso orario query
L'opzione Query Time Zone (Fuso orario query) viene visualizzata solo se hai disabilitato User Specific Time Zone. In questo caso, devi impostare il valore Query Time Zone quando aggiungi una connessione a un database nella pagina Impostazioni connessione.
Se disabiliti Fuso orario specifico per gli utenti,tutte le query sui dati temporali utilizzeranno il Fuso orario query e Looker convertirà tutti i dati basati sul tempo dal Fuso orario del database al Fuso orario 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 prima che 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 dialetto Postgres
Looker utilizza l'impostazione del driver per selezionare il fuso orario di destinazione. Questo potrebbe influire sul modo in cui le query vengono elaborate in SQL Runner rispetto a pgAdmin, perché Looker utilizzerà la data/ora attuale nel fuso orario selezionato.
Supporto del dialetto del database per la conversione del fuso orario
Affinché Looker possa convertire 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 | Supportato? |
|---|---|
| Valanga atiana | No |
| Amazon Athena | Sì |
| Amazon Aurora MySQL | Sì |
| Amazon Redshift | Sì |
| Apache drud | No |
| Apache Druid 0.13 e versioni successive | Sì |
| Apache Druid 0.18 e versioni successive | Sì |
| Apache Hive 2.3 e 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+ 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 |
| IBM Netezza | Sì |
| MariaDB | Sì |
| Microsoft Azure PostgreSQL | Sì |
| Database SQL di Microsoft Azure | Sì |
| Analisi di Microsoft Azure Synapse | Sì |
| Microsoft SQL Server 2008 e versioni successive | No |
| Microsoft SQL Server 2012 e versioni successive | No |
| Microsoft SQL Server 2016 | Sì |
| Microsoft SQL Server 2017 e versioni successive | Sì |
| MongoBI | No |
| MySQL | Sì |
| MySQL 8.0.12 o versioni successive | Sì |
| Oracle | Sì |
| ADWC Oracle | 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 o versioni successive | Sì |
| Snowflake | Sì |
| Teradata | No |
| Trino | Sì |
| Vettore | No |
| Vertica | Sì |