convert_tz

Usage

view: view_name {
  dimension: field_name {
    convert_tz: yes | no
  }
}
היררכיה
convert_tz
סוגי שדות אפשריים
מאפיין, קבוצת מאפיינים, מדד, מסנן, פרמטר

אישור
ערך בוליאני (yes או no)

הגדרה

ב-Looker יש הגדרות שונות של אזורי זמן שממירות נתונים מבוססי-זמן בין אזורי זמן שונים. כברירת מחדל, Looker מבצע המרה של אזור הזמן. אם לא רוצים ש-Looker יבצע המרה של אזור זמן עבור dimension, dimension_group (עם type: time) או שדה filter מסוים, אפשר להשתמש בפרמטר convert_tz. האפשרות הזו יכולה להיות שימושית בשדות שכבר הומרו לאזור הזמן המתאים, או במצבים מתקדמים שבהם צריך להימנע מהמרה כפולה של אזור הזמן.

באופן כללי, חישובים שקשורים לזמן (הפרשים, משכי זמן וכו') פועלים בצורה תקינה רק כשמבצעים פעולות על ערכי זמן שהומרו לאותו אזור זמן. חשוב לזכור את אזורי הזמן כשכותבים LookML.

דוגמאות

לא לבצע המרה של אזור הזמן עבור קבוצת המאפיינים local_created:

dimension_group: local_created {
  type: time
  timeframes: [time, date, week, month]
  sql: ${TABLE}.local_created_at ;;
  convert_tz: no
}

דברים שכדאי לקחת בחשבון

האפשרות convert_tz: no חלה רק על מימד, ולא על מסנן שמשתמש במימד. במילים אחרות, המסננים תמיד מבצעים המרה של אזור הזמן. כשמציינים convert_tz: no, ערכי הנתונים שמבוססים על זמן מוצגים באזור הזמן של מסד הנתונים, אבל הם מסוננים לפי אזור הזמן של השאילתה.

מכיוון שהמסננים תמיד מבצעים המרה של אזור הזמן, יכול להיות שנתונים ייכללו או יוחרגו ממערך נתונים באופן לא צפוי בגלל הבדל בין אזור הזמן של מסד הנתונים לבין אזור הזמן של השאילתה. כדי למנוע את הבעיה הזו, צריך לוודא שאזור הזמן של השאילתה מוגדר לאותו ערך כמו אזור הזמן של מסד הנתונים.

אם האפשרות User Specific Time Zones (אזורי זמן ספציפיים למשתמש) מופעלת, צריך להגדיר בתפריט הנפתח של אזור הזמן (שנמצא ליד הלחצן Run (הפעלה) בדפי ניתוח, ב-Looks ובמרכזי בקרה) את אותו ערך כמו אזור הזמן של מסד הנתונים. אם ההגדרה אזורי זמן ספציפיים למשתמש מושבתת, צריך להגדיר את אזור הזמן של השאילתה לאותו ערך כמו אזור הזמן של מסד הנתונים.

אם אתם משתמשים במסננים בהתאמה אישית, כדאי להשאיר את ההגדרה של המרת אזור זמן מופעלת כדי להבטיח השוואות תקינות של תאריכים. אם משביתים את ההמרה של אזור הזמן באמצעות convert_tz: no וכוללים את השדה במסנן בהתאמה אישית, יכול להיות שהשוואות התאריכים לא יהיו תקפות.

תמיכה בניבים של מסדי נתונים להמרת אזורי זמן

כדי ש-Looker ימיר אזורי זמן בפרויקט Looker, הניב של מסד הנתונים צריך לתמוך בהמרת אזורי זמן. בטבלה הבאה מפורטים הניבים שבהם יש תמיכה בהמרת אזורי זמן בגרסה האחרונה של Looker:

דיאלקט האם יש תמיכה?
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
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