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 di 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 Database tab 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 Koneksi Looker, klik tombol Edit untuk koneksi, klik untuk membuka tab Setelan Opsional, lalu pastikan tombol Aktifkan PDT diaktifkan.
  • Untuk koneksi BigQuery yang menggunakan autentikasi dengan OAuth, pengguna harus memiliki izin untuk melihat tabel dalam skema awal guna melihat data yang diupload. Konfigurasi ini sama dengan konfigurasi yang diperlukan agar pengguna dapat menggunakan tabel turunan persisten (PDT) dengan koneksi OAuth.
• Untuk koneksi Snowflake, administrator database harus memberikan CREATE STAGE ke peran Looker. Untuk mengetahui detailnya, lihat halaman dokumentasi untuk membuat koneksi Looker ke Snowflake.
• Untuk setiap pengguna yang akan membuat Eksplorasi layanan mandiri, akun pengguna Looker-nya 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 Explore layanan mandiri, setelah upgrade 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 yang memiliki izin upload_data akan dapat mengupload data untuk membuat Eksplorasi layanan mandiri di instance Anda.

Sebelum pengguna 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 Eksplorasi Layanan Mandiri, jika Anda ingin mengizinkan pengguna memilih dari beberapa koneksi untuk upload data mereka, aktifkan opsi Tata kelola koneksi lanjutan. Lihat bagian Tata kelola koneksi lanjutan untuk mengetahui informasi selengkapnya.
3. Konfigurasi satu atau beberapa koneksi untuk upload layanan mandiri:
   • Jika Koneksi default tunggal diaktifkan: Dari menu drop-down Koneksi default, pilih koneksi yang akan digunakan untuk menyimpan data untuk Eksplorasi layanan mandiri. Looker akan menyimpan data ke database ini untuk Eksplorasi layanan mandiri di instance Anda.
   • Jika Tata kelola koneksi lanjutan diaktifkan: Di tabel Koneksi, temukan koneksi yang ingin Anda gunakan untuk upload layanan mandiri dan aktifkan tombol untuk Pengaktifan upload data untuk setiap koneksi yang ingin Anda dukung untuk upload data. Saat pengguna membuat Eksplorasi layanan mandiri, Looker akan mengizinkan pengguna memilih dari daftar koneksi yang diaktifkan dan dapat diakses pengguna, serta menyimpan data ke database yang ditentukan.

4. Klik tombol Uji untuk memverifikasi konfigurasi koneksi:

   • Jika Koneksi default tunggal diaktifkan: 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 memulai untuk mengetahui persyaratan koneksi).
   • Jika Tata kelola koneksi lanjutan diaktifkan: Klik tombol Uji di samping setiap koneksi yang diaktifkan di tabel Koneksi.

   Jika pengujian gagal, Anda tidak dapat mengaktifkan upload data untuk koneksi tersebut. Buka halaman admin Koneksi untuk memecahkan masalah koneksi.

5. Jika pengujian berhasil, aktifkan tombol Upload Data untuk mengaktifkan fitur Eksplorasi layanan mandiri.

6. Jika Anda ingin instance Looker mendukung upload data dari Google Spreadsheet, lakukan hal berikut:

   • Pastikan Anda telah mengonfigurasi koneksi BigQuery untuk Eksplorasi layanan mandiri (upload Google Spreadsheet hanya didukung pada koneksi BigQuery).
   • Gunakan Google Cloud konsol untuk mengaktifkan API yang diperlukan untuk mendukung upload Google Spreadsheet.
   • Secara opsional, aktifkan OAuth untuk upload Google Spreadsheet jika Anda ingin mengizinkan pengguna menggunakan navigasi Google Drive untuk memilih file Google Spreadsheet untuk upload data.
   • Uji dan aktifkan upload Google Spreadsheet:
     • Jika Koneksi default tunggal diaktifkan: Klik tombol Uji di samping tombol Impor data Google Spreadsheet untuk menguji koneksi untuk upload Google Spreadsheet. Jika pengujian berhasil, aktifkan tombol Impor data Google Spreadsheet.
     • Jika Tata kelola koneksi lanjutan diaktifkan: Klik tombol Uji untuk Impor Google Spreadsheet di tabel Koneksi untuk setiap koneksi yang ingin Anda aktifkan untuk upload Google Spreadsheet. Jika pengujian untuk koneksi berhasil, aktifkan tombol Impor Google Spreadsheet untuk koneksi tersebut. (Tombol Upload Data dan tombol Impor Google Spreadsheet harus diaktifkan agar koneksi dapat 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 Google Cloud konsol oleh pengguna IAM dengan izin IAM roles/serviceusage.serviceUsageAdmin:

• API ini harus diaktifkan di Google Cloud project yang menghosting koneksi BigQuery yang ditentukan di menu drop-down Koneksi default pada 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 pada koneksi BigQuery Anda, yang mungkin sama atau mungkin tidak sama dengan Google Cloud project yang ditentukan di menu drop-down Koneksi default pada 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 menghosting koneksi BigQuery yang ditentukan di menu drop-down Koneksi default pada halaman admin Eksplorasi Layanan Mandiri.

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

   Buka BigQuery API

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

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

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

6. Di menu navigasi Google Cloud konsol, buka API & Layanan > 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 Google Cloud konsol, buka API & Layanan > 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 Spreadsheet sebagai layanan menggunakan Private Service Connect, lalu menambahkan Google Spreadsheet ke setelan FQDN Lokal di konfigurasi Looker (Google Cloud core). Saat mengonfigurasi FQDN Lokal, gunakan sheets.googleapis.com di kolom FQDN Lokal dan URI lampiran layanan layanan yang dipublikasikan di kolom URI Lampiran Layanan Target. 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 Anda mengaktifkan Eksplorasi layanan mandiri, mengaktifkan API untuk mendukung upload Google Spreadsheet, dan mengaktifkan tombol Impor data Google Spreadsheet, Anda juga dapat mengizinkan pengguna untuk menggunakan navigasi Google Drive untuk memilih dokumen Google Spreadsheet untuk upload data.

Untuk mengaktifkan navigasi Google Drive di instance Looker, pengguna IAM dengan peran yang diperlukan harus membuat klien OAuth di Google Cloud konsol, lalu memasukkan kredensial OAuth ke halaman admin Eksplorasi Layanan Mandiri di instance Looker, seperti yang dijelaskan dalam prosedur di bagian ini.

Catatan: Sebelum dapat membuat kredensial OAuth, Google mengharuskan 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 Konfigurasi layar izin. 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. Dikonsol Google Cloud , gunakankonsol Google Cloud Buka pemilih project untuk memilihproject Google Cloud yang terkait dengan akun layanan yang digunakan untuk mengupload data (akun layanan yang digunakan untuk proses PDT pada koneksi BigQuery Anda).

   Bukakonsol Google Cloud

2. Gunakan menu utama konsol Google Cloud untuk membuka API & Layanan > Kredensial.

3. Dari halaman Kredensial, klik menu drop-down Buat Kredensial, lalu pilih ID klien OAuth.

4. Di drop-down Jenis aplikasi, pilih Aplikasi web.

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

6. Di bagian Asal JavaScript yang diizinkan, klik tombol Tambahkan URI. Masukkan URL instance Looker Anda:

   https://LOOKER_INSTANCE_URL
   

7. Klik Buat.

8. Setelah Anda mengklik Buat, jendela Klien OAuth dibuat akan muncul. Jendela ini menampilkan ID klien dan rahasia klien yang dibuat Google Cloud konsol untuk klien OAuth Anda. Salin dan catat nilai ini.

9. Di instance Looker, pilih Eksplorasi Layanan Mandiri dari bagian Umum di panel Admin.

10. Di halaman Eksplorasi Layanan Mandiri, di kolom ID klien dan Rahasia klien, tempelkan nilai yang Anda salin dari Google Cloud konsol saat membuat klien OAuth di Google Cloud konsol.

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 mengupload data menggunakan opsi Impor dari cloud, Looker akan menampilkan navigasi Google Drive untuk memilih dokumen Google Spreadsheet.

Tata kelola koneksi lanjutan

Secara default, Eksplorasi layanan mandiri disimpan ke satu koneksi database default yang ditentukan oleh admin Looker. Namun, jika Anda mengaktifkan opsi Tata kelola koneksi lanjutan di halaman admin Eksplorasi Layanan Mandiri, Anda dapat mengonfigurasi instance dengan beberapa koneksi database untuk menyimpan data Eksplorasi layanan mandiri. Di bagian Tata kelola koneksi lanjutan, hanya pengguna yang memiliki izin pada koneksi yang diizinkan yang dapat memilih koneksi tersebut untuk menyimpan dan membuat kueri data yang diupload.

Mengaktifkan beberapa koneksi

Jika Tata kelola koneksi lanjutan diaktifkan, halaman admin Eksplorasi Layanan Mandiri akan menampilkan tabel Koneksi yang mencantumkan semua koneksi database di instance Anda yang memenuhi persyaratan untuk Eksplorasi layanan mandiri. Dari tabel ini, admin Looker dapat melakukan tindakan berikut untuk setiap koneksi:

• Mengaktifkan atau menonaktifkan alur upload tertentu menggunakan tombol di kolom Pengaktifan upload data (untuk upload file) dan kolom Impor Google Spreadsheet (untuk upload Google Spreadsheet).
• Menguji validitas koneksi dan status tabel turunan persisten (PDT) dengan mengklik tombol Uji di kolom Pengaktifan upload data, dan menguji koneksi untuk konfigurasi upload Google Spreadsheet.

Pemilihan koneksi selama upload

Saat pengguna memulai upload data dengan menggunakan tab Upload dari lokal atau tab Impor dari cloud di dialog Buat sumber data, langkah pertama adalah memilih koneksi. Pengguna dapat memilih dari daftar drop-down koneksi yang diizinkan. Looker memfilter daftar ini sehingga pengguna hanya melihat koneksi yang dikonfigurasi untuk digunakan oleh model yang memiliki izin upload_data untuk pengguna tersebut. Pengguna tidak dapat mengupload data ke koneksi lain.

Izin pengguna dan akses koneksi

Di bagian Tata kelola koneksi lanjutan, akses berkelanjutan ke upload data layanan mandiri terikat secara ketat ke koneksi database yang mendasarinya:

• Akses berkelanjutan ke upload yang ada: Sebagian besar tindakan pengguna pada upload data setelah pembuatan memerlukan akses berkelanjutan ke koneksi yang mendasarinya. Jika akses pengguna ke koneksi database dicabut, pengguna tidak akan dapat lagi melihat, membuat kueri, mengedit, atau membagikan Eksplorasi layanan mandiri yang menggunakan koneksi tersebut, meskipun pengguna tersebut awalnya mengupload data. Eksplorasi layanan mandiri akan terus berfungsi untuk pengguna lain yang masih memiliki akses ke koneksi tersebut.
• Akses kueri: Akses kueri berkelanjutan ke Eksplorasi layanan mandiri mengharuskan pengguna memiliki izin access_data pada setidaknya satu model LookML yang dikonfigurasi untuk menggunakan koneksi database yang mendasarinya untuk upload tersebut.
• Membagikan Eksplorasi layanan mandiri: Pengguna hanya dapat membagikan Eksplorasi layanan mandiri kepada pengguna atau grup lain yang memiliki izin access_data pada model LookML yang dikonfigurasi untuk menggunakan koneksi database yang mendasarinya untuk upload tersebut.

Izin admin

Admin Looker (pengguna yang ditetapkan dengan peran Admin Looker) dianggap memiliki izin upload_data pada semua model di instance. Admin dapat melihat upload data yang ada di instance Looker, tetapi untuk melihat atau mengedit Eksplorasi layanan mandiri, admin harus diberi peran dengan akses ke model layanan mandiri tertentu tersebut.

Menonaktifkan Tata kelola koneksi lanjutan

Jika Anda memutuskan untuk menonaktifkan Tata kelola koneksi lanjutan di instance tempat fitur tersebut sebelumnya diaktifkan, perhatikan implikasi berikut:

• Otorisasi yang lebih longgar: Model otorisasi menjadi lebih permisif. Karena tata kelola tingkat koneksi tidak lagi diterapkan, upload data layanan mandiri dapat dibagikan kepada pengguna mana pun di instance.
• Akses kueri: Pengguna akan terus dapat membuat kueri upload data layanan mandiri yang ada dan dapat mereka akses sebelum Tata kelola koneksi lanjutan dinonaktifkan.
• Perubahan peran: Kontrol tata kelola koneksi dinonaktifkan, yang berarti perubahan peran atau izin di masa mendatang tidak akan membatasi akses ke upload data layanan mandiri yang ada.
• Persyaratan koneksi default: Saat Tata kelola koneksi lanjutan dinonaktifkan, pengguna hanya dapat mengupload data ke satu koneksi yang dipilih di menu drop-down Koneksi default. Jika instance Anda hanya menggunakan upload layanan mandiri saat Tata kelola koneksi lanjutan diaktifkan, koneksi default mungkin belum dipilih. Admin Looker harus memilih dan menguji koneksi default saat kembali untuk menjaga upload layanan mandiri tetap beroperasi.

Melihat upload data di instance Looker

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.

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 di tabel Upload data. Namun, bagian Eksplorasi Layanan Mandiri di menu Eksplorasi Looker hanya mencantumkan Eksplorasi layanan mandiri yang Anda miliki atau yang secara khusus dibagikan oleh pemiliknya kepada Anda. Menu Eksplorasi tidak mencantumkan setiap Eksplorasi layanan mandiri di instance untuk admin Looker, karena hal tersebut dapat membuat menu Eksplorasi menjadi rumit.

Menghapus upload data

Pemilik upload data dapat menghapus upload 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.