Looker dapat mempermudah pemahaman data berbasis waktu 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, Explore, atau dasbor. Data pokok tidak terpengaruh; melainkan, 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 Database
- Zona Waktu Khusus Pengguna
- Zona Waktu Aplikasi
- Zona Waktu Kueri
convert_tzParameter LookMLsqlParameter LookML
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 Explore Aktivitas Sistem, menyimpan data berbasis waktu di zona waktu sistem.
Zona waktu sistem tidak dapat dikonfigurasi melalui aplikasi Looker. Untuk instance yang dihosting oleh Looker, zona waktu sistem selalu ditetapkan ke UTC. Instance yang dihosting pelanggan mungkin berada di zona waktu sistem yang berbeda. Mengubah zona waktu sistem tidak mudah dan tidak direkomendasikan.
Jika Anda perlu menyesuaikan stempel waktu di Eksplorasi Aktivitas Sistem, gunakan kalkulasi tabel untuk membuat kolom yang disesuaikan dengan waktu. Misalnya, untuk mengonversi dari UTC ke EST, Anda dapat membuat kolom dengan penghitungan tabel add_hours(-5, ${time}).
Perhatikan bahwa karena kalkulasi tabel dilakukan setelah hasil kueri ditampilkan, kalkulasi tabel tidak dapat digunakan untuk mengelompokkan atau memutar data berdasarkan komponen waktu tertentu (seperti jam dalam sehari atau hari dalam seminggu). Untuk menyesuaikan stempel waktu Aktivitas Sistem untuk visualisasi yang memerlukan pemutaran atau pengelompokan berdasarkan komponen waktu, gunakan dimensi kustom sebagai gantinya. Dimensi kustom diproses sebelum visualisasi, yang memungkinkan pengelompokan yang tepat. Misalnya, untuk menyesuaikan data dari UTC ke GMT-3, Anda harus membuat dimensi kustom untuk waktu yang disesuaikan dengan menggunakan ekspresi Looker add_hours(-3, ${user_facts.last_ui_login_hour}). Kemudian, Anda akan membuat dimensi kustom berikutnya untuk mengekstrak hari kerja atau jam yang diperlukan berdasarkan kolom waktu yang disesuaikan tersebut.
Zona Waktu Database
Saat Anda menambahkan koneksi ke database, Anda menetapkan nilai untuk Zona Waktu Database di halaman Setelan Koneksi.
Setelan ini mewakili zona waktu database Anda, yang biasanya adalah Waktu Universal Terkoordinasi (UTC). Menetapkan nilai ini ke zona waktu selain zona waktu database Anda dapat menyebabkan hasil yang tidak terduga.
Zona Waktu Khusus Pengguna
Setelan 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 akan 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 Zona Waktu Khusus Pengguna diaktifkan, 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, akun mereka akan menggunakan setelan Zona Waktu Aplikasi Looker secara default.
Setiap kali pengguna membuat kueri, kueri tersebut akan 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 Explore dan Look.
Opsi dalam drop-down ini adalah:
- Zona Waktu Setiap Petak (khusus dasbor): Semua kueri dijalankan di zona waktu yang digunakan saat kueri disimpan.
- Zona Waktu Pelihat: Semua kueri dijalankan di setelan zona waktu saat ini pengguna.
- Daftar setiap zona waktu individual, yang dapat dipilih pengguna secara manual jika mereka mau.
Semua kueri secara default menggunakan zona waktu yang digunakan saat 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 ditetapkan ke "America/New York". Demikian pula, penelusuran detail selalu menggunakan zona waktu yang digunakan saat kueri dibuat secara default.
Setiap kali melihat kueri, pengguna dapat menggunakan drop-down untuk mengganti zona waktu, memilih Zona Waktu Pelihat atau zona waktu lain untuk kueri tersebut atau kumpulan kueri dasbor tersebut.
Hal yang perlu dipertimbangkan terkait Zona Waktu Khusus Pengguna
Jika Anda mengaktifkan Zona Waktu Khusus Pengguna, pengguna di zona waktu yang berbeda mungkin melihat data secara berbeda.
Misalnya, jam pasti yang membentuk periode waktu last month akan berbeda antar-zona waktu, sehingga pengguna mungkin melihat nilai data yang berbeda jika mereka berada di zona waktu yang berbeda, tetapi keduanya memfilter berdasarkan 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 tersebut hanya memengaruhi waktu pengiriman data.
Jika Anda mengaktifkan opsi Zona Waktu Khusus Pengguna, Zona Waktu Aplikasi adalah zona waktu default untuk pengguna yang tidak memiliki nilai zona waktu yang ditetapkan 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 Zona Waktu Kueri saat Anda menambahkan koneksi ke database di halaman Setelan Koneksi.
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.
Parameter LookML convert_tz
Looker melakukan konversi zona waktu secara default. Untuk menonaktifkan konversi zona waktu untuk kolom individual, Anda dapat menggunakan parameter LookML convert_tz. Contoh:
dimension_group: created {
type: time
timeframes: [time, date]
convert_tz: no
}
Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi parameter convert_tz.
Parameter LookML sql
Anda juga dapat menentukan konversi zona waktu secara manual menggunakan fungsi dialek database dalam parameter sql dalam 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 agar fungsi konversi zona waktunya dapat berfungsi. Hal ini dapat dijalankan oleh admin. Anda dapat membaca lebih lanjut dalam 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 datetime saat ini di zona waktu yang dipilih.
Dukungan dialek database untuk konversi zona waktu
Agar Looker dapat mengonversi zona waktu di project Looker Anda, 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 | |
| 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 |