Menggunakan Sheet yang Terhubung untuk Looker

Catatan: Halaman ini adalah bagian dari seri pembelajaran Mengambil dan memetakan data.

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

Catatan: Sheet yang Terhubung untuk Looker hanya tersedia untuk instance yang dihosting Looker.

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 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 seperti yang digunakan untuk akun Google Workspace mereka. Jika alamat email akun Google Workspace dan Looker-nya berbeda, dia 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. Fitur ini biasanya diaktifkan secara default. Untuk mengetahui informasi selengkapnya, lihat artikel bantuan Mengelola akses ke layanan yang tidak dikontrol satu per satu.

Menghubungkan ke Looker dari Google Spreadsheet

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

2. Pada dialog Connect to Looker, masukkan nama instance Looker Anda, atau pilih nama instance yang baru-baru ini Anda hubungkan, lalu pilih Continue.

   Catatan: Saat pertama kali terhubung ke instance Looker dari Google Spreadsheet, Anda akan diminta untuk menautkan akun Google dan Looker. Anda dapat membatalkan tautan akun Anda kapan saja. Untuk informasi selengkapnya tentang penautan Akun Google, lihat artikel bantuan Mengelola akun pihak ketiga yang telah Anda tautkan dengan Google.

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

Saat terhubung ke instance Looker, Spreadsheet akan membuka sheet baru yang menampilkan struktur Jelajah 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 sheet:

1. Dari sheet yang menampilkan Eksplorasi, 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 Jelajahi 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 pivot Looker.
   • Nilai setara dengan ukuran Looker. Anda dapat membuat ukuran kustom dengan memilih dimensi Looker dan fungsi Ringkas menurut Spreadsheet.
   • Filter setara dengan filter Looker.

   Editor pivot juga menampilkan daftar tampilan yang merupakan bagian dari Eksplorasi, 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 bagian Jelajahi. 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 sheet dengan data dari instance Looker Anda.

   

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

Opsi pemfilteran

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

Tips: Untuk pemfilteran tanggal relatif, lihat bagian Filter menggunakan ekspresi filter Looker nanti dalam dokumen ini.

Filter menurut nilai — ditambahkan Agustus 2023

Anda dapat memfilter dimensi Looker di tabel pivot Sheet yang Terhubung untuk Looker dengan melihat daftar nilai, lalu memilih dan 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 menu dropdown 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 menurut frekuensi atau abjad. Saat Anda mengklik OK 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 yang menggunakan ekspresi filter Looker — ditambahkan September 2023

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

Untuk menggunakan ekspresi filter Looker:

1. Tambahkan kolom ke bagian filter di tabel pivot.

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

   

3. Masukkan ekspresi filter Looker ke kolom Value.

   

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

4. Klik Oke.

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

• String yang tidak diawali 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 — ditambahkan Oktober 2023

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

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

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

Memperbarui data di Google Spreadsheet

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

Catatan: Untuk meningkatkan performa, Looker menyimpan hasil kueri dalam cache seperti yang ditentukan oleh kebijakan penyimpanan dalam cache yang ditentukan dalam model. Saat Anda memuat ulang data dari Google Spreadsheet, data yang ditampilkan mungkin berasal dari cache Looker. Jika cache Looker belum habis masa berlakunya sejak pembaruan Google Spreadsheet terbaru, pembaruan Google Spreadsheet mungkin menampilkan data yang sama.

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

Pilih Muat ulang untuk memperbarui data dalam tabel pivot.

Menjadwalkan waktu refresh rutin

Untuk menjadwalkan pembaruan data otomatis, pilih menu tiga titik di tabel pivot, lalu pilih Opsi Muat Ulang, atau pilih Opsi Muat Ulang di sheet Jelajahi. Looker menampilkan dialog Pembaruan 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 Jelajah Histori Aktivitas Sistem. Entri dibuat di Jelajahi Histori setiap kali kueri baru dijalankan.

Dalam grup kolom Query API Client Properties, 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 Refresh di Spreadsheet atau oleh pembaruan terjadwal.

Berikut adalah contoh URL Aktivitas Sistem yang menampilkan penggunaan Spreadsheet 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 Connected Sheets API

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

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

• Muat ulang data otomatis: Anda dapat menjadwalkan pembaruan rutin ke spreadsheet yang didukung Looker untuk memastikan bahwa 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 AppsScript atau Google Spreadsheet API.

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 memaksa ketidakpekaan huruf besar/kecil dalam situasi saat filter tidak peka huruf besar/kecil untuk data Spreadsheet native.
• 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 mengautentikasi dengan OAuth ke database BigQuery, mereka mungkin memerlukan izin yang diberikan di 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 menjadi 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 dimensi yang lebih sedikit dan/atau 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 yang dimasukkan 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. Mungkin perlu waktu hingga 24 jam agar instance Looker baru tersedia di Spreadsheet yang Terhubung.
• Anda mencoba terhubung ke instance Looker yang tidak dihosting oleh Looker. Menghubungkan 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 ingin menggunakan Sheet yang Terhubung untuk Looker, pengguna harus memiliki izin explore. Peran Admin, Developer, dan Pengguna menyertakan 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 Tidak Valid: 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 memiliki daftar yang diizinkan IP yang dikonfigurasi, daftar yang diizinkan dapat mencegah Sheet 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.