Menghubungkan Looker ke database Anda

Setelah mengamankan dan mengonfigurasi database, Anda siap menghubungkan database ke Looker.

Anda membuat koneksi database di Looker di halaman Connect your database to Looker. Ada dua opsi untuk membuka halaman Connect your database to Looker:

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

Halaman ini menjelaskan kolom umum yang ditampilkan Looker di halaman Connect your database to Looker. Kolom persis yang ditampilkan halaman bergantung pada setelan dialek Anda.

Untuk mengetahui informasi tentang cara menerapkan atribut pengguna ke setelan koneksi, lihat bagian Connections di halaman dokumentasi User Attributes.

Penyiapan Koneksi Database menampilkan empat bagian berikut:

Setelan umum

Nama

Nama koneksi yang ingin Anda gunakan untuk merujuknya. Anda memerlukan nama koneksi database ini untuk digunakan dalam parameter connection model LookML Anda. Nama koneksi database juga merupakan cara koneksi diidentifikasi di halaman Admin Connections di Looker. Jangan gunakan nama folder apa pun untuk setelan ini. Nilai ini tidak perlu 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 mendapatkan opsi koneksi yang tepat, dan agar Looker dapat menerjemahkan LookML Anda ke SQL dengan benar.

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 Use the latest driver version untuk memilih versi driver JDBC yang lebih lama untuk koneksi tersebut. Jika ingin memilih versi driver JDBC yang lebih lama, Anda dapat menonaktifkan tombol Use the latest driver version untuk koneksi Anda, lalu memilih versi driver dari menu pull-down Driver Version.

Jika Anda memilih versi driver JDBC yang lebih lama, Looker akan terus menggunakan versi 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 Driver Version pada halaman Edit your database connection untuk memberi tahu Anda bahwa versi driver yang dipilih tidak lagi didukung. Notifikasi juga akan memberi tahu Anda versi driver yang digunakan Looker untuk koneksi. Untuk menghapus pemberitahuan ini, pilih versi driver JDBC yang didukung dari menu pull-down Driver Version atau aktifkan tombol Use the latest driver version untuk menggunakan versi driver terbaru.

Ruang lingkup proyek

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

  • All Projects: Semua project LookML di instance dapat memiliki akses ke koneksi, sehingga nama koneksi dapat ditentukan dalam parameter connection file model dalam project tersebut.
  • Selected Project: 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 dengan izin berikut untuk mendelegasikan pengelolaan koneksi dan konfigurasi model:

Detail status

Luaskan bagian Status Details untuk menguji setelan koneksi Anda.

Setelan Database

Mengaktifkan Server SSH

Opsi SSH Server 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 Enable SSH Server, 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 Create New Tunnel jika Anda ingin membuat tunnel SSH baru dengan hostname dan Port atau Local port.

Hostname

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

Jika Anda bekerja sama dengan analis Looker untuk mengonfigurasi tunnel SSH ke database, 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, di kolom Port, masukkan nomor port yang mengalihkan ke database Anda, yang seharusnya diberikan oleh analis Looker.

Port Lokal

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

ID Project Penagihan (khusus Google BigQuery)

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

ID Project Penyimpanan (khusus Google BigQuery)

Nama Storage Project ID Anda, jika Anda memisahkan komputasi dan penyimpanan dalam project terpisah. Anda dapat mengkueri set data di project Google Cloud yang berbeda jika developer LookML Anda menentukan nama tabel yang tercakup sepenuhnya dalam parameter sql_table_name dari tabel virtual, Explore, atau gabungan LookML Anda. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Google BigQuery.

Set Data Utama (khusus Google BigQuery)

Nama set data yang ingin Anda jadikan default Looker saat membuat kueri database. 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 berisi database bernama sales_info. Anda akan memasukkan sales_info di kolom ini. Jika Anda memiliki beberapa database di host yang sama, Anda mungkin perlu membuat beberapa koneksi untuk menggunakannya (kecuali untuk MySQL, yang menggunakan kata database dengan arti yang sedikit berbeda dari kebanyakan dialek SQL).

Skema Default

Skema default yang digunakan Looker jika 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 Anda inginkan untuk digunakan Looker dalam 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 yang akan digunakan Looker untuk melakukan autentikasi ke database Anda.

Saat Anda menggunakan OAuth, pengguna harus login ke database Anda untuk mengeluarkan kueri dari Looker. Saat pengguna memulai alur otorisasi OAuth di Looker, Looker akan menampilkan dialog Authorize OAuth Connection yang memberi tahu mereka bahwa mengizinkan koneksi akan memungkinkan instance Looker mengakses data atas nama mereka, dan bahwa pengguna Looker dengan hak istimewa, seperti administrator atau developer, mungkin memiliki visibilitas ke data mereka. Pengguna harus memilih Authorize untuk melanjutkan ke halaman login OAuth. Informasi izin disimpan di penyimpanan lokal browser; jika penyimpanan lokal dihapus, dialog akan muncul lagi saat pengguna memulai alur otorisasi OAuth berikutnya. 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 Status Details 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 Anda. 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 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 koneksi maksimum yang akan diterima. Jika konfigurasi database Anda membatasi koneksi, pastikan nilai Max Connections per node sama dengan atau lebih rendah dari batas database Anda.

Waktu Tunggu Kumpulan Koneksi

Jika pengguna Anda meminta lebih banyak koneksi daripada yang dikonfigurasi untuk setelan Max Connections per node, permintaan tersebut akan menunggu permintaan lain selesai sebelum dieksekusi. Durasi maksimum permintaan akan menunggu dikonfigurasi di sini. Setelan default-nya adalah 120 detik.

Tetapkan nilai ini dengan cermat. Jika disetel terlalu rendah, pengguna mungkin mendapati kueri mereka dibatalkan karena tidak ada cukup waktu untuk menyelesaikan kueri pengguna lain. Jika ditetapkan terlalu tinggi, sejumlah besar kueri dapat menumpuk, sehingga menyebabkan pengguna 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 lebih banyak permintaan serentak yang masuk dan memerlukan koneksi yang sama, Looker akan mengantrekannya secara internal dan memprosesnya secara berurutan. Menetapkan nilai ini akan menimpa nilai Koneksi maksimum per node yang ada.

Kueri serentak maksimum 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 lebih banyak permintaan serentak yang masuk dan memerlukan koneksi yang sama, Looker akan mengantrekannya secara internal dan memprosesnya secara berurutan. Nilai default ditetapkan oleh dialek database Anda, dan biasanya adalah 25.

Setelan Max concurrent queries per user for this connection berlaku untuk koneksi individual yang ditetapkan. Setelan ini menggantikan opsi startup per-user-query-limit tingkat instance untuk koneksi.

Karena setelan Max concurrent queries per user for this connection menggantikan setelan per-user-query-limit, penting untuk memahami perbedaan setelan ini:

  • Setelan Max concurrent queries per user for this connection berlaku per pengguna dan per koneksi, tetapi TIDAK per node. Setelan Max concurrent queries per user for this connection berlaku untuk kueri serentak pengguna untuk koneksi di seluruh instance Looker. Untuk instance Looker yang dikelompokkan, nilai yang Anda tetapkan untuk Max concurrent queries per user for this connection dibagi dengan jumlah node dalam cluster Looker Anda untuk menentukan jumlah kueri serentak yang dapat dijalankan pengguna di setiap node.

    Misalnya, jika Anda memiliki cluster 5 node dan menetapkan nilai ini ke 15, setiap node akan mengizinkan 3 kueri serentak per pengguna untuk koneksi ini (15 / 5 = 3), dengan total 15 kueri di semua node.

  • Opsi startup per-user-query-limit berlaku per pengguna, per koneksi, dan per node.

    Misalnya, jika Anda memiliki cluster 5 node dengan per-user-query-limit 15, setiap node akan mengizinkan 15 kueri serentak per pengguna untuk koneksi ini, sehingga totalnya adalah 75 kueri di semua node (15 * 5 = 75).

Oleh karena itu, untuk instance Looker yang dikelompokkan, menerapkan nilai untuk Max concurrent queries per user for this connection dapat memengaruhi performa kueri bagi pengguna Anda.

Parameter JDBC tambahan

Driver Java Database Connectivity (JDBC) adalah komponen software yang mengelola koneksi antara Looker dan database Anda.

Saat driver JDBC untuk database Anda memulai koneksi dari Looker ke database, driver akan membuat URL dengan serangkaian parameter, seperti host, port, database atau warehouse, dan parameter tambahan khusus dialek. Saat menyiapkan koneksi untuk database, Anda dapat menentukan parameter JDBC tambahan yang harus disertakan Looker saat berkomunikasi dengan driver database Anda. Bergantung pada dialek dan parameter spesifik Anda, parameter JDBC dapat diproses oleh driver JDBC atau dapat diteruskan ke database Anda.

Agar koneksi Anda tetap aman, Looker memiliki daftar yang diizinkan untuk parameter JDBC yang didukung untuk setiap dialek database.

  • Jika Anda mencoba membuat atau memperbarui koneksi menggunakan parameter JDBC yang tidak didukung, Looker akan menampilkan pesan error yang menunjukkan parameter yang tidak diizinkan.
  • Jika Anda memiliki koneksi yang sudah ada dengan parameter JDBC yang tidak didukung, Looker akan menghapus parameter tersebut, lalu terhubung ke database Anda.

Untuk mengetahui daftar parameter JDBC yang didukung untuk dialek Anda, lihat bagian "Parameter JDBC yang didukung" di halaman petunjuk konfigurasi database untuk dialek Anda.

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 (tabel gabungan dan tabel turunan persisten) yang didasarkan pada sql_trigger_value. Berdasarkan pemeriksaan ini, regenerator Looker akan mem-build ulang atau menghapus tabel persisten dari skema dasar database Anda.

Nilai Maintenance Schedule 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 berlangsung pada interval cron berikutnya, regenerator Looker akan menyelesaikan siklus regenerator yang sedang berlangsung, 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 Maintenance Schedule, yang berarti Anda dapat memperpanjang interval antara siklus regenerator Looker selama yang dapat ditentukan oleh ekspresi cron. Perlu diingat bahwa siklus regenerator Looker yang lebih lama dapat berdampak buruk pada keaktualan data di cache dan tabel persisten Anda.

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

Jika database Anda tidak aktif 24/7, sebaiknya batasi pemeriksaan pada waktu database aktif. Berikut beberapa ekspresi cron tambahan:

Ekspresi cron Definisi
*/5 8-17 * * MON-FRI Memeriksa 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 kerja, setiap hari
0 8-17 * * MON-FRI Memeriksa 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 kapan pemeriksaan dilakukan.
  • Jika PDT tidak dibuat, reset string cron kembali ke default */5 * * * *.

Berikut adalah beberapa referensi untuk membantu membuat string cron:

Menonaktifkan Koneksi

Opsi Disable Connection memungkinkan admin Looker menonaktifkan koneksi untuk sementara jika ada masalah downstream dengan database, alih-alih menghentikan kueri secara manual atau membiarkan kueri tetap berada dalam antrean kueri.

Jika tombol Disable Connection diaktifkan, Looker tidak akan mengirim kueri apa pun ke database, melainkan menampilkan pesan error kepada pengguna bahwa koneksi dinonaktifkan.

Setelah masalah database diselesaikan, admin Looker dapat menonaktifkan tombol Disable Connection. Setelah koneksi diaktifkan kembali, semua kueri akan berfungsi kembali seperti yang diharapkan.

SSL

Pilih apakah Anda ingin menggunakan enkripsi SSL untuk melindungi data saat data tersebut diteruskan 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 precache tabel dan kolom

Di SQL Runner, semua informasi tabel dimuat sebelumnya segera setelah Anda memilih koneksi dan skema. Hal ini memungkinkan SQL Runner 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 melakukan pra-pemuatan semua informasi.

Jika Anda ingin SQL Runner memuat informasi tabel hanya saat tabel dipilih, Anda dapat membatalkan pilihan opsi Precache tables and columns untuk menonaktifkan pra-pemuatan SQL Runner untuk koneksi.

Mengambil dan meng-cache skema

Untuk beberapa fitur penulisan SQL seperti aggregate awareness, Looker menggunakan skema informasi database Anda untuk mengoptimalkan penulisan SQL. Jika skema informasi tidak di-cache, Looker mungkin harus sesekali memblokir penulisan SQL ke database agar dapat mengambil skema informasi. Untuk dialek Denodo atau dialek yang menggunakan Hadoop Distributed File System (HDFS), pengambilan skema informasi mungkin memerlukan waktu yang cukup lama untuk memengaruhi performa kueri Looker Anda secara signifikan. Jika Anda tahu bahwa skema informasi Anda lambat, Anda dapat menonaktifkan opsi Fetch and cache schema untuk koneksi Anda. Menonaktifkan fitur ini akan mencegah beberapa pengoptimalan SQL Looker untuk fitur tertentu, jadi Anda harus mengaktifkan opsi Fetch and cache schema kecuali jika Anda tahu bahwa skema informasi koneksi Anda sangat lambat.

Estimasi Biaya

Tombol Cost Estimate hanya berlaku untuk koneksi database berikut:

Tombol Cost Estimate 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 Enable PDTs untuk mengaktifkan tabel turunan persisten. Jika PDT diaktifkan, jendela Connection akan menampilkan kolom PDT tambahan dan bagian PDT Overrides. Looker menampilkan tombol Enable PDTs hanya jika dialek database mendukung penggunaan PDT.

Perhatikan hal-hal berikut terkait PDT:

  • PDT tidak didukung untuk koneksi Snowflake yang menggunakan OAuth.
  • Menonaktifkan PDT pada koneksi tidak akan menonaktifkan datagroup 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 menjadikan parameter datagroup sebagai komentar dari project LookML, atau Anda dapat memperbarui setelan Maintenance Schedule untuk koneksi sehingga Looker sangat 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 mengelola sistem pendaftaran PDT-nya.

Database Sementara

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

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

Jumlah Maksimum Koneksi PDT Builder

Setelan Max Number of PDT Builder Connections memungkinkan Anda menentukan jumlah build tabel serentak yang dapat dimulai oleh regenerator Looker pada koneksi database Anda. Setelan Jumlah Maksimum Koneksi PDT Builder hanya berlaku untuk jenis tabel yang regenerator Looker-nya memulai pembangunan ulang:

  • 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 turunan 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 kaskade. Jika tidak, regenerator tidak akan memulai build untuk tabel persist_for.

Setelan Max Number of PDT Builder Connections ditetapkan secara default ke 1, tetapi dapat ditetapkan hingga 100. Namun, nilai tersebut tidak boleh lebih tinggi dari nilai yang ditetapkan di kolom Max connections 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 build kueri paralel.

Jika Anda ingin meningkatkan setelan Max Number of PDT Builder Connections, sebaiknya tingkatkan terlebih dahulu dengan penambahan 1. Jika terjadi perilaku yang tidak terduga, setel kembali ke default 1. Jika performa kueri tidak terpengaruh, Anda dapat terus menaikkannya secara bertahap sebesar 1 dan memverifikasi performa di setiap peningkatan sebelum menaikkan setelan lebih lanjut.

Perhatikan hal-hal berikut tentang setelan Jumlah Maksimum Koneksi PDT Builder:

  • Setelan Max Number of PDT Builder Connections 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 Max Number of PDT Builder Connections tidak berlaku.
  • Dalam instance Looker yang dikelompokkan, regenerator hanya berjalan di node utama. Setelan Max Number of PDT Builder Connections hanya berlaku untuk node utama, sehingga menetapkan batas untuk seluruh cluster.
  • Setelan Max Number of PDT Builder Connections 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 yang dibuat ulang dengan opsi Rebuild Derived Tables & Run.
    • Tabel yang satu bergantung pada tabel lain dalam cascade dependensi. Tabel tidak dapat dibuat bersamaan dengan tabel yang menjadi dependensinya. Misalnya, jika table_B bergantung pada table_A, table_A harus selesai di-build ulang sebelum table_B dapat mulai di-build ulang.

Mencoba lagi build PDT yang gagal

Tombol Retry failed PDT builds mengonfigurasi cara regenerator Looker mencoba membangun ulang tabel dengan pemicu persistensi yang gagal dalam siklus regenerator sebelumnya. Regenerator Looker adalah proses yang membangun ulang tabel dengan pemicu persistensi (PDT dan tabel gabungan) sesuai dengan interval yang dikonfigurasi dalam setelan koneksi Maintenance Schedule. Jika tombol Retry Failed PDT Builds 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. Retry Failed PDT Builds dinonaktifkan secara default.

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

Kontrol API PDT

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

Mengaktifkan Penggantian PDT

Jika database Anda mendukung tabel turunan persisten, dan Anda telah mengaktifkan tombol Enable PDTs di setelan koneksi, Looker akan menampilkan tombol PDT Overrides. Aktifkan tombol PDT Overrides untuk menampilkan bagian PDT Overrides, tempat Anda dapat memasukkan parameter JDBC terpisah (host, port, database, nama pengguna, sandi, skema, parameter tambahan, dan pernyataan setelah koneksi) yang khusus untuk proses PDT. Hal ini dapat berguna 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 Anda.
  • Proses PDT dapat melakukan autentikasi melalui pengguna database terpisah yang memiliki prioritas lebih tinggi. Dengan cara ini, 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 untuk sebagian besar organisasi.
  • Untuk database seperti Snowflake, proses PDT dapat dirutekan ke hardware yang lebih canggih yang tidak dibagikan kepada pengguna Looker lainnya. Dengan cara ini, PDT dapat dibangun dengan cepat tanpa menimbulkan biaya untuk menjalankan hardware mahal secara penuh.

Misalnya, pada koneksi yang kolom nama pengguna dan sandinya ditetapkan ke atribut pengguna, bagian PDT Overrides 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 bagi 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 mengkueri 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 Status Details untuk menguji setelan koneksi Anda.

Ulasan

Setelah memasukkan semua setelan koneksi database, Anda dapat meninjau dan menguji koneksi untuk memastikan bahwa koneksi tersebut dikonfigurasi dengan benar.

Menguji setelan koneksi Anda

Anda dapat menguji setelan koneksi dengan mengklik tombol Test Connection di bagian Status details di bagian bawah halaman Connections Settings.

Jika Looker menampilkan Can Connect, tekan Connect untuk membuat koneksi. Koneksi database Anda kemudian akan ditambahkan ke daftar di halaman Admin Connections Looker.

Admin dapat menguji koneksi kapan saja dengan mengklik tombol Test di samping listingan koneksi di halaman Connections Admin, seperti yang dijelaskan di halaman dokumentasi Connections.

Jika Anda telah menetapkan satu atau beberapa nilai parameter koneksi ke atribut pengguna, opsi Test as User akan muncul. Pilih pengguna, lalu klik Test 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, Google BigQuery, Trino, dan Databricks, memerlukan login pengguna. Jika Anda tidak login ke akun pengguna OAuth saat menguji salah satu koneksi ini, Looker akan menampilkan peringatan dengan link Log In. Klik link, pilih Authorize di dialog Authorize OAuth Connection jika diminta, dan masukkan kredensial OAuth Anda untuk mengizinkan Looker mengakses informasi akun OAuth Anda.
  • Untuk instance Looker yang dihosting pelanggan, lihat halaman dokumentasi Menguji konektivitas database untuk instance yang dihosting pelanggan guna mendapatkan tips pemecahan masalah.

Langkah berikutnya

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