Utilisation
view: view_name {
dimension: field_name {
convert_tz: yes | no
}
}
|
Hiérarchie
convert_tz |
Types de champs possibles
Dimension, groupe de dimensions, mesure, filtre, paramètre
Acceptation
Booléen (oui ou non)
|
Définition
Looker propose différents paramètres de fuseau horaire qui convertissent les données temporelles entre différents fuseaux horaires. Looker effectue la conversion de fuseau horaire par défaut. Si vous ne souhaitez pas que Looker effectue une conversion de fuseau horaire pour un champ dimension, dimension_group (avec type: time) ou filter particulier, vous pouvez utiliser le paramètre convert_tz. Cela peut être utile pour les champs déjà convertis au fuseau horaire approprié ou dans certaines situations avancées où vous devez éviter une double conversion de fuseau horaire.
En général, les calculs temporels (différences, durées, etc.) ne fonctionnent correctement que lorsque vous utilisez des valeurs temporelles toutes converties au même fuseau horaire. Il est important de tenir compte des fuseaux horaires lorsque vous écrivez du code LookML.
Exemples
Ne pas effectuer de conversion de fuseau horaire pour le groupe de dimensions local_created :
dimension_group: local_created {
type: time
timeframes: [time, date, week, month]
sql: ${TABLE}.local_created_at ;;
convert_tz: no
}
Éléments à prendre en compte
convert_tz: no ne s'applique qu'à une dimension, et non à un filtre qui l'utilise. En d'autres termes, les filtres effectuent toujours une conversion de fuseau horaire. Lorsque vous spécifiez convert_tz: no, les valeurs de données temporelles s'affichent dans le fuseau horaire de la base de données, mais sont filtrées à l'aide du fuseau horaire de la requête.
Étant donné que les filtres effectuent toujours une conversion de fuseau horaire, une différence entre le fuseau horaire de la base de données et celui de la requête peut entraîner l'inclusion ou l'exclusion inattendue de données dans un ensemble de données. Pour éviter cela, assurez-vous que le fuseau horaire de la requête est défini sur la même valeur que celui de la base de données.
Si l'option Fuseaux horaires spécifiques à l'utilisateur est activée, définissez le menu déroulant du fuseau horaire (situé à côté du bouton Exécuter dans les explorations, les looks et les tableaux de bord) sur la même valeur que le fuseau horaire de la base de données. Si l'option Fuseaux horaires spécifiques à l'utilisateur est désactivée, définissez le fuseau horaire de la requête sur la même valeur que le fuseau horaire de la base de données.
Si vous utilisez des filtres personnalisés, laissez la conversion de fuseau horaire activée pour garantir des comparaisons de dates valides. Si vous désactivez la conversion de fuseau horaire avec convert_tz: no et incluez le champ dans un filtre personnalisé, vos comparaisons de dates peuvent être invalides.
Compatibilité des dialectes de base de données avec la conversion de fuseau horaire
Pour que Looker convertisse les fuseaux horaires dans votre projet, 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 :
| Dialecte | Compatibilité |
|---|---|
| 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 |