Setelan admin - Eksplorasi layanan mandiri

Dengan fitur Eksplorasi Layanan Mandiri, pengguna Looker dapat mengupload file CSV, XLS, dan XLSX ke Looker, lalu membuat kueri dan memvisualisasikan data dalam Eksplorasi Looker tanpa perlu mengonfigurasi model LookML atau menyiapkan kontrol versi Git.

Admin Looker dapat memilih opsi Eksplorasi Layanan Mandiri dari menu Admin Looker untuk mengonfigurasi fitur Eksplorasi Layanan Mandiri dan melihat upload data di instance.

Sebelum memulai

Untuk menggunakan Eksplorasi layanan mandiri, instance Looker Anda harus memenuhi persyaratan berikut:

• Menjalankan Looker 25.20 atau yang lebih baru untuk koneksi BigQuery, atau Looker 26.8 atau yang lebih baru untuk koneksi Snowflake.
• Memiliki koneksi ke database BigQuery atau Snowflake, dan koneksi harus dikonfigurasi dengan cara berikut:
  • Koneksi harus dikonfigurasi dengan cakupan Semua project. Untuk memverifikasi cakupan koneksi, lihat kolom Cakupan di tab Database pada halaman Koneksi di menu admin Looker. Nilai Cakupan Project koneksi tidak dapat diedit setelah koneksi dibuat.
  • Koneksi harus diaktifkan untuk tabel turunan persisten (PDT). Untuk memverifikasi bahwa PDT diaktifkan pada koneksi, buka halaman Connections Looker, klik tombol Edit untuk koneksi, klik untuk membuka tab Optional Settings, lalu verifikasi bahwa tombol Enable PDTs diaktifkan.
  • Untuk koneksi Snowflake, administrator database harus memberikan CREATE STAGE ke peran Looker. Untuk mengetahui detailnya, lihat halaman dokumentasi tentang membuat koneksi Looker ke Snowflake.
• Untuk setiap pengguna yang akan membuat Eksplorasi layanan mandiri, akun pengguna Looker mereka harus memiliki izin upload_data, yang memungkinkan pengguna mengupload file CSV ke instance Anda.

Perhatikan batasan berikut untuk mengupload data dari Google Spreadsheet:

• Instance Looker (Google Cloud core) yang menggunakan Private Service Connect tidak mendukung alur OAuth untuk upload Google Spreadsheet. Instance ini harus menggunakan alur URL manual untuk mengupload data dari Google Spreadsheet.
• Instance Looker (Google Cloud core) yang menggunakan Kontrol Layanan VPC tidak mendukung upload Google Spreadsheet.

Mengaktifkan Eksplorasi layanan mandiri

Penting:

• Untuk mendukung fitur Eksplorasi Layanan Mandiri, setelah mengupgrade ke Looker 25.20, instance Looker Anda akan menambahkan izin upload_data ke peran atau set izin yang berisi izin explore, termasuk set izin kustom. Jika Anda mengaktifkan upload data di instance Looker, setiap pengguna dengan izin upload_data akan dapat mengupload data untuk membuat Jelajah layanan mandiri di instance Anda.
• Berhati-hatilah saat mengubah setelan di halaman admin Eksplorasi layanan mandiri jika instance Anda memiliki Eksplorasi layanan mandiri yang sudah ada:
  • Jika Anda menonaktifkan upload data, pengguna tidak akan lagi dapat mengakses Eksplorasi layanan mandiri yang ada dari menu Eksplorasi, dan setiap Look atau dasbor yang mengandalkan data tersebut dapat terpengaruh.
  • Jika Anda mengubah koneksi default untuk Eksplorasi layanan mandiri, semua Eksplorasi layanan mandiri yang ada di instance Anda dapat terpengaruh, beserta semua Look atau dasbor yang mengandalkan datanya.

Sebelum pengguna Anda dapat membuat Eksplorasi layanan mandiri, admin Looker harus mengonfigurasi fitur tersebut dengan melakukan langkah-langkah berikut:

1. Dari bagian Umum di menu Admin Looker, pilih halaman admin Eksplorasi layanan mandiri.
2. Di halaman admin Self-service Explores, dari menu drop-down Default connection, pilih koneksi BigQuery atau Snowflake yang akan digunakan untuk menyimpan data untuk Eksplorasi layanan mandiri. Looker akan menyimpan data ke database ini untuk Eksplorasi layanan mandiri di instance Anda.
3. Klik tombol Uji di samping tombol Upload Data untuk memverifikasi bahwa koneksi default valid dan koneksi diaktifkan untuk tabel turunan persisten (PDT) (lihat bagian Sebelum Anda memulai untuk mengetahui persyaratan koneksi). Jika pengujian gagal, Anda tidak dapat mengaktifkan upload data. Buka halaman admin Koneksi untuk memecahkan masalah koneksi.
4. Jika pengujian berhasil, aktifkan tombol Upload Data untuk mengaktifkan fitur Eksplorasi layanan mandiri.
5. Jika Anda ingin instance Looker mendukung mengupload data dari Google Spreadsheet:
   • Pastikan Anda telah mengonfigurasi koneksi BigQuery untuk Eksplorasi layanan mandiri (upload Google Spreadsheet hanya didukung di koneksi BigQuery).
   • Gunakan konsol Google Cloud untuk mengaktifkan API yang diperlukan untuk mendukung upload Google Spreadsheet.
   • Anda dapat mengaktifkan OAuth untuk upload Google Spreadsheet jika ingin mengizinkan pengguna menggunakan navigasi Google Drive untuk memilih file Google Spreadsheet yang akan diupload datanya.
   • Klik tombol Uji di samping tombol Impor data Google Spreadsheet untuk menjalankan pengujian khusus upload Google Spreadsheet.
   • Aktifkan tombol Impor data Google Spreadsheet. (Tombol Upload Data dan tombol impor data Google Spreadsheet harus diaktifkan untuk mengupload data dari Google Spreadsheet.)

Mengaktifkan API untuk mendukung upload Google Spreadsheet

Agar Looker dapat mendukung upload data dari Google Spreadsheet untuk koneksi BigQuery, API berikut harus diaktifkan di konsol Google Cloud oleh pengguna IAM dengan izin roles/serviceusage.serviceUsageAdmin IAM:

• API ini harus diaktifkan di Google Cloud project yang menghosting koneksi BigQuery yang ditentukan di menu drop-down Koneksi default di halaman admin Eksplorasi layanan mandiri:

  • BigQuery API: Diperlukan untuk semua operasi BigQuery

• API ini harus diaktifkan di Google Cloud project yang terkait dengan akun layanan yang digunakan untuk mengupload data (akun layanan yang digunakan untuk proses PDT di koneksi BigQuery Anda, yang mungkin sama atau tidak sama dengan Google Cloud project yang ditentukan di menu drop-down Koneksi default di halaman admin Eksplorasi layanan mandiri):

  • BigQuery API: Diperlukan untuk semua operasi BigQuery
  • Google Sheets API: Diperlukan untuk mengambil nama setiap sheet dalam dokumen Google Spreadsheet
  • Google Drive API: Diperlukan agar BigQuery dapat membaca file dari Drive

Lakukan langkah-langkah berikut untuk mengaktifkan API:

1. Dari Google Cloud konsol Buka pemilih project, pilih project yang berisi koneksi BigQuery yang ditentukan di menu drop-down Koneksi default di halaman admin Eksplorasi mandiri.

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

   Buka BigQuery API

3. Di halaman BigQuery API, jika API belum diaktifkan, klik Enable.

4. Masih di halaman BigQuery API, dari Google Cloud konsol pemilih project, pilih Google Cloud project yang terkait dengan akun layanan yang digunakan untuk mengupload data (akun layanan yang digunakan untuk proses PDT di koneksi BigQuery Anda).

5. Di halaman BigQuery API, jika API belum diaktifkan, klik Enable.

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

   Buka Google Sheets API

7. Di halaman Google Sheets API, jika API belum diaktifkan, klik Aktifkan.

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

   Buka Google Drive API

9. Di halaman Google Drive API, jika API belum diaktifkan, klik Aktifkan.

Konfigurasi untuk instance Private Service Connect

Jika instance Looker (Google Cloud core) Anda menggunakan Private Service Connect (PSC), Anda harus melakukan langkah tambahan untuk mendukung upload Google Spreadsheet.

Untuk mengizinkan Looker menjangkau Google Sheets API, Anda harus memublikasikan Google Sheets sebagai layanan menggunakan Private Service Connect, lalu menambahkan Google Sheets ke setelan FQDN Lokal dalam konfigurasi Looker (Google Cloud core) Anda. Saat mengonfigurasi FQDN Lokal, gunakan sheets.googleapis.com di kolom FQDN Lokal dan URI lampiran layanan dari layanan yang dipublikasikan di kolom Target Service Attachment URI. Untuk mengetahui petunjuknya, lihat dokumentasi Menghubungkan ke layanan yang dipublikasikan menggunakan FQDN Lokal.

Mengaktifkan OAuth untuk upload Google Spreadsheet

Penting: Instance Looker (Google Cloud core) yang menggunakan Private Service Connect tidak mendukung alur OAuth untuk upload Google Spreadsheet. Instance ini harus menggunakan alur URL manual untuk mengupload data dari Google Spreadsheet.

Setelah mengaktifkan Eksplorasi layanan mandiri, mengaktifkan API untuk mendukung upload Google Spreadsheet, dan mengaktifkan tombol impor data Google Spreadsheet, Anda juga dapat mengizinkan pengguna menggunakan navigasi Google Drive untuk memilih dokumen Google Spreadsheet yang akan diupload datanya.

Untuk mengaktifkan navigasi Google Drive di instance Looker, pengguna IAM dengan peran yang diperlukan harus membuat klien OAuth di konsol Google Cloud , lalu memasukkan kredensial OAuth ke halaman admin Eksplorasi Layanan Mandiri di instance Looker, seperti yang dijelaskan dalam prosedur di bagian 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 OAuth dan memasukkan kredensial di instance Looker, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , gunakan Pemilih project konsol Google Cloud untuk memilih project Google Cloud yang terkait dengan akun layanan yang digunakan untuk mengupload data (akun layanan yang digunakan untuk proses PDT di koneksi BigQuery Anda).

   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 aplikasi web.

5. Di kolom Name, masukkan nama untuk klien OAuth Anda, seperti Looker upload data from Sheets.

6. Di bagian Authorized JavaScript origins, klik tombol Add URI. Masukkan URL instance Looker Anda:

   https://LOOKER_INSTANCE_URL
   

7. Klik Create.

8. 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-nilai ini.

9. Di instance Looker Anda, pilih Self-service Explores dari bagian General di panel Admin.

10. Di halaman Self-service Explores, 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 .

11. Klik Simpan.

12. Klik tombol Uji di samping tombol Impor data Google Spreadsheet untuk menguji konfigurasi OAuth selain konfigurasi upload Google Spreadsheet. (Anda juga dapat mengklik tombol Uji di samping tombol Upload Data untuk memverifikasi koneksi selain konfigurasi Google Spreadsheet.)

Sekarang, saat pengguna Anda mengupload data menggunakan opsi Impor dari cloud, Looker akan menampilkan navigasi Google Drive untuk memilih dokumen Google Spreadsheet.

Melihat upload data di instance Looker Anda

Jika Eksplorasi layanan mandiri diaktifkan di instance Anda, admin Looker dapat menggunakan tabel Upload data di halaman admin Eksplorasi layanan mandiri untuk melihat data yang telah diupload pengguna di instance tersebut.

Tabel Upload data menampilkan informasi berikut tentang upload data di instance Anda:

• Nama Eksplorasi layanan mandiri, yang juga merupakan hyperlink yang membuka Eksplorasi layanan mandiri
• Pemilik upload data
• Tanggal data diupload
• Tombol Hapus yang memungkinkan admin Looker menghapus upload file dan Eksplorasi layanan mandiri terkait

Admin Looker dapat membuka Eksplorasi layanan mandiri apa pun di instance menggunakan link dalam tabel Upload data. Namun, bagian Eksplorasi Layanan Mandiri di menu Eksplorasi Looker hanya mencantumkan Eksplorasi layanan mandiri yang Anda miliki atau yang telah dibagikan secara khusus kepada Anda oleh pemiliknya. Menu Explore tidak mencantumkan setiap Eksplorasi layanan mandiri di instance untuk admin Looker, karena hal itu dapat membuat menu Explore menjadi rumit.

Menghapus upload data

Pemilik upload data dapat menghapus upload-annya dari halaman Edit Eksplorasi Layanan Mandiri. Selain itu, admin Looker dapat menghapus upload data dari halaman admin Eksplorasi layanan mandiri dengan mengikuti langkah-langkah berikut:

1. Dari bagian Umum di menu Admin Looker, pilih halaman admin Eksplorasi layanan mandiri.
2. Di tabel Upload data, klik tombol Hapus untuk upload data yang ingin Anda hapus.
3. Klik Hapus di dialog konfirmasi.