Menghubungkan Looker ke database Anda

Setelah mengamankan dan mengonfigurasi database, Anda siap menghubungkan database ke Looker. Halaman ini menjelaskan alur kerja koneksi Looker baru.

Anda membuat koneksi database di Looker pada halaman Hubungkan database Anda ke Looker. Ada dua opsi untuk membuka halaman Hubungkan database Anda ke Looker:

  • Klik ikon Menu utama , pilih Admin, lalu pilih Koneksi dari bagian Database di panel Admin. Di halaman Connections, klik tombol Add Connection.
  • Klik tombol Buat di menu navigasi utama, lalu pilih item menu Koneksi.

Halaman ini menjelaskan kolom umum yang ditampilkan Looker di halaman Hubungkan database Anda ke Looker. Kolom persis yang ditampilkan halaman bergantung pada setelan dialek Anda.

Untuk mengetahui informasi tentang cara menerapkan atribut pengguna ke setelan koneksi, lihat bagian Koneksi di halaman dokumentasi Atribut Pengguna.

Penyiapan Koneksi Database memiliki empat bagian berikut:

Setelan umum

Nama

Nama koneksi yang ingin Anda gunakan. Anda memerlukan nama koneksi database ini untuk digunakan dalam parameter connection model LookML Anda. Nama koneksi database juga merupakan cara koneksi diidentifikasi di halaman Koneksi Admin Looker. Jangan gunakan nama folder apa pun untuk setelan ini. Nilai ini tidak harus cocok dengan apa pun di database Anda; Name adalah label yang mengidentifikasi koneksi ini dalam UI Looker.

Dialek SQL

Dialek SQL yang cocok dengan koneksi Anda. Penting untuk memilih nilai yang benar agar Anda dapat melihat opsi koneksi yang tepat, dan agar Looker dapat menerjemahkan LookML Anda dengan benar ke dalam SQL.

Menggunakan versi driver terbaru

Secara default, Looker selalu terhubung ke database Anda menggunakan driver JDBC versi terbaru untuk dialek database Anda. Jika dialek database yang Anda pilih memiliki lebih dari satu versi driver JDBC yang didukung oleh Looker, Anda dapat menonaktifkan tombol Gunakan versi driver terbaru untuk memilih versi driver JDBC yang lebih lama untuk koneksi. Jika ingin memilih versi driver JDBC yang lebih lama, Anda dapat menonaktifkan tombol Gunakan versi driver terbaru untuk koneksi Anda, lalu memilih versi driver dari menu pull-down Versi Driver.

Jika Anda memilih versi driver JDBC yang lebih lama, Looker akan terus menggunakan versi yang lebih lama tersebut selama Looker mendukungnya.

Looker akan berhenti mendukung versi driver dalam dua skenario berikut:

  • Versi driver telah dihapus dari dukungan Looker. Dalam hal ini, koneksi akan menggunakan versi driver paling awal yang didukung Looker untuk dialek tersebut.
  • Versi driver belum ada karena rollback Looker. Dalam hal ini, koneksi akan menggunakan versi driver terbaru yang didukung oleh rilis yang di-roll back.

Jika versi driver yang Anda pilih tidak lagi didukung oleh Looker, Looker akan menampilkan pemberitahuan di kolom Versi Driver pada halaman Edit koneksi database Anda untuk memberi tahu Anda bahwa versi driver yang dipilih tidak lagi didukung. Pemberitahuan juga akan memberi tahu Anda versi driver mana yang digunakan Looker untuk koneksi. Untuk menghapus pemberitahuan ini, pilih versi driver JDBC yang didukung dari menu pull-down Versi Driver atau aktifkan tombol Gunakan versi driver terbaru untuk menggunakan versi driver terbaru.

Ruang lingkup proyek

Pilih apakah koneksi dapat digunakan dengan semua project atau hanya dengan satu project:

  • Semua Project: Semua project LookML di instance dapat memiliki akses ke koneksi, sehingga nama koneksi dapat ditentukan dalam parameter connection file model dalam project tersebut.
  • Project yang Dipilih: Hanya satu project LookML di instance yang dapat memiliki akses ke koneksi. Saat Anda memilih opsi ini, layar Connection akan menampilkan menu drop-down project di instance. Pilih project yang dapat memiliki akses ke koneksi ini.

Gunakan opsi ini bersama izin berikut untuk mendelegasikan pengelolaan koneksi dan konfigurasi model:

Detail status

Luaskan bagian Detail Status untuk menguji setelan koneksi Anda.

Setelan Database

Mengaktifkan Server SSH

Opsi Server SSH hanya tersedia jika instance di-deploy di infrastruktur Kubernetes dan kemampuan untuk menambahkan informasi konfigurasi server SSH ke instance Looker Anda telah diaktifkan. Jika opsi ini tidak diaktifkan di instance Looker Anda dan Anda ingin mengaktifkannya, hubungi Google Cloud spesialis penjualan atau buka permintaan dukungan. Jika Anda mengaktifkan opsi Aktifkan Server SSH, Looker akan menampilkan kolom Server SSH dan Tunnel SSH.

Server SSH

Anda tidak dapat menentukan port localhost; server SSH akan otomatis memilih port localhost untuk Anda. Jika Anda perlu membuat koneksi SSH yang mengharuskan Anda menentukan port localhost, buka permintaan dukungan.

Pilih konfigurasi server SSH dari menu drop-down. Server SSH diperlukan untuk memilih atau membuat tunnel SSH yang sesuai. Anda dapat membuat server SSH baru di tab SSH Servers di panel Connections.

Tunnel SSH

Pilih tunnel SSH yang ada dari menu drop-down atau klik ikon Buat Tunnel Baru jika Anda ingin membuat tunnel SSH baru dengan nama host dan Port atau Port lokal.

Hostname

Nama host database yang harus digunakan Looker untuk terhubung ke host database Anda.

Jika Anda bekerja sama dengan analis Looker untuk mengonfigurasi tunnel SSH ke database Anda, di kolom Host, masukkan "localhost". Jika Anda menerapkan atribut pengguna ke kolom Host, atribut pengguna tidak boleh memiliki tingkat akses pengguna yang ditetapkan ke Dapat Diedit. Jika Anda mengonfigurasi tunnel SSH untuk terhubung ke database, Anda tidak dapat menerapkan atribut pengguna ke kolom Remote Host:Port.

Port

Port database yang harus digunakan Looker untuk terhubung ke host database Anda.

Jika Anda bekerja sama dengan analis Looker untuk mengonfigurasi tunnel SSH ke database Anda, di kolom Port, masukkan nomor port yang mengalihkan ke database Anda, yang seharusnya telah diberikan oleh analis Looker Anda.

Port Lokal

Secara default, Looker akan otomatis memilih port lokal yang tersedia untuk tunnel SSH. Untuk memilih port lokal secara manual, pilih Entri Manual dan masukkan nomor port ke kolom Port Lokal Kustom. Pastikan port lokal tersedia di instance Anda.

ID Project Penagihan (khusus Google BigQuery)

Billing Project ID adalah Google Cloud project ID. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Google BigQuery.

ID Project Storage (khusus Google BigQuery)

Nama Project ID Penyimpanan Anda, jika Anda memisahkan komputasi dan penyimpanan dalam project terpisah. Anda dapat membuat kueri set data dalam Google Cloud project yang berbeda jika developer LookML Anda menentukan nama tabel yang tercakup sepenuhnya dalam parameter sql_table_name pada tampilan, Jelajah, atau gabungan LookML Anda. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Google BigQuery.

Set Data Utama (khusus Google BigQuery)

Nama set data yang Anda inginkan agar Looker gunakan secara default saat mengkueri database Anda. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Google BigQuery.

Nama Database

Nama database di host Anda. Misalnya, Anda mungkin memiliki nama host my-instance.us-east-1.redshift.amazonaws.com yang memiliki database bernama sales_info. Anda akan memasukkan sales_info di kolom ini. Jika memiliki beberapa database di host yang sama, Anda mungkin perlu membuat beberapa koneksi untuk menggunakannya (kecuali MySQL, yang kata database-nya memiliki arti yang sedikit berbeda dengan kebanyakan dialek SQL).

Skema Default

Skema default yang digunakan Looker saat skema tidak ditentukan. Hal ini berlaku saat Anda menggunakan SQL Runner, selama pembuatan project LookML, dan saat Anda membuat kueri tabel.

Setelan Autentikasi

Untuk koneksi Google BigQuery, Snowflake, Trino, dan Databricks, pilih jenis autentikasi yang ingin Anda gunakan oleh Looker untuk mengakses database Anda:

  • Untuk koneksi Google BigQuery, Anda memiliki opsi untuk mengonfigurasi OAuth atau akun layanan yang akan digunakan Looker untuk melakukan autentikasi ke database Anda.
  • Untuk koneksi Snowflake, Trino, dan Databricks, Anda memiliki opsi untuk mengonfigurasi OAuth atau akun database agar digunakan Looker untuk mengautentikasi ke database Anda.

Saat Anda menggunakan OAuth, pengguna Anda diwajibkan untuk login ke database Anda untuk mengeluarkan kueri dari Looker. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi OAuth pada koneksi ke Looker, lihat prosedur koneksi Google BigQuery, Snowflake, Trino, atau Databricks.

Nama pengguna

Nama pengguna dari akun pengguna di database Anda yang dapat digunakan Looker untuk terhubung ke database Anda.

Sandi

Sandi dari akun pengguna di database Anda yang dapat digunakan Looker untuk terhubung ke database Anda.

Luaskan bagian Detail Status untuk menguji setelan koneksi Anda.

Setelan Opsional

Koneksi maksimum per node

Di sini, Anda dapat menetapkan jumlah maksimum koneksi yang dapat dibuat Looker dengan database Anda. Sebagian besar, Anda menetapkan jumlah kueri serentak yang dapat dijalankan Looker terhadap database Anda. Looker juga mencadangkan hingga tiga koneksi untuk penghentian kueri. Jika kumpulan koneksi sangat kecil, Looker akan mencadangkan lebih sedikit koneksi.

Tetapkan nilai ini dengan cermat. Jika nilainya terlalu tinggi, Anda dapat membebani database. Jika nilainya terlalu rendah, kueri harus berbagi sejumlah kecil koneksi, yang dapat membuat banyak kueri tampak lambat bagi pengguna karena kueri harus menunggu kueri lain yang lebih awal untuk ditampilkan.

Nilai default (yang bervariasi bergantung pada dialek SQL Anda) biasanya merupakan titik awal yang wajar. Sebagian besar database juga memiliki setelan sendiri untuk jumlah maksimum koneksi yang akan diterima. Jika konfigurasi database Anda membatasi koneksi, pastikan nilai Koneksi Maksimum per node sama dengan atau lebih rendah dari batas database Anda.

Waktu Tunggu Kumpulan Koneksi Habis

Jika pengguna Anda meminta lebih banyak koneksi daripada yang dikonfigurasi untuk setelan Koneksi Maks per node, permintaan akan menunggu yang lain selesai sebelum dieksekusi. Durasi maksimum permintaan akan menunggu dikonfigurasi di sini. Setelan defaultnya adalah 120 detik.

Tetapkan nilai ini dengan cermat. Jika disetel terlalu rendah, pengguna mungkin mendapati kueri mereka dibatalkan karena tidak ada cukup waktu bagi kueri pengguna lain untuk selesai. Jika ditetapkan terlalu tinggi, sejumlah besar kueri dapat menumpuk, sehingga pengguna harus menunggu dalam waktu yang sangat lama. Nilai default biasanya merupakan titik awal yang wajar.

Kueri serentak maksimum untuk koneksi ini

Nilai opsional ini membatasi jumlah kueri serentak yang akan dikirimkan Looker ke koneksi database ini sekaligus. Jika ada lebih banyak permintaan serentak yang meminta koneksi yang sama, Looker akan mengantrekannya secara internal dan memprosesnya secara berurutan. Menetapkan nilai ini akan menggantikan nilai Koneksi maks per node yang ada.

Jumlah maksimum kueri serentak per pengguna untuk koneksi ini

Nilai opsional ini membatasi jumlah kueri serentak dari satu pengguna yang akan dikirimkan Looker ke koneksi database ini sekaligus. Jika ada lebih banyak permintaan serentak yang meminta koneksi yang sama, Looker akan mengantrekannya secara internal dan memprosesnya secara berurutan.

Parameter JDBC tambahan

Anda dapat menyertakan parameter Java Database Connectivity (JDBC) tambahan untuk kueri Anda di sini, jika diperlukan.

Untuk mereferensikan atribut pengguna dalam parameter JDBC, gunakan sintaksis template Liquid: _user_attributes['name_of_attribute']. Lihat contoh berikut:

my_jdbc_param={{ _user_attributes['name_of_attribute'] }}

Jadwal Pemeliharaan

Regenerator Looker memeriksa grup data dan tabel persisten (baik tabel gabungan maupun tabel turunan persisten) yang didasarkan pada sql_trigger_value. Berdasarkan pemeriksaan ini, regenerator Looker membangun ulang atau menghapus tabel yang dipertahankan dari skema awal database Anda.

Nilai Jadwal Pemeliharaan menetapkan interval cron untuk regenerator Looker. Regenerator Looker memulai siklus regenerator untuk memeriksa grup data dan tabel persisten pada interval cron. Jika siklus regenerator Looker masih dalam proses pada interval cron berikutnya, regenerator Looker akan menyelesaikan siklus regenerator yang sedang dalam proses, lalu menunggu hingga interval cron berikutnya untuk memulai siklus regenerator berikutnya.

Setelan Jadwal Pemeliharaan menerima ekspresi cron. Nilai defaultnya adalah */5 * * * *, yang berarti siklus regenerator Looker akan memulai siklus pada interval lima menit, jika siklus regenerator sebelumnya telah selesai. Jika siklus regenerator sebelumnya belum selesai, regenerator Looker akan dimulai pada interval lima menit berikutnya setelah siklusnya selesai.

Interval default lima menit juga merupakan interval paling sering yang didukung untuk Jadwal Pemeliharaan. Looker tidak menerapkan interval maksimum untuk Jadwal Pemeliharaan, yang berarti Anda dapat memperpanjang interval antara siklus regenerator Looker selama dapat ditentukan oleh ekspresi cron. Perlu diingat bahwa siklus regenerator Looker yang lebih panjang dapat memengaruhi keaktualan data dalam cache dan tabel persisten Anda secara negatif.

Setelah regenerator Looker menyelesaikan semua pemeriksaan dan membangun ulang PDT dalam satu siklus, regenerator akan menunggu interval cron berikutnya untuk memulai siklus berikutnya. Jika Anda memiliki build PDT yang berjalan lama, Anda mungkin memiliki periode yang panjang di antara siklus regenerator Looker. Faktor lain dapat memengaruhi waktu yang diperlukan untuk membangun kembali tabel Anda, seperti yang dijelaskan di bagian Pertimbangan penting untuk menerapkan tabel persisten di halaman Tabel turunan di Looker.

Jika database Anda tidak aktif 24/7, Anda dapat membatasi pemeriksaan pada saat database aktif. Berikut beberapa ekspresi cron tambahan:

cron ekspresi Definisi
*/5 8-17 * * MON-FRI Periksa grup data dan PDT setiap 5 menit selama jam kerja, Senin hingga Jumat
*/5 8-17 * * * Memeriksa grup data dan PDT setiap 5 menit selama jam buka, setiap hari
0 8-17 * * MON-FRI Periksa grup data dan PDT setiap jam selama jam kerja, Senin hingga Jumat
1 3 * * * Memeriksa grup data dan PDT setiap hari pukul 03.01

Beberapa hal yang perlu diperhatikan saat Anda membuat ekspresi cron:

  • Looker menggunakan parse-cron v0.1.3, yang tidak mendukung ? dalam ekspresi cron.
  • Ekspresi cron menggunakan zona waktu aplikasi Looker untuk menentukan waktu pemeriksaan.
  • Jika PDT tidak dibuat, reset string cron kembali ke default */5 * * * *.

Berikut adalah beberapa referensi untuk membantu membuat string cron:

SSL

Pilih apakah Anda ingin menggunakan enkripsi SSL untuk melindungi data saat data berpindah antara Looker dan database Anda. SSL hanyalah salah satu opsi yang dapat digunakan untuk melindungi data Anda; opsi aman lainnya dijelaskan di halaman dokumentasi Mengaktifkan akses database yang aman.

Verifikasi SSL

Pilih apakah Anda ingin mewajibkan verifikasi sertifikat SSL yang digunakan oleh koneksi. Jika verifikasi diperlukan, Certificate Authority (CA) SSL yang menandatangani sertifikat SSL harus berasal dari daftar sumber tepercaya klien. Jika CA bukan sumber tepercaya, koneksi database tidak akan dibuat.

Jika kotak ini tidak dicentang, enkripsi SSL tetap digunakan pada koneksi, tetapi verifikasi koneksi SSL tidak diperlukan, sehingga koneksi dapat dibuat saat CA tidak ada dalam daftar sumber tepercaya klien.

Melakukan pra-cache tabel dan kolom

Di SQL Runner, semua informasi tabel dimuat sebelumnya segera setelah Anda memilih koneksi dan skema. Dengan begitu, SQL Runner dapat menampilkan kolom tabel dengan cepat segera setelah Anda mengklik nama tabel. Namun, untuk koneksi dan skema dengan banyak tabel atau dengan tabel yang sangat besar, Anda mungkin tidak ingin SQL Runner memuat semua informasi terlebih dahulu.

Jika Anda lebih memilih SQL Runner untuk memuat informasi tabel hanya saat tabel dipilih, Anda dapat membatalkan pilihan opsi Precache tabel dan kolom untuk menonaktifkan pra-pemuatan SQL Runner untuk koneksi.

Mengambil dan menyimpan skema dalam cache

Untuk beberapa fitur penulisan SQL seperti pemahaman agregasi, Looker menggunakan skema informasi database Anda untuk mengoptimalkan penulisan SQL. Jika skema informasi tidak di-cache, Looker mungkin harus memblokir penulisan SQL ke database sesekali agar dapat mengambil skema informasi. Untuk dialek yang menggunakan Hadoop Distributed File System (HDFS), pengambilan skema informasi dapat memakan waktu cukup lama sehingga memengaruhi performa kueri Looker Anda secara signifikan. Jika mengetahui bahwa skema informasi Anda lambat, Anda dapat menonaktifkan opsi Ambil dan simpan skema dalam cache untuk koneksi Anda. Menonaktifkan fitur ini akan mencegah beberapa pengoptimalan SQL Looker untuk fitur tertentu, jadi Anda harus mengaktifkan opsi Ambil dan simpan skema dalam cache kecuali jika Anda tahu bahwa skema informasi koneksi Anda sangat lambat.

Estimasi Biaya

Tombol Perkiraan Biaya hanya berlaku untuk koneksi database berikut:

Tombol Perkiraan Biaya mengaktifkan fitur berikut pada koneksi:

Lihat halaman dokumentasi Menjelajahi data di Looker untuk mengetahui informasi selengkapnya.

Penggabungan Koneksi Database

Untuk dialek yang mendukung penggabungan koneksi database, fitur ini memungkinkan Looker menggunakan kumpulan koneksi melalui driver JDBC. Penggabungan koneksi database memungkinkan performa kueri yang lebih cepat; kueri baru tidak perlu membuat koneksi database baru, tetapi dapat menggunakan koneksi yang ada dari kumpulan koneksi. Kemampuan penggabungan koneksi memastikan bahwa koneksi dibersihkan setelah eksekusi kueri dan tersedia untuk digunakan kembali setelah eksekusi kueri berakhir. Lihat halaman dokumentasi Penggabungan koneksi database untuk mengetahui informasi selengkapnya.

Setelan Tabel Turunan Persisten (PDT)

Setelan berikut akan muncul jika PDT diaktifkan.

Mengaktifkan PDT

Aktifkan tombol Aktifkan PDT untuk mengaktifkan tabel turunan persisten. Jika PDT diaktifkan, jendela Koneksi akan menampilkan kolom PDT tambahan dan bagian Penggantian PDT. Looker hanya menampilkan tombol Aktifkan PDT jika dialek database mendukung penggunaan PDT.

Perhatikan hal-hal berikut tentang PDT:

  • PDT tidak didukung untuk koneksi Snowflake yang menggunakan OAuth.
  • Menonaktifkan PDT pada koneksi tidak akan menonaktifkan grup data yang terkait dengan PDT Anda. Meskipun Anda menonaktifkan PDT, grup data yang ada akan tetap menjalankan kueri sql_trigger terhadap database. Jika Anda ingin menghentikan grup data menjalankan kueri sql_trigger terhadap database, Anda harus menghapus atau mengomentari parameter datagroup dari project LookML, atau Anda dapat memperbarui setelan Jadwal Pemeliharaan untuk koneksi agar Looker jarang atau tidak pernah memeriksa PDT dan grup data.
  • Untuk koneksi Snowflake, Looker menetapkan nilai untuk parameter AUTOCOMMIT ke TRUE (nilai default Snowflake). AUTOCOMMIT diperlukan untuk perintah SQL yang dijalankan Looker untuk mempertahankan sistem pendaftaran PDT-nya.

Database Sementara

Meskipun diberi label Temp Database, Anda akan memasukkan nama database atau nama skema — sebagaimana sesuai untuk dialek SQL Anda — yang harus digunakan Looker untuk membuat tabel turunan persisten. Anda harus mengonfigurasi database atau skema ini sebelumnya, dengan izin tulis yang sesuai. Di halaman dokumentasi Database configuration instructions, pilih dialek database Anda untuk melihat petunjuk dialek tersebut.

Setiap koneksi harus memiliki Database Sementara atau Skema sendiri; keduanya tidak dapat dibagikan di seluruh koneksi.

Jumlah Maksimum Koneksi Pembuat PDT

Setelan Jumlah Maksimum Koneksi Pembuat PDT memungkinkan Anda menentukan jumlah build tabel serentak yang dapat dimulai oleh regenerator Looker pada koneksi database Anda. Setelan Jumlah Maksimum Koneksi Pembuat PDT hanya berlaku untuk jenis tabel yang memulai pembangunan ulang oleh regenerator Looker:

  • Tabel dengan pemicu persistensi (tabel turunan persisten dan tabel gabungan yang menggunakan strategi persistensi datagroup_trigger atau sql_trigger_value).
  • Tabel persisten yang menggunakan strategi persist_for, tetapi hanya jika tabel persist_for adalah bagian dari cascade tabel turunan yang bergantung pada tabel yang menggunakan strategi persistensi datagroup_trigger atau sql_trigger_value. Dalam hal ini, regenerator Looker akan membangun ulang tabel persist_for, karena tabel tersebut diperlukan untuk membangun ulang tabel lain dalam cascade. Jika tidak, regenerator tidak akan memulai build untuk tabel persist_for.

Setelan Jumlah Maksimum Koneksi Pembuat PDT secara default adalah 1, tetapi dapat ditetapkan hingga 10. Namun, nilai tidak boleh lebih tinggi dari nilai yang ditetapkan di kolom Koneksi maks. per node atau di per-user-query-limit yang ditetapkan di opsi startup Looker.

Tetapkan nilai ini dengan cermat. Jika nilainya terlalu tinggi, Anda dapat membebani database. Jika nilainya rendah, PDT yang berjalan lama atau tabel gabungan dapat menunda pembuatan tabel persisten lainnya atau memperlambat kueri lain pada koneksi. Database yang mendukung multi-tenancy — seperti BigQuery, Snowflake, dan Redshift — mungkin lebih berperforma dalam menangani pembuatan kueri paralel.

Jika Anda ingin meningkatkan setelan Jumlah Maksimum Koneksi Pembuat PDT, sebaiknya tingkatkan terlebih dahulu dengan inkremen 1. Jika ada perilaku yang tidak terduga, setel kembali ke default 1. Jika tidak, jika performa kueri tidak terpengaruh, Anda dapat terus menaikkannya secara bertahap sebesar 1 dan memverifikasi performa pada setiap kenaikan sebelum meningkatkan setelan lebih lanjut.

Perhatikan hal berikut tentang setelan Jumlah Maksimum Koneksi Pembuat PDT:

  • Setelan Jumlah Maksimum Koneksi Pembuat PDT hanya berlaku untuk koneksi yang diperlukan untuk membangun ulang tabel, bukan untuk koneksi yang diperlukan untuk pemeriksaan pemicu. Pemeriksaan pemicu adalah kueri yang memeriksa apakah strategi persistensi tabel dipicu; karena kueri pemeriksaan pemicu ini selalu dijalankan secara berurutan, setelan Jumlah Maksimum Koneksi Pembuat PDT tidak berlaku.
  • Dalam instance Looker yang dikelompokkan, regenerator hanya berjalan di node utama. Setelan Jumlah Maksimum Koneksi Pembuat PDT hanya berlaku untuk node utama, sehingga menetapkan batas untuk seluruh cluster.
  • Setelan Jumlah Maksimum Koneksi Pembuat PDT tidak berlaku untuk jenis tabel berikut. Jenis tabel ini dibuat secara berurutan:
    • Tabel dipertahankan melalui parameter persist_for (kecuali jika tabel tersebut bergantung pada tabel yang menggunakan strategi datagroup_trigger atau sql_trigger_value).
    • Tabel dalam Mode Pengembangan.
    • Tabel dibuat ulang dengan opsi Buat Ulang Tabel Turunan & Jalankan.
    • Tabel yang satu bergantung pada tabel lain dalam cascade dependensi. Tabel tidak dapat dibuat pada saat yang sama dengan tabel yang menjadi dependensinya. Misalnya, jika table_B bergantung pada table_A, maka table_A harus menyelesaikan pembangunan ulang sebelum table_B dapat mulai dibangun ulang.

Mencoba lagi build PDT yang gagal

Tombol Coba lagi build PDT yang gagal mengonfigurasi cara regenerator Looker mencoba membangun ulang tabel yang dipertahankan pemicu yang gagal dalam siklus regenerator sebelumnya. Regenerator Looker adalah proses yang membangun kembali tabel yang dipertahankan pemicunya (PDT dan tabel gabungan) sesuai dengan interval yang dikonfigurasi dalam setelan koneksi Jadwal Pemeliharaan. Jika tombol Coba Ulang Pembuatan PDT yang Gagal diaktifkan, regenerator Looker akan mencoba membangun ulang PDT yang gagal dalam siklus regenerator sebelumnya, meskipun kondisi pemicu PDT tidak terpenuhi. Jika setelan ini dinonaktifkan, regenerator Looker akan mencoba membangun ulang PDT yang sebelumnya gagal hanya jika kondisi pemicu PDT terpenuhi. Coba Ulang Build PDT yang Gagal dinonaktifkan secara default.

Lihat halaman dokumentasi Tabel turunan di Looker untuk mengetahui informasi selengkapnya tentang regenerator Looker.

Kontrol PDT API

Tombol Kontrol API PDT menentukan apakah panggilan API start_pdt_build, check_pdt_build, dan stop_pdt_build dapat digunakan untuk koneksi ini. Jika tombol Kontrol API PDT dinonaktifkan, panggilan API ini akan gagal saat mereferensikan PDT pada koneksi ini. Tombol Kontrol API PDT dinonaktifkan secara default.

Mengaktifkan Penggantian PDT

Jika database Anda mendukung tabel turunan persisten, dan Anda telah mengaktifkan tombol Aktifkan PDT di setelan koneksi, Looker akan menampilkan tombol Penggantian PDT. Aktifkan tombol Penggantian PDT untuk menampilkan bagian Penggantian PDT, tempat Anda dapat memasukkan parameter JDBC terpisah (host, port, database, nama pengguna, sandi, skema, parameter tambahan, dan pernyataan setelah terhubung) yang khusus untuk proses PDT. Hal ini dapat bermanfaat karena beberapa alasan:

  • Dengan membuat pengguna database terpisah untuk proses PDT, Anda dapat menggunakan PDT di project Looker meskipun Anda menetapkan atribut pengguna ke kredensial login database atau menggunakan OAuth untuk koneksi database.
  • Proses PDT dapat melakukan autentikasi melalui pengguna database terpisah yang memiliki prioritas lebih tinggi. Dengan demikian, database dapat memprioritaskan tugas PDT daripada kueri pengguna yang kurang penting.
  • Akses tulis dapat dicabut untuk koneksi database Looker standar, dan hanya diberikan kepada pengguna khusus yang akan digunakan oleh proses PDT untuk autentikasi. Ini adalah strategi keamanan yang lebih baik bagi sebagian besar organisasi.
  • Untuk database seperti Snowflake, proses PDT dapat diarahkan ke hardware yang lebih canggih yang tidak digunakan bersama dengan pengguna Looker lainnya. Dengan cara ini, PDT dapat dibuat dengan cepat tanpa menimbulkan biaya menjalankan hardware mahal secara penuh.

Misalnya, pada koneksi tempat kolom nama pengguna dan sandi ditetapkan ke atribut pengguna, bagian Penggantian PDT dapat membuat pengguna terpisah (pdt_user) dengan sandinya sendiri. Dengan konfigurasi ini, hal berikut akan terjadi:

  • Setiap pengguna dapat mengakses database menggunakan kredensial masing-masing yang ditetapkan oleh atribut pengguna mereka.
  • Akun pdt_user akan digunakan untuk semua proses PDT, dengan tingkat akses yang sesuai untuk pembuatan dan pembaruan PDT.
  • Traffic kueri pengguna dan traffic proses PDT dapat dibedakan dengan cepat untuk tujuan seperti pemantauan dengan Aktivitas Sistem.

Zona Waktu Database

Zona waktu tempat database Anda menyimpan informasi berbasis waktu. Looker perlu mengetahui hal ini agar dapat mengonversi nilai waktu untuk pengguna, sehingga memudahkan pemahaman dan penggunaan data berbasis waktu. Lihat halaman dokumentasi Menggunakan setelan zona waktu untuk mengetahui informasi selengkapnya.

Zona Waktu Kueri

Opsi Zona Waktu Kueri hanya terlihat jika Anda telah menonaktifkan Zona Waktu Khusus Pengguna.

Jika Zona Waktu Khusus Pengguna dinonaktifkan, Zona Waktu Kueri adalah zona waktu yang ditampilkan kepada pengguna saat mereka membuat kueri data berbasis waktu, dan zona waktu yang akan digunakan Looker untuk mengonversi data berbasis waktu dari Zona Waktu Database.

Lihat halaman dokumentasi Menggunakan setelan zona waktu untuk mengetahui informasi selengkapnya.

Luaskan bagian Detail Status untuk menguji setelan koneksi Anda.

Ulasan

Setelah memasukkan semua setelan koneksi database, Anda dapat meninjau dan menguji koneksi untuk memastikan konfigurasi sudah benar.

Anda dapat menguji setelan koneksi dari beberapa tempat di UI Looker:

  • Pilih tombol Uji di bagian Detail status di bagian bawah halaman Setelan Koneksi.
  • Pilih tombol Uji berdasarkan listingan koneksi di halaman Admin Koneksi, seperti yang dijelaskan di halaman dokumentasi Koneksi.

Jika Looker menampilkan Dapat Terhubung, tekan Hubungkan untuk membuat koneksi. Koneksi database Anda kemudian ditambahkan ke daftar di halaman Connections Admin Looker.

Jika Anda telah menyetel satu atau beberapa nilai parameter koneksi ke atribut pengguna, opsi Uji sebagai Pengguna akan muncul. Pilih pengguna, lalu klik Uji untuk memverifikasi bahwa database dapat terhubung dan menjalankan kueri sebagai pengguna ini.

Pemecahan masalah

Jika koneksi Anda tidak lulus satu atau beberapa pengujian, perhatikan hal berikut:

  • Jika Anda menjalankan Mongo versi 3.6 atau yang lebih lama di Atlas dan mengalami kegagalan link komunikasi, lihat halaman dokumentasi Mongo Connector.
  • Untuk menerima pesan koneksi yang berhasil terkait skema sementara dan PDT, Anda harus mengizinkan fungsi tersebut saat menyiapkan database Looker. Petunjuk untuk melakukannya dapat ditemukan di halaman dokumentasi Petunjuk konfigurasi database.
  • Koneksi database yang menggunakan OAuth, seperti Snowflake dan Google BigQuery, memerlukan login pengguna. Jika Anda tidak login ke akun pengguna OAuth saat menguji salah satu koneksi ini, Looker akan menampilkan peringatan dengan link Login. Klik link untuk memasukkan kredensial OAuth Anda atau untuk mengizinkan Looker mengakses informasi akun OAuth Anda.
  • Untuk instance Looker yang dihosting oleh pelanggan, lihat halaman dokumentasi Menguji konektivitas database untuk instance yang dihosting oleh pelanggan untuk mengetahui tips pemecahan masalah.

Langkah berikutnya

Setelah menghubungkan database ke Looker, Anda siap mengonfigurasi opsi login untuk pengguna.