Menggunakan Diagram LookML

Catatan: Diagram LookML kini tersedia secara umum. Untuk menikmati fungsi penuh ekstensi Diagram LookML, admin harus mengupdate aplikasi Diagram LookML ke versi 2.0.0 atau yang lebih baru.

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 entity-hubungan dari model LookML yang secara visual menggambarkan hubungan antara objek LookML-nya. Gunakan ekstensi ini untuk:

• Menilai struktur model LookML, mengidentifikasi area di mana LookML dapat digabungkan dan menentukan cara terbaik untuk ditambahkan ke model
• Identifikasi logika yang salah, sehingga dapat mengurangi kemungkinan penghitungan yang salah dan performa kueri yang buruk
• Mempelajari 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 mendapatkan petunjuk tentang cara mengaktifkan ekstensi ini bagi pengguna Looker.

Halaman ini membahas cara:

• Membuka Diagram LookML
• Mengamati hubungan objek LookML dengan Diagram LookML
• Mengonfigurasi setelan diagram
• Mengonfigurasi opsi tampilan untuk Explore
• Menafsirkan kanvas diagram
• Mengamati informasi objek dengan Object Profiler

Membuka Diagram LookML

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

Mengamati hubungan objek LookML dengan Diagram LookML

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

Ekstensi Diagram LookML terdiri dari elemen-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 Explore yang dipilih
5. Daftar kolom Explore yang dipilih, yang dikelompokkan menurut tampilan
6. Toolbar dengan opsi zoom dan posisi serta ikon untuk menampilkan atau menyembunyikan peta mini kanvas, yang membantu mengarahkan diri Anda dalam diagram yang lebih besar
7. Object Profiler untuk melihat informasi tentang objek LookML dan membuka LookML atau Explore yang terkait, jika ada

Klik dua kali ikon Setelan Diagram atau ikon Opsi Tampilan 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 izinnya Anda miliki untuk melihatnya. Setelah Anda memilih model, dua opsi tambahan akan muncul:

• Drop-down Current Branch 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 Current Branch akan dinonaktifkan.

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

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

Jelajahi opsi tampilan

Dengan memilih Explore, Anda dapat menggunakan panel Opsi Tampilan untuk membatasi kolom dan tampilan mana 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 untuk Ditampilkan; atau, untuk hanya menampilkan tampilan yang memiliki kolom yang digabungkan dengan kolom lain, pilih Kolom dengan join.

Jika diaktifkan, tombol Sembunyikan kolom tersembunyi akan menyembunyikan kolom apa pun yang berisi hidden: yes di LookML dasarnya. Tombol Sembunyikan kolom tersembunyi diaktifkan secara default.

Membatasi tampilan yang ditampilkan

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

Klik Sembunyikan semua untuk menyembunyikan semua tampilan di Eksplorasi dari kanvas diagram. Klik Tampilkan semua untuk memperlihatkan semua tampilan di Jelajah tersebut.

Anda juga dapat menyembunyikan tampilan satu per satu dari kanvas secara selektif dengan membatalkan pilihan ikon mata di sebelah kanan nama tampilan. Jika tampilan disembunyikan, nama tampilan akan berwarna abu-abu dan ikon mata memiliki garis miring. Untuk memperlihatkan tampilan tersembunyi satu per satu, klik ikon garis miring.

Menafsirkan kanvas diagram

Kanvas Diagram LookML adalah tempat semua entitas dan hubungan untuk Jelajah tertentu ditunjukkan. Dalam bahasa Looker sederhana, Anda dapat menganggap Diagram LookML sebagai gambaran bagaimana objek LookML bergabung bersama dalam Jelajah untuk model tertentu.

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

Entity

Setiap tampilan Explore direpresentasikan sebagai kumpulan entity-nya sendiri, dengan nama tampilan yang muncul di bagian atas kumpulan tersebut:

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

3. Saat gabungan, tampilan, atau kolom dipilih, penggabungan akan ditandai dengan warna biru cerah.

   Di bawah setiap tampilan adalah daftar kolom yang dimiliki tampilan tersebut:

4. Dimensi dicantumkan di bagian atas.

5. Tindakan tercantum di bagian bawah dan ditandai dengan warna oranye terang.

6. Jika kolom merupakan 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
• Tanda 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 Object Profiler dan mempelajari kolom yang dipilih lebih lanjut.

Hubungan

Diagram menggunakan garis untuk menggambarkan bagaimana setiap objek berkaitan dengan objek lain dalam model yang dipilih. Bentuk garis, yang menempel pada tampilan atau bidang, menunjukkan kardinalitas hubungan antara kedua objek; garis bercabang menunjukkan kardinalitas "banyak", dan garis tunggal menunjukkan kardinalitas "satu". Anda akan membaca hubungan sebagai dari tampilan dasar ke tampilan gabungan. Contoh:

1. Koneksi one-to-one dari order_items ke inventory_items, bergabung di kolom id
2. Penggabungan many-to-one dari order_items ke repeat_purchase_facts

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

Klik baris untuk membuka Object Profiler untuk melihat informasi selengkapnya tentang join.

Opsi tampilan kanvas

Sebuah minimap 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 sedang ditampilkan di kanvas. Lakukan {i>click and drag<i} (klik dan seret) pada ruang kosong di kanvas untuk berpindah ke bagian diagram yang lain.

{i>Toolbar<i} 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 peta mini.

Menampilkan informasi objek dengan Object Profiler

Object Profiler menampilkan informasi tentang objek yang dipilih. Klik Explore, view, field, atau join pada kanvas diagram untuk membuka Object Profiler di sisi kanan kanvas. Klik kanvas untuk menciutkan Object Profiler.

Jelajah

Klik ikon Jelajahi info — "i" yang dilingkari — di sisi kanan bilah judul objek.

Untuk Explore yang dipilih pada panel Diagram Settings, Object Profiler menampilkan:

• Label: Nilai Explore label.
• Label Grup: Nilai parameter group_label, yang menggabungkan Jelajah menjadi grup kustom di menu Jelajahi Looker. Jika label grup tidak ditentukan untuk Explore, label ini akan ditetapkan secara default ke nama model.
• Project Name: Nama project LookML, seperti yang ditentukan dalam setelan project.
• Connection Name: 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 Explore ditentukan. File akan terbuka di tab browser baru dengan baris untuk explore ditandai.

Tabel Virtual

Klik tampilan dari kanvas diagram.

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

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

Kolom

Klik kolom dari kanvas diagram.

Object Profiler menampilkan nilai nama, jenis, dan 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 tersebut.

Di tab Detail, Anda dapat melihat:

• Nama Tampilan: Nama tampilan yang memiliki kolom.
• Label: Bagaimana kolom akan muncul di bagian Data pada Jelajah, yang merupakan nama atau label tampilan yang diikuti dengan nama atau label kolom tersebut.
• Distribusi: Untuk dimensi numerik pada tampilan dengan ukuran yang memiliki type: count, klik Calculate 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 Calculate untuk menampilkan pratinjau nilai jumlah. Klik Jelajahi Lainnya untuk membuka bagian Jelajahi yang memiliki kolom ini.

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

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

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

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 Go to LookML di kiri bawah Object Profiler untuk membuka file tempat join ditentukan. File akan terbuka di tab browser baru pada baris untuk Explore di join.