convert_tz

שימוש

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

אמצעי תשלום מקובלים
ערך בוליאני (כן או לא)

הגדרה

ב-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
ClickHouse 26+
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+
Dremio 26+ with Arrow Flight SQL
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