Koneksi default BigQuery untuk Looker (Google Cloud core)

Looker (inti Google Cloud) harus terhubung ke database untuk mengaktifkan eksplorasi data. Koneksi BigQuery default yang dapat menggunakan Kredensial Default Aplikasi dapat dibuat menggunakan Koneksi Panduan Memulai BigQuery.

Sebelum memulai

Mengonfigurasi Koneksi Panduan Memulai BigQuery memerlukan izin berikut.

Izin Looker (Google Cloud core)

Anda dapat melihat dan mengedit halaman Koneksi Mulai Cepat BigQuery di halaman Beranda instance Looker (inti Google Cloud) jika memiliki salah satu izin berikut:

• Peran Admin Looker (Google Cloud core)
• Izin Looker (Google Cloud core) manage_project_connections

Izin BigQuery

Instance Looker (inti Google Cloud) dapat menggunakan Kredensial Default Aplikasi (ADC) untuk mengautentikasi saat Anda menyiapkan koneksi ke database SQL Standar BigQuery. Saat Anda menggunakan ADC, koneksi akan melakukan autentikasi ke database menggunakan kredensial akun layanan project Looker (inti Google Cloud).

Jika akun layanan Looker (inti Google Cloud) belum memiliki peran IAM di project yang berisi set data BigQuery, untuk memberikan peran IAM baru kepada agen layanan, Anda harus dapat mengubah kebijakan IAM di konsol Google Cloud menggunakan langkah-langkah berikut.

1. Login ke konsol Google Cloud dan buka project tempat Anda ingin memberikan peran baru.
2. Salin ID akun utama dan tambahkan sebagai akun utama di IAM.
3. Tetapkan kedua peran berikut ke akun utama yang Anda tambahkan:
   • Service Usage Consumer
   • BigQuery Jobs User

Jika instance Looker (inti Google Cloud) menggunakan tabel turunan persisten dengan set data BigQuery, Anda juga harus memberikan peran IAM BigQuery Data Editor ke akun layanan Looker (inti Google Cloud).

Mengonfigurasi Koneksi Panduan Memulai BigQuery

Koneksi Panduan Memulai BigQuery berisi bagian berikut.

• Billing Project ID
• Set Data Utama
• Setelan Opsional
• Ulasan

Melihat koneksi

Koneksi Mulai Cepat BigQuery dapat dilihat dan diedit oleh pengguna dengan izin yang benar, baik dari halaman Beranda maupun halaman Koneksi di panel Admin. Di halaman Koneksi, Koneksi Mulai Cepat BigQuery akan muncul dengan nama Koneksi BigQuery Default. Pada instance baru, kolom Storage project ID dan Billing project ID akan ditetapkan secara default ke None.

Dari halaman Beranda, klik tombol Tinjau koneksi untuk mengelola koneksi. Anda dapat menutup kartu halaman Beranda dengan mengklik x atau dengan mengalihkan opsi BigQuery Quick Start di sidebar Discover.

Koneksi Panduan Memulai BigQuery berisi bagian berikut.

• Billing Project ID
• Set Data Utama
• Setelan Opsional
• Ulasan

ID Project Penagihan

ID project berfungsi sebagai ID unik untuk project penagihan Google Cloud. Project penagihan adalah project Google Cloud yang ditagih, tetapi Anda tetap dapat membuat kueri set data di project Google Cloud lain jika developer LookML menentukan nama tabel dengan cakupan penuh dalam parameter sql_table_name dari tampilan, Jelajah, atau gabungan LookML. Kolom ini wajib diisi.

Untuk melakukan autentikasi ke database BigQuery menggunakan OAuth: Untuk koneksi BigQuery, Looker (inti Google Cloud) dapat otomatis menggunakan kredensial aplikasi OAuth yang digunakan admin Looker (inti Google Cloud) saat membuat instance. Lihat Membuat kredensial otorisasi OAuth untuk halaman instance Looker (Google Cloud core) untuk mengetahui informasi selengkapnya.

Luaskan bagian Status Details untuk menguji setelan koneksi Anda.

Set Data Utama

Halaman Set Data Utama berisi setelan berikut.

Project ID Storage

Jika Anda menggunakan project selain project BigQuery tempat Looker (inti Google Cloud) berada, masukkan Project ID Storage. Kolom ini wajib diisi.

Untuk menemukan Project ID Penyimpanan, ikuti langkah-langkah berikut:

1. Buka konsol Google Cloud.
2. Dari daftar project, pilih Semua. Nama dan ID untuk semua project yang Anda ikuti akan ditampilkan.
3. Salin ID Project Storage dari project yang berisi data yang ingin Anda hubungkan ke Looker (inti Google Cloud).

Set Data Utama

Set data utama adalah tempat BigQuery akan mencari tabel jika lokasinya tidak ditentukan dalam teks kueri SQL. Perhatikan bahwa kueri Looker (inti Google Cloud) dapat mereferensikan tabel dalam project atau set data apa pun, selama kueri menggunakan nama tabel dengan cakupan penuh dalam format project_id.dataset_name.table_name. Agen Layanan Looker (inti Google Cloud) juga memerlukan izin IAM yang sesuai untuk mengakses tabel di lokasi tersebut. Kolom ini wajib diisi.

Untuk mempelajari set data lebih lanjut, lihat halaman dokumentasi Menghubungkan Looker ke BigQuery.

Luaskan bagian Status Details untuk menguji setelan koneksi Anda.

Setelan Opsional

Bagian Setelan Opsional berisi opsi berikut:

• Koneksi Maksimum per Node: Jumlah maksimum koneksi ke database yang diizinkan sekaligus. Catatan: Setelan ini berlaku untuk setiap node dalam deployment Looker (Google Cloud core). Nilai harus antara 5 dan 100 dan dapat dibiarkan pada nilai default pada awalnya. Baca selengkapnya tentang setelan ini di bagian Koneksi maksimum per node di halaman dokumentasi Menghubungkan Looker ke database.

• Waktu Tunggu Kumpulan Koneksi: Jumlah detik yang akan ditunggu kueri sebelum waktu tunggu habis saat kumpulan koneksi penuh. Dapat dibiarkan pada nilai default pada awalnya. Baca selengkapnya tentang setelan ini di bagian Connection Pool Timeout di halaman dokumentasi Menghubungkan Looker ke database.

• Parameter JDBC Tambahan: Tambahkan parameter JDBC tambahan, seperti label BigQuery (lihat bagian Label tugas dan komentar konteks untuk koneksi BigQuery di halaman ini untuk mengetahui informasi selengkapnya).

• Jadwal Pemeliharaan: Ekspresi cron yang menunjukkan frekuensi maksimum pemeriksaan pemicu grup data dan pemeliharaan PDT. Baca selengkapnya tentang setelan ini dalam dokumentasi Jadwal Pemeliharaan Datagroup dan PDT.

• SSL: Pilih apakah Anda ingin menggunakan enkripsi SSL untuk melindungi data saat data tersebut diteruskan antara Looker (inti Google Cloud) 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.

• Verifikasi SSL: Pilih apakah Anda ingin mewajibkan verifikasi sertifikat SSL yang digunakan oleh koneksi. Baca selengkapnya tentang setelan ini di bagian Memverifikasi SSL di halaman dokumentasi Menghubungkan Looker ke database.

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

• Mengambil dan menyimpan skema dalam cache: Untuk beberapa fitur penulisan SQL seperti kesadaran gabungan, Looker (inti Google Cloud) menggunakan skema informasi database Anda untuk mengoptimalkan penulisan SQL. Baca selengkapnya tentang setelan ini di bagian Mengambil Skema Informasi untuk Penulisan SQL di halaman dokumentasi Menghubungkan Looker ke database Anda.

• Aktifkan PDT: Aktifkan tombol Aktifkan PDT untuk mengaktifkan tabel turunan persisten. Jika PDT diaktifkan, jendela Setelan Opsional akan menampilkan kolom PDT tambahan dan bagian Penggantian PDT.

• Database sementara: Masukkan set data di BigQuery tempat Looker (inti Google Cloud) akan membuat tabel turunan persisten. Anda harus mengonfigurasi set data ini terlebih dahulu, dengan izin tulis yang sesuai. Kolom ini wajib diisi untuk menggunakan PDT.

• Max Number of PDT Builder Connections: 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 Koneksi maksimum per node. Baca selengkapnya tentang setelan ini di bagian Jumlah Maksimal Koneksi Builder PDT di halaman dokumentasi Menghubungkan Looker ke database. 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.

• Coba ulang build PDT yang gagal: Tombol Coba ulang build PDT yang gagal mengonfigurasi cara regenerator Looker (inti Google Cloud) mencoba mem-build ulang tabel yang dipertahankan pemicu yang gagal dalam siklus regenerator sebelumnya. Baca selengkapnya tentang setelan ini di bagian Mencoba ulang build PDT yang gagal di halaman dokumentasi Menghubungkan Looker ke database.

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

• Penggantian PDT: Jika database Anda mendukung tabel turunan persisten, dan Anda telah mengaktifkan tombol Aktifkan PDT di setelan koneksi, Looker (inti Google Cloud) 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. Baca selengkapnya tentang setelan ini di bagian Penggantian PDT di halaman dokumentasi Menghubungkan Looker ke database.

• Zona Waktu Database: Zona waktu tempat database Anda menyimpan informasi berbasis waktu. Looker (inti Google Cloud) 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. Lihat halaman dokumentasi Menggunakan setelan zona waktu untuk mengetahui informasi selengkapnya.

Luaskan bagian Status Details untuk menguji setelan koneksi Anda.

Ulasan

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.

Menyimpan dan menguji koneksi

Klik tombol Save untuk menyimpan perubahan apa pun yang dilakukan pada Koneksi Mulai Cepat BigQuery.

Anda dapat menguji setelan koneksi dari beberapa tempat di UI Looker (Google Cloud core):

• Luaskan bagian Status Details di bagian bawah halaman Koneksi QuickStart, lalu klik Test Connection.
• Dari halaman Beranda, luaskan bagian Status Details di bagian bawah kartu QuickStart Connection, lalu klik Test Connection.
• Di halaman Admin Connections, pilih tombol Test di samping listingan koneksi, seperti yang dijelaskan di halaman dokumentasi Connections.

Setelah memasukkan setelan koneksi, klik Uji untuk memverifikasi bahwa informasi sudah benar dan database dapat terhubung.

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.
• Akses log instance Looker (Google Cloud core) Anda untuk melihat pesan error yang lebih mendetail.
• Hubungi dukungan untuk mendapatkan bantuan pemecahan masalah tambahan.

Langkah selanjutnya

• Mengelola pengguna dalam Looker (Google Cloud core)
• Mengelola instance Looker (Google Cloud core) dari konsol Google Cloud
• Setelan admin Looker (Google Cloud core)
• Menggunakan contoh project LookML di instance Looker (Google Cloud core)