convert_tz

Penggunaan

view: view_name {
  dimension: field_name {
    convert_tz: yes | no
  }
}

Hierarki Lihat File view Jenis Kolom convert_tz

Kemungkinan Jenis Kolom Dimension, Dimension Group, Measure, Filter, Parameter Menerima Boolean (ya atau tidak)

Definisi

Looker memiliki berbagai setelan zona waktu yang mengonversi data berbasis waktu antara zona waktu yang berbeda. Looker melakukan konversi zona waktu secara default. Jika Anda tidak ingin Looker melakukan konversi zona waktu untuk dimension, dimension_group (dengan type: time), atau kolom filter tertentu, Anda dapat menggunakan parameter convert_tz. Parameter ini dapat berguna untuk kolom yang sudah dikonversi ke zona waktu yang sesuai, atau dalam beberapa situasi lanjutan saat Anda perlu menghindari konversi zona waktu ganda.

Secara umum, komputasi waktu (perbedaan, durasi, dll.) hanya berfungsi dengan benar jika Anda beroperasi pada nilai waktu yang semuanya dikonversi ke zona waktu yang sama. Penting untuk mengingat zona waktu saat menulis LookML.

Contoh

Jangan lakukan konversi zona waktu untuk grup dimensi local_created:

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

Hal-hal yang perlu dipertimbangkan

convert_tz: no hanya berlaku untuk dimensi, bukan untuk filter yang menggunakan dimensi tersebut. Dengan kata lain, filter selalu melakukan konversi zona waktu. Jika Anda menentukan convert_tz: no, nilai data berbasis waktu akan ditampilkan dalam zona waktu database, tetapi difilter menggunakan zona waktu kueri.

Karena filter selalu melakukan konversi zona waktu, perbedaan antara zona waktu database dan zona waktu kueri dapat menyebabkan data disertakan atau dikecualikan secara tidak terduga dari set data. Untuk menghindari hal ini, pastikan zona waktu kueri ditetapkan ke nilai yang sama dengan zona waktu database.

Jika Zona Waktu Khusus Pengguna diaktifkan, tetapkan menu drop-down zona waktu (terletak di samping tombol Run di Explore, Look, dan dasbor) ke nilai yang sama dengan zona waktu database. Jika Zona Waktu Khusus Pengguna dinonaktifkan, tetapkan Zona Waktu Kueri ke nilai yang sama dengan zona waktu database.

Jika Anda menggunakan filter kustom, tetap aktifkan konversi zona waktu untuk memastikan perbandingan tanggal yang valid. Jika Anda menonaktifkan konversi zona waktu dengan convert_tz: no dan menyertakan kolom dalam filter kustom, perbandingan tanggal Anda mungkin tidak valid.

Dukungan dialek database untuk konversi zona waktu

Agar Looker dapat mengonversi zona waktu dalam project Looker, dialek database Anda harus mendukung konversi zona waktu. Tabel berikut menunjukkan dialek yang mendukung konversi zona waktu dalam rilis terbaru Looker:

Dialek	Didukung?
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