Utiliser les paramètres de fuseau horaire

Looker peut faciliter la compréhension des données temporelles en les convertissant dans différents fuseaux horaires. Les utilisateurs peuvent consulter les résultats des requêtes et créer des filtres avec des données temporelles converties dans leur fuseau horaire local. Par exemple, un utilisateur de New York qui consulte des données créées en Californie n'a pas besoin de soustraire manuellement trois heures pour filtrer ou interpréter ses requêtes.

Looker convertit les données temporelles lorsqu'il génère du code SQL lors d'une requête pour une présentation, une exploration ou un tableau de bord. Les données sous-jacentes ne sont pas affectées. Les résultats de la requête sont convertis à l'aide des paramètres de fuseau horaire de Looker. Cela signifie également que les requêtes exécutées à l'aide de Exécuteur SQL ne convertissent pas les données temporelles.

Plusieurs paramètres de Looker spécifient comment convertir les données temporelles :

• Fuseau horaire du système
• Fuseau horaire de la base de données
• Fuseaux horaires spécifiques à l'utilisateur
• Fuseau horaire de l'application
• Requête Fuseau horaire
• convert_tz Paramètre LookML
• sql Paramètre LookML

Fuseau horaire du système

Le fuseau horaire du système est celui pour lequel le serveur exécutant Looker est configuré. La base de données interne de Looker, qui stocke les informations disponibles dans les explorations d'activité du système, stocke les données temporelles dans le fuseau horaire du système.

Le fuseau horaire du système n'est pas configurable via l'application Looker. Pour les instances hébergées par Looker, le fuseau horaire du système est toujours défini sur UTC. Les instances hébergées par le client peuvent se trouver dans un autre fuseau horaire du système. Il n'est pas simple de modifier le fuseau horaire du système, et ce n'est pas recommandé.

Si vous devez ajuster les horodatages dans une exploration d'activité du système, utilisez des calculs de table pour créer des colonnes ajustées dans le temps. Par exemple, pour convertir UTC en EST, vous pouvez créer une colonne avec le calcul de table add_hours(-5, ${time}).

Notez que, comme les calculs de table sont effectués après le renvoi des résultats de la requête, ils ne peuvent pas être utilisés pour regrouper ou croiser des données par composants temporels spécifiques (tels que l'heure de la journée ou le jour de la semaine). Pour ajuster les horodatages de l'activité du système pour les visualisations qui nécessitent un croisement ou un regroupement par composants temporels, utilisez des dimensions personnalisées plutôt. Les dimensions personnalisées sont traitées avant la visualisation, ce qui permet un regroupement approprié. Par exemple, pour ajuster les données d'UTC à GMT-3, vous devez d'abord créer une dimension personnalisée pour l'heure ajustée à l'aide de l'expression Looker add_hours(-3, ${user_facts.last_ui_login_hour}). Vous devez ensuite créer des dimensions personnalisées pour extraire le jour de la semaine ou l'heure requis en fonction de ce champ d'heure ajusté.

Fuseau horaire de la base de données

Lorsque vous ajoutez une connexion à une base de données, vous définissez la valeur du fuseau horaire de la base de données sur la page Paramètres de connexion.

Ce paramètre représente le fuseau horaire de votre base de données, qui est généralement le temps universel coordonné (UTC). Si vous définissez une valeur autre que le fuseau horaire de votre base de données, vous risquez d'obtenir des résultats inattendus.

Fuseaux horaires spécifiques à l'utilisateur

Le paramètre le plus important pour la conversion des données temporelles est l'option Fuseaux horaires spécifiques à l'utilisateur, qui se trouve sur la page Paramètres généraux de la section Admin de Looker.

Vous pouvez activer ou désactiver les fuseaux horaires spécifiques à l'utilisateur :

• Lorsque cette option est activée, chaque utilisateur Looker est associé à un fuseau horaire, qui spécifie l'apparence des résultats de sa requête.
• Lorsque cette option est désactivée, aucun fuseau horaire individuel n'est attribué aux comptes des utilisateurs. Toutes les requêtes sont exécutées à l'aide de la valeur Requête Fuseau horaire.

Lorsque les fuseaux horaires spécifiques à l'utilisateur sont activés, un utilisateur peut définir son fuseau horaire sur sa page Compte, ou les administerurs Looker peuvent attribuer des fuseaux horaires aux utilisateurs sur la page Utilisateurs. Si aucun fuseau horaire n'est défini pour un utilisateur, son compte est défini par défaut sur le paramètre Fuseau horaire de l'application de Looker.

Chaque fois qu'un utilisateur crée une requête, celle-ci est créée dans son fuseau horaire. Par conséquent, lorsqu'une requête renvoie des données temporelles, Looker convertit les données du fuseau horaire de la base de données au fuseau horaire de l'utilisateur. Lorsqu'un utilisateur utilise des valeurs de filtre liées au temps dans une requête, Looker convertit les valeurs de filtre dans le fuseau horaire de la base de données.

De plus, lorsque vous activez cette option, Looker affiche un menu déroulant Fuseau horaire dans les explorations et les présentations.

Les options de ce menu déroulant sont les suivantes :

• Fuseau horaire de chaque vignette (tableaux de bord uniquement) : toutes les requêtes sont exécutées dans le fuseau horaire dans lequel elles ont été enregistrées.
• Fuseau horaire du lecteur : toutes les requêtes sont exécutées dans le paramètre de fuseau horaire actuel de l'utilisateur.
• Liste de chaque fuseau horaire individuel, que les utilisateurs peuvent choisir manuellement s'ils le souhaitent.

Toutes les requêtes sont définies par défaut sur le fuseau horaire avec lequel elles ont été créées. En d'autres termes, si Alice crée une requête avec le fuseau horaire "America/Los Angeles" et l'envoie à Bob, Bob verra la requête avec le fuseau horaire "America/Los Angeles", même si son fuseau horaire est défini sur "America/New York". De même, l'exploration est toujours définie par défaut sur le fuseau horaire avec lequel la requête a été créée.

Lorsqu'ils consultent une requête, les utilisateurs peuvent utiliser le menu déroulant pour remplacer le fuseau horaire, en sélectionnant leur fuseau horaire de lecteur ou tout autre fuseau horaire pour cette requête ou l'ensemble de requêtes de ce tableau de bord.

Points à prendre en compte avec les fuseaux horaires spécifiques à l'utilisateur

Lorsque vous activez les fuseaux horaires spécifiques à l'utilisateur, les utilisateurs situés dans différents fuseaux horaires peuvent voir les données différemment.

Par exemple, les heures exactes composant la période last month diffèrent selon les fuseaux horaires. Les utilisateurs peuvent donc voir des valeurs de données différentes s'ils se trouvent dans des fuseaux horaires différents, mais qu'ils filtrent tous les deux sur last month.

Fuseau horaire de l'application

Le paramètre Fuseau horaire de l'application peut être configuré sur la page Paramètres généraux de la section Admin de Looker.

Le fuseau horaire de l'application est le fuseau horaire par défaut pour les envois de contenu. Le fuseau horaire utilisé pour les envois de contenu n'affecte pas les données temporelles renvoyées par une requête. Il n'affecte que l'heure d'envoi d'un envoi de données.

Si vous activez l'option Fuseaux horaires spécifiques à l'utilisateur, le fuseau horaire de l'application est le fuseau horaire par défaut pour les utilisateurs dont le compte ne comporte pas de valeur de fuseau horaire.

Requête Fuseau horaire

L'option Requête Fuseau horaire ne s'affiche que si vous avez désactivé fuseaux horaires spécifiques à l'utilisateur. Dans ce cas, vous définissez la valeur Requête Fuseau horaire lorsque vous ajoutez une connexion à une base de données sur la page Paramètres de connexion.

Si vous désactivez les fuseaux horaires spécifiques à l'utilisateur, toutes les requêtes de données temporelles utilisent le fuseau horaire de la requête, et Looker convertit toutes les données temporelles du fuseau horaire de la base de données au fuseau horaire de la requête.

Paramètre LookML convert_tz

Looker effectue la conversion de fuseau horaire par défaut. Pour désactiver la conversion de fuseau horaire pour un champ individuel, vous pouvez utiliser le paramètre LookML convert_tz. Exemple :

dimension_group: created {
  type: time
  timeframes: [time, date]
  convert_tz: no
}

Pour en savoir plus, consultez la page de documentation sur le paramètre convert_tz.

Paramètre LookML sql

Vous pouvez également définir manuellement la conversion de fuseau horaire à l'aide des fonctions du dialecte de votre base de données dans le paramètre sql d'une dimension LookML. Par exemple, pour définir manuellement la conversion de fuseau horaire dans MySQL, vous pouvez utiliser le code LookML suivant :

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

Remarques sur le dialecte MySQL

MySQL nécessite une table de fuseaux horaires pour que sa fonction de conversion de fuseau horaire fonctionne. Un administrateur peut l'exécuter. Pour en savoir plus, consultez la documentation MySQL.

Remarques sur le dialecte Postgres

Looker utilise le paramètre du pilote pour sélectionner le fuseau horaire cible. Cela peut affecter la façon dont les requêtes sont traitées dans SQL Runner par rapport à pgAdmin, car Looker utilisera la date et l'heure actuelles dans le fuseau horaire sélectionné.

Compatibilité du dialecte de base de données pour la conversion de fuseau horaire

Pour que Looker convertisse les fuseaux horaires dans votre projet Looker, votre dialecte de base de données doit prendre en charge la conversion de fuseau horaire. Le tableau suivant indique les dialectes qui prennent en charge la conversion de fuseau horaire dans la dernière version de Looker :