Link cepat Sheet yang Terhubung

Pratinjau: Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari 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 Sheet yang Terhubung Explore actions, laporkan masalah tersebut ke [e-mail].

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

Sebelum memulai

Untuk menggunakan link cepat Connected Sheets, 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 Connected Sheets 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 yang terkait dengan akun Looker Anda

Catatan: Fitur ini tidak tersedia untuk pengguna Looker Embed.

Menggunakan link cepat Connected Sheets dari Explore

Jika admin Looker Anda 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 mengosongkan Explore.

3. Klik ikon roda gigi Explore actions setelan, 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 dengan akun Looker Anda. Klik Link Account.

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

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 Connected Sheets

Untuk mengaktifkan link cepat Connected Sheets 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 Connected Sheets hanya didukung untuk koneksi jaringan koneksi aman publik atau hibrida. Instance koneksi pribadi Looker (Google Cloud core) (akses layanan pribadi) tidak didukung.
• Untuk instance Looker (original), link cepat Connected Sheets hanya didukung untuk instance yang dihosting Looker. Instance Looker yang dihosting pelanggan tidak didukung.

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

• Mengaktifkan Google Sheets API di Google Cloud konsol.
• Membuat klien OAuth di Google Cloud konsol di project Google Cloud konsol yang sama tempat Google Sheets API diaktifkan.
• Mengaktifkan dan mengonfigurasi opsi Enable Connected Sheets quick link di halaman Looker BI Connectors.

Mengaktifkan Google Sheets API di Google Cloud konsol

Link cepat Connected Sheets menggunakan Google Sheets API, sehingga API ini harus diaktifkan di project yang sama 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 Google Cloud konsol, 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 Looker Explore Anda. Anda harus menggunakan project Google Cloud konsol yang sama di seluruh prosedur penyiapan link cepat Connected Sheets agar 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 mana pun yang Anda inginkan. Google Cloud 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 Google Cloud konsol yang dipilih, Google Cloud konsol 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. Dikonsol, gunakan konsol Open project picker untuk membuka project yang sama tempat Anda mengaktifkan Google Sheets API. Google Cloud Google Cloud

   Buka Google Cloud konsol

2. Gunakan menu utama Google Cloud konsol 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 Web application.

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 client secret yang dibuat Google Cloud konsol untuk klien OAuth Anda. Salin dan catat nilai ini, karena nilai ini akan diperlukan saat Anda mengonfigurasi opsi Enable Connected Sheets quick link.

Mengonfigurasi opsi Enable Connected Sheets quick link

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

1. Di instance Looker, pilih BI Connectors dari bagian Platform pada panel Admin.
2. Aktifkan tombol Google Sheets jika belum diaktifkan.
3. Aktifkan tombol bertingkat Enable Connected Sheets quick link.
4. Di kolom Client ID dan Client Secret, tempel nilai yang Anda salin dari Google Cloud konsol saat Anda membuat klien OAuth di Google Cloud konsol.
5. Klik Save.

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 Open in Sheets, instance Looker Anda menggunakan klien OAuth yang dikelola secara terpusat yang disediakan oleh Looker. Penyiapan ini tidak digunakan lagi dan diganti dengan metode yang lebih aman dan skalabel, yang memungkinkan 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 tetap berjalan.

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

• Mengaktifkan Google Sheets API di Google Cloud konsol
• Membuat klien OAuth di Google Cloud konsol di project Google Cloud konsol yang sama tempat Google Sheets API diaktifkan
• Mengaktifkan dan mengonfigurasi opsi Enable Connected Sheets quick link di halaman Looker BI Connectors

Setelah admin menyelesaikan langkah-langkah ini, instance Anda akan otomatis menggunakan alur OAuth yang dikelola pelanggan yang 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"Connected Sheets" tidak terlihat: Opsi ini akan muncul di menu roda gigi Explore actions hanya jika admin Looker Anda telah mengaktifkan fitur ini di setelan BI Connectors. Hubungi admin Looker Anda untuk mendapatkan bantuan.
• Google Cloud Izin konsol: Admin yang mengonfigurasi klien OAuth dan layar izin harus memiliki izin roles/oauthconfig.editor dan roles/serviceusage.serviceUsageAdmin di Google Cloud project.
• Untuk masalah atau masukan lainnya selama periode Pratinjau Publik, kirim email ke [e-mail].