Menggunakan Kamus Data Looker

Looker Data Dictionary berbeda dengan Blok Kamus Data.

Untuk menikmati fungsi penuh ekstensi Looker Data Dictionary, admin harus mengupdate aplikasi Looker Data Dictionary ke versi 2.0.0 atau yang lebih baru.

Kamus Data Looker adalah ekstensi—aplikasi web yang dibuat menggunakan komponen Looker—yang dikembangkan menggunakan framework ekstensi Looker dan di-deploy melalui Looker Marketplace.

Ekstensi Kamus Data Looker menyediakan antarmuka terpusat khusus untuk menelusuri semua kolom dan deskripsi Looker Anda. Gunakan ekstensi ini untuk:

  • Menyediakan direktori yang dapat ditelusuri untuk semua metrik dan deskripsi agar pengguna dapat mengidentifikasi dimensi atau ukuran yang tepat untuk analisis
  • Memudahkan pemangku kepentingan eksternal untuk mengidentifikasi dan menemukan metrik yang unik
  • Mengaudit model LookML untuk menilai apakah konvensi penamaan yang konsisten diikuti, apakah ada kolom yang berlebihan, atau apakah kolom dianotasi dengan deskripsi
  • Menambahkan dan membagikan komentar tentang kolom tertentu (jika aplikasi Looker Data Dictionary Anda menggunakan versi 2.0.0 atau yang lebih baru)

Agar pengguna dapat mengakses dan menggunakan Kamus Data Looker, admin Looker harus:

  1. Aktifkan fitur yang sesuai.
  2. Instal ekstensi Kamus Data Looker.
  3. Berikan izin untuk mengakses Kamus Data Looker.

Setelah ekstensi tersedia bagi pengguna, Anda dapat:

  1. Buka Looker Data Dictionary.
  2. Lihat metadata model Anda.

Menginstal Kamus Data Looker

Sebelum menginstal Kamus Data Looker dari Marketplace, admin Looker harus mengaktifkan fitur berikut:

  • Marketplace: Untuk mengakses Looker Marketplace (diaktifkan secara default)
  • Framework Ekstensi: Untuk men-deploy ekstensi yang dikembangkan menggunakan framework ekstensi Looker (diaktifkan secara default)

Menginstal aplikasi dan alat — seperti ekstensi — dari Marketplace mengharuskan Anda memiliki izin develop, manage_models, dan deploy.

Lihat dokumentasi Menggunakan Looker Marketplace untuk mendapatkan petunjuk tentang cara menginstal alat dari Looker Marketplace. Anda dapat memastikan bahwa Anda selalu memiliki versi Kamus Data terbaru dengan membuka Looker Marketplace, memilih Kelola, lalu memilih tombol Perbarui di samping ekstensi.

Memberikan izin untuk mengakses Kamus Data Looker

Setelah Kamus Data Looker terinstal, model yang disebut data-dictionary akan otomatis ditambahkan ke daftar model yang tersedia di halaman New Model Set dan Edit Model Set, yang dapat diakses dari halaman Roles di panel Admin.

Admin Looker harus memberi pengguna izin explore atau develop untuk mengakses model data-dictionary dan model apa pun yang perlu mereka jelajahi di Kamus Data. Lihat halaman dokumentasi Menetapkan izin untuk ekstensi Looker guna mengetahui informasi tentang cara memberikan izin kepada pengguna untuk mengakses dan menggunakan ekstensi.

Memberikan izin untuk berinteraksi dengan komentar kolom

Komentar kolom memberi pengguna kemampuan untuk menambahkan konteks ke definisi kolom tanpa harus memperbarui LookML apa pun. Secara default, semua pengguna yang memiliki akses ke ekstensi kamus data akan dapat melihat semua komentar, serta menambahkan, mengedit, dan menghapus komentar mereka sendiri.

Jika diinginkan, admin Looker dapat mengelola cara pengguna berinteraksi dengan fungsi komentar kolom dengan membuat grup pengguna tertentu di halaman Grup pada panel Admin dan menetapkan pengguna ke grup tersebut. Lihat halaman dokumentasi Grup untuk informasi selengkapnya tentang cara menetapkan pengguna ke grup.

Admin Looker harus membuat grup ini dengan nama standar seperti yang ditunjukkan di bawah.

Grup pengguna harus dibuat dengan nama standar yang ditampilkan dalam tabel di bawah. Tabel juga menampilkan hak istimewa yang telah ditetapkan sebelumnya yang akan dimiliki pengguna yang ditetapkan ke setiap grup.

Nama Grup Hak Istimewa
marketplace_data_dictionary_comments_disabled Pengguna tidak dapat melihat atau berinteraksi dengan komentar apa pun; semua fungsi komentar dinonaktifkan. Hak istimewa grup ini selalu diprioritaskan daripada hak istimewa grup lain — semua pengguna yang termasuk dalam grup disabled tidak akan memiliki akses ke fungsi komentar, meskipun mereka juga merupakan bagian dari grup lain yang memiliki hak istimewa yang lebih tinggi.
marketplace_data_dictionary_comments_reader Pengguna dapat melihat komentar yang sudah ada, tetapi tidak dapat menambahkan komentar.
marketplace_data_dictionary_comments_writer Pengguna dapat melihat semua komentar, menambahkan komentar baru, dan mengedit/menghapus komentar mereka sendiri. Ini adalah hak istimewa default.
marketplace_data_dictionary_comments_manager Pengguna dapat melihat semua komentar, menambahkan komentar baru, dan mengedit/menghapus semua komentar.

Jika pengguna tidak termasuk dalam salah satu grup ini, dia akan ditetapkan secara default ke writer. Jika pengguna ditetapkan ke beberapa grup (tidak termasuk marketplace_data_dictionary_comments_disabled), hak istimewanya yang lebih tinggi akan lebih diutamakan.

Perubahan pada grup komentar, seperti menambahkan atau menghapus pengguna, yang dibuat melalui halaman Grup di panel Admin akan diterapkan setelah halaman Kamus Data dimuat ulang secara paksa atau setelah pengguna memilih opsi lain, lalu kembali ke halaman Kamus Data.

Anda dapat menavigasi ke Kamus Data dari daftar aplikasi dan ekstensi yang terinstal di bilah sisi kiri.

Melihat metadata model dengan Looker Data Dictionary

Di Kamus Data Looker, pengguna dengan izin explore pada sebuah model dapat memilih model ini dan melihat metadatanya, termasuk Jelajah dan setiap daftar kolom Jelajah, yang dikelompokkan berdasarkan tampilan. Kamus Data Looker menampilkan Jelajah model yang dipilih di sidebar kiri serta tampilan dan kolom Jelajah yang dipilih di bagian utama halaman.

Pengguna dapat menciutkan sidebar dengan memilih ikon <.

Kamus Data Looker menunjukkan:

  1. Nama model yang dipilih
  2. Daftar Jelajah yang ada dalam model yang dipilih
  3. Jelajah yang dipilih
  4. Kolom teks untuk memfilter kolom di bagian Jelajahi
  5. Filter cepat untuk mempersempit kolom yang ditampilkan berdasarkan karakteristik yang dipilih
  6. Nama tampilan
  7. Metadata tentang setiap kolom. Pilih metadata yang ditampilkan dengan memilih tombol Lihat Opsi. Melihat seluruh kumpulan metadata kolom di field profiler.
  8. Baris yang berisi metadata untuk setiap kolom dalam tampilan tertentu
  9. Navigasi ke Jelajah di UI Looker

Memilih model dan Jelajah

Drop-down Pilih Model mencantumkan semua model yang izin explore-nya dimiliki pengguna. Saat memilih model dari menu drop-down Pilih Model, sidebar kiri akan diisi dengan daftar Jelajah model tersebut.

Anda juga dapat menelusuri model yang dipilih untuk Jelajah tertentu dengan mengetik di kotak penelusuran Model Penelusuran. Daftar Jelajah akan memfilter untuk hanya menampilkan hasil yang cocok dengan istilah penelusuran Anda.

Pilih nama Explore untuk melihat kolomnya, yang dikelompokkan menurut tampilan, yang ditampilkan di bagian utama halaman.

Anda juga dapat memilih tombol Jelajahi di sudut kanan atas untuk langsung membuka halaman Jelajahi di Looker.

Memfilter kolom dalam Eksplorasi

Anda dapat memfilter kolom yang ditampilkan dengan mengetik teks ke kotak Filter kolom di Eksplorasi ini untuk mencocokkan dengan daftar Label Kolom atau Deskripsi kolom.

Anda juga dapat memilih atribut metadata tertentu untuk difilter, seperti apakah kolomnya:

Melihat metadata kolom

Kamus Data Looker menampilkan metadata untuk kolom Jelajah, yang dikelompokkan berdasarkan tampilan:

Menyesuaikan metadata yang ditampilkan

Anda dapat menentukan metadata yang ditampilkan untuk setiap kolom dengan memilih tombol Opsi Tampilan di pojok kanan atas dan mencentang atau menghapus centang kotak untuk metadata yang ingin dilihat.

Menggunakan komentar kolom

Jika instance sudah memiliki Marketplace, admin harus memastikan bahwa ekstensi Kamus Data menggunakan versi 2.0.0 atau yang lebih baru untuk menggunakan komentar tingkat kolom.

Developer LookML sering menyertakan informasi atau penjelasan tambahan tentang kolom model di parameter description tingkat kolom. Namun, deskripsi ini tidak selalu bermakna atau berguna bagi semua pengguna. Dengan komentar tingkat kolom, pengguna dapat menambahkan konteks ke kolom tertentu. Komentar ini dapat dilihat oleh pengguna lain, tetapi tidak akan memengaruhi LookML yang mendasari model.

Admin harus memberi pengguna kemampuan untuk berinteraksi dengan komentar dengan menambahkannya ke grup tertentu di halaman Grup pada panel Admin. Secara default, semua pengguna yang memiliki akses ke ekstensi kamus data dapat melihat semua komentar dan menambahkan, mengedit, dan menghapus komentar mereka sendiri.

Menambahkan komentar kolom

Untuk menambahkan komentar ke kolom:

  1. Arahkan kursor ke baris kolom untuk menampilkan ikon + (jika tidak ada komentar kolom) atau ikon notepad (jika kolom memiliki komentar yang ada). Klik ikon untuk membuka tab Comment di panel field profiler.
  2. Klik tombol Tambahkan Komentar.
  3. Ketik komentar Anda, lalu pilih tombol Komentar untuk menyimpan entri. Klik Cancel untuk menutup profiler kolom. Anda dapat memperluas kotak komentar dengan memilih dan menarik sudut kanan bawah.

Setelah ditambahkan, komentar akan muncul di tab Komentar di profiler kolom dan dapat dilihat oleh pengguna lain.

Melihat komentar kolom

Ketika bidang menyertakan komentar, ikon catatan muncul dengan jumlah komentar yang ada di bidang tersebut. Klik ikon notepad untuk melihat komentar kolom yang tercantum di tab Comment di profiler kolom.

Jumlah komentar di kolom tersebut juga ditunjukkan dalam tanda kurung pada tab Komentar. Setiap entri komentar menampilkan informasi berikut:

  • Nama pemberi komentar
  • Stempel waktu yang menunjukkan kapan komentar ditambahkan
  • Pratinjau komentar

Mengedit atau menghapus komentar kolom

Untuk mengedit atau menghapus komentar kolom Anda sendiri:

  1. Pilih ikon catatan untuk kolom.
  2. Pada tab Komentar, cari dan arahkan kursor ke komentar yang ingin Anda edit atau hapus.
  3. Klik menu tiga titik, lalu pilih Edit Komentar untuk mengedit komentar atau Hapus Komentar untuk menghapus komentar. Jika Anda menghapus komentar, konfirmasikan niat Anda.
  4. Jika Anda mengedit komentar, pilih Simpan setelah perubahan selesai.

Membagikan komentar kolom

URL tab Komentar untuk setiap kolom bersifat unik dan dapat disalin serta dibagikan kepada pengguna lain yang memiliki akses ke model tersebut di Kamus Data Looker.

Menggunakan profiler kolom

Mengklik baris kolom tertentu akan membuka panel profiler kolom di sebelah kanan halaman yang menampilkan seluruh kumpulan metadata kolom, opsi untuk melihat pratinjau nilai dimensi numerik, dan tombol untuk membuka Looker IDE atau halaman Explore.

Jika Anda menggunakan ekstensi Kamus Data Looker versi 2.0.0 atau yang lebih baru, profiler kolom akan terbuka secara default ke tab Details.

Di bagian Distribusi, pilih Calculate untuk menampilkan pratinjau diagram kolom yang menggambarkan distribusi nilai jumlah untuk dimensi numerik pada tampilan dengan ukuran yang memiliki type: count. Bagian Distribusi juga akan menampilkan nilai minimum, maksimum, dan rata-rata dari deret dimensi numerik.

Di bagian Nilai, pilih Hitung untuk menampilkan pratinjau nilai jumlah untuk dimensi numerik pada tampilan dengan ukuran yang memiliki type: count. Pilih tombol Jelajahi Lainnya untuk membuka UI Eksplorasi dengan dimensi numerik dan ukuran jumlah yang telah dipilih sebelumnya dari pemilih kolom.

Pilih Go to LookML untuk membuka file tampilan dari project LookML yang terkait dengan model yang dipilih di Looker IDE.

Pilih tombol Jelajahi dengan Kolom untuk membuka halaman Jelajahi dengan kolom yang dipilih secara otomatis dari pemilih kolom.