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 BigQuery yang menggunakan autentikasi dengan OAuth, pengguna harus memiliki izin untuk melihat tabel dalam skema sementara agar dapat 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 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 Jelajahi 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 dengan izin upload_data akan dapat mengupload data untuk membuat Jelajah layanan mandiri di instance Anda.

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 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 Jelajah 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 Pengaktifan upload data untuk setiap koneksi yang ingin Anda dukung untuk upload data. Saat pengguna membuat Jelajah layanan mandiri, Looker memungkinkan pengguna memilih dari daftar koneksi yang diaktifkan yang dapat diakses pengguna dan menyimpan data ke database yang ditentukan.

4. Klik tombol Uji untuk memverifikasi konfigurasi koneksi:

   • Jika Satu koneksi default 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 dalam 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 mengupload data dari Google Spreadsheet, lakukan hal berikut:

   • 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.
   • 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 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 konsol Google Cloud 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 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 Google Cloud 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. 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 OAuth client created akan muncul. Jendela ini menampilkan client ID dan rahasia klien yang dibuat Google Cloud konsol untuk klien OAuth Anda. 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 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.

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 mandiri akan menampilkan tabel Koneksi yang mencantumkan semua koneksi database di instance Anda yang memenuhi persyaratan untuk Eksplorasi mandiri. Dari tabel ini, admin Looker dapat melakukan tindakan berikut untuk setiap koneksi:

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

Pilihan koneksi selama upload

Saat pengguna memulai upload data menggunakan tab Upload dari lokal atau tab Impor dari cloud dalam 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 izin upload_data-nya dimiliki 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, mereka tidak dapat lagi melihat, membuat kueri, mengedit, atau membagikan Eksplorasi layanan mandiri yang menggunakan koneksi tersebut, meskipun mereka awalnya mengupload data. Fitur Jelajahi layanan mandiri akan terus berfungsi untuk pengguna lain yang masih memiliki akses ke koneksi.
• Akses kueri: Akses kueri berkelanjutan ke Jelajah layanan mandiri mengharuskan pengguna memiliki izin access_data pada setidaknya satu model LookML yang dikonfigurasi untuk menggunakan koneksi database pokok 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 pokok 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 pada instance yang 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 tetap dapat membuat kueri pada upload data layanan mandiri yang ada dan telah mereka akses sebelum Tata kelola koneksi lanjutan dinonaktifkan.
• Perubahan peran: Kontrol tata kelola koneksi dinonaktifkan, yang berarti setiap perubahan peran atau izin di masa mendatang tidak akan membatasi akses ke upload data layanan mandiri yang ada.
• Persyaratan koneksi default: Jika 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 mengembalikan untuk menjaga agar upload layanan mandiri tetap beroperasi.

Melihat upload data di instance Looker Anda

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

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

• Nama Explore layanan mandiri, yang juga merupakan hyperlink yang membuka Explore 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 Self-service Explores di menu Explore Looker hanya mencantumkan Self-service Explore 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.