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 (הפעלה) בדפים מסוג Explores, ב-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
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