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 kuerinya.

Looker mengonversi data berbasis waktu saat membuat SQL selama kueri untuk Look, Jelajah, atau dasbor. Data pokok tidak terpengaruh; sebaliknya, 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 Aktivitas Sistem, menyimpan data berbasis waktu di zona waktu sistem.

Zona waktu sistem tidak dapat dikonfigurasi melalui aplikasi Looker. Untuk instance yang dihosting Looker, zona waktu sistem selalu disetel ke UTC. Instance yang dihosting pelanggan mungkin berada di 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 Jelajah Aktivitas Sistem, Looker merekomendasikan penggunaan penghitungan tabel untuk membuat kolom yang disesuaikan waktunya. Misalnya, untuk mengonversi dari UTC ke EST, Anda dapat membuat kolom dengan penghitungan tabel add_hours(-5, ${time}).

Zona Waktu Database

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

Setelan ini mewakili zona waktu database Anda, yang biasanya adalah Coordinated Universal Time (UTC). Menetapkan nilai ini ke nilai selain zona waktu tempat database Anda berada dapat menyebabkan hasil yang tidak terduga.

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 di bagian Admin Looker.

Anda dapat mengaktifkan atau menonaktifkan Zona Waktu Khusus Pengguna:

  • Jika diaktifkan, setiap pengguna Looker akan ditetapkan ke zona waktu, dan zona waktu tersebut menentukan tampilan hasil kueri mereka.
  • Jika dinonaktifkan, pengguna tidak akan memiliki zona waktu individual yang ditetapkan ke akun mereka. Sebaliknya, 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 kepada 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 di 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 ke Zona Waktu Database.

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

Opsi di drop-down ini adalah:

  • Zona Waktu Setiap Kartu (khusus dasbor): Semua kueri berjalan dalam zona waktu tempat kueri disimpan.
  • Zona Waktu Pelihat: Semua kueri berjalan di setelan zona waktu pengguna saat ini.
  • Daftar setiap zona waktu, yang dapat dipilih pengguna secara manual jika mereka mau.

Semua kueri secara default menggunakan zona waktu tempat kueri dibuat. Dengan kata lain, jika Alice membuat kueri dengan zona waktu "America/Los Angeles" dan mengirimkannya ke Bob, Bob akan melihat kueri dengan zona waktu "America/Los Angeles", meskipun zona waktu Bob disetel ke "America/New York". Demikian pula, pengelompokan selalu ditetapkan secara default ke zona waktu yang digunakan untuk membuat kueri.

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

Hal-hal yang perlu dipertimbangkan dengan Zona Waktu Khusus Pengguna

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

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

Zona Waktu Aplikasi

Setelan Zona Waktu Aplikasi dapat dikonfigurasi di halaman Setelan Umum di 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 ditampilkan oleh kueri; zona waktu hanya memengaruhi waktu pengiriman data.

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

Zona Waktu Kueri

Opsi Zona Waktu Kueri hanya ditampilkan jika Anda telah menonaktifkan Zona Waktu Khusus Pengguna. Dalam hal ini, Anda menetapkan nilai Query Time Zone saat menambahkan koneksi ke database di halaman Connection Settings.

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

convert_tz Parameter LookML

Looker melakukan konversi zona waktu secara default. Untuk menonaktifkan konversi zona waktu untuk setiap 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 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 waktunya berfungsi. Tindakan 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 di 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+
Ya
Apache Hive 3.1.2+
Ya
Apache Spark 3+
Ya
ClickHouse
Tidak
Cloudera Impala 3.1+
Ya
Cloudera Impala 3.1+ dengan Driver Native
Ya
Cloudera Impala dengan Driver Native
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
Google Cloud PostgreSQL
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 pra-9.5
Ya
PrestoDB
Ya
PrestoSQL
Ya
SAP HANA 2+
Tidak
SingleStore
Ya
SingleStore 7+
Ya
Snowflake
Ya
Teradata
Tidak
Trino
Ya
Vektor
Tidak
Vertica
Ya