Google BigQuery

Ringkasan

Halaman ini menjelaskan cara menyiapkan koneksi di Looker ke SQL Standar Google BigQuery atau SQL Lama Google BigQuery.

Langkah-langkah umum untuk menyiapkan koneksi SQL Standar Google BigQuery atau Google BigQuery Legacy SQL adalah sebagai berikut:

  1. Di database BigQuery, konfigurasikan autentikasi yang akan digunakan Looker untuk mengakses database BigQuery Anda. Looker mendukung opsi autentikasi berikut untuk BigQuery:

  2. Di database BigQuery, jika Anda ingin menggunakan tabel turunan persisten (PDT) di koneksi, buat set data sementara yang dapat digunakan Looker untuk membuat PDT di database Anda. Lihat bagian Membuat set data sementara untuk tabel turunan persisten di halaman ini untuk mengetahui prosedurnya.

  3. Di Looker, siapkan koneksi Looker ke database BigQuery Anda. Lihat bagian Menghubungkan Looker ke BigQuery di halaman ini untuk mengetahui prosedurnya.

  4. Di Looker, uji koneksi antara Looker dan database BigQuery Anda. Lihat bagian Menguji koneksi di halaman ini untuk mengetahui prosedurnya.

Mengenkripsi lalu lintas jaringan

Praktik terbaiknya adalah mengenkripsi traffic jaringan antara aplikasi Looker dan database Anda. Pertimbangkan salah satu opsi yang dijelaskan di halaman dokumentasi Mengaktifkan akses database yang aman.

Autentikasi dengan akun layanan BigQuery

Salah satu cara Looker dapat melakukan autentikasi ke dalam database BigQuery adalah dengan akun layanan BigQuery. Anda membuat akun layanan di database BigQuery menggunakan Pengelola API di Konsol Google Cloud. Anda harus memiliki izin administrator Google Cloud untuk membuat akun layanan. Lihat dokumentasi tentang cara membuat akun layanan dan membuat kunci pribadi.

Membuat akun layanan dan mendownload sertifikat kredensial JSON

Untuk membuat akun layanan BigQuery, ikuti langkah-langkah berikut:

  1. Buka halaman kredensial di Pengelola API di konsol Google Cloud dan pilih project Anda.

  2. Pilih BUAT KREDENSIAL dan pilih Akun layanan.

  3. Masukkan nama untuk akun layanan baru. Anda juga dapat menambahkan deskripsi, lalu pilih BUAT DAN LANJUTKAN.

  4. Akun layanan Anda memerlukan dua peran standar Google BigQuery:

    • BigQuery > Editor Data BigQuery
    • BigQuery > BigQuery Job User

    Pilih peran pertama di kolom Select a role, pilih ADD ANOTHER ROLE, lalu pilih peran kedua.

    Setelah memilih kedua peran, pilih LANJUTKAN, lalu pilih SELESAI.

  5. Di halaman Credentials, pilih akun layanan baru Anda:

  6. Pilih KUNCI, lalu pilih TAMBAHKAN KUNCI, lalu, di drop-down, pilih Buat kunci baru:

  7. Pilih JSON di bagian Key type, lalu pilih CREATE:

  8. Kunci JSON akan disimpan ke komputer Anda.

    Setelah mencatat lokasi download, pilih TUTUP:

  9. Pilih SELESAI.

  10. Cari alamat email yang sesuai dengan akun layanan. Anda memerlukan alamat ini untuk mengonfigurasi koneksi Looker ke BigQuery:

  11. Setelah membuat akun layanan di database BigQuery, Anda akan memasukkan informasi akun layanan ini dan detail file sertifikat di kolom Email Akun Layanan, File JSON/P12 Akun Layanan, dan Sandi dari jendela Connections Looker setelah menyiapkan koneksi Looker ke BigQuery.

Autentikasi dengan OAuth

Looker mendukung OAuth untuk koneksi Google BigQuery, yang berarti setiap pengguna Looker melakukan autentikasi ke Google dengan kredensial Google OAuth-nya sendiri dan mengizinkan Looker mengakses database.

OAuth memungkinkan administrator database menjalankan fungsi berikut:

  • Mengaudit pengguna Looker mana yang menjalankan kueri terhadap database.
  • Menerapkan kontrol akses berbasis peran menggunakan izin Google.
  • Gunakan token OAuth untuk semua proses dan tindakan yang mengakses Google BigQuery, bukan menyematkan ID dan sandi BigQuery di beberapa tempat.

Perhatikan hal-hal berikut untuk koneksi BigQuery dengan OAuth:

  • Jika administrator database mengubah kredensial klien OAuth BigQuery, setiap jadwal atau pemberitahuan yang dimiliki pengguna akan terpengaruh. Pengguna harus login lagi jika administrator mereka mengubah kredensial OAuth BigQuery. Pengguna juga dapat membuka halaman Akun Looker dari halaman akun profil pengguna untuk login ke Google.
  • Karena koneksi BigQuery yang menggunakan OAuth adalah "per pengguna", kebijakan cache juga berlaku per pengguna, bukan hanya per kueri. Artinya, Looker tidak akan menggunakan hasil yang di-cache setiap kali kueri yang sama dijalankan dalam periode cache, tetapi Looker akan menggunakan hasil yang di-cache hanya jika pengguna yang sama telah menjalankan kueri yang sama dalam periode cache. Untuk informasi selengkapnya tentang penyimpanan dalam cache, lihat halaman dokumentasi Kueri cache.
  • Jika ingin menggunakan tabel turunan persisten (PDT) di koneksi BigQuery dengan OAuth, Anda harus membuat akun layanan tambahan untuk Looker agar dapat mengakses database Anda untuk proses PDT. Lihat bagian Tabel turunan persisten di koneksi BigQuery di halaman ini untuk mendapatkan informasinya.
  • Admin, ketika melakukan sudo sebagai pengguna lain, akan menggunakan token otorisasi OAuth pengguna tersebut. Lihat halaman dokumentasi Pengguna untuk informasi tentang penggunaan perintah sudo.

Mengonfigurasi project database BigQuery untuk OAuth

Bagian berikut menjelaskan cara membuat kredensial OAuth dan cara mengonfigurasi layar izin OAuth. Jika sudah mengonfigurasi layar izin OAuth untuk aplikasi lain dalam project, Anda tidak perlu membuat layar izin lain. Anda hanya mengonfigurasi satu layar izin untuk semua aplikasi dalam sebuah project.

Kredensial OAuth dan layar izin OAuth harus dikonfigurasi di Konsol Google Cloud. Deskripsi umum Google dapat ditemukan di situs dukungan Google Cloud dan di situs Konsol Google Dev.

Bergantung pada jenis pengguna yang mengakses data BigQuery di Looker dan apakah data BigQuery Anda bersifat publik atau pribadi, OAuth mungkin bukan metode autentikasi yang paling sesuai. Demikian pula, jenis data yang diminta dari pengguna dan tingkat akses yang diperlukan ke data pengguna tersebut saat mereka melakukan autentikasi ke Google untuk menggunakan Looker mungkin memerlukan verifikasi oleh Google. Lihat verifikasi selengkapnya di bagian Membuat kredensial Google OAuth di halaman ini.

Membuat kredensial Google OAuth

  1. Buka Konsol Google Cloud.

  2. Di drop-down Select a project, buka project BigQuery Anda. Tindakan ini akan membawa Anda ke dasbor project.

  3. Di menu kiri, pilih halaman APIs & Services. Lalu pilih Credentials. Pada halaman Credentials, pilih panah bawah di tombol Create credentials, lalu pilih OAuth client ID dari menu drop-down:

  4. Google mewajibkan Anda mengonfigurasi layar izin OAuth, yang memungkinkan pengguna memilih cara memberikan akses ke data pribadi mereka, sebelum Anda dapat membuat kredensial OAuth. Untuk mengonfigurasi layar izin OAuth, lihat bagian Mengonfigurasi layar izin OAuth di halaman ini.

  5. Jika Anda sudah mengonfigurasi layar izin OAuth, Google akan menampilkan halaman Buat client ID OAuth, yang memungkinkan Anda membuat client ID dan rahasia klien OAuth untuk digunakan dalam koneksi BigQuery ke Looker. Dari drop-down Jenis aplikasi, pilih Aplikasi web. Halaman akan meluas dan menampilkan opsi tambahan:

  6. Di kolom Name, masukkan nama aplikasi, seperti Looker.

  7. Di bagian Asal JavaScript yang sah, pilih + ADD URI untuk menampilkan kolom URIs 1. Di kolom URIs 1, masukkan URL ke instance Looker Anda, termasuk https://. Contoh:

    • Jika Looker menghosting instance Anda: https://<instancename>.looker.com
    • Jika Anda memiliki instance Looker yang dihosting pelanggan: https://looker.<mycompany>.com
    • Jika instance Looker Anda memerlukan nomor port: https://looker.<mycompany>.com:9999

  8. Di bagian Authorized redirect URI, pilih + ADD URI untuk menampilkan kolom URIs 1. Di kolom URIs 1, masukkan URL ke instance Looker Anda, diikuti dengan /external_oauth/redirect. Misalnya: https://<instancename>.looker.com/external_oauth/redirect atau https://looker.<mycompany>.com:9999/external_oauth/redirect.

  9. Pilih Buat. Google menampilkan Client-ID dan Rahasia Klien Anda.

  10. Salin client ID dan nilai rahasia klien. Anda akan meminta mereka untuk mengonfigurasi OAuth untuk koneksi BigQuery di Looker.

Google mewajibkan Anda mengonfigurasi layar izin OAuth, yang memungkinkan pengguna memilih cara memberikan akses ke data pribadi mereka dan memberikan link ke persyaratan layanan dan kebijakan privasi organisasi Anda.

Di menu kiri, pilih halaman OAuth consent screen. Sebelum dapat mengonfigurasi layar izin OAuth, Anda harus memilih untuk jenis pengguna yang akan menerima aplikasi ini. Bergantung pada pilihan Anda, aplikasi Anda mungkin perlu verifikasi oleh Google.

Tentukan pilihan, lalu pilih Buat. Google akan menampilkan halaman OAuth consent screen. Anda dapat mengonfigurasi layar ini untuk semua aplikasi dalam project, termasuk aplikasi internal dan publik.

Google akan melakukan verifikasi untuk aplikasi publik jika salah satu hal berikut benar:

  • Aplikasi ini menggunakan Google API yang menggunakan cakupan yang dibatasi atau sensitif.
  • Layar izin OAuth menyertakan logo aplikasi.
  • Project telah melampaui nilai minimum domain.

Lakukan tindakan berikut untuk mengonfigurasi layar izin OAuth Anda:

  1. Di kolom Nama aplikasi, masukkan nama aplikasi yang diberi akses oleh pengguna — dalam hal ini, Looker.

  2. Di kolom Email dukungan pengguna, masukkan email dukungan yang harus dihubungi pengguna terkait masalah login atau izin.

  3. Pilih TAMBAHKAN DOMAIN untuk menampilkan kolom Domain yang diotorisasi 1. Di kolom ini, masukkan domain URL ke instance Looker Anda. Misalnya, jika Looker menghosting instance Anda di https://<instance_name>.cloud.looker.com, domainnya adalah cloud.looker.com. Untuk deployment Looker yang dihosting pelanggan, masukkan domain tempat Anda menghosting Looker.

  4. Di bagian Informasi kontak developer, masukkan satu atau beberapa alamat email yang dapat digunakan Google untuk menghubungi Anda terkait project Anda.

    Kolom yang tersisa bersifat opsional, tetapi Anda dapat menggunakannya untuk menyesuaikan layar izin lebih lanjut.

  5. Pilih SIMPAN DAN LANJUTKAN.

  6. Google menampilkan halaman Cakupan, tempat Anda dapat mengonfigurasi cakupan. Looker hanya memerlukan cakupan default, sehingga tidak diperlukan konfigurasi cakupan tambahan. Pilih SIMPAN DAN LANJUTKAN.

  7. Di halaman Ringkasan, pilih KEMBALI KE DASBOR.

Kini Anda dapat melanjutkan prosedur untuk membuat kredensial OAuth.

Untuk informasi selengkapnya tentang cara mengonfigurasi layar izin OAuth Google, lihat dokumentasi dukungan Google.

Mengonfigurasi koneksi Looker untuk BigQuery dengan OAuth

Guna mengaktifkan OAuth untuk koneksi BigQuery Anda, pilih opsi OAuth di halaman Connection Looker saat Anda menyiapkan koneksi Looker ke BigQuery. Jika Anda mengaktifkan opsi OAuth, Looker akan menampilkan kolom Client ID OAuth dan Rahasia Klien OAuth. Tempel nilai Client ID dan Client Secret yang Anda peroleh sebagai langkah dalam prosedur Membuat kredensial Google OAuth di halaman ini.

Cara pengguna Looker melakukan autentikasi ke BigQuery dengan OAuth

Setelah koneksi Looker ke BigQuery disiapkan untuk OAuth, pengguna dapat menggunakan Looker untuk melakukan autentikasi awal ke database BigQuery Anda dengan melakukan salah satu tindakan berikut:

  • Mengautentikasi ke Google dari kueri Looker yang menggunakan koneksi BigQuery
  • Mengautentikasi ke Google dari bagian OAuth Connection Credentials di halaman Looker Account

Mengautentikasi ke Google dari kueri

Setelah koneksi Looker ke BigQuery disiapkan untuk OAuth, Looker akan meminta pengguna untuk login dengan Akun Google mereka sebelum menjalankan kueri yang menggunakan koneksi BigQuery. Looker menampilkan perintah ini dari Jelajah, dasbor, Look, dan SQL Runner.

Pengguna harus memilih Login dan melakukan autentikasi dengan OAuth. Setelah pengguna melakukan autentikasi ke BigQuery, pengguna dapat memilih tombol Jalankan di bagian Jelajah dan Looker akan memuat data ke Jelajah.

Mengautentikasi ke Google dari halaman akun pengguna

Setelah koneksi Looker ke BigQuery disiapkan untuk OAuth, pengguna dapat melakukan autentikasi ke Akun Google-nya dari halaman akun pengguna Looker:

  1. Dari Looker, pilih ikon profil dan pilih Akun dari menu pengguna.
  2. Buka bagian Kredensial Koneksi OAuth, lalu pilih tombol Log In untuk koneksi database BigQuery yang sesuai.
  3. Pilih akun yang sesuai dari halaman Login dengan Google.
  4. Pilih Izinkan di layar izin OAuth untuk mengizinkan Looker melihat dan mengelola data Anda di Google BigQuery.

Setelah melakukan autentikasi ke Google melalui Looker, Anda dapat logout atau memberikan otorisasi ulang kredensial kapan saja melalui halaman Akun, seperti yang dijelaskan di halaman dokumentasi Mempersonalisasi akun pengguna. Meskipun token Google BigQuery tidak akan habis masa berlakunya, pengguna dapat memilih Otorisasi ulang untuk login dengan Akun Google yang berbeda.

Mencabut token OAuth

Pengguna dapat revoke akses dari aplikasi seperti Looker ke Akun Google dengan membuka setelan Akun Google mereka.

Token Google BigQuery tidak memiliki tanggal habis masa berlaku; namun, jika admin database mengubah kredensial OAuth koneksi database dengan cara yang membatalkan kredensial yang ada, pengguna harus login dengan Akun Google mereka lagi sebelum menjalankan kueri apa pun yang menggunakan koneksi tersebut.

Tabel turunan persisten pada koneksi BigQuery

Jika ingin menggunakan tabel turunan persisten (PDT) untuk koneksi BigQuery, Anda mungkin perlu melakukan hal berikut, bergantung pada konfigurasi koneksi Anda:

  • Gunakan konsol Google Cloud untuk membuat set data sementara di database BigQuery yang dapat digunakan Looker untuk menulis PDT. Lihat bagian Membuat set data sementara untuk tabel turunan persisten di halaman ini untuk mengetahui prosedurnya. Langkah ini diperlukan untuk PDT, terlepas dari opsi konfigurasi lainnya pada koneksi.
  • Gunakan API Manager di konsol Google Cloud guna membuat akun layanan terpisah untuk proses PDT Looker. Lihat bagian Membuat akun layanan dan mendownload sertifikat kredensial JSON di halaman ini untuk mengetahui prosedurnya. Jenis autentikasi pada koneksi Anda memengaruhi apakah akun layanan PDT diperlukan, dan juga tempat Anda memasukkan informasi akun layanan PDT di jendela Connections Looker saat menyiapkan koneksi Looker ke BigQuery:
    • Jika koneksi Anda menggunakan OAuth untuk autentikasi pengguna, Anda harus membuat akun layanan terpisah untuk proses PDT. Anda akan memasukkan informasi akun layanan dan detail file sertifikat di bagian PDT Overrides pada jendela Connections Looker. Jendela Connections Looker akan menampilkan bagian PDT Overrides secara otomatis saat Anda mengaktifkan tombol Enable PDTs untuk koneksi yang juga dikonfigurasi dengan opsi OAuth di kolom Authentication. Lihat bagian Mengaktifkan PDT untuk koneksi Looker ke BigQuery dengan OAuth guna mengetahui informasi selengkapnya.
    • Jika koneksi Anda menggunakan akun layanan untuk autentikasi pengguna, Anda memiliki opsi untuk membuat akun layanan terpisah untuk proses PDT. Jika memilih untuk memiliki akun layanan PDT terpisah, Anda harus memasukkan informasi akun layanan di bagian PDT Overrides untuk kolom Service Account Email, Service Account JSON/P12 File, dan Password di jendela Connections Looker. Bagian Penggantian PDT muncul saat Anda mengaktifkan tombol Aktifkan PDT untuk koneksi Looker ke BigQuery menggunakan autentikasi akun layanan.

Membuat set data sementara untuk tabel turunan persisten

Guna mengaktifkan tabel turunan persisten (PDT) untuk koneksi BigQuery Anda, aktifkan tombol Aktifkan PDT di halaman Koneksi Looker saat Anda menyiapkan koneksi Looker ke BigQuery. Saat Anda mengaktifkan PDT, Looker akan menampilkan kolom Temp Dataset. Di kolom ini, Anda akan memasukkan nama set data yang dapat digunakan Looker untuk membuat PDT. Anda harus mengonfigurasi database atau skema ini terlebih dahulu, dengan izin tulis yang sesuai.

Anda dapat menyiapkan set data sementara menggunakan Konsol Google Cloud:

  1. Buka Konsol Google Cloud dan pilih project Anda.

  2. Pilih menu tiga titik, lalu pilih Create dataset.

  3. Masukkan ID Set Data (biasanya looker_scratch), lalu pilih Lokasi data (opsional), Masa berlaku tabel default, dan solusi pengelolaan kunci enkripsi. Pilih CREATE DATASET untuk menyelesaikan.

Setelah membuat set data, Anda dapat menentukan nama set data di kolom Temp Dataset di jendela Connections Looker saat menyiapkan koneksi Looker ke BigQuery.

Mengaktifkan PDT untuk koneksi Looker ke BigQuery dengan OAuth

Untuk koneksi BigQuery yang menggunakan OAuth, pengguna Anda melakukan autentikasi ke Looker dengan kredensial OAuth mereka. Looker mendukung PDT untuk koneksi BigQuery dengan OAuth, tetapi Looker tidak dapat menggunakan OAuth. Jadi, Anda harus menyiapkan akun layanan BigQuery secara khusus agar Looker dapat mengakses database Anda untuk proses PDT.

Anda dapat menyiapkan akun layanan PDT pada database BigQuery menggunakan Google Cloud API Manager. Lihat bagian Membuat akun layanan dan mendownload sertifikat kredensial JSON di halaman ini.

Setelah membuat akun layanan di database BigQuery, Anda akan memasukkan informasi akun layanan dan detail file sertifikat di bagian PDT Overrides pada jendela Connections Looker saat menyiapkan koneksi Looker ke BigQuery. Jendela Connections Looker akan menampilkan bagian PDT Overrides secara otomatis saat Anda mengaktifkan tombol Enable PDTs untuk koneksi yang juga dikonfigurasi dengan opsi OAuth di kolom Authentication. Gunakan kolom berikut di bagian Penggantian PDT guna memasukkan informasi untuk akun layanan yang dapat digunakan Looker untuk proses PDT di database Anda:

  • Upload p12 atau json: Gunakan tombol Upload File untuk mengupload file sertifikat untuk akun layanan BigQuery yang ingin Anda gunakan untuk proses PDT pada koneksi. Anda bisa mendapatkan file ini dari Pengelola Google Cloud API sebagai langkah dalam prosedur Membuat akun layanan dan mendownload sertifikat kredensial JSON.
  • : Kolom ini hanya berlaku jika Anda mengupload file P12 di kolom Upload p12 or json pada bagian PDT Overrides. Masukkan alamat email untuk akun layanan BigQuery yang ingin Anda gunakan untuk proses PDT pada koneksi. Anda bisa mendapatkan alamat email ini dari Pengelola Google Cloud API sebagai langkah dalam prosedur Membuat akun layanan dan mendownload sertifikat kredensial JSON.
  • Password: Kolom ini hanya berlaku jika Anda mengupload file P12 di kolom Upload p12 or json pada bagian PDT Overrides. Masukkan sandi ke file kredensial .p12 untuk akun layanan BigQuery yang ingin Anda gunakan untuk proses PDT pada koneksi.

Menghubungkan Looker ke BigQuery

Di bagian Admin Looker, pilih Koneksi untuk membuka halaman Koneksi, lalu lakukan salah satu tindakan berikut:

  • Untuk membuat koneksi baru, pilih tombol Add Connection.
  • Untuk mengedit koneksi yang ada, cari koneksi dari tabel Databases, lalu pilih tombol Edit di listingan koneksi.

Isi detail koneksi. Sebagian besar setelan ini bersifat umum untuk sebagian besar dialek database dan dijelaskan di halaman dokumentasi Menghubungkan Looker ke database. Setelan di bawah ini disebutkan untuk menyorotnya, atau untuk memperjelas penerapannya secara khusus untuk koneksi BigQuery:

  • Dialek: Pilih Google BigQuery Standard SQL atau Google BigQuery Legacy SQL.

  • ID Project Penagihan: Nama project penagihan Google Cloud. Project penagihan adalah project Google Cloud yang akan ditagih, tetapi Anda masih dapat membuat kueri set data dalam project Google Cloud lain jika developer LookML Anda menentukan nama tabel dengan cakupan penuh di parameter sql_table_name views, Explores, atau joins LookML Anda. Untuk BigQuery, nama tabel yang tercakup sepenuhnya menggunakan format <project_name>.<dataset_name>.<table_name>. Tanpa referensi yang tercakup sepenuhnya, BigQuery akan mencari tabel dalam project penagihan dan set data yang Anda tentukan di halaman Connections Looker untuk koneksi BigQuery ke Looker. Lihat dokumentasi BigQuery untuk mendapatkan penjelasan tentang hierarki resource di BigQuery.

  • Nama set data yang Anda inginkan untuk dijadikan default oleh Looker saat membuat kueri database Anda. Set data default harus berada di dalam project penagihan yang ditentukan untuk koneksi; Anda tidak dapat memasukkan nilai seperti project_name.dataset_name di kolom Database untuk menentukan set data di project berbeda.

    Project LookML Anda dapat mengakses tabel di set data lain (termasuk tabel dalam set data publik) jika developer LookML Anda menentukan nama tabel dengan cakupan penuh dalam parameter sql_table_name tampilan LookML, Explores, atau joins. Untuk BigQuery, nama tabel yang tercakup sepenuhnya menggunakan format <project_name>.<dataset_name>.<table_name>. Untuk membuat kueri tabel di set data lain, tabel tersebut harus dapat diakses oleh akun layanan (untuk koneksi yang menggunakan autentikasi akun layanan) atau oleh pengguna yang menjalankan kueri (untuk koneksi yang menggunakan autentikasi OAuth). Jika kode LookML Anda tidak menentukan nama tabel yang tercakup sepenuhnya, BigQuery akan menelusuri tabel dalam set data yang Anda tentukan di kolom Dataset pada koneksi BigQuery.

    Jika project Anda tidak memiliki set data (yang mungkin terjadi jika Anda memisahkan komputasi dan penyimpanan dalam project terpisah), Anda dapat memberikan nilai Dataset arbitrer, tetapi Anda harus selalu menggunakan nama tabel yang tercakup sepenuhnya dalam LookML.

  • : Jenis autentikasi yang akan digunakan Looker untuk mengakses database Anda, baik Akun Layanan maupun OAuth:

    • Akun Layanan: Pilih opsi ini untuk menggunakan akun layanan BigQuery bagi Looker guna melakukan autentikasi ke database Anda (lihat Autentikasi dengan akun layanan BigQuery untuk mengetahui informasi selengkapnya). Jika Service Account dipilih, Anda akan melihat kolom berikut:
    • OAuth: Pilih opsi ini agar setiap pengguna Looker dapat melakukan autentikasi ke Google BigQuery dan mengizinkan Looker mengakses database dengan akun BigQuery pengguna. Lihat bagian Autentikasi dengan OAuth di halaman ini untuk mengetahui informasi selengkapnya tentang cara menerapkan OAuth untuk koneksi BigQuery Anda. Jika OAuth dipilih, Anda akan melihat kolom berikut:

  • Aktifkan PDT: Aktifkan tombol ini untuk mengizinkan tabel turunan persisten (PDT) di koneksi. Anda harus menentukan set data sementara di database yang akan digunakan Looker untuk menulis PDT. Lihat bagian Membuat set data sementara untuk tabel turunan persisten di halaman ini untuk mengetahui prosedurnya. Catatan: Jika koneksi Anda dikonfigurasi untuk OAuth, Anda harus menggunakan bagian Penggantian PDT guna menentukan akun layanan yang dapat digunakan Looker untuk proses PDT di koneksi BigQuery Anda. Lihat bagian Mengaktifkan PDT untuk koneksi Looker ke BigQuery dengan OAuth untuk mengetahui detailnya.

  • Set Data Sementara: Set data BigQuery yang Anda buat di konsol Google Cloud untuk memungkinkan Looker menulis tabel turunan persisten ke database Anda. Lihat bagian Membuat set data sementara untuk tabel turunan persisten untuk mengetahui prosedurnya.

  • Zona Waktu Database: Zona waktu default untuk BigQuery adalah UTC. Setelan zona waktu yang Anda tentukan di sini harus cocok dengan setelan zona waktu BigQuery Anda. Lihat bagian Zona Waktu Database di halaman Menghubungkan Looker ke database Anda untuk mengetahui informasi selengkapnya.

  • Zona Waktu Kueri: Lihat bagian Zona Waktu Kueri di halaman Menghubungkan Looker ke database Anda untuk mengetahui informasi selengkapnya.

  • Parameter JDBC tambahan: Menambahkan parameter JDBC tambahan, seperti label BigQuery (lihat bagian Label tugas dan komentar konteks untuk koneksi BigQuery di halaman ini untuk mengetahui informasi selengkapnya.) Berikut adalah beberapa parameter lain yang didukung:

    • connectTimeout: Jumlah milidetik untuk menunggu koneksi. Default-nya adalah 240000.
    • readTimeout: Jumlah milidetik untuk menunggu pembacaan. Default-nya adalah 240000.
    • rootUrl: Jika Anda memiliki instance BigQuery di jaringan pribadi, tentukan endpoint alternatif untuk terhubung ke BigQuery selain endpoint publik default.

  • Gigabyte Penagihan Maksimal: Di koneksi BigQuery, Anda dikenai biaya untuk setiap kueri berdasarkan ukurannya. Untuk membantu mencegah pengguna secara tidak sengaja menjalankan kueri yang terlalu mahal, Anda dapat menetapkan jumlah maksimum gigabyte yang diizinkan untuk menarik pengguna dalam satu kueri. Anda dapat mengosongkan kolom Gigabyte Penagihan Maks jika Anda tidak membatasi ukuran kueri. Baca detail selengkapnya tentang harga di halaman harga BigQuery.

  • Koneksi maksimum per node: Dapat dibiarkan dengan nilai default di awal. Baca selengkapnya tentang setelan ini di bagian Koneksi maksimum per node di halaman dokumentasi Menghubungkan Looker ke database Anda.

  • Waktu Tunggu Kumpulan Koneksi: Dapat dibiarkan pada nilai default di awal. Baca selengkapnya tentang setelan ini di bagian Waktu Tunggu Kumpulan Koneksi di halaman dokumentasi Menghubungkan Looker ke database Anda.

  • Disable Context: Opsi ini menonaktifkan komentar konteks di koneksi BigQuery. Komentar konteks pada koneksi Google BigQuery dinonaktifkan secara default karena komentar konteks membatalkan kemampuan Google BigQuery untuk melakukan cache dan dapat berdampak negatif terhadap performa cache. Anda dapat mengaktifkan komentar konteks untuk koneksi BigQuery dengan menonaktifkan tombol Nonaktifkan Konteks. Untuk mengetahui informasi selengkapnya, lihat bagian Label tugas dan komentar konteks untuk koneksi BigQuery.

  • Precache SQL Runner: Jika Anda ingin SQL Runner tidak melakukan pramuat informasi tabel dan, sebagai gantinya, memuat informasi tabel hanya saat tabel dipilih, hapus opsi ini. Lihat bagian Precache Runner SQL di halaman Menghubungkan Looker ke database untuk mengetahui informasi selengkapnya.

Setelah mengisi semua kolom yang berlaku untuk koneksi, Anda dapat menguji koneksi sesuai kebutuhan.

Untuk menyimpan setelan ini, klik Hubungkan.

Menguji koneksi

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

  • Pilih tombol Uji di bagian bawah halaman Setelan Koneksi, seperti yang dijelaskan di halaman dokumentasi Menghubungkan Looker ke database Anda.
  • Pilih tombol Uji di samping listingan koneksi di halaman admin Koneksi, seperti yang dijelaskan di halaman dokumentasi Koneksi.

Untuk koneksi baru, jika Looker menampilkan Dapat terhubung, pilih Tambahkan koneksi. Looker akan menjalankan pengujian koneksi lainnya untuk memverifikasi bahwa akun layanan telah disiapkan dengan benar dan dengan peran yang tepat.

Menguji koneksi yang menggunakan OAuth

  1. Di Looker, buka Mode Pengembangan.
  2. Untuk koneksi BigQuery yang ada yang menggunakan OAuth, buka file project untuk project Looker yang menggunakan koneksi BigQuery Anda. Untuk koneksi BigQuery baru yang menggunakan OAuth, buka file model dan ganti nilai connection model dengan nama koneksi BigQuery baru Anda, lalu simpan file model.
  3. Buka salah satu dasbor atau Jelajah model dan jalankan kueri. Saat Anda mencoba menjalankan kueri, Looker akan meminta Anda untuk login dengan Akun Google Anda. Ikuti perintah login Google OAuth.

Label tugas dan komentar konteks untuk koneksi BigQuery

Untuk koneksi BigQuery, Looker mengirimkan konteks kueri dalam bentuk label tugas BigQuery. Secara default, Looker mengirimkan kunci label konteks berikut untuk koneksi BigQuery:

  • looker-context-user_id: ID unik untuk setiap pengguna di instance Looker. Anda dapat mencocokkan ID pengguna ini dengan ID pengguna di halaman Pengguna pada menu Admin.

  • looker-context-history_slug: ID unik untuk setiap kueri yang dijalankan di database oleh instance Looker.

  • looker-context-instance_slug: Nomor ID instance Looker yang mengeluarkan kueri. Dukungan Looker dapat menggunakan informasi ini untuk membantu Anda memecahkan masalah, jika diperlukan.

Anda dapat mengonfigurasi label tugas tambahan untuk Looker yang akan dikirim dengan setiap kueri di koneksi BigQuery menggunakan kolom teks Parameter JDBC tambahan di halaman Koneksi. Di kolom Parameter JDBC tambahan, tambahkan parameter JDBC tambahan, labels, dan berikan daftar yang dipisahkan koma untuk pasangan key=value berenkode URL. Misalnya, jika Anda menyertakannya di kolom Parameter JDBC tambahan:

labels=this%3Dconnection-label,that%3Danother-connection-label

%3D adalah encoding URL untuk =, sehingga dua label berikut akan ditambahkan ke setiap kueri yang dikirim Looker ke database BigQuery, selain label konteks Looker default:

  • this: connection-label
  • that: another-connection-label

Perlu diperhatikan bahwa BigQuery memiliki batasan pada label tugas:

  • Setiap label koneksi yang memiliki kunci yang sama dengan label konteks akan diabaikan.
  • Jika gabungan label koneksi dan label konteks melebihi jumlah total maksimum 64 label, label konteks akan dihapus terlebih dahulu, diikuti dengan label koneksi, hingga jumlah total label maksimal 64.

Looker memastikan bahwa label konteks sesuai dengan semua persyaratan validitas label BigQuery, tetapi tidak memeriksa validitas label koneksi. Mengonfigurasi label koneksi yang tidak valid dapat menyebabkan kueri gagal.

Label tugas BigQuery yang dikirim Looker secara default (looker-context-user_id, looker-context-history_id, dan looker-context-instance_slug) sesuai dengan komentar konteks SQL yang dilampirkan Looker ke kueri SQL untuk dialek database selain BigQuery. Untuk koneksi BigQuery, komentar konteks dinonaktifkan secara default karena membuat kemampuan BigQuery untuk melakukan cache menjadi tidak valid, dan dapat berdampak negatif terhadap performa cache. Anda dapat mengaktifkan komentar konteks untuk koneksi BigQuery dengan menonaktifkan tombol Nonaktifkan Konteks untuk koneksi BigQuery. Sebaiknya Anda mempertahankan setelan default untuk Disable Context Komentar, sehingga Anda dapat menggunakan cache BigQuery. Namun, jika Anda membatalkan pilihan Nonaktifkan Komentar Konteks untuk koneksi BigQuery, Looker akan mengirim komentar konteks SQL dan label tugas BigQuery ke database Anda.

Komentar konteks SQL dan label tugas BigQuery menyampaikan informasi yang sama. Misalnya, Looker mungkin menghasilkan komentar konteks SQL berikut untuk sebuah kueri:

-- Looker Query Context

'{"user_id":1,"history_id":4757,"instance_slug":"ec2804ddef74c466f2a43e0afaa3ff6b"}'

Kemudian Looker akan menghasilkan label tugas BigQuery berikut untuk kueri yang sama:

[{"value":"1","key":"looker-context-user_id"},

 {"value":"4757","key":"looker-context-history_id"},

 {"value":"ec2804ddef74c466f2a43e0afaa3ff6b","key":"looker-context-instance_slug"}]

Dukungan fitur

Agar Looker dapat mendukung beberapa fitur, dialek database Anda juga harus mendukung fitur tersebut.

SQL Standar Google BigQuery

SQL Standar Google BigQuery mendukung fitur berikut mulai Looker 24.6:

Fitur Didukung?
Level Dukungan
Didukung
Looker (Google Cloud core)
Ya
Agregat Simetris
Ya
Tabel Turunan
Ya
Tabel Turunan SQL Persisten
Ya
Tabel Turunan Berbasis Persisten
Ya
Tampilan Stabil
Ya
Penghentian Kueri
Ya
Pivot berbasis SQL
Ya
Zona waktu
Ya
SSL
Ya
Subtotal
Ya
Parameter Tambahan JDBC
Ya
Peka Huruf Besar/Kecil
Ya
Jenis Lokasi
Ya
Jenis Daftar
Ya
Persentil
Ya
Persentil berbeda
Ya
Proses Tampilan Runner SQL
Tidak
Tabel Deskripsi Runner SQL
Tidak
Indeks Tampilan Runner SQL
Tidak
Pilihan Runner SQL 10
Ya
Jumlah Runner SQL
Ya
Penjelasan SQL
Tidak
Kredensial OAuth
Ya
Komentar Konteks
Ya
Penggabungan Koneksi
Tidak
Sketsa HLL
Ya
Awareness Gabungan
Ya
PDT inkremental
Ya
Milidetik
Ya
Mikrodetik
Ya
Tampilan Terwujud
Ya
Perkiraan Jumlah Berbeda
Ya

Legacy SQL Google BigQuery

SQL Lama Google BigQuery mendukung fitur berikut mulai Looker 24.6:

Fitur Didukung?
Level Dukungan
Didukung
Looker (Google Cloud core)
Tidak
Agregat Simetris
Ya
Tabel Turunan
Ya
Tabel Turunan SQL Persisten
Ya
Tabel Turunan Berbasis Persisten
Ya
Tampilan Stabil
Tidak
Penghentian Kueri
Ya
Pivot berbasis SQL
Ya
Zona waktu
Tidak
SSL
Ya
Subtotal
Tidak
Parameter Tambahan JDBC
Ya
Peka Huruf Besar/Kecil
Ya
Jenis Lokasi
Ya
Jenis Daftar
Ya
Persentil
Ya
Persentil berbeda
Ya
Proses Tampilan Runner SQL
Tidak
Tabel Deskripsi Runner SQL
Tidak
Indeks Tampilan Runner SQL
Tidak
Pilihan Runner SQL 10
Ya
Jumlah Runner SQL
Ya
Penjelasan SQL
Tidak
Kredensial OAuth
Ya
Komentar Konteks
Ya
Penggabungan Koneksi
Tidak
Sketsa HLL
Tidak
Awareness Gabungan
Ya
PDT inkremental
Tidak
Milidetik
Ya
Mikrodetik
Ya
Tampilan Terwujud
Tidak
Perkiraan Jumlah Berbeda
Ya

Langkah berikutnya

Setelah menghubungkan database ke Looker, konfigurasi opsi login untuk pengguna.