Koneksi default BigQuery untuk Looker (Google Cloud core)

Looker (inti Google Cloud) harus terhubung ke database untuk mengaktifkan eksplorasi data. Koneksi default ke database SQL Standar BigQuery dapat dibuat menggunakan Koneksi Mulai Cepat BigQuery.

Sebelum memulai

Mengonfigurasi Koneksi Mulai Cepat BigQuery memerlukan izin berikut.

Izin Looker

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

• Peran Admin Looker
• Izin Looker manage_project_connections

Izin IAM

Instance Looker (inti Google Cloud) dapat menggunakan Kredensial Default Aplikasi (ADC) untuk mengautentikasi saat Anda menyiapkan koneksi ke BigQuery. Saat Anda menggunakan ADC, koneksi akan melakukan autentikasi ke database menggunakan kredensial akun layanan Looker (inti Google Cloud). Akun layanan harus memiliki izin IAM berikut untuk mengakses set data BigQuery:

• Untuk project yang berisi set data BigQuery, akun layanan Looker harus memiliki peran IAM berikut:

  • Pelanggan Service Usage (roles/serviceusage.serviceUsageConsumer)
  • BigQuery Job User (roles/bigquery.jobUser)

  • BigQuery Data Editor (roles/bigquery.dataEditor), atau izin IAM berikut:

    • bigquery.config.get
    • bigquery.datasets.create
    • bigquery.datasets.get
    • bigquery.tables.create
    • bigquery.tables.get
    Catatan: Jika instance Looker (inti Google Cloud) Anda menggunakan tabel turunan persisten dengan set data BigQuery, akun layanan harus memiliki peran BigQuery Data Editor, bukan izin individual yang tercantum di sini.

• Untuk project penagihan, akun layanan Looker harus memiliki peran IAM berikut:

  • Pelanggan Service Usage (roles/serviceusage.serviceUsageConsumer)
  • BigQuery Job User (roles/bigquery.jobUser)

Jika akun layanan Looker (inti Google Cloud) belum memiliki peran IAM yang diperlukan, gunakan alamat email akun layanan saat memberikan peran di project tersebut. Untuk menemukan alamat email akun layanan, buka halaman IAM di konsol Google Cloud dan centang kotak Sertakan pemberian peran yang disediakan Google. Email akan memiliki format service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Gunakan email tersebut untuk memberikan peran yang sesuai ke akun layanan.

Mengonfigurasi Koneksi Mulai Cepat BigQuery

Koneksi BigQuery QuickStart dapat dilihat dan diedit oleh pengguna yang memiliki izin yang benar dari halaman Beranda atau dari 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 BigQuery QuickStart berisi bagian berikut:

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

ID Project Penagihan

Project ID berfungsi sebagai ID unik untuk Google Cloud project penagihan. Project penagihan adalah Google Cloud project yang ditagih untuk penggunaan BigQuery, tetapi Anda tetap 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, Jelajahi, 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

Di kolom Storage Project ID, masukkan project ID untuk project yang berisi set data BigQuery yang ingin Anda hubungkan, meskipun project tersebut sama dengan project yang berisi instance Looker (Google Cloud core). Kolom ini wajib diisi.

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. Akun 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). Nilainya 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 yang 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 lagi 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

Untuk menyimpan perubahan apa pun yang dilakukan pada Koneksi QuickStart BigQuery, klik Simpan.

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 berikutnya

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