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 secara interaktif dari model LookML melalui antarmuka spreadsheet Google Spreadsheet yang sudah dikenal. Pengguna Spreadsheet akan memiliki akses ke data yang diatur dari 50+ database yang didukung oleh Looker. Eksplorasi bersifat intuitif karena Sheet yang Terhubung menyajikan tampilan model yang tertata dengan tampilan, kolom, dan ukuran seperti yang didefinisikan 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 oleh Looker.

Mengaktifkan Sheet yang Terhubung

Untuk menggunakan Sheet yang Terhubung:

• Di Looker (asli), admin Looker Anda harus mengaktifkan tombol Konektor BI Looker atau tombol Sheet yang Terhubung di panel Konektor BI di bagian Platform pada menu Admin Looker. Di Looker (Google Cloud Core), 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 dihosting di Google Cloud. Jika instance Looker Anda tidak dihosting di Google Cloud, instance tersebut harus menjalankan Looker 23.4 atau yang lebih baru.
• Setiap pengguna yang ingin terhubung ke instance Looker dari Google Spreadsheet harus menggunakan alamat email yang sama di akun pengguna Looker-nya dengan yang digunakan untuk akun Google Workspace. Jika alamat email akun Workspace dan Looker miliknya berbeda, kedua akun tersebut akan menerima pesan error saat mencoba terhubung ke Looker dari Spreadsheet.
• Akses ke layanan yang tidak dikontrol satu per satu harus diaktifkan di konsol Admin Google Workspace Anda. Tindakan ini biasanya diaktifkan secara default. Untuk mengetahui informasi selengkapnya, lihat artikel bantuan Mengelola akses ke layanan yang tidak dikontrol satu per satu.

Terhubung ke Looker dari Google 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-baru ini Anda hubungkan, lalu pilih Lanjutkan.

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

3. Pada dialog berikut, pilih model dan Explore Looker yang ingin digunakan untuk kueri Anda, lalu pilih Connect.

Saat Spreadsheet terhubung ke instance Looker Anda, Spreadsheet akan membuka sheet baru yang menampilkan struktur Jelajah yang dipilih, termasuk tampilan, dimensi, ukuran, dan deskripsi kolom apa pun 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 Explore, pilih Pivot Table.

2. Pilih apakah akan menyisipkan tabel pivot baru di sheet baru atau sheet yang sudah 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 Jelajah Looker Anda.

   

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

   • Baris setara dengan dimensi Looker.
   • Kolom setara dengan dimensi berubah Looker.
   • Nilai setara dengan ukuran Looker. Anda dapat membuat pengukuran kustom dengan memilih dimensi Looker dan fungsi Rangkum berdasarkan 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. Sheet 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.

4. Setelah Anda 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 fungsi Google Spreadsheet reguler 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 yang menggunakan ekspresi filter Looker nanti dalam dokumen ini.

Filter menurut nilai — ditambahkan Agustus 2023

Dimensi Looker dapat difilter di Sheet yang Terhubung untuk tabel pivot Looker dengan melihat daftar nilai dan memilih serta membatalkan pilihan nilai yang diminati. Sebelumnya, Anda perlu mengetikkan nilai filter secara manual saat menggunakan pemfilteran menurut kondisi.

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

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

Selanjutnya, Anda dapat menelusuri item, memilih atau menghapus semua, atau mengurutkan item menurut frekuensi atau menurut abjad. Ketika Anda mengklik Oke di bagian bawah, Spreadsheet akan menyimpan pilihan Anda. Anda kemudian 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 apa pun ke dalam kolom Nilai.

   

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

4. Klik OK.

Selain pemfilteran tanggal relatif, contoh pemfilteran lain yang sekarang dapat dilakukan mencakup:

• 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 — ditambahkan Oktober 2023

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

Kolom dan parameter khusus filter akan muncul di bagian KOLOM HANYA FILTER pada pemilih kolom di Spreadsheet, seperti halnya 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 pada dialog Filter menurut kondisi.
3. Untuk kolom khusus 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 di tabel pivot Anda bersifat statis, tetapi dapat diperbarui kapan saja. Memuat ulang data akan menyebabkan Looker mengkueri database dan memperbarui tabel pivot dengan data terbaru.

Catatan: Untuk meningkatkan performa, Looker menyimpan hasil kueri dalam cache seperti yang ditentukan oleh kebijakan caching 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 dapat menampilkan data yang sama.

Tabel pivot dan lembar yang menampilkan layar Explore Anda menunjukkan waktu pembaruan terkini.

Pilih Refresh untuk memperbarui data di tabel pivot Anda.

Menjadwalkan waktu pembaruan reguler

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

Mengedit setelan tabel pivot

Untuk mengubah baris, kolom, nilai, atau filter yang disertakan dalam tabel pivot Anda, 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 Properti Klien Query API di Jelajah Histori Aktivitas Sistem. Entri dibuat di Jelajahi Histori setiap kali kueri baru dijalankan.

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

• Nama Klien API — Kolom ini akan selalu menampilkan Connected Sheets untuk mengidentifikasi entri Sheet yang Terhubung.
• ID Spreadsheet Sheet yang Terhubung — Kolom ini menampilkan ID sheet, yang disertakan di 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 Sheet 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

Hal untuk diketahui

• Kepekaan huruf besar/kecil untuk data yang ditampilkan dalam tabel pivot ditentukan oleh setelan peka huruf besar/kecil untuk model. Namun, filter pada tabel pivot memaksakan ketidakpekaan huruf besar/kecil dalam situasi ketika 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 di 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 sesuai ke data melalui filter akses atau pemberian akses.
• Jika pengguna melakukan autentikasi dengan OAuth ke database BigQuery, pengguna mungkin perlu memberikan izin pada database pokok.

Batas data dan baris Sheet yang Terhubung

Kueri yang dibuat dengan Sheet yang Terhubung memiliki batas maksimum 30.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 dipotong 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 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, kosongkan kolom API Host URL di panel admin API.

Error: Instance Looker tidak dikonfigurasi untuk menggunakan fitur ini. Hubungi admin Looker Anda untuk memastikannya 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 Sheet yang Terhubung.
• Anda mencoba terhubung ke instance Looker yang tidak dihosting 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 pada instance Anda.

Pengguna Looker dengan peran Pelihat tidak memiliki izin yang memadai untuk membuat koneksi di Spreadsheet, karena pengguna tersebut 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 mencakup izin explore. Admin Looker dapat memberikan izin explore kepada pengguna, dan izin tersebut akan memungkinkan pengguna melihat model di instance.

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

Hal ini menunjukkan bahwa alamat email akun Looker Anda tidak cocok dengan alamat email yang digunakan di 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: klien yang diaktifkan tidak ditemukan.

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

Error: 403 Terlarang

Jika instance Looker Anda memiliki daftar IP yang diizinkan yang dikonfigurasi, daftar yang diizinkan dapat mencegah Spreadsheet terhubung ke Looker API. Untuk mengetahui apakah daftar yang diizinkan adalah penyebabnya, coba buka URL instance Looker untuk melihat apakah Anda menerima error Alamat IP Tidak Ada di Daftar yang Diizinkan.