Menghubungkan Looker ke database Anda menggunakan alur kerja yang ditingkatkan

Setelah mengamankan dan mengonfigurasi database, Anda siap untuk menghubungkan database ke Looker. Jika fitur Labs Penyiapan Koneksi Database Baru diaktifkan, halaman Tambahkan/Edit Koneksi akan memiliki UI yang diperbarui, kemampuan pengujian koneksi dan validasi yang ditingkatkan, dokumentasi yang diperluas termasuk referensi khusus cloud, dan ringkasan konfigurasi yang komprehensif.

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

  • Pilih Connections dari bagian Database di panel Admin. Di halaman Koneksi, klik tombol Tambahkan Koneksi.
  • Klik tombol Buat di menu navigasi utama, lalu pilih item menu Koneksi.

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

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

Setelah memasukkan setelan koneksi database, Anda dapat menguji koneksi untuk memastikan koneksi tersebut dikonfigurasi dengan benar. Lihat halaman dokumentasi Menguji konektivitas database untuk mengetahui informasi pemecahan masalah. Jika Looker menampilkan Dapat Terhubung, tekan Hubungkan untuk membuat koneksi. Koneksi database Anda kemudian akan ditambahkan ke daftar di halaman Koneksi Admin Looker.

Penyiapan Koneksi Database memiliki empat bagian berikut:

Setelan umum

Nama

Nama koneksi yang ingin Anda rujuk. Anda memerlukan nama koneksi database ini untuk digunakan dalam parameter connection model LookML. 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 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 dalam SQL dengan benar.

Ruang lingkup project

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 di project tersebut.
  • Project Terpilih: Hanya satu project LookML di instance yang dapat memiliki akses ke koneksi. Saat Anda memilih opsi ini, layar Koneksi 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 Server SSH hanya tersedia jika instance di-deploy di infrastruktur Kubernetes, dan hanya jika kemampuan untuk menambahkan informasi konfigurasi server SSH ke instance Looker Anda telah diaktifkan. Jika opsi ini tidak diaktifkan di instance Looker dan Anda ingin mengaktifkannya, hubungi spesialis penjualan Google Cloud atau buka permintaan dukungan. Jika Anda mengaktifkan opsi Aktifkan Server SSH, Looker akan menampilkan kolom Server SSH dan Tunnel SSH.

Server SSH

Server SSH akan otomatis memilih port localhost untuk Anda, dan Anda tidak dapat menentukan port localhost. 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. Server SSH baru dapat dibuat di tab Server SSH di panel Koneksi.

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 yang harus digunakan Looker untuk terhubung ke host database Anda.

Jika Anda bekerja sama dengan analis Looker untuk mengonfigurasi tunnel SSH ke database, masukkan "localhost" di kolom Host. Jika Anda menerapkan atribut pengguna ke kolom Host, atribut pengguna tidak boleh memiliki tingkat akses pengguna yang ditetapkan ke Dapat diedit. Jika 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, 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 Manual Entry dan masukkan nomor port ke kolom Custom Local Port. Pastikan port lokal tersedia di instance Anda.

ID Project Penagihan (khusus Google BigQuery)

Billing Project ID adalah project ID Google Cloud. 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 di project Google Cloud lain jika developer LookML menentukan nama tabel yang dicakup sepenuhnya dalam parameter sql_table_name dari tampilan, Jelajah, atau gabungan LookML. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Google BigQuery.

Set Data Utama (khusus Google BigQuery)

Nama set data yang Anda inginkan sebagai setelan 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 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 di sebagian besar 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 ingin Anda gunakan Looker untuk mengakses database:

  • 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 mengautentikasi ke database Anda.

Saat Anda menggunakan OAuth, pengguna diwajibkan untuk login ke database Anda untuk membuat kueri dari Looker. Untuk 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 pada 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, database Anda mungkin akan kelebihan beban. Jika nilainya terlalu rendah, kueri harus berbagi koneksi dalam jumlah kecil. Dengan demikian, banyak kueri mungkin 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 maksimum koneksi yang akan diterima. Jika konfigurasi database Anda membatasi koneksi, pastikan nilai Koneksi Maksimal per node sama dengan atau lebih rendah dari batas database Anda.

Waktu Tunggu Kumpulan Koneksi Habis

Jika pengguna Anda meminta lebih banyak koneksi daripada setelan Koneksi Maksimal per node, permintaan akan menunggu koneksi lain selesai sebelum dieksekusi. Jumlah waktu maksimum yang akan ditunggu permintaan dikonfigurasi di sini. Setelan default-nya adalah 120 detik.

Anda harus menetapkan nilai ini dengan cermat. Jika terlalu rendah, pengguna mungkin mendapati kuerinya dibatalkan karena tidak ada cukup waktu untuk menyelesaikan kueri pengguna lain. Jika terlalu tinggi, kueri dalam jumlah besar dapat menumpuk, sehingga pengguna harus menunggu dalam waktu yang sangat lama. Nilai default biasanya merupakan titik awal yang wajar.

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']. Contoh:

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

Jadwal Pemeliharaan

Pembuat ulang Looker memeriksa datagroup dan tabel yang dipertahankan (baik tabel agregat maupun tabel turunan persisten) yang didasarkan pada sql_trigger_value. Berdasarkan pemeriksaan ini, generator ulang Looker akan mem-build 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 yang dipertahankan 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.

Lima menit default juga merupakan interval yang paling sering didukung untuk Jadwal Pemeliharaan. Looker tidak menerapkan interval maksimum untuk Jadwal Pemeliharaan, yang berarti Anda dapat memperpanjang interval antara siklus regenerator Looker selama yang dapat ditentukan oleh ekspresi cron. Perlu diingat bahwa siklus generator ulang Looker yang lebih lama dapat berdampak negatif pada keaktualan data di cache dan tabel persisten Anda.

Setelah regenerator Looker menyelesaikan semua pemeriksaan dan membangun ulang PDT dalam 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 mem-build ulang tabel, seperti yang dijelaskan di bagian Pertimbangan penting untuk menerapkan tabel yang dipertahankan di halaman Tabel turunan di Looker.

Jika database Anda tidak aktif 24/7, sebaiknya batasi pemeriksaan ke waktu saat database aktif. Berikut adalah 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 buka, 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 di-build, 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 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 aman.

Memverifikasi 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 masih digunakan pada koneksi, tetapi verifikasi koneksi SSL tidak diperlukan, sehingga koneksi dapat dibuat saat CA tidak ada dalam daftar sumber tepercaya klien.

Menyimpan tabel dan kolom dalam cache

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 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 tables and columns untuk menonaktifkan pramuat SQL Runner untuk koneksi.

Mengambil dan meng-cache skema

Untuk beberapa fitur penulisan SQL seperti kesadaran gabungan, 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 yang menggunakan Hadoop Distributed File System (HDFS), pengambilan skema informasi mungkin memerlukan waktu yang cukup lama sehingga memengaruhi performa kueri Looker Anda secara signifikan. Jika mengetahui bahwa skema informasi lambat, Anda dapat menonaktifkan opsi Ambil dan simpan skema dalam cache untuk koneksi Anda. Menonaktifkan fitur ini akan mencegah beberapa pengoptimalan Looker SQL 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 informasi selengkapnya.

Penggabungan Koneksi Database

Untuk dialek yang mendukung penggabungan koneksi database, fitur ini memungkinkan Looker menggunakan kumpulan koneksi melalui driver JDBC. Pengelompokan 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 pengumpulan koneksi memastikan bahwa koneksi dibersihkan setelah eksekusi kueri dan tersedia untuk digunakan kembali setelah eksekusi kueri berakhir. Lihat halaman dokumentasi Penumpukan 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 persistent derived tables. Jika PDT diaktifkan, jendela Connection akan menampilkan kolom PDT tambahan dan bagian PDT Overrides. 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 ingin menghentikan grup data agar tidak menjalankan kueri sql_trigger terhadap database, Anda harus menghapus atau mengomentari parameter datagroup dari project LookML, atau Anda dapat memperbarui setelan Jadwal Pemeliharaan PDT dan Grup Data untuk koneksi sehingga 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 guna mempertahankan sistem pendaftaran PDT-nya.

Database Sementara

Meskipun berlabel 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 Petunjuk konfigurasi database, pilih dialek database Anda untuk melihat petunjuk dialek tersebut.

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

Jumlah Maksimum Koneksi Builder PDT

Setelan Max Number of PDT Builder Connections memungkinkan Anda menentukan jumlah pembuatan tabel serentak yang dapat dimulai oleh regenerator Looker pada koneksi database Anda. Setelan Max Number of PDT Builder Connections hanya berlaku untuk jenis tabel yang akan di-rebuild oleh regenerator Looker:

  • Tabel dengan persistensi pemicu (tabel turunan persisten dan tabel gabungan yang menggunakan strategi persistensi datagroup_trigger atau sql_trigger_value).
  • Tabel yang dipertahankan 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, generator ulang Looker akan membuat ulang tabel persist_for, karena tabel tersebut diperlukan untuk membuat ulang tabel lain dalam cascade. Jika tidak, generator ulang tidak akan memulai build untuk tabel persist_for.

Setelan Max Number of PDT Builder Connections ditetapkan secara default ke 1, tetapi dapat ditetapkan hingga 10. Namun, nilai 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, database Anda mungkin akan kelebihan beban. Jika nilainya rendah, PDT yang berjalan lama atau tabel agregat dapat menunda pembuatan tabel persisten lainnya atau memperlambat kueri lain pada koneksi. Database yang mendukung multi-tenancy — seperti BigQuery, Snowflake, dan Redshift — mungkin memiliki performa yang lebih baik dalam menangani build kueri paralel.

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

Perhatikan hal-hal berikut tentang setelan Max Number of PDT Builder Connections:

  • Setelan Max Number of PDT Builder Connections hanya berlaku untuk koneksi yang diperlukan untuk mem-build 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, generator ulang hanya berjalan di node utama. Setelan Max Number of PDT Builder Connections hanya berlaku untuk node utama, sehingga menetapkan batas untuk seluruh cluster.
  • Setelan Jumlah Koneksi Builder PDT Maksimum tidak berlaku untuk jenis tabel berikut. Jenis tabel ini dibuat secara berurutan:
    • Tabel dipertahankan melalui parameter persist_for (kecuali jika tabel 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 lainnya dalam cascade dependensi. Tabel tidak dapat di-build pada saat yang sama dengan tabel yang menjadi dependensinya. Misalnya, jika table_B bergantung pada table_A, table_A harus selesai mem-build ulang sebelum table_B dapat mulai mem-build ulang.

Mencoba ulang build PDT yang gagal

Tombol Coba ulang build PDT yang gagal mengonfigurasi cara regenerator Looker mencoba mem-build ulang tabel yang dipertahankan pemicu yang gagal dalam siklus regenerator sebelumnya. Regenerator Looker adalah proses yang mem-build ulang tabel yang dipertahankan pemicu (PDT dan tabel gabungan) sesuai dengan interval yang dikonfigurasi di setelan koneksi Jadwal Pemeliharaan. Jika tombol Retry Failed PDT Builds diaktifkan, generator ulang Looker akan mencoba mem-build ulang PDT yang gagal dalam siklus generator ulang sebelumnya, meskipun kondisi pemicu PDT tidak terpenuhi. Jika setelan ini dinonaktifkan, generator ulang Looker akan mencoba membuat ulang PDT yang sebelumnya gagal hanya jika kondisi pemicu PDT terpenuhi. Coba Lagi Build PDT yang Gagal dinonaktifkan secara default.

Lihat halaman dokumentasi Tabel turunan di Looker untuk informasi selengkapnya tentang generator ulang Looker.

Kontrol PDT API

Tombol Kontrol PDT API menentukan apakah panggilan API start_pdt_build, check_pdt_build, dan stop_pdt_build dapat digunakan untuk koneksi ini. Jika tombol Kontrol PDT API dinonaktifkan, panggilan API ini akan gagal saat mereferensikan PDT pada koneksi ini. Tombol Kontrol PDT API 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 bagian Penggantian PDT. Di bagian Penggantian PDT, 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 diautentikasi 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 di-build dengan cepat tanpa menimbulkan biaya untuk menjalankan hardware mahal secara penuh waktu.

Misalnya, pada koneksi dengan 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 seperti 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 dengan cepat dibedakan 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 mempermudah 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 tempat Looker akan 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

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

  • Pilih tombol Test di bagian bawah halaman Connections Settings.
  • Pilih tombol Test di samping listingan koneksi di halaman Connections Admin, seperti yang dijelaskan di halaman dokumentasi Connections.
  • Pilih tombol Tinjau di bagian bawah setiap langkah penyiapan koneksi. Tinjau dan ubah detail koneksi yang Anda masukkan di bagian sebelumnya di bagian Tinjau. Luaskan bagian Status Details untuk menguji setelan koneksi Anda. Klik ikon edit di samping setiap bagian untuk kembali ke bagian tersebut guna mengubah setelan Anda.

Jika koneksi Anda tidak lulus satu atau beberapa pengujian, berikut beberapa opsi pemecahan masalah:

  • Coba beberapa langkah pemecahan masalah di halaman dokumentasi Menguji konektivitas database.
  • 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 atau mengizinkan Looker mengakses informasi akun OAuth Anda.

Jika Anda masih mengalami masalah, hubungi Dukungan Looker untuk mendapatkan bantuan.

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

Langkah berikutnya

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