Penggunaan
view: view_name {
dimension: field_name {
convert_tz: yes | no
}
}
|
Hierarki
convert_tz |
Kemungkinan Jenis Kolom
Dimensi, Grup Dimensi, Metrik, Filter, Parameter
Menerima
Boolean (ya atau tidak)
|
Definisi
Looker memiliki berbagai setelan zona waktu yang mengonversi data berbasis waktu antar 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. Hal 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, perhitungan waktu (perbedaan, durasi, dll.) hanya berfungsi dengan benar jika Anda mengoperasikan 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. Dengan kata lain, filter selalu melakukan konversi zona waktu. Saat Anda menentukan convert_tz: no, nilai data berbasis waktu akan ditampilkan di 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 dari set data secara tidak terduga. Untuk menghindarinya, pastikan zona waktu kueri ditetapkan ke nilai yang sama dengan zona waktu database.
Jika User Specific Time Zones diaktifkan, tetapkan menu drop-down zona waktu (terletak di samping tombol Run di Jelajah, Tampilan, dan dasbor) ke nilai yang sama dengan zona waktu database. Jika User Specific Time Zones dinonaktifkan, tetapkan Query Time Zone ke nilai yang sama dengan zona waktu database.
Jika Anda menggunakan filter kustom, 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 Anda, dialek database harus mendukung konversi zona waktu. Tabel berikut menunjukkan dialek yang mendukung konversi zona waktu dalam rilis Looker terbaru:
| 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 | |
| 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 |