Menggunakan Sheet yang Terhubung untuk Looker

Sheet yang Terhubung untuk Looker memungkinkan pengguna menjelajahi data dari model LookML secara interaktif melalui antarmuka spreadsheet Google Spreadsheet yang sudah dikenal luas. Pengguna Spreadsheet akan memiliki akses ke data yang diatur dari lebih dari 50 database yang didukung oleh Looker. Eksplorasi bersifat intuitif karena Sheet yang Terhubung menyajikan tampilan model yang teratur dengan tampilan, kolom, dan ukuran seperti yang ditentukan di Looker. Data Looker melalui Sheet yang Terhubung dapat digunakan dalam konstruksi Spreadsheet standar, seperti tabel pivot, diagram, dan formula, sehingga memungkinkan fleksibilitas analisis melalui konstruksi yang sudah dikenal.

Mengaktifkan Sheet yang Terhubung

Untuk menggunakan Sheet yang Terhubung:

  • Di Looker (asli), admin Looker Anda harus mengaktifkan tombol Semua Konektor BI Looker atau Sheet yang Terhubung di panel Konektor BI di bagian Platform pada menu Admin Looker. Di Looker (inti Google Cloud), opsi ini diaktifkan secara default.
  • Instance Looker Anda harus dihosting oleh Looker.
  • Instance Looker Anda harus menjalankan Looker 22.20 atau yang lebih baru jika instance Anda dihosting di Google Cloud. Jika instance Looker Anda tidak dihosting di Google Cloud, instance Anda harus menjalankan Looker 23.4 atau yang lebih baru.
  • Setiap pengguna yang ingin terhubung ke instance Looker Anda dari Google Spreadsheet harus menggunakan alamat email yang sama di akun pengguna Looker mereka dengan yang mereka gunakan untuk akun Google Workspace mereka. Jika alamat email akun Google Workspace dan Looker mereka berbeda, mereka akan menerima error saat mencoba terhubung ke Looker dari Spreadsheet.
  • Akses ke layanan yang tidak dikontrol satu per satu harus diaktifkan di konsol Admin Google Workspace. Opsi ini biasanya diaktifkan secara default. Untuk mengetahui informasi selengkapnya, lihat artikel bantuan Mengelola akses ke layanan yang tidak dikontrol satu per satu.

Menghubungkan ke Look dari Google Spreadsheet

Di Looker, Look adalah satu kueri yang sebelumnya disimpan. Anda dapat menambahkan hasil Look ke spreadsheet, lalu berinteraksi dengan output Look di Spreadsheet.

  1. Dari menu Data Google Spreadsheet, pilih Konektor Data, lalu pilih Hubungkan ke Looker.

  2. Pada dialog Hubungkan ke Looker, masukkan nama instance Looker Anda, atau pilih nama instance yang baru saja Anda hubungkan, lalu pilih Hubungkan ke Look.

  3. Dalam dialog berikutnya, pilih Look yang ingin Anda tambahkan ke Google Spreadsheet, lalu pilih Hubungkan. Anda dapat menggunakan kolom Search for a Look untuk menelusuri Look tersimpan berdasarkan nama atau ID Look, atau Anda dapat memfilter daftar Look yang ditampilkan dalam dialog dengan memasukkan substring yang ada dalam nama Look.

  4. Pada dialog Hubungkan ke Look, pilih apakah akan membuat sheet baru untuk output Look atau menambahkan output Look ke sheet yang ada, lalu pilih Buat.

Saat terhubung ke instance Looker Anda, Spreadsheet akan menambahkan output Look yang Anda pilih.

Tampilan tidak dapat diedit di Spreadsheet, tetapi Anda dapat memperbarui data Tampilan kapan saja dengan mengklik Perbarui. Anda dapat mengklik URL Look untuk membuka Look di Looker. Anda juga dapat melihat nama, ID, dan URL Look di sidebar Look.

Menghubungkan ke Eksplorasi Looker dari Google Spreadsheet

Eksplorasi adalah titik awal untuk kueri. Jelajah menampilkan sekumpulan kolom tertentu dari file tampilan terkaitnya, dan kolom ini dapat dipilih untuk membuat kueri dalam sheet.

  1. Dari menu Data Google Spreadsheet, pilih Konektor Data, lalu pilih Hubungkan ke Looker.

  2. Pada dialog Hubungkan ke Looker, masukkan nama instance Looker Anda, atau pilih nama instance yang baru-baru ini Anda hubungkan, lalu pilih Hubungkan ke Jelajah.

  3. Di dialog berikut, pilih model Looker dan Jelajah yang ingin Anda gunakan untuk kueri, lalu pilih Hubungkan.

Saat terhubung ke instance Looker Anda, Spreadsheet akan membuka sheet baru yang menampilkan struktur Eksplorasi yang dipilih, termasuk tampilan, dimensi, ukuran, dan deskripsi kolom yang ditambahkan oleh developer Looker Anda.

Membuat kueri Looker menggunakan Google Spreadsheet

Kueri Looker dibuat menggunakan tabel pivot Spreadsheet. Untuk menambahkan data Looker ke spreadsheet Anda:

  1. Dari sheet yang menampilkan Eksplorasi Anda, pilih Tabel Pivot.

  2. Pilih apakah akan menyisipkan tabel pivot baru di sheet baru atau sheet yang ada, lalu pilih Buat.

    Tabel pivot baru yang kosong akan dibuat, dan jendela Editor tabel pivot akan terbuka. Anda dapat menambahkan baris, kolom, nilai, dan filter untuk membuat kueri berdasarkan dimensi dan ukuran di Eksplorasi Looker.

    Baris, kolom, nilai, dan filter di editor pivot setara dengan dimensi dan ukuran Looker Anda dengan cara berikut:

    • Baris setara dengan dimensi Looker.
    • Kolom setara dengan dimensi yang di-pivot Looker.
    • Nilai setara dengan ukuran Looker. Anda dapat membuat ukuran kustom dengan memilih dimensi Looker dan fungsi Ringkas menurut di Spreadsheet.
    • Filter setara dengan filter Looker.

    Editor pivot juga menampilkan daftar tampilan yang merupakan bagian dari Eksplorasi Anda, yang dapat Anda pilih untuk menampilkan dimensi dan ukuran yang disertakan dalam tampilan tersebut.

  3. Pilih Tambahkan untuk menambahkan baris, kolom, nilai, atau filter. Sheets yang Terhubung menampilkan daftar tampilan yang tersedia di Jelajah Anda. Pilih nama tampilan untuk menampilkan daftar dimensi dan ukuran dalam tampilan, lalu pilih kolom yang menyediakan data untuk baris, kolom, nilai, atau filter Anda.

  4. Setelah menambahkan kolom dan filter Looker untuk membuat kueri, pilih Terapkan. Tindakan ini akan mengisi spreadsheet Anda dengan data dari instance Looker Anda.

Setelah menambahkan data Looker ke tabel pivot, Anda dapat menggunakan Google Spreadsheet untuk memformat data atau membuat formula sheet baru berdasarkan data Looker.

Opsi pemfilteran

Sejak rilis awal Sheet yang Terhubung untuk Looker, opsi pemfilteran baru telah ditambahkan.

Filter berdasarkan nilai

Dimungkinkan untuk memfilter dimensi Looker dalam tabel pivot Sheet yang Terhubung untuk Looker dengan melihat daftar nilai dan memilih serta membatalkan pilihan nilai yang diinginkan. Sebelumnya, Anda harus mengetik nilai filter secara manual saat menggunakan pemfilteran menurut kondisi.

Untuk menggunakan fitur ini, tambahkan kolom ke bagian Filter pada tabel pivot, lalu klik drop-down Status untuk membuka opsi filter. Kemudian, klik Tambahkan Filter:

Sidebar akan terbuka, dan Spreadsheet akan mengambil 500 nilai yang paling sering muncul dari Looker.

Kemudian, Anda dapat menelusuri item, memilih untuk memilih atau menghapus semua, atau mengurutkan item berdasarkan frekuensi atau abjad. Saat Anda mengklik OKE di bagian bawah, Spreadsheet akan menyimpan pilihan Anda. Kemudian, Anda dapat mengklik Terapkan untuk memuat ulang tabel pivot seperti biasa, dengan filter baru yang diterapkan.

Filter menggunakan ekspresi filter Looker

Anda dapat menerapkan filter tanggal relatif, serta banyak filter lanjutan lainnya, di Sheet yang Terhubung dengan menggunakan ekspresi filter Looker. Misalnya, Anda dapat menerapkan filter seperti "berada dalam 30 menit terakhir" atau "berada dalam 10 hari terakhir" di Sheet yang Terhubung.

Untuk menggunakan ekspresi filter Looker:

  1. Tambahkan kolom ke bagian filter tabel pivot.

  2. Klik drop-down Status untuk menampilkan opsi filter, lalu pilih Filter ekspresi.

  3. Masukkan ekspresi filter Looker apa pun ke kolom Nilai.

    Misalnya, untuk memfilter 7 hari terakhir, Anda dapat menulis "7 hari" atau "7 hari terakhir".

  4. Klik Oke.

Selain pemfilteran tanggal relatif, contoh pemfilteran lain yang kini dapat dilakukan meliputi:

  • String yang tidak dimulai dengan: -FOO%
  • Rentang numerik inklusif dan eksklusif: (12, 20]

Untuk melihat semua ekspresi filter yang tersedia, lihat halaman dokumentasi Ekspresi filter Looker.

Menggunakan parameter Looker dan kolom khusus filter

Anda kini dapat menggunakan parameter dan kolom khusus filter di Sheet yang Terhubung.

Kolom dan parameter khusus filter akan muncul di bagian KOLOM KHUSUS FILTER di pemilih kolom di Spreadsheet, seperti di Looker. Untuk menggunakannya, ikuti langkah-langkah berikut:

  1. Tambahkan atau tarik parameter dan kolom khusus filter yang dipilih ke bagian Filter, seperti yang Anda lakukan untuk memfilter dimensi atau ukuran.
  2. Untuk parameter dengan nilai yang diizinkan, nilai ini akan ditampilkan di drop-down dalam dialog Filter menurut kondisi.
  3. Untuk kolom hanya filter, Anda dapat menggunakan dialog Filter menurut kondisi reguler. Jika kolom memiliki saran yang ditentukan dalam model Looker, Anda juga dapat menggunakan fitur filter menurut nilai.

Memperbarui data Anda di Google Spreadsheet

Data dalam tabel pivot Anda bersifat statis, tetapi dapat diperbarui kapan saja. Memuat ulang data akan menyebabkan Looker membuat kueri database Anda dan memperbarui tabel pivot dengan data terbaru.

Tabel pivot dan sheet yang menampilkan Look atau Eksplorasi Anda akan menampilkan waktu saat terakhir kali diperbarui.

Pilih Muat ulang untuk memperbarui data dalam tabel pivot.

Menjadwalkan waktu muat ulang rutin

Untuk menjadwalkan pembaruan otomatis data Anda, pilih menu tiga titik di tabel pivot, lalu pilih Opsi Muat Ulang, atau pilih Opsi Muat Ulang di sheet Jelajah Anda. Looker akan menampilkan dialog Penyegaran Terjadwal.

Mengedit setelan tabel pivot

Untuk mengubah baris, kolom, nilai, atau filter yang disertakan dalam tabel pivot, pilih ikon pensil di samping menu tiga titik untuk membuka panel editor tabel pivot.

Memantau Sheet yang Terhubung

Admin Looker dapat melihat penggunaan Sheet yang Terhubung menggunakan grup kolom Query API Client Properties di System Activity History Explore. Entri dibuat di Eksplorasi Histori setiap kali kueri baru dijalankan.

Di grup kolom Properti Klien API Kueri, ada tiga kolom baru untuk Spreadsheet Terhubung:

  • Nama Klien API — Kolom ini akan selalu menampilkan Connected Sheets untuk mengidentifikasi entri Spreadsheet yang Terhubung.
  • ID Spreadsheet Sheet yang Terhubung — Kolom ini menampilkan ID sheet, yang disertakan dalam URL Google Spreadsheet untuk sheet tersebut.
  • Pemicu Sheet yang Terhubung — Kolom ini menunjukkan apakah kueri dipicu oleh pengguna yang memilih tombol Muat Ulang di Spreadsheet atau oleh pembaruan terjadwal.

Berikut adalah contoh URL Aktivitas Sistem yang menunjukkan penggunaan Spreadsheet yang Terhubung. Ganti <instance_name.looker.com> dengan URL instance Anda.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

Dukungan API Sheet yang Terhubung

Dukungan API untuk Sheet yang Terhubung untuk Looker dapat diakses melalui AppsScript dan Google Sheets API.

Beberapa hal yang dapat Anda lakukan secara terprogram dengan dukungan API meliputi:

  • Pembaruan data otomatis: Anda dapat menjadwalkan pembaruan rutin pada spreadsheet yang didukung Looker untuk memastikan Anda menggunakan informasi terbaru.
  • Alur kerja kustom: Anda dapat membuat proses kompleks yang menggabungkan data Looker ke dalam alur kerja Google Spreadsheet yang ada.
  • Integrasi dengan aplikasi lain: Anda dapat menghubungkan data Looker ke alat dan layanan eksternal menggunakan API Apps Script atau Google Spreadsheet.

Untuk menentukan Looker sebagai sumber data dengan Google Sheets API, gunakan objek looker dengan resource REST DataSourceSpec.

Hal untuk diketahui

  • Kepekaan huruf besar/kecil untuk data yang ditampilkan dalam tabel pivot ditentukan oleh setelan kepekaan huruf besar/kecil untuk model. Namun, filter pada tabel pivot memaksakan ketidakpekaan huruf besar/kecil dalam situasi saat filter tidak peka huruf besar/kecil untuk data native Spreadsheet.
  • Siapa pun yang memiliki akses Pelihat ke sheet akan dapat melihat data yang di-cache dalam tabel pivot.
  • Selain akses Editor ke sheet, setiap pengguna yang perlu mengedit atau memuat ulang tabel pivot akan memerlukan izin yang benar di Looker untuk mengakses model data. Hal ini mencakup akses ke model yang menjadi dasar tabel pivot, izin untuk melihat data, dan akses yang tepat ke data melalui filter akses atau pemberian akses.
  • Jika pengguna melakukan autentikasi dengan OAuth ke database BigQuery, mereka mungkin memerlukan izin untuk diberikan pada database pokok.

Batas data dan baris Sheet yang Terhubung

Kueri yang dibuat dengan Sheet yang Terhubung memiliki batas maksimum 100.000 baris. Jika hasil kueri berisi lebih banyak baris, Spreadsheet akan menampilkan error kepada pengguna. Jika pengguna tidak memiliki izin download_without_limit, hasilnya akan dipangkas hingga maksimum 5.000 baris,terlepas dari batas Spreadsheet.

Selain itu, kueri Sheet yang Terhubung tunduk pada batas ukuran data. Kueri yang menampilkan terlalu banyak data juga akan menghasilkan error.

Jika Anda melihat salah satu error ini, pertimbangkan untuk menambahkan filter atau menggunakan lebih sedikit dimensi dan/atau dimensi yang kurang terperinci dalam kueri Anda.

Memecahkan masalah Sheet yang Terhubung

Anda mungkin mengalami beberapa masalah saat mencoba terhubung ke Looker dari Google Spreadsheet. Bagian ini menjelaskan masalah tersebut dan cara memperbaikinya.

Error: Terjadi error saat menghubungkan ke instance Looker Anda. Coba lagi. Jika masalah berlanjut, harap kirim masukan.

Error ini dapat terjadi karena beberapa alasan:

  • Nama instance Looker dimasukkan dengan salah. Dalam hal ini, verifikasi nama instance Looker Anda dan coba hubungkan lagi.
  • Spreadsheet tidak dapat terhubung ke Looker API. Hal ini dapat terjadi jika instance Looker Anda tidak menggunakan URL Host API default. Untuk memperbaikinya, biarkan kolom URL Host API di panel admin API kosong.

Error: Instance Looker tidak dikonfigurasi untuk menggunakan fitur ini. Hubungi admin Looker Anda untuk memastikan instance memenuhi syarat.

Error ini dapat terjadi karena beberapa alasan:

  • Anda mencoba terhubung ke instance Looker yang baru dibuat. Diperlukan waktu hingga 24 jam agar instance Looker baru tersedia di Spreadsheet yang Terhubung.
  • Anda mencoba terhubung ke instance Looker yang tidak dihosting oleh Looker. Hubungkan ke instance Looker lain yang dihosting Looker.

Tidak ada model yang muncul setelah terhubung ke instance Looker

Hal ini menunjukkan bahwa Anda tidak memiliki izin yang diperlukan untuk melihat model di instance Anda.

Pengguna Looker dengan peran Pelihat tidak memiliki izin yang memadai untuk membuat koneksi di Spreadsheet, sama seperti mereka tidak memiliki izin yang memadai untuk menggunakan UI Jelajah di Looker. Jika pengguna ingin menggunakan Sheet yang Terhubung untuk Looker, mereka harus memiliki izin explore. Peran Admin, Developer, dan Pengguna mencakup izin explore. Admin Looker dapat memberikan izin explore kepada pengguna, dan hal ini akan memungkinkan pengguna melihat model di instance.

Error: Alamat email akun Looker yang ditautkan berbeda dengan alamat email Akun Google Anda.

Hal ini menunjukkan bahwa alamat email akun Looker Anda tidak cocok dengan alamat email yang digunakan dengan Akun Google Anda. Pastikan Anda login ke Akun Google yang memiliki alamat email yang cocok dengan akun Looker Anda. Atau, admin Looker dapat membuat akun pengguna Looker baru yang menggunakan alamat email Google Anda saat ini.

Error: Permintaan Buruk: tidak ada klien yang diaktifkan.

Error ini menunjukkan bahwa konektor Sheet yang Terhubung belum diaktifkan. Admin Looker harus mengaktifkan tombol Semua Konektor BI Looker atau Sheet yang Terhubung di panel Konektor BI di bagian Platform pada menu Admin Looker.

Error: 403 Forbidden

Jika instance Looker Anda telah mengonfigurasi daftar yang diizinkan IP, daftar yang diizinkan tersebut dapat mencegah Spreadsheet terhubung ke Looker API. Untuk menentukan apakah daftar yang diizinkan adalah penyebabnya, coba buka URL instance Looker untuk melihat apakah Anda menerima error Alamat IP Tidak Ada dalam Daftar yang Diizinkan.