Membangun dasbor LookML

Dasbor LookML dibuat oleh developer LookML dan disimpan sebagai file yang dikontrol versi. Secara default, dasbor ini muncul di folder dasbor LookML pada instance Looker Anda.

Untuk membandingkan dan membedakan dasbor LookML dan dasbor yang ditentukan pengguna, lihat halaman dokumentasi Membandingkan dasbor yang ditentukan pengguna dan dasbor LookML.

Untuk membuat dasbor LookML, Anda harus memiliki izin Looker berikut:

• see_lookml_dashboards
• develop

Selain itu, Anda harus memiliki akses ke model LookML untuk data apa pun yang ingin digunakan di dasbor.

Membuat file dasbor LookML

Untuk mem-build dasbor LookML, mulailah dengan membuat file dasbor, yang memiliki ekstensi .dashboard.lookml (meskipun bagian .lookml dari ekstensi tidak aktif dalam IDE). Langkah-langkah untuk melakukannya adalah sebagai berikut:

1. Aktifkan Mode Pengembangan.
2. Di menu Develop, buka project Anda.
3. Pilih ikon plus Tambahkan file atau folder di bagian atas panel file browser di Looker IDE untuk membuat file dasbor LookML di luar folder project yang ada. Atau, klik menu tiga titik Folder Options folder untuk membuat file di dalam folder. Klik Buat Dasbor untuk membuat file dasbor.

1. Jendela Create File akan muncul. Dalam jendela, beri nama file dasbor di kolom tulis dan pilih tombol Buat.

Mengedit file dasbor LookML

Saat Anda membuat file dasbor LookML, Looker akan mengisi file tersebut secara otomatis dengan beberapa parameter dasbor dasar, yang menerapkan setelan untuk seluruh dasbor. Template ini juga mengisi file secara otomatis dengan beberapa contoh parameter elemen dasbor, yang dikelompokkan dalam parameter dasbor elements, dan yang menentukan fungsi serta tampilan kartu, teks, dan tombol dasbor. File .dashboard.lookml yang baru dibuat berisi LookML dasbor yang mirip dengan ini:

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

Anda dapat mengedit file dasbor dalam IDE selama Anda berada dalam Mode Pengembangan.

Anda memiliki beberapa opsi untuk membuat dasbor:

• Pembuatan manual: Anda dapat membuat dasbor secara manual menggunakan parameter dasbor dan parameter elemen dasbor.
• Menyalin dasbor yang ditentukan pengguna: Anda dapat membuat salinan dasbor yang ditentukan pengguna dengan menghapus LookML dasbor yang telah diisi otomatis dari file, menyalin LookML dasbor dari dasbor yang ditentukan pengguna, dan menempelkannya ke dalam file dasbor.
• Menyalin elemen LookML dasbor: Anda dapat menyalin LookML dasbor dari Jelajahi atau Tampilan dan menempelkannya ke file dasbor.

Saat membuat dasbor, perhatikan praktik terbaik untuk pembuatan dasbor. Temukan informasi dan rekomendasi tentang cara membuat dasbor yang berperforma tinggi di halaman Praktik Terbaik Pertimbangan saat membuat dasbor Looker yang berperforma tinggi.

Menambahkan visualisasi ke dasbor LookML yang ada

Cara termudah untuk menambahkan visualisasi ke dasbor LookML yang ada adalah dengan menggunakan halaman Jelajahi untuk membuat kueri yang ingin Anda ubah menjadi elemen dasbor:

1. Setelah membuat kueri dan visualisasi yang ingin ditambahkan ke dasbor, klik menu roda gigi Tindakan eksplorasi di Eksplorasi.

2. Pilih Get LookML untuk mengekspos LookML.

   

3. Jendela Get LookML akan muncul. Dengan Dasbor dipilih di jendela, pilih semua LookML dan salin.

   

Dari sini, tempelkan LookML ke dalam file LookML dasbor Anda. Saat mengedit file LookML dasbor, pastikan untuk:

• Pastikan Anda berada dalam Mode Pengembangan sehingga dapat mengedit file dasbor.
• Tempelkan LookML di bagian parameter elements dasbor.
• Gunakan indentasi yang benar saat menempelkan LookML ke dalam file dasbor. Jika memungkinkan, cocokkan indentasi dengan elemen yang sudah ada dalam file dasbor.

Anda dapat menyesuaikan parameter LookML jika diinginkan, menggunakan parameter yang dijelaskan di halaman dokumentasi untuk setiap jenis elemen.

Menambahkan filter

Setelah menyimpan elemen dasbor di file dasbor, Anda dapat menambahkan filter, yang memungkinkan pelihat dasbor memfilter beberapa atau semua elemen di dasbor. Filter dapat berguna karena berbagai alasan, misalnya:

• Menyesuaikan jangka waktu yang ditampilkan
• Menyesuaikan kategori produk, jenis pelanggan, dll. tertentu yang ditampilkan
• Memberikan kemampuan jenis "lookup" untuk klien atau pelanggan

Pastikan untuk membuat jenis filter yang Anda inginkan. Kedua jenis tersebut adalah:

• Filter yang Anda hard code ke dalam elemen dasbor, yang tidak dapat diubah oleh pelihat dasbor
• Filter dasbor, yang dapat diubah oleh pelihat dasbor

Filter yang di-hardcode ke dalam elemen dasbor

Filter yang Anda hard code ke dalam elemen dasbor, yang tidak dapat diubah oleh pengguna, biasanya dibuat secara otomatis di langkah menyalin LookML untuk visualisasi atau untuk dasbor. Di dasbor LookML, filter tersebut menggunakan parameter elemen dasbor filters dan terlihat seperti ini:

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

Filter dasbor

Filter dasbor memungkinkan pelihat menyaring data yang ditampilkan di elemen dasbor secara interaktif. Untuk membuat filter dasbor, ikuti langkah-langkah berikut:

1. Buat filter dasbor menggunakan parameter filters dalam file dasbor LookML Anda.
2. Terapkan filter ke setiap elemen dasbor menggunakan parameter listen.

Membuat filter dasbor

Parameter filters memungkinkan Anda membuat berbagai jenis filter interaktif untuk dasbor.

Untuk membuat filter dasbor yang dapat berinteraksi dengan pengguna, tambahkan parameter filters ke file dasbor Anda. Misalnya, kode contoh berikut membuat dasbor LookML yang memiliki filter date dan category_name:

- dashboard: dashboard_name
  title: Dashboard Title
  layout: newspaper
  filters:
  - name: date
    title: 'Date Range'
    type: date_filter
    default_value: 30 days

  - name: category_name
    type: field_filter
    model: ecommerce
    explore: product
    field: category.name

Kode dalam contoh sebelumnya membuat filter berikut:

• date: Filter tanggal yang memungkinkan pengguna memilih rentang tanggal. Nilai defaultnya ditetapkan ke 30 hari terakhir.
• category_name: Filter kolom yang memungkinkan pengguna memfilter menurut kategori produk. Filter ini secara dinamis menghasilkan opsi yang didasarkan pada kolom category.name dalam model LookML (ecommerce) dan Jelajah (product) yang ditentukan.

Catatan: Hanya filter dengan type: field_filter yang menggunakan parameter explore dan field. Jika menyertakan parameter explore dan field dengan jenis filter lainnya, Anda akan mendapatkan error validasi LookML.

Menerapkan filter dasbor ke elemen dasbor

Setelah membuat filter dasbor, Anda dapat menerapkan filter tersebut ke setiap elemen dasbor menggunakan parameter listen. Dengan menggunakan parameter listen dengan cara ini, elemen tertaut dapat diperbarui secara dinamis berdasarkan pilihan pengguna di filter.

Catatan: Parameter listen didukung oleh semua jenis elemen kecuali type: text dan type: button.

Misalnya, pertimbangkan contoh kode LookML berikut untuk elemen diagram area:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'

Diagram approved_orders_by_day menampilkan jumlah pesanan yang disetujui menurut hari, karena kueri didasarkan pada dimensi orders_created_date dan ukuran orders.count serta memiliki filter yang diterapkan, orders.status: 'approved'. Filter ini ditetapkan dalam elemen dan tidak dapat diubah oleh pelihat dasbor.

Agar pengguna dapat memfilter diagram approved_orders_by_day menggunakan filter date dan filter category_name dari contoh sebelumnya, tambahkan parameter listen ke elemen dasbor.

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'
  listen:
    category_name: category.name
    date: orders.created_date

Saat pelihat dasbor berinteraksi dengan filter category_name atau filter date, diagram approved_orders_by_day akan otomatis diperbarui untuk mencerminkan hasil yang difilter.

Parameter listen menggunakan sintaksis filter_name: field_name. Dalam contoh sebelumnya, category_name dan date adalah nama filter, dan category.name dan orders.created_date adalah kolom yang akan digunakan untuk memungkinkan pelihat dasbor memberikan input ke filter.

Filter dasbor dapat diterapkan ke kolom mana pun (dari jenis data yang sama) di elemen tertentu. Misalnya, satu elemen dapat menerapkan input pengguna ke tanggal pembuatan pesanan (date: orders.created_date), sementara elemen lain menerapkannya ke tanggal pengiriman pesanan (date: orders.ship_date):

- name: element_one
  # lots of other element parameters here
  listen:
    date: orders.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: orders.ship_date

Catatan: Untuk elemen dasbor yang menggunakan parameter merged_queries, setiap kueri sumber dapat memproses satu atau beberapa filter dasbor. Anda dapat menentukan logika filter untuk setiap kueri sumber secara independen, terlepas dari jumlah kueri sumber dalam elemen hasil gabungan. Jika tidak memiliki parameter listen, kueri tidak akan terpengaruh oleh filter dasbor apa pun.

Menyertakan file dasbor dalam model

Agar dasbor Anda dapat dilihat pratinjaunya dalam Mode Pengembangan atau terlihat dalam produksi, dasbor harus disertakan dalam file model tempat dasbor didasarkan menggunakan pernyataan include.

Praktik umum adalah menyertakan semua dasbor LookML dalam model menggunakan karakter pengganti:

include: "*.dashboard.lookml"

atau, jika dasbor LookML Anda muncul dalam folder di IDE, gunakan jalur ke lokasinya

 include: "/path/*.dashboard.lookml"

Anda juga dapat menyertakan dasbor tertentu dengan menentukan nama filenya:

include: "my_dashboard.dashboard.lookml"

Menyimpan, melihat pratinjau, dan memublikasikan dasbor LookML

Untuk melihat pratinjau dasbor:

1. Simpan file .dashboard.lookml dengan mengklik tombol Save Changes di pojok kanan atas file.
2. Sertakan dasbor dalam file model yang relevan dan simpan perubahan ke file tersebut.
3. Pada file .dashboard.lookml yang ingin Anda lihat pratinjaunya, klik ikon panah bawah Lihat tindakan file, lalu pilih Lihat Dasbor.

Anda dapat melakukan perubahan lebih lanjut pada file .dashboard.lookml, menyimpannya, dan melihat pratinjau dasbor lagi.

Setelah puas dengan dasbor, Anda dapat memublikasikannya ke produksi, yang memungkinkan pengguna lain dengan izin yang benar untuk melihatnya. Metode untuk memublikasikan dasbor sama dengan memublikasikan perubahan lain pada LookML di instance Anda, dan bergantung pada setelan kontrol versi untuk instance Looker Anda.

Folder dasbor LookML

Setelah dipublikasikan, dasbor LookML disimpan di folder Dasbor LookML secara default. Folder Dasbor LookML terletak di folder Folder di navigasi sebelah kiri. Folder Dasbor LookML unik dari folder lain dalam beberapa hal:

• Anda harus menyertakan dasbor LookML di setidaknya satu file model agar dapat muncul di folder Dasbor LookML.
• Untuk melihat folder dasbor LookML, pengguna harus memiliki izin see_lookml_dashboards.
• Untuk melihat dasbor dalam folder Dasbor LookML, pengguna harus memiliki akses ke model LookML yang menyertakan dasbor.
• Untuk melihat kartu tertentu dalam dasbor LookML, pelihat dasbor harus memiliki akses ke model LookML yang menjadi dasar kartu tersebut.
• Untuk mengedit dasbor di folder Dasbor LookML, Anda harus memiliki izin develop pada model yang menyertakan dasbor LookML.
• Untuk Menjelajahi dari Sini pada kartu tertentu dalam dasbor, pelihat dasbor harus memiliki izin explore untuk model yang menjadi dasar kartu tersebut.
• Anda tidak dapat membuat folder di dalam folder dasbor LookML.

Memindahkan dasbor LookML ke luar folder dasbor LookML

Jika Anda memiliki izin Looker see_lookml_dashboards dan develop serta akses ke model LookML yang menyertakan dasbor LookML, Anda dapat memindahkan dasbor LookML ke folder mana pun yang memiliki tingkat akses folder Kelola Akses, Edit.

Ada dua cara untuk memindahkan dasbor:

• Dari folder LookML dashboards, pilih dasbor yang akan dipindahkan, klik tombol Move di bagian atas dasbor, lalu pilih folder tempat Anda ingin memindahkan dasbor. Lihat halaman dokumentasi Mengatur dan mengelola konten untuk mengetahui informasi selengkapnya.
• Dari folder Dasbor LookML, klik menu tiga titik untuk dasbor, pilih Pindahkan dari menu, lalu pilih folder tempat Anda ingin memindahkan dasbor.

Jika berada dalam Mode Pengembangan, Anda tidak dapat memindahkan dasbor LookML ke luar folder Dasbor LookML. Sebagai gantinya, Anda dapat menggunakan opsi Import untuk menyalin dasbor LookML sebagai dasbor yang ditentukan pengguna ke folder lain.

Folder yang berisi dasbor yang ditentukan pengguna dan dasbor LookML akan menampilkan dasbor LookML di bagian Dasbor LookML. Dari bagian Dasbor LookML, Anda dapat memindahkan dasbor LookML ke folder lain atau menyematkan dasbor LookML ke papan tulis virtual. Namun, tidak seperti dasbor yang ditentukan pengguna, dasbor LookML tidak dapat diganti namanya atau dipindahkan ke sampah dari folder.

Jika nilai parameter dashboard dasbor LookML diubah, dasbor LookML akan otomatis dipindahkan kembali ke folder Dasbor LookML.

Melihat LookML untuk dasbor LookML yang ada

Jika memiliki izin see_lookml, Anda dapat membuka LookML dasbor untuk dasbor LookML yang ada dengan memilih Buka LookML dari menu Tindakan dasbor tiga titik dasbor:

Saat Anda memilih Buka LookML, Looker akan membuka file dasbor tempat dasbor LookML ditentukan.

Memperluas dasbor LookML

Setelah membuat dasbor LookML, Anda dapat memperluas dasbor. Dengan demikian, Anda dapat membuat dasbor kedua berdasarkan dasbor asli, yang mungkin menambahkan atau mengganti beberapa setelan. Kemudian, jika Anda mengubah dasbor pertama, dasbor kedua akan otomatis mewarisi perubahan tersebut (kecuali jika diganti di dasbor kedua). Lihat halaman dokumentasi Menggunakan kembali kode dengan extends untuk mengetahui informasi selengkapnya.

Meningkatkan performa dasbor menggunakan kesadaran gabungan

Developer LookML mungkin dapat meningkatkan performa dasbor LookML dengan menggunakan kesadaran gabungan. Dengan kesadaran gabungan, developer dapat membuat tabel gabungan di bagian parameter explore LookML, yang dapat mengoptimalkan kueri untuk satu atau beberapa kartu di dasbor.

Setelah membuat dan melihat dasbor LookML, Anda dapat menggunakan opsi Dapatkan LookML tabel gabungan di menu Tindakan dasbor tiga titik, yang terlihat jika Anda memiliki izin see_lookml.

Untuk informasi selengkapnya, lihat halaman dokumentasi parameter aggregate_table.

Catatan: Temukan informasi dan rekomendasi lainnya tentang cara membuat dasbor berperforma tinggi di halaman Praktik Terbaik Pertimbangan saat membuat dasbor Looker berperforma tinggi.