Menggunakan setelan zona waktu

Looker dapat membuat data berbasis waktu lebih mudah dipahami dengan mengonversinya ke zona waktu yang berbeda. Pengguna dapat melihat hasil kueri dan membuat filter dengan data berbasis waktu yang dikonversi ke zona waktu lokal mereka. Misalnya, pengguna di New York yang melihat data yang dibuat di California tidak perlu mengurangi tiga jam secara manual untuk memfilter atau menafsirkan kueri mereka.

Looker mengonversi data berbasis waktu saat menghasilkan SQL selama kueri untuk Tampilan, Jelajah, atau dasbor. Data pokok tidak akan terpengaruh; tetapi, hasil kueri dikonversi menggunakan setelan zona waktu Looker. Hal ini juga berarti bahwa kueri yang dijalankan menggunakan SQL Runner tidak mengonversi data berbasis waktu.

Beberapa setelan dalam Looker menentukan cara mengonversi data berbasis waktu:

Zona waktu sistem

Zona waktu sistem adalah zona waktu yang dikonfigurasi untuk server yang menjalankan Looker. Database internal Looker, yang menyimpan informasi yang tersedia di Jelajah i__looker dan System Activity, menyimpan data berbasis waktu dalam zona waktu sistem.

Zona waktu sistem tidak dapat dikonfigurasi melalui aplikasi Looker. Untuk instance yang dihosting Looker, zona waktu sistem selalu ditetapkan ke UTC. Instance yang dihosting pelanggan mungkin berada dalam zona waktu sistem yang berbeda. Mengubah zona waktu sistem bukanlah hal yang mudah dan tidak direkomendasikan. Jika Anda perlu menyesuaikan stempel waktu di i__looker atau Eksplorasi Aktivitas Sistem, Looker merekomendasikan penggunaan penghitungan tabel untuk membuat kolom yang disesuaikan dengan waktu. Misalnya, untuk mengonversi dari UTC ke EST, Anda dapat membuat kolom dengan kalkulasi tabel add_hours(-5, ${time}).

Zona Waktu Database

Saat menambahkan koneksi ke database, Anda dapat menetapkan nilai untuk Database Time Zone di halaman Connection Settings.

Setelan ini menunjukkan zona waktu tempat database Anda berada, yang biasanya adalah Waktu Universal Terkoordinasi (UTC). Menetapkan nilai ini ke zona selain zona waktu tempat database Anda berada dapat menyebabkan hasil yang tidak diharapkan.

Zona Waktu Khusus Pengguna

Setelan yang paling signifikan untuk konversi data berbasis waktu adalah opsi Zona Waktu Khusus Pengguna, yang ada di halaman Setelan Umum pada bagian Admin Looker.

Anda dapat mengaktifkan atau menonaktifkan Zona Waktu Khusus Pengguna:

  • Jika diaktifkan, setiap pengguna Looker ditetapkan ke suatu zona waktu, dan zona waktu tersebut akan menentukan tampilan hasil kuerinya.
  • Saat dinonaktifkan, pengguna tidak memiliki zona waktu individual yang ditetapkan ke akun mereka. Namun, semua kueri dijalankan menggunakan nilai Zona Waktu Kueri.

Dengan mengaktifkan Zona Waktu Khusus Pengguna, pengguna dapat menetapkan zona waktu di halaman Akun, atau admin Looker dapat menetapkan zona waktu untuk pengguna di halaman Pengguna. Jika zona waktu tidak ditetapkan untuk pengguna, akunnya akan ditetapkan secara default ke setelan Zona Waktu Aplikasi Looker.

Setiap kali pengguna membuat kueri, kueri tersebut dibuat dalam zona waktu pengguna. Akibatnya, saat kueri menampilkan data berbasis waktu, Looker akan mengonversi data dari Zona Waktu Database ke zona waktu pengguna. Saat pengguna menggunakan nilai filter terkait waktu dalam kueri, Looker akan mengonversi nilai filter menjadi Zona Waktu Database.

Selain itu, jika Anda mengaktifkan opsi ini, Looker akan menampilkan menu drop-down Zona Waktu di Jelajah dan Tampilan.

Opsi di menu drop-down ini adalah:

  • Setiap Zona Waktu Kartu (khusus dasbor): Semua kueri berjalan dalam zona waktu yang digunakan untuk menyimpan kueri.
  • Zona Waktu Penonton: Semua kueri dijalankan dalam setelan zona waktu pengguna saat ini.
  • Daftar setiap zona waktu, yang dapat dipilih pengguna secara manual jika mereka mau.

Semua kueri ditetapkan secara default ke zona waktu yang digunakan untuk membuat kueri. Dengan kata lain, jika Anita membuat kueri dengan zona waktu "Amerika/Los Angeles" dan mengirimkannya ke Budi, Budi akan melihat kueri tersebut dengan zona waktu "Amerika/Los Angeles", meskipun zona waktu Bob ditetapkan ke "Amerika/New York". Demikian pula, penelusuran selalu ditetapkan secara default ke zona waktu mana pun yang digunakan untuk membuat kueri.

Setiap kali melihat kueri, pengguna dapat menggunakan menu drop-down untuk mengganti zona waktu, memilih Zona Waktu Penonton atau zona waktu yang berbeda untuk kueri tersebut atau kumpulan kueri dasbor tersebut.

Hal-hal yang perlu dipertimbangkan terkait Zona Waktu Khusus Pengguna

Saat Anda mengaktifkan Zona Waktu Khusus Pengguna, pengguna di zona waktu yang berbeda dapat melihat data secara berbeda.

Misalnya, jam persis yang membentuk jangka waktu last month akan berbeda di setiap zona waktu, sehingga pengguna mungkin melihat nilai data yang berbeda jika mereka berada di zona waktu yang berbeda tetapi keduanya memfilter last month.

Zona Waktu Aplikasi

Setelan Zona Waktu Aplikasi dapat dikonfigurasi di halaman Setelan Umum pada bagian Admin Looker.

Zona Waktu Aplikasi adalah zona waktu default untuk pengiriman konten. Zona waktu yang digunakan untuk pengiriman konten tidak memengaruhi data berbasis waktu yang dikembalikan oleh kueri; zona ini hanya memengaruhi waktu pengiriman data.

Jika Anda mengaktifkan opsi Zona Waktu Khusus Pengguna, Zona Waktu Aplikasi adalah zona waktu default untuk pengguna yang belum menetapkan nilai zona waktu untuk akun mereka.

Zona Waktu Kueri

Opsi Query Time Zone hanya ditampilkan jika Anda telah menonaktifkan User Specific Time Zones. Dalam hal ini, Anda menyetel nilai Zona Waktu Kueri saat menambahkan koneksi ke database di halaman Setelan Koneksi.

Jika Anda menonaktifkan Zona Waktu Spesifik Per Pengguna, semua kueri data berbasis waktu akan menggunakan Zona Waktu Kueri, dan Looker akan mengonversi semua data berbasis waktu dari Zona Waktu Database menjadi Zona Waktu Kueri.

convert_tz parameter LookML

Looker melakukan konversi zona waktu secara default. Untuk menonaktifkan konversi zona waktu untuk masing-masing kolom, Anda dapat menggunakan parameter LookML convert_tz. Contoh:

dimension_group: created {
  type: time
  timeframes: [time, date]
  convert_tz: no
}

Untuk informasi selengkapnya, lihat halaman dokumentasi parameter convert_tz.

sql parameter LookML

Anda juga dapat menentukan konversi zona waktu secara manual menggunakan fungsi dialek database Anda dalam parameter sql di dimensi LookML. Misalnya, untuk menentukan konversi zona waktu secara manual di MySQL, Anda dapat menggunakan LookML berikut:

dimension_group: created {
 type: time
 timeframes: [time, date]
 sql: CONVERT_TZ(${TABLE}.created_at,'UTC','PST') ;;
}

Catatan dialek MySQL

MySQL memerlukan tabel zona waktu sebelum fungsi konversi zona waktu berfungsi. Ini dapat dijalankan oleh admin. Anda dapat membaca selengkapnya di dokumentasi MySQL.

Catatan dialek Postgres

Looker menggunakan setelan driver untuk memilih zona waktu target. Hal ini dapat memengaruhi cara kueri diproses di SQL Runner dibandingkan dengan pgAdmin, karena Looker akan menggunakan tanggal dan waktu saat ini dalam zona waktu yang dipilih.

Dukungan dialek database untuk konversi zona waktu

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

Dialek Didukung?
Actian Avalanche
Tidak
Amazon Athena
Ya
Amazon Aurora MySQL
Ya
Amazon Redshift
Ya
Apache Druid
Tidak
Apache Druid 0.13+
Ya
Apache Druid 0.18+
Ya
Apache Hive 2.3 dan yang lebih baru
Ya
Apache Hive 3.1.2+
Ya
Apache Spark 3+
Ya
ClickHouse
Tidak
Cloudera Impala 3.1+
Ya
Cloudera Impala 3.1+ dengan Native Driver
Ya
Cloudera Impala dengan Native Driver
Ya
DataVirtuality
Tidak
Databricks
Ya
Denodo 7
Tidak
Denodo 8
Tidak
Dremio
Ya
Dremio 11+
Ya
Exasol
Tidak
Firebolt
Tidak
Legacy SQL Google BigQuery
Tidak
SQL Standar Google BigQuery
Ya
PostgreSQL Google Cloud
Ya
Google Cloud SQL
Ya
Google Spanner
Ya
Greenplum
Ya
HyperSQL
Tidak
IBM Netezza
Ya
MariaDB
Ya
Microsoft Azure PostgreSQL
Ya
Microsoft Azure SQL Database
Ya
Microsoft Azure Synapse Analytics
Ya
Microsoft SQL Server 2008+
Tidak
Microsoft SQL Server 2012+
Tidak
Microsoft SQL Server 2016
Ya
Microsoft SQL Server 2017+
Ya
MongoBI
Tidak
MySQL
Ya
MySQL 8.0.12+
Ya
Oracle
Ya
Oracle ADWC
Ya
PostgreSQL 9.5+
Ya
PostgreSQL versi 9.5
Ya
PrestoDB
Ya
PrestoSQL
Ya
SAP HANA
Tidak
SAP HANA 2+
Tidak
SingleStore
Ya
SingleStore 7+
Ya
Snowflake
Ya
Teradata
Tidak
Trino
Ya
Vector
Tidak
Vertica
Ya