Link cepat Sheet yang Terhubung

Pratinjau: Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika Anda mengalami masalah selama Pratinjau Publik opsi menu roda gigi Explore actions di Sheet yang Terhubung, laporkan ke [e-mail].

Halaman ini menjelaskan cara mengaktifkan dan menggunakan opsi link cepat Sheet yang Terhubung dari menu roda gigi Explore actions di Looker. Opsi Sheet yang Terhubung akan membuka Google Spreadsheet dan memulai koneksi dari Google Spreadsheet ke Looker Explore. Kemudian, Anda dapat membuat laporan, tabel pivot, atau diagram dalam Spreadsheet Google yang baru dibuat menggunakan kolom dari Eksplorasi Looker yang dipilih.

Sebelum memulai

Untuk menggunakan link cepat Sheet yang Terhubung, Anda memerlukan hal berikut:

• Instance Looker yang telah diaktifkan dan dikonfigurasi untuk fitur tersebut oleh admin seperti yang dijelaskan di bagian Mengaktifkan dan mengonfigurasi link cepat Sheet yang Terhubung di halaman ini
• Akun pengguna Looker dengan izin explore untuk model LookML yang ingin Anda hubungkan ke Spreadsheet
• Akun Google dengan alamat email yang sama dengan yang terkait dengan akun Looker Anda

Catatan: Fitur ini tidak tersedia untuk pengguna penyematan Looker.

Menggunakan link cepat Sheet yang Terhubung dari Explore

Jika admin Looker telah mengaktifkan fitur ini, Anda dapat memulai koneksi antara Google Spreadsheet dan Explore mana pun yang dapat Anda akses:

1. Login ke Looker dengan alamat email yang terkait dengan Akun Google Anda.

2. Di Looker, buka Explore yang ingin Anda gunakan sebagai sumber data.

   Tips: Anda tidak perlu membuat kueri di Explore; Anda dapat membiarkan Explore kosong.

3. Klik ikon roda gigi Explore actions, lalu pilih Connected Sheets.

4. Saat pertama kali menggunakan fitur ini, Anda akan diminta untuk mengizinkan Looker mengakses Akun Google Anda. Pilih Akun Google yang ingin Anda gunakan. Alamat email untuk Akun Google harus cocok dengan alamat email yang terkait dengan akun pengguna Looker Anda.

5. Tinjau izin yang diminta di layar izin, lalu klik Allow.

6. Tab browser baru akan terbuka ke Google Spreadsheet dan menampilkan dialog yang menanyakan apakah Anda ingin menautkan Akun Google Anda dengan akun Looker Anda. Klik Tautkan Akun.

Spreadsheet Google kini terhubung ke Looker Explore tempat Anda memulai. Dalam Spreadsheet Google, Anda dapat menambahkan kolom dari Eksplorasi, membuat tabel pivot, membuat diagram, dan menerapkan formula untuk menganalisis data dari Eksplorasi Looker.

Lihat halaman dokumentasi Menggunakan Sheet yang Terhubung untuk Looker guna mengetahui informasi selengkapnya tentang cara membuat kueri di Sheet yang Terhubung.

Mengaktifkan dan Mengonfigurasi link cepat Sheet yang Terhubung

Untuk mengaktifkan link cepat Sheet yang Terhubung di menu roda gigi Explore actions, instance Looker Anda harus memenuhi persyaratan berikut:

• Instance Anda harus menjalankan Looker 25.20 atau yang lebih baru.
• Untuk instance Looker (Google Cloud core), link cepat Sheet yang Terhubung hanya didukung untuk koneksi jaringan koneksi aman publik atau koneksi hybrid. Instance koneksi pribadi (akses layanan pribadi) Looker (Google Cloud core) tidak didukung.
• Untuk instance Looker (original), link cepat Sheet yang Terhubung hanya didukung untuk instance yang dihosting oleh Looker. Instance Looker yang dihosting pelanggan tidak didukung.

Untuk mengaktifkan opsi Sheet yang Terhubung di menu roda gigi Explore actions pada instance Looker, admin harus melakukan tugas umum berikut, yang dijelaskan di bagian berikut:

• Aktifkan Google Sheets API di konsol Google Cloud .
• Buat klien OAuth di konsol Google Cloud dalam project konsol Google Cloud yang sama tempat Google Sheets API diaktifkan.
• Aktifkan dan konfigurasi opsi Enable Connected Sheets quick link di halaman Looker BI Connectors.

Mengaktifkan Google Sheets API di konsol Google Cloud

Link cepat Sheet yang Terhubung menggunakan Google Sheets API, sehingga API ini harus diaktifkan di project yang sama dengan yang akan Anda gunakan untuk membuat klien OAuth. Google Sheets API dapat diaktifkan oleh pengguna IAM dengan izin IAM roles/serviceusage.serviceUsageAdmin.

Lakukan langkah-langkah berikut untuk mengaktifkan Google Sheets API:

1. Di menu navigasi konsol Google Cloud , buka APIs & Services > Library, lalu buka Google Sheets API.

   Buka Google Sheets API

2. Dari konsol Google Cloud Buka pemilih project, pilih project yang ingin Anda gunakan untuk terhubung ke Google Spreadsheet dari Explore Looker. Anda harus menggunakan project konsol Google Cloud yang sama selama prosedur penyiapan link cepat Sheet yang Terhubung, sehingga Google Sheets API diaktifkan di project yang sama tempat Anda mengonfigurasi OAuth.

3. Di halaman Google Sheets API, klik Enable jika API belum diaktifkan.

Membuat klien OAuth

Pengguna IAM dengan peran yang diperlukan harus membuat klien OAuth.

Anda dapat menyiapkan klien OAuth di project Google Cloud mana pun yang Anda inginkan. Namun, Google Sheets API harus diaktifkan di project yang sama ini.

Catatan: Sebelum Anda dapat membuat kredensial OAuth, Google mewajibkan Anda mengonfigurasi layar izin OAuth, yang memungkinkan pengguna memilih cara memberikan akses ke data pribadi mereka. Jika Anda belum mengonfigurasi layar izin OAuth untuk project konsol Google Cloud yang dipilih, konsol Google Cloud akan menampilkan pemberitahuan dengan tombol Configure consent screen. Klik tombol tersebut dan ikuti prosedur di halaman dokumentasi Workspace Mengonfigurasi layar izin OAuth dan memilih cakupan, lalu kembali ke prosedur ini.

Untuk membuat klien dan kredensialnya, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , gunakan Google Cloud pemilih project konsol untuk membuka project yang sama tempat Anda mengaktifkan Google Sheets API.

   Buka konsol Google Cloud

2. Gunakan menu utama konsol Google Cloud untuk membuka APIs & Services > Credentials.

3. Dari halaman Credentials, klik menu drop-down Create Credentials, lalu pilih OAuth client ID.

4. Di menu drop-down Application type, pilih aplikasi web.

5. Di kolom Name, masukkan nama untuk klien OAuth Anda, seperti Looker to Connected Sheets.

6. Di bagian Authorized redirect URIs, klik tombol Add URI. Tambahkan URI berikut:

   https://LOOKER_INSTANCE_URL/oauth2callback
   

7. Klik tombol Add URI untuk menambahkan URI berikut:

   https://LOOKER_INSTANCE_URL/external_oauth/redirect
   

8. Klik Create.

9. Setelah Anda mengklik Create, jendela OAuth client created akan muncul. Jendela ini menampilkan client ID dan rahasia klien yang dibuat oleh konsol Google Cloud untuk klien OAuth Anda. Salin dan catat nilai ini, karena akan diperlukan saat Anda mengonfigurasi opsi link cepat Enable Connected Sheets.

Mengonfigurasi opsi link cepat Enable Connected Sheets

Setelah mengaktifkan Google Sheets API di konsol Google Cloud dan membuat klien OAuth di konsol Google Cloud , Anda dapat mengaktifkan link cepat Sheet yang Terhubung di instance Looker dengan melakukan langkah-langkah berikut:

1. Di instance Looker, pilih BI Connectors dari bagian Platform di panel Admin.
2. Aktifkan tombol Google Spreadsheet jika belum diaktifkan (Anda juga dapat mengaktifkan klien Sheet yang Terhubung yang telah dikonfigurasi sebelumnya di halaman Kelola Klien OAuth; setelan antara kedua halaman disinkronkan).
3. Aktifkan tombol bertingkat Aktifkan link cepat Sheet yang Terhubung.
4. Di kolom Client ID dan Rahasia Klien, tempel nilai yang Anda salin dari konsol Google Cloud saat Anda membuat klien OAuth di konsol Google Cloud .
5. Klik Simpan.

Opsi Connected Sheets di menu roda gigi Explore actions kini telah disiapkan untuk instance Looker Anda.

Bermigrasi dari program uji coba

Jika organisasi Anda berpartisipasi dalam program uji coba sebelumnya untuk fitur Buka di Spreadsheet, instance Looker Anda menggunakan klien OAuth yang dikelola secara terpusat yang disediakan oleh Looker. Penyiapan ini tidak digunakan lagi dan digantikan dengan metode yang lebih aman dan skalabel, yaitu setiap admin Looker mengonfigurasi klien OAuth mereka sendiri untuk instance Looker mereka. Pelanggan uji coba yang ada harus beralih ke konfigurasi baru ini untuk memastikan fungsi yang berkelanjutan.

Untuk bermigrasi ke versi baru, admin harus menyiapkan klien OAuth organisasi Anda sendiri di konsol Google Cloud , lalu mengonfigurasi kredensial di halaman admin Looker BI Connectors. Langkahnya sama dengan penyiapan pertama kali, yang dijelaskan di bagian halaman ini:

• Aktifkan Google Sheets API di konsol Google Cloud
• Buat klien OAuth di konsol Google Cloud dalam project konsol Google Cloud yang sama tempat Google Sheets API diaktifkan
• Aktifkan dan konfigurasi opsi Enable Connected Sheets quick link di halaman Looker BI Connectors

Setelah admin menyelesaikan langkah-langkah ini, instance Anda akan otomatis menggunakan alur OAuth baru yang dikelola pelanggan. Fungsi uji coba sebelumnya dan ketergantungannya pada klien OAuth yang dikelola Looker tidak akan aktif lagi.

Pemecahan masalah

• Error ketidakcocokan email: Jika Anda mengalami error selama langkah autentikasi Google, pastikan Akun Google yang Anda pilih memiliki alamat email yang sama persis dengan akun pengguna Looker Anda.
• Opsi "Sheet yang Terhubung" tidak terlihat: Opsi ini akan muncul di menu roda gigi Explore actions hanya jika admin Looker Anda telah mengaktifkan fitur tersebut di setelan BI Connectors. Hubungi admin Looker Anda untuk mendapatkan bantuan.
• Izin konsolGoogle Cloud : Admin yang mengonfigurasi klien OAuth dan layar izin harus memiliki izin roles/oauthconfig.editor dan roles/serviceusage.serviceUsageAdmin di project Google Cloud .
• Untuk masalah atau masukan lainnya selama periode Pratinjau Publik, kirim email ke [e-mail].