Membangun dasbor LookML

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

Untuk membandingkan dan mempertentangkan 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 Anda gunakan di dasbor.

Membuat file dasbor LookML

Untuk membuat dasbor LookML, mulailah dengan membuat file dasbor, yang memiliki ekstensi .dashboard.lookml (meskipun bagian .lookml dari ekstensi tidak terlihat 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 Opsi Folder folder untuk membuat file di dalam folder. Klik Buat Dasbor untuk membuat file dasbor.

1. Jendela Create File akan muncul. Di dalam jendela, beri nama file dasbor di kolom tulis, lalu pilih tombol Buat.

Mengedit file dasbor LookML

Saat Anda membuat file dasbor LookML, Looker akan mengisi file dengan beberapa parameter dasbor dasar, yang menerapkan setelan untuk seluruh dasbor. File ini juga diisi otomatis dengan beberapa parameter elemen dasbor contoh, yang dikelompokkan dalam parameter dasbor elements, dan yang menentukan fungsi serta tampilan kartu dasbor, teks, dan tombol. 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 sebelumnya dari file, menyalin LookML dasbor dari dasbor yang ditentukan pengguna, dan menempelkannya ke file dasbor Anda.
• Menyalin LookML dasbor elemen: Anda dapat menyalin LookML dasbor dari Eksplorasi atau Look dan menempelkannya ke file dasbor.

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

Menambahkan visualisasi ke dasbor LookML yang ada

Cara termudah untuk menambahkan visualisasi ke dasbor LookML yang ada adalah dengan menggunakan halaman Jelajah 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 penjelajahan di Penjelajah.

2. Pilih Dapatkan LookML untuk menampilkan LookML.

   

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

   

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

• Pastikan Anda berada di Mode Pengembangan agar dapat mengedit file dasbor.
• Tempelkan LookML di bagian parameter elements dasbor.
• Gunakan indentasi yang benar saat menempelkan LookML ke dalam file dasbor. Jika memungkinkan, sesuaikan 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 elemen dasbor disimpan dalam file dasbor, Anda mungkin ingin 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 tertentu, jenis pelanggan, dll. yang ditampilkan
• Menyediakan kemampuan jenis "pencarian" 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 dikodekan secara permanen ke dalam elemen dasbor

Filter yang Anda hardcode ke dalam elemen dasbor, yang tidak dapat diubah oleh pengguna, biasanya dibuat secara otomatis di langkah LookML salinan 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 dalam 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 digunakan 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 Eksplorasi (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 yang ditautkan dapat diperbarui secara dinamis berdasarkan pilihan pengguna dalam filter.

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

Misalnya, perhatikan 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.

Untuk mengizinkan pengguna 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, serta 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 (dengan jenis data yang sama) dalam elemen tertentu. Misalnya, satu elemen dapat menerapkan input pengguna ke tanggal dibuat 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 kueri tidak memiliki parameter listen, kueri tersebut tidak akan terpengaruh oleh filter dasbor apa pun.

Menyertakan file dasbor dalam model

Agar dasbor Anda dapat dilihat untuk pratinjau dalam Mode Pengembangan atau terlihat dalam produksi, dasbor tersebut harus disertakan dalam file model tempat dasbor didasarkan dengan 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 Simpan Perubahan di pojok kanan atas file.
2. Sertakan dasbor dalam file model yang relevan dan simpan perubahan pada file tersebut.
3. Pada file .dashboard.lookml yang ingin Anda lihat pratinjaunya, klik ikon panah ke 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, sehingga pengguna lain dengan izin yang benar dapat 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 akan disimpan di folder Dasbor LookML secara default. Folder Dasbor LookML berada di folder Folder di navigasi sebelah kiri. Folder dasbor LookML berbeda dari folder lain dalam beberapa hal:

• Anda harus menyertakan dasbor LookML dalam setidaknya satu file model agar dasbor tersebut 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 petak tertentu dalam dasbor LookML, pelihat dasbor harus memiliki akses ke model LookML yang menjadi dasar petak tersebut.
• Untuk mengedit dasbor di folder Dasbor LookML, Anda harus memiliki izin develop pada model yang menyertakan dasbor LookML.
• Untuk menggunakan fitur Jelajahi 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 tingkat akses foldernya adalah Kelola Akses, Edit.

Ada dua cara untuk memindahkan dasbor:

• Dari folder Dasbor LookML, pilih dasbor yang akan dipindahkan, klik tombol Pindahkan di bagian atas bagian 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 Anda berada dalam Mode Pengembangan, Anda tidak dapat memindahkan dasbor LookML ke luar folder dasbor LookML. Sebagai gantinya, Anda dapat menggunakan opsi Impor 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. 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 tiga titik Tindakan dasbor 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 begitu, Anda dapat membuat dasbor kedua berdasarkan dasbor asli, dan 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 dapat meningkatkan performa dasbor LookML dengan menggunakan pengenalan agregat. Dengan pengetahuan gabungan, developer dapat membuat tabel gabungan di bawah 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 mengetahui informasi selengkapnya, lihat halaman dokumentasi parameter aggregate_table.

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