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 Tindakan penjelajahan Connected Sheets, laporkan ke [e-mail].

Halaman ini menjelaskan cara mengaktifkan dan menggunakan opsi link cepat Sheet yang Terhubung dari menu roda gigi Tindakan jelajah di Looker. Opsi Sheet yang Terhubung akan membuka Google Spreadsheet dan memulai koneksi dari Google Spreadsheet ke Eksplorasi Looker. 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 ini 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 sematan Looker.

Menggunakan link cepat Sheet yang Terhubung dari Eksplorasi

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

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

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

   Tips: Anda tidak perlu membuat kueri di Eksplorasi; Anda dapat membiarkan Eksplorasi 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 sama dengan alamat email yang dikaitkan dengan akun pengguna Looker Anda.

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

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.

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

Lihat halaman dokumentasi Menggunakan Sheet yang Terhubung untuk Looker untuk 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 Tindakan penjelajahan, 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 Spreadsheet yang Terhubung hanya didukung untuk koneksi jaringan koneksi aman publik atau koneksi hibrida. Instance koneksi pribadi (akses layanan pribadi) Looker (Google Cloud core) tidak didukung.
• Untuk instance Looker (asli), link cepat Sheet yang Terhubung hanya didukung untuk instance yang dihosting Looker. Instance Looker yang dihosting oleh pelanggan tidak didukung.

Untuk mengaktifkan opsi Spreadsheet Terhubung di menu roda gigi Tindakan penjelajahan pada instance Looker, admin harus melakukan tugas umum berikut, yang dijelaskan di bagian berikut:

• Aktifkan Google Sheets API di Google Cloud konsol.
• Buat klien OAuth di konsol Google Cloud dalam project konsol Google Cloud yang sama tempat Google Sheets API diaktifkan.
• Aktifkan dan konfigurasi opsi Aktifkan link cepat Spreadsheet yang Terhubung di halaman Konektor BI Looker.

Mengaktifkan Google Sheets API di konsol Google Cloud

Link cepat Spreadsheet Terhubung menggunakan Google Sheets API, jadi 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 Google Cloud konsol Open project picker, pilih project yang ingin Anda gunakan untuk terhubung ke Google Spreadsheet dari Eksplorasi Looker. Anda harus menggunakan project konsol Google Cloud yang sama selama prosedur penyiapan link cepat Spreadsheet 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.

Buat 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 yang dipilih, konsol akan menampilkan pemberitahuan dengan tombol Konfigurasi layar izin. Google Cloud Google Cloud 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 Google Cloud konsol, gunakan Google Cloud konsol Pemilih project terbuka untuk membuka project yang sama tempat Anda mengaktifkan Google Sheets API.

   Buka Google Cloud konsol

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 drop-down Application type, pilih Web application.

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

6. Di bagian URI pengalihan yang diberi otorisasi, klik tombol Tambahkan 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 Buat.

9. Setelah Anda mengklik Buat, jendela Klien OAuth dibuat akan muncul. Jendela ini menampilkan client ID dan rahasia klien yang dibuat konsol untuk klien OAuth Anda. Google Cloud Salin dan catat nilai ini karena akan diperlukan saat Anda mengonfigurasi opsi link cepat Aktifkan Sheet yang Terhubung.

Mengonfigurasi opsi link cepat Aktifkan Sheet yang Terhubung

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.
3. Aktifkan tombol bertingkat Aktifkan link cepat Sheet yang Terhubung.
4. Di kolom Client ID dan Client Secret, tempel nilai yang Anda salin dari konsol Google Cloud saat Anda membuat klien OAuth di konsol Google Cloud .
5. Klik Simpan.

Opsi Sheet yang Terhubung di menu roda gigi Tindakan jelajah kini 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 dihentikan demi metode yang lebih aman dan skalabel, di mana setiap admin Looker mengonfigurasi klien OAuth-nya sendiri untuk instance Looker-nya. Pelanggan uji coba yang sudah 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. Langkah-langkahnya sama dengan penyiapan pertama kali, yang dijelaskan di bagian-bagian halaman ini:

• Aktifkan Google Sheets API di konsol Google Cloud
• Buat klien OAuth di Google Cloud konsol dalam project konsol Google Cloud yang sama tempat Google Sheets API diaktifkan
• Aktifkan dan konfigurasi opsi Aktifkan link cepat Spreadsheet Terhubung di halaman Konektor BI Looker

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

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 "Spreadsheet yang terhubung" tidak terlihat: Opsi ini akan muncul di menu roda gigi Tindakan eksplorasi hanya jika admin Looker Anda telah mengaktifkan fitur ini di setelan Konektor BI. 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].