Google BigQuery

Ringkasan

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

Langkah-langkah umum untuk menyiapkan koneksi Google BigQuery Standard SQL 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) pada 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 traffic 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 mengautentikasi ke database BigQuery Anda adalah dengan akun layanan BigQuery. Anda membuat akun layanan di database BigQuery menggunakan API Manager 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 API Manager di konsol Google Cloud dan pilih project Anda.

  2. Pilih BUAT KREDIENSIAL, lalu pilih Akun layanan.

  3. Masukkan nama untuk akun layanan baru, tambahkan deskripsi (opsional), lalu pilih CREATE AND CONTINUE.

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

    • BigQuery > BigQuery Data Editor
    • 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 CONTINUE, lalu pilih DONE.

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

  6. Pilih KEYS, lalu pilih ADD KEY, lalu, di menu drop-down, pilih Create new key:

  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. Temukan 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 di jendela Koneksi Looker saat 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 OAuth Google mereka sendiri dan memberikan otorisasi kepada Looker untuk mengakses database.

OAuth memungkinkan administrator database menjalankan fungsi berikut:

  • Audit pengguna Looker yang menjalankan kueri terhadap database.
  • Terapkan 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 berikut untuk koneksi BigQuery dengan OAuth:

  • Jika administrator database mengubah kredensial klien OAuth BigQuery, jadwal atau pemberitahuan apa pun 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 bersifat "per pengguna", kebijakan penyimpanan dalam cache juga bersifat per pengguna, bukan hanya per kueri. Artinya, alih-alih menggunakan hasil yang di-cache setiap kali kueri yang sama dijalankan dalam periode penyimpanan dalam cache, Looker hanya akan menggunakan hasil yang di-cache jika pengguna yang sama telah menjalankan kueri yang sama dalam periode penyimpanan dalam cache. Untuk informasi selengkapnya tentang penyimpanan dalam cache, lihat halaman dokumentasi Menyimpan kueri ke dalam cache.
  • Jika ingin menggunakan tabel turunan persisten (PDT) pada koneksi BigQuery dengan OAuth, Anda harus membuat akun layanan tambahan agar Looker dapat mengakses database untuk proses PDT. Lihat bagian Tabel turunan persisten di koneksi BigQuery di halaman ini untuk mengetahui informasinya.
  • Admin, saat menggunakan sudo sebagai pengguna lain, akan menggunakan token otorisasi OAuth pengguna tersebut. Lihat halaman dokumentasi Pengguna untuk mengetahui informasi tentang penggunaan perintah sudo.

Mengonfigurasi project database BigQuery untuk OAuth

Bagian berikut menjelaskan cara membuat kredensial OAuth dan cara mengonfigurasi layar izin OAuth.

Dalam kasus berikut, Anda tidak perlu melakukan prosedur ini:

Kredensial OAuth dan layar izin OAuth harus dikonfigurasi di konsol Google Cloud. Deskripsi generik Google ada 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 untuk data pengguna tersebut saat mereka melakukan autentikasi ke Google untuk menggunakan Looker mungkin memerlukan verifikasi oleh Google. Lihat informasi selengkapnya tentang verifikasi di bagian Membuat kredensial Google OAuth di halaman ini.

Membuat kredensial OAuth Google

  1. Buka Konsol Google Cloud.

  2. Di menu drop-down Select a project, buka project BigQuery Anda. Anda akan diarahkan ke dasbor project.

  3. Di menu sebelah kiri, pilih halaman API & Layanan. Kemudian, pilih Kredensial. Di halaman Kredensial, pilih panah bawah di tombol Buat kredensial, lalu pilih ID klien OAuth 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 telah mengonfigurasi layar izin OAuth, Google akan menampilkan halaman Buat client ID OAuth, yang memungkinkan Anda membuat client ID dan secret OAuth untuk digunakan dalam koneksi BigQuery ke Looker. Dari drop-down Application type, pilih Web application. Halaman akan diperluas dan menampilkan opsi tambahan:

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

  7. Di bagian Asal JavaScript yang sah, pilih + TAMBAHKAN URI untuk menampilkan kolom URI 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 oleh pelanggan: https://looker.<mycompany>.com
    • Jika instance Looker Anda memerlukan nomor port: https://looker.<mycompany>.com:9999

  8. Di bagian Authorized redirect URIs, 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. Anda memerlukannya 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 Layar persetujuan OAuth. Sebelum dapat mengonfigurasi layar izin OAuth, Anda harus memilih jenis pengguna yang akan Anda sediakan aplikasi ini. Bergantung pada pilihan Anda, aplikasi Anda mungkin memerlukan verifikasi oleh Google.

Tentukan pilihan Anda, 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 menggunakan Google API yang menggunakan cakupan yang dibatasi atau sensitif.
  • Layar izin OAuth menyertakan logo aplikasi.
  • Project telah melampaui nilai minimum domain.

Lakukan hal berikut untuk mengonfigurasi layar izin OAuth Anda:

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

  2. Di kolom User support email, masukkan email dukungan yang harus dihubungi pengguna jika mengalami masalah login atau izin.

  3. Pilih TAMBAHKAN DOMAIN untuk menampilkan kolom Domain resmi 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 lainnya bersifat opsional, tetapi Anda dapat menggunakannya untuk menyesuaikan layar izin lebih lanjut.

  5. Pilih SIMPAN DAN LANJUTKAN.

  6. Google akan 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 Summary, pilih KEMBALI KE DASBOR.

Sekarang 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

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

Jika telah menetapkan durasi sesi untuk OAuth BigQuery, untuk menghindari waktu tunggu sesi Looker habis, Anda harus menggunakan fitur Pengecualian Aplikasi Tepercaya untuk menambahkan Looker ke aplikasi tepercaya. Lihat artikel bantuan Menetapkan durasi sesi untuk layanan Google Cloud untuk melihat langkah-langkah prosedur ini.

Cara pengguna Looker mengautentikasi ke BigQuery dengan OAuth

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

Melakukan autentikasi 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 Run di Jelajahi dan Looker akan memuat data ke Jelajahi.

Mengautentikasi ke Google dari halaman akun pengguna

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

  1. Dari Looker, pilih ikon profil, lalu pilih Akun dari menu pengguna.
  2. Buka bagian OAuth Connection Credentials, 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 Anda kapan saja melalui halaman Akun, seperti yang dijelaskan di halaman dokumentasi Mempersonalisasi akun pengguna. Meskipun token Google BigQuery tidak memiliki masa berlaku, pengguna dapat memilih Otorisasi ulang untuk login dengan Akun Google yang berbeda.

Mencabut token OAuth

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

Token Google BigQuery tidak memiliki masa berlaku; namun, jika admin database mengubah kredensial OAuth koneksi database dengan cara yang membatalkan kredensial yang ada, pengguna harus login lagi dengan Akun Google mereka 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:

  • 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 Pengelola API di konsol Google Cloud untuk membuat akun layanan terpisah bagi 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 Koneksi 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 Koneksi Looker akan otomatis menampilkan bagian Penggantian PDT saat Anda mengaktifkan tombol Aktifkan PDT untuk koneksi yang juga dikonfigurasi dengan opsi OAuth di kolom Autentikasi. Lihat bagian Mengaktifkan PDT untuk koneksi Looker ke BigQuery dengan OAuth untuk 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 akan memasukkan informasi akun layanan di bagian Penggantian PDT untuk kolom Email Akun Layanan, File JSON/P12 Akun Layanan, dan Sandi di jendela Koneksi 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

Untuk mengaktifkan tabel turunan persisten (PDT) untuk koneksi BigQuery, aktifkan tombol Aktifkan PDT di halaman Koneksi Looker saat Anda menyiapkan koneksi Looker ke BigQuery. Saat Anda mengaktifkan PDT, Looker akan menampilkan kolom Set Data Sementara. 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 pada 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 akan diautentikasi ke Looker dengan kredensial OAuth mereka. Looker mendukung PDT untuk koneksi BigQuery dengan OAuth, tetapi Looker itu sendiri tidak dapat menggunakan OAuth, sehingga Anda harus menyiapkan akun layanan BigQuery secara khusus untuk mengizinkan Looker mengakses database Anda untuk proses PDT.

Anda dapat menyiapkan akun layanan PDT di database BigQuery menggunakan Pengelola API Google Cloud. 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 Penggantian PDT pada jendela Koneksi Looker saat menyiapkan koneksi Looker ke BigQuery. Jendela Koneksi Looker akan otomatis menampilkan bagian Penggantian PDT saat Anda mengaktifkan tombol Aktifkan PDT untuk koneksi yang juga dikonfigurasi dengan opsi OAuth di kolom Autentikasi. Gunakan kolom berikut di bagian PDT Overrides untuk memasukkan informasi 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 API Google Cloud sebagai langkah dalam prosedur Membuat akun layanan dan mendownload sertifikat kredensial JSON.
  • Nama Pengguna: Kolom ini hanya berlaku jika Anda mengupload file P12 di kolom Upload p12 atau json di bagian Penggantian PDT. 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.
  • Sandi: Kolom ini hanya berlaku jika Anda mengupload file P12 di kolom Upload p12 atau json di bagian Penggantian PDT. 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 di 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, temukan koneksi dari tabel Database, lalu pilih tombol Edit di listingan koneksi.

Isi detail koneksi. Sebagian besar setelan ini umum untuk sebagian besar dialek database dan dijelaskan di halaman dokumentasi Menghubungkan Looker ke database. Setelan berikut disebutkan untuk menyorotinya atau untuk menjelaskan penerapannya secara khusus untuk koneksi BigQuery:

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

  • ID Project Penagihan: ID project (ID unik) project penagihan Google Cloud. Project penagihan adalah project Google Cloud yang ditagih, tetapi Anda masih dapat mengkueri set data di project Google Cloud lain jika developer LookML menentukan nama tabel dengan cakupan penuh di parameter sql_table_name dari tampilan, Jelajahi, atau gabungan LookML. Untuk BigQuery, nama tabel yang sepenuhnya dicakup menggunakan format <project_name>.<dataset_name>.<table_name>. Tanpa referensi cakupan penuh, BigQuery akan mencari tabel di project penagihan dan set data yang Anda tentukan di halaman Koneksi Looker untuk koneksi BigQuery ke Looker. Lihat dokumentasi BigQuery untuk mengetahui penjelasan hierarki resource di BigQuery.

  • Project ID Storage: Nama Project ID Storage, 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 BigQuery, nama tabel yang sepenuhnya dicakup menggunakan format <project_name>.<dataset_name>.<table_name>. Tanpa referensi cakupan penuh, BigQuery akan mencari tabel di project penagihan dan set data yang Anda tentukan di halaman Koneksi Looker untuk koneksi BigQuery ke Looker. Lihat dokumentasi BigQuery untuk mengetahui penjelasan hierarki resource di BigQuery.

  • Set data: Nama set data yang Anda inginkan sebagai setelan default Looker saat membuat kueri database. Set data default harus berada 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 yang berbeda.

    Project LookML Anda dapat mengakses tabel di set data lain (termasuk tabel di set data publik) jika developer LookML menentukan nama tabel dengan cakupan penuh dalam parameter sql_table_name dari tampilan, Jelajah, atau gabungan LookML. Untuk BigQuery, nama tabel yang sepenuhnya dicakup menggunakan format <project_name>.<dataset_name>.<table_name>. Untuk membuat kueri tabel di set data lain, tabel 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 dengan cakupan penuh, BigQuery akan menelusuri tabel dalam set data yang Anda tentukan di kolom Set data 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 Set Data arbitrer, tetapi Anda harus selalu menggunakan nama tabel yang sepenuhnya dicakup dalam LookML.

  • Autentikasi: Jenis autentikasi yang akan digunakan Looker untuk mengakses database Anda. Beberapa opsi ini hanya didukung untuk instance Looker (Google Cloud core):

    • Kredensial Default Aplikasi: (Khusus Looker (inti Google Cloud)) Pilih opsi ini untuk menggunakan Kredensial Default Aplikasi (ADC) guna mengautentikasi ke database Anda (lihat dokumentasi Looker (inti Google Cloud) untuk mengetahui informasi selengkapnya).
    • Service Account: Pilih opsi ini untuk menggunakan akun layanan BigQuery agar Looker dapat 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 untuk mengizinkan setiap pengguna Looker melakukan autentikasi ke Google BigQuery dan memberi otorisasi Looker untuk 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) pada 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 untuk 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 untuk mengetahui informasi selengkapnya.

  • 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.) Berikut adalah beberapa parameter lain yang didukung:

    • connectTimeout: Jumlah milidetik untuk menunggu koneksi. Setelan defaultnya adalah 240000.
    • readTimeout: Jumlah milidetik untuk menunggu operasi baca. Setelan defaultnya 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: Pada koneksi BigQuery, Anda akan ditagih untuk setiap kueri berdasarkan ukurannya. Untuk membantu mencegah pengguna tidak sengaja menjalankan kueri yang terlalu mahal, Anda dapat menetapkan jumlah maksimum gigabyte yang diizinkan pengguna untuk diambil dalam satu kueri. Anda dapat mengosongkan kolom Max Billing Gigabytes jika tidak membatasi ukuran kueri. Baca detail selengkapnya tentang harga di halaman harga BigQuery.

  • Koneksi maksimum per node: 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.

  • Connection Pool Timeout: Dapat dibiarkan pada nilai default pada awalnya. Baca selengkapnya tentang setelan ini di bagian Connection Pool Timeout di halaman dokumentasi Menghubungkan Looker ke database.

  • Nonaktifkan Konteks: Opsi ini menonaktifkan komentar konteks pada koneksi BigQuery. Komentar konteks pada koneksi Google BigQuery dinonaktifkan secara default karena komentar konteks membatalkan kemampuan Google BigQuery untuk menyimpan dalam cache dan dapat berdampak negatif pada performa cache. Anda dapat mengaktifkan komentar konteks untuk koneksi BigQuery dengan menonaktifkan tombol Nonaktifkan Konteks. Lihat bagian Label tugas dan komentar konteks untuk koneksi BigQuery guna mengetahui informasi selengkapnya.

  • Pratmuat SQL Runner: Jika Anda ingin SQL Runner tidak memuat informasi tabel secara otomatis, dan sebagai gantinya, memuat informasi tabel hanya saat tabel dipilih, hapus opsi ini. Lihat bagian Pra-cache SQL Runner 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 Test di bagian bawah halaman Connections Settings, 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 Can connect, pilih Add connection. Looker akan menjalankan pengujian koneksi lainnya untuk memverifikasi bahwa akun layanan disiapkan dengan benar dan dengan peran yang sesuai.

Menguji koneksi yang menggunakan OAuth

  1. Di Looker, buka Mode Pengembangan.
  2. Untuk koneksi BigQuery yang ada dan 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 Jelajah atau dasbor 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 di 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 dikirim Looker 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 pasangan key=value yang dienkode ke URL dan dipisahkan koma. Misalnya, jika Anda menyertakannya di kolom Additional JDBC parameters:

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

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

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

Perhatikan 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 total label maksimum 64, label konteks akan dihapus terlebih dahulu, diikuti dengan label koneksi, hingga jumlah total label tidak lebih dari 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 akan membatalkan kemampuan BigQuery untuk menyimpan dalam cache, dan dapat berdampak negatif pada performa cache. Anda dapat mengaktifkan komentar konteks untuk koneksi BigQuery dengan menonaktifkan tombol Nonaktifkan Konteks untuk koneksi BigQuery. Sebaiknya pertahankan setelan default untuk Nonaktifkan Komentar Konteks, sehingga Anda dapat menggunakan cache BigQuery. Namun, jika Anda membatalkan pilihan opsi Nonaktifkan Komentar Konteks untuk koneksi BigQuery, Looker akan mengirimkan komentar konteks SQL dan label tugas BigQuery ke database Anda.

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

-- Looker Query Context

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

Kemudian, Looker akan membuat 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 mendukung beberapa fitur, dialek database Anda juga harus mendukungnya.

SQL Standar Google BigQuery

Google BigQuery Standard SQL mendukung fitur berikut mulai Looker 24.20:

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
Tidak
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 Tampilkan SQL Runner
Tidak
SQL Runner Describe Table
Tidak
SQL Runner Show Indexes
Tidak
SQL Runner Select 10
Ya
Jumlah SQL Runner
Ya
SQL Explain
Tidak
Kredensial Oauth
Ya
Komentar Konteks
Ya
Penggabungan Koneksi
Tidak
Sketsa HLL
Ya
Kesadaran Agregat
Ya
PDT inkremental
Ya
Milidetik
Ya
Mikrodetik
Ya
Tampilan Terwujud
Ya
Perkiraan Jumlah Berbeda
Ya

Legacy SQL Google BigQuery

Google BigQuery Legacy SQL mendukung fitur berikut mulai Looker 24.20:

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 Tampilkan SQL Runner
Tidak
SQL Runner Describe Table
Tidak
SQL Runner Show Indexes
Tidak
SQL Runner Select 10
Ya
Jumlah SQL Runner
Ya
SQL Explain
Tidak
Kredensial Oauth
Ya
Komentar Konteks
Ya
Penggabungan Koneksi
Tidak
Sketsa HLL
Tidak
Kesadaran Agregat
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.