Utilizzo delle impostazioni del fuso orario

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 loro fusi orari locali. Ad esempio, un utente di New York che guarda 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 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 in Looker specificano come convertire i dati basati sul tempo:

Fuso orario del sistema

Il fuso orario del sistema è il fuso orario per cui è configurato il server che esegue Looker. Il database interno di Looker, in cui sono memorizzate le informazioni disponibili nelle esplorazioni di i__looker e System Activity, archivia i dati basati sull'ora 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 del sistema non è banale e non è consigliato. Se hai bisogno di modificare i timestamp in una i__looker o in un'esplorazione dell'attività di sistema, Looker consiglia di utilizzare i calcoli della tabella per creare colonne modificate in base all'ora. 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 del Fuso orario del database nella pagina Impostazioni di connessione:

Questa impostazione rappresenta il fuso orario in cui si trova il tuo database, in genere il UTC (Coordinated Universal Time). Se imposti questo valore su un valore diverso dal fuso orario in cui si trova il database, potrebbero verificarsi risultati imprevisti.

Fusi orari specifici degli utenti

L'impostazione più significativa per la conversione dei dati basata sul tempo è l'opzione Fusi orari specifici degli utenti, che si trova nella pagina Impostazioni generali nella sezione Amministratore di Looker:

Puoi attivare o disattivare i fusi orari specifici degli utenti:

  • Quando l'opzione è attivata, a ogni utente Looker è assegnato un fuso orario che specifica l'aspetto dei risultati delle query.
  • Quando l'opzione è disattivata, agli utenti non vengono assegnati singoli fusi orari. Tutte le query vengono eseguite utilizzando il valore Query Time Zone (Fuso orario query).

Se l'opzione Fusi orari specifici degli utenti è abilitata, un utente può impostare il proprio fuso orario sulla pagina Account oppure gli amministratori di Looker possono assegnare i fusi orari agli utenti nella pagina Utenti. Se un fuso orario non è impostato per un utente, il suo account utilizzerà per impostazione predefinita l'impostazione Fuso orario dell'applicazione di Looker.

Ogni volta che un utente crea una query, questa viene creata nel suo fuso orario. Di conseguenza, quando una query restituisce dati basati sul tempo, Looker li converte dal fuso orario del database al fuso orario dell'utente. Quando un utente utilizza valori di filtro relativi al tempo in una query, Looker li converte nel fuso orario del database.

Inoltre, quando attivi questa opzione, Looker visualizza un menu a discesa in Explores (Esplora), legacy dashboard e Looks:

Le opzioni in questo menu a discesa sono:

  • Fuso orario di ogni riquadro (solo per le dashboard): tutte le query vengono eseguite nel fuso orario in cui sono state salvate.
  • Fuso orario dello spettatore: tutte le query vengono eseguite nell'impostazione del fuso orario corrente dell'utente.
  • Un elenco di ogni fuso orario che gli utenti possono scegliere manualmente.

Per impostazione predefinita, tutte le query sono correlate al fuso orario della query. In altre parole, se Alice crea una query con il fuso orario "America/Los Angeles" e la invia a Roberto, Bob vedrà la query con fuso orario "America/Los Angeles", anche se Roberto ha impostato il fuso orario su "America/New York". Analogamente, per impostazione predefinita la visualizzazione in dettaglio interessa sempre il fuso orario in cui è stata creata la query.

Ogni volta che visualizzano una query, gli utenti possono utilizzare il menu a discesa per eseguire l'override del fuso orario, scegliendo il Fuso orario del visualizzatore o qualsiasi fuso orario diverso per la query o l'insieme di query della dashboard.

Aspetti da considerare con i fusi orari specifici degli utenti

Quando attivi Fusi orari specifici degli utenti, gli utenti che si trovano in fusi orari diversi visualizzano i dati in modo diverso a seconda di come vengono applicati i filtri a ciascuno dei fusi orari. Ad esempio, la seguente query ha un filtro di last month ed è stata eseguita nel fuso orario di New York:

La stessa query eseguita nel fuso orario di Seul restituisce risultati diversi:

I dati sottostanti non sono diversi; le ore esatte che compongono il periodo di tempo last month sono leggermente diverse.

Fuso orario applicazione

L'impostazione Fuso orario dell'applicazione si trova nella pagina Impostazioni generali della sezione Amministratore di Looker:

Il fuso orario dell'applicazione è il fuso orario predefinito per le distribuzione di contenuti. Il fuso orario utilizzato per la distribuzione dei contenuti non influisce sui dati basati sul tempo restituiti da una query, ma solo sul momento in cui viene inviata la distribuzione dei dati.

Se attivi l'opzione Fusi orari specifici degli utenti, Fuso orario dell'applicazione è il fuso orario predefinito per gli utenti a cui non è stato impostato un valore per il loro account.

Fuso orario query

L'opzione Fuso orario query è visibile solo se hai disattivato i Fusi orari specifici degli utenti. In tal caso, imposti il valore del fuso orario della query quando aggiungi una connessione a un database nella pagina Impostazioni di connessione:

Se disattivi i fusi orari specifici degli utenti, tutte le query sui dati basati sul tempo utilizzano il fuso orario delle query e Looker converte tutti i dati basati sul tempo dal fuso orario del database al fuso orario della 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 ulteriori informazioni, 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 codice LookML:

dimension_group: created {
 type: time
 timeframes: [time, date]
 sql: CONVERT_TZ(${TABLE}.created_at,'UTC','PST') ;;
}

Note del dialetto MySQL

MySQL richiede una tabella del fuso orario prima che la sua funzione di conversione del fuso orario funzioni. Può essere eseguito 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. Questo potrebbe influire sul modo in cui le query vengono elaborate in SQL Runner rispetto a pgAdmin, perché Looker utilizzerà la data e l'ora correnti nel fuso orario selezionato.

Supporto del dialetto del database per la conversione del fuso orario

Affinché Looker possa convertire i fusi orari nel 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: