Menggunakan Diagram LookML

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

Diagram LookML adalah diagram hubungan entitas dari model LookML yang secara visual menggambarkan hubungan antara objek LookML. Gunakan ekstensi ini untuk:

  • Menilai struktur model LookML, mengidentifikasi area tempat LookML dapat digabungkan, dan menentukan cara terbaik untuk menambahkannya ke model
  • Mengidentifikasi logika yang salah, sehingga mengurangi kemungkinan penghitungan yang salah dan performa kueri yang buruk
  • Pelajari cara melakukan pemodelan data berbasis kode (LookML)

Halaman dokumentasi ini menjelaskan cara menggunakan Diagram LookML versi 2.0.0 dan yang lebih baru. Admin Looker harus melihat halaman dokumentasi Mengonfigurasi ekstensi Diagram LookML untuk mengetahui petunjuk cara mengaktifkan ekstensi ini bagi pengguna Looker.

Halaman ini membahas cara:

Setelah Diagram LookML diinstal, Anda dapat membuka Diagram LookML dengan mengklik Blok di panel navigasi sebelah kiri, lalu memilih kartu Diagram LookML.

Mengamati hubungan objek LookML dengan Diagram LookML

Admin Looker harus memberi Anda izin ke model lookml_diagram dan model apa pun yang ingin Anda lihat di ekstensi.

Ekstensi Diagram LookML terdiri dari elemen berikut:

  1. Panel Diagram Settings untuk memilih model, cabang Git, dan Explore
  2. Panel Opsi Tampilan untuk menyaring kolom yang ingin Anda lihat
  3. Bagian Bantuan Diagram untuk memberikan penjelasan tambahan tentang elemen diagram
  4. Kanvas diagram untuk berinteraksi dengan objek LookML di Jelajah yang dipilih
  5. Daftar kolom Jelajah yang dipilih, yang dikelompokkan menurut tampilan
  6. Toolbar dengan opsi zoom dan posisi serta ikon untuk menampilkan atau menyembunyikan minimap kanvas, yang membantu Anda berorientasi dalam diagram yang lebih besar
  7. Profiler Objek untuk melihat informasi tentang objek LookML dan membuka LookML atau Jelajah terkait, jika ada

Klik dua kali ikon Diagram Settings atau ikon View Options untuk menciutkan panel kiri.

Mengonfigurasi setelan diagram

Klik ikon diagram di menu navigasi diagram untuk menampilkan Setelan Diagram.

Drop-down Pilih Model mencantumkan semua model yang izin untuk dilihatnya Anda miliki. Setelah memilih model, dua opsi tambahan akan muncul:

  • Drop-down Current Branch akan diisi dengan daftar cabang Git model tersebut. Jika model hanya memiliki satu cabang — biasanya cabang produksi — cabang tersebut akan ditampilkan. Jika Anda berada dalam Mode Produksi atau jika Anda tidak memiliki izin untuk mengubah cabang Git, menu drop-down Cabang Saat Ini akan dinonaktifkan.

    Jika admin telah memberi Anda izin untuk mengubah cabang Git di Diagram LookML, aktifkan Mode Pengembangan, pastikan model dan Jelajah dipilih, lalu pilih cabang untuk melihat diagram sesuai dengan cara model disiapkan di cabang tersebut.

  • Daftar Pilih Jelajah akan diisi dengan daftar Jelajah model tersebut. Klik nama Jelajah untuk melihat kolomnya, yang dikelompokkan menurut tampilan, yang ditampilkan di kanvas halaman.

Jelajahi opsi tampilan

Dengan memilih Jelajahi, Anda dapat menggunakan panel Opsi Tampilan untuk membatasi kolom dan tampilan yang ditampilkan di kanvas.

Membatasi kolom yang ditampilkan

Anda dapat memilih untuk menampilkan semua kolom di setiap tampilan Jelajah dengan memilih Semua kolom di bagian Kolom yang Akan Ditampilkan; atau, untuk hanya menampilkan tampilan yang memiliki kolom yang digabungkan ke kolom lain, pilih Kolom dengan join.

Jika diaktifkan, tombol Sembunyikan kolom tersembunyi akan menyembunyikan kolom yang berisi hidden: yes dalam LookML yang mendasarinya. Tombol Sembunyikan kolom tersembunyi diaktifkan secara default.

Membatasi tampilan yang ditampilkan

Bagian Tampilan di panel Opsi Tampilan menampilkan daftar tampilan yang ada di Jelajah yang dipilih. Secara default, semua tampilan ditampilkan di kanvas diagram. Saat Anda menyembunyikan tampilan, objek tampilan dan join apa pun yang menghubungkan objek tampilan tersebut ke objek lain di Jelajahi akan disembunyikan dari kanvas diagram.

Klik Sembunyikan semua untuk menyembunyikan semua tampilan di Jelajahi dari kanvas diagram. Klik Tampilkan semua untuk menampilkan semua tampilan di Jelajahi tersebut.

Anda juga dapat menyembunyikan setiap tampilan secara selektif dari kanvas dengan membatalkan pilihan ikon mata di sebelah kanan nama tampilan. Saat tampilan disembunyikan, nama tampilan akan berwarna abu-abu dan ikon mata akan memiliki garis miring. Untuk menampilkan kembali setiap tampilan tersembunyi, klik ikon mata yang dicoret.

Menafsirkan kanvas diagram

Kanvas Diagram LookML adalah tempat semua entitas dan hubungan untuk Jelajah tertentu digambarkan. Dalam istilah Looker, Anda dapat menganggap Diagram LookML sebagai penggambaran cara objek LookML digabungkan dalam Jelajah untuk model tertentu.

Panel judul objek di bagian atas kanvas menampilkan nama Jelajah yang tampilannya ditampilkan di kanvas. Klik ikon info Jelajahi — "i" yang dilingkari — di panel judul objek untuk membuka Profiler Objek dan mempelajari lebih lanjut Jelajahi yang dipilih. Klik panah searah jarum jam untuk memuat ulang ekstensi.

Entity

Setiap tampilan Jelajah direpresentasikan sebagai set entity-nya sendiri, dengan nama tampilan yang muncul di bagian atas set:

  1. Tampilan dasar Jelajah ditunjukkan dengan latar belakang biru tua.
  2. Tampilan yang digabungkan di Jelajahi memiliki latar belakang biru muda.

  3. Saat dipilih, join, tampilan, atau kolom akan ditandai dengan warna biru terang.

    Di bawah setiap tampilan terdapat daftar kolom yang termasuk dalam tampilan tersebut:

  4. Dimensi dicantumkan di bagian atas.

  5. Metrik dicantumkan di bagian bawah dan ditandai dengan warna oranye muda.

  6. Jika kolom adalah kunci utama, ikon kunci akan muncul di sebelah kanan nama kolom.

Di sebelah kiri setiap kolom terdapat ikon yang menunjukkan jenisnya:

  • A: dimensi type: string
  • #: dimensi atau ukuran type: number
  • Batang bertingkat: dimensi type: tier
  • Centang: dimensi type: yesno
  • Kalender: dimensi type: date, type: date_time, type: time
  • Titik peta: dimensi type: location, type: distance, type: zipcode

Klik nama kolom untuk membuka Profiler Objek dan mempelajari lebih lanjut kolom yang dipilih.

Hubungan

Diagram menggunakan garis untuk menggambarkan hubungan setiap objek dengan objek lain dalam model yang dipilih. Bentuk garis, tempat garis tersebut melekat ke tampilan atau kolom, menyampaikan kardinalitas hubungan antara dua objek; garis bercabang menunjukkan kardinalitas "banyak", dan satu garis menunjukkan kardinalitas "satu". Anda akan membaca hubungan tersebut sebagai dari tampilan dasar ke tampilan yang digabungkan. Contoh:

  1. Join satu-ke-satu dari order_items ke inventory_items, yang bergabung di kolom id
  2. Join many-to-one dari order_items ke repeat_purchase_facts

Anda juga dapat mengarahkan kursor ke garis untuk melihat jenis hubungan join yang menghubungkan kedua objek.

Klik baris untuk membuka Profiler Objek guna melihat informasi selengkapnya tentang join.

Opsi tampilan kanvas

Peta mini di kanan atas kanvas dapat membantu mengarahkan penempatan Anda dalam diagram yang lebih besar, dengan bagian peta yang berwarna abu-abu menunjukkan bagian diagram yang saat ini ditampilkan di kanvas. Klik dan tarik ruang kosong di kanvas untuk berpindah ke bagian lain diagram.

Toolbar vertikal di kiri bawah kanvas berisi ikon untuk mengontrol tampilan diagram:

  • Klik (+) untuk memperbesar dan (-) untuk memperkecil diagram.
  • Klik ikon persegi untuk kembali ke posisi awal default diagram.
  • Klik ikon peta untuk mengaktifkan atau menonaktifkan minimap.

Melihat informasi objek dengan Object Profiler

Object Profiler menampilkan informasi tentang objek yang dipilih. Klik Pelajari, tampilan, kolom, atau join di kanvas diagram untuk membuka Object Profiler di sisi kanan kanvas. Klik kanvas untuk menciutkan Object Profiler.

Penjelajah

Klik ikon Info jelajah — "i" yang dilingkari — di sisi kanan panel judul objek.

Untuk Jelajahi yang dipilih di panel Setelan Diagram, Profil Objek akan menampilkan:

  • Label: Nilai Jelajahi label.
  • Label Grup: Nilai parameter group_label, yang menggabungkan Jelajah ke dalam grup kustom di menu Jelajah Looker. Jika label grup tidak ditentukan untuk Jelajah, nama model akan digunakan secara default.
  • Project Name: Nama project LookML, seperti yang ditentukan di setelan project.
  • Nama Koneksi: Nilai parameter connection, yang menentukan koneksi database tempat model akan mengambil data.

Jika memiliki izin untuk melihat LookML, Anda dapat mengklik Go to LookML di kiri bawah Object Profiler untuk membuka file tempat Jelajah ditentukan. File akan terbuka di tab browser baru dengan baris untuk explore ditandai.

Dilihat

Klik tampilan dari kanvas diagram.

Profiler Objek menampilkan Nama Tabel SQL jika ditentukan dalam LookML tampilan. Jika tidak ada sql_table_name yang ditentukan untuk tampilan, Nama Tabel SQL akan ditampilkan sebagai unknown.

Jika memiliki izin untuk melihat LookML, Anda dapat mengklik Buka LookML di kiri bawah Object Profiler untuk membuka file tempat Jelajah yang dihubungkan dengan tampilan ditentukan. File akan terbuka di tab browser baru dengan baris untuk explore ditandai.

Kolom

Klik kolom dari kanvas diagram.

Profiler Objek menampilkan nama, jenis, dan nilai jenis kolom, serta apakah kolom tersebut merupakan kunci utama di bagian atas panel. Dua tab di profiler — Details dan Code — menampilkan informasi tambahan tentang kolom.

Di tab Details, Anda dapat melihat:

  • Nama Tampilan: Nama tampilan tempat kolom berada.
  • Label: Cara kolom akan muncul di bagian Data Jelajahi, yaitu nama atau label tampilan, diikuti dengan nama atau label kolom.
  • Distribusi: Untuk dimensi numerik pada tampilan dengan ukuran yang memiliki type: count, klik Hitung untuk menampilkan pratinjau diagram kolom yang menggambarkan distribusi nilai jumlah. Bagian Distribusi juga akan menampilkan nilai minimum, maksimum, dan rata-rata dari deret dimensi numerik.
  • Nilai: Untuk dimensi numerik pada tampilan dengan ukuran yang memiliki type: count, klik Hitung untuk menampilkan pratinjau nilai jumlah. Klik Jelajahi Lebih Lanjut untuk membuka Eksplorasi tempat kolom ini berada.

Di tab Code, Anda dapat melihat parameter dan subparameter kolom.

Jika memiliki izin untuk melihat LookML, Anda dapat mengklik Buka LookML di kiri bawah Object Profiler untuk membuka file tempat join ditentukan. File akan terbuka di tab browser baru pada baris untuk Jelajahi gabungan.

Jika Anda memiliki izin untuk menjelajahi data, klik Jelajahi dengan Kolom di kanan bawah Object Profiler untuk membuka Jelajahi dengan kolom tersebut yang telah dipilih sebelumnya di pemilih kolom Jelajahi.

Gabungan

Klik join dari kanvas diagram.

Object Profiler menampilkan pernyataan join yang menjelaskan hubungan join serta jenis dan kardinalitas join.

Jika memiliki izin untuk melihat LookML, Anda dapat mengklik Buka LookML di kiri bawah Object Profiler untuk membuka file tempat join ditentukan. File akan terbuka di tab browser baru pada baris untuk Jelajahi gabungan.