Membangun dasbor LookML

Dasbor LookML dibuat oleh developer LookML dan disimpan sebagai file yang dikontrol versinya. Secara default, dasbor LookML muncul di folder LookML dashboards 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 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 ditampilkan dalam IDE). Langkah-langkahnya adalah sebagai berikut:

1. Aktifkan Mode Pengembangan.
2. Di menu Develop, buka project Anda.
3. Pilih ikon plus Add file or 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 Create Dashboard untuk membuat file dasbor.

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

Mengedit file dasbor LookML

Saat Anda membuat file dasbor LookML, Looker akan mengisi file tersebut dengan beberapa parameter dasbor dasar, yang menerapkan setelan untuk seluruh dasbor. Looker juga mengisi otomatis file tersebut dengan beberapa parameter elemen dasbor contoh, yang dikelompokkan di bawah parameter dasbor elements, dan yang menentukan fungsi serta tampilan tile 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 Anda.

Saat membuat dasbor, ingatlah praktik terbaik untuk pembuatan dasbor. Temukan informasi dan rekomendasi tentang pembuatan 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 menggunakan halaman Eksplorasi untuk membuat kueri yang ingin Anda ubah menjadi elemen dasbor:

1. Setelah membuat kueri dan visualisasi yang ingin Anda tambahkan ke dasbor, klik menu roda gigi Explore actions Eksplorasi.

2. Pilih Get LookML untuk menampilkan LookML.

   

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

   

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

• Memverifikasi bahwa Anda berada dalam Mode Pengembangan sehingga Anda dapat mengedit file dasbor.
• Menempelkan LookML di bawah parameter elements dasbor.
• Menggunakan indentasi yang benar saat menempelkan LookML ke file dasbor. Jika memungkinkan, cocokkan indentasi dengan elemen yang sudah ada di file dasbor.

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

Menambahkan filter

Setelah menyimpan elemen dasbor di 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, jenis pelanggan, dll. tertentu yang ditampilkan
• Menyediakan kemampuan jenis "pencarian" untuk klien atau pelanggan

Pastikan Anda membuat jenis filter yang diinginkan. Ada dua jenis filter:

• Filter yang Anda hardcode 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 hardcode ke dalam elemen dasbor, yang tidak dapat diubah oleh pengguna, biasanya dibuat secara otomatis pada 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 elemen dasbor individual 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 default 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 Anda 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 elemen dasbor individual menggunakan parameter listen. Penggunaan parameter listen dengan cara ini memungkinkan elemen tertaut diupdate secara dinamis berdasarkan pilihan pengguna dalam filter.

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

Misalnya, pertimbangkan kode LookML contoh 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 per 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 diupdate untuk mencerminkan hasil yang difilter.

Parameter listen menggunakan sintaksis filter_name: field_name. Dalam contoh sebelumnya, category_name dan date adalah nama filter, sedangkan 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 apa pun (dari jenis data yang sama) dalam elemen tertentu. Misalnya, satu elemen dapat menerapkan input pengguna ke tanggal dibuat pesanan (date: orders.created_date), sedangkan elemen lain menerapkannya ke tanggal dikirim 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 yang menjadi dasar dasbor 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 sudut kanan atas file.
2. Sertakan dasbor dalam file model yang relevan dan simpan perubahan pada file tersebut.
3. Di file .dashboard.lookml yang ingin Anda lihat pratinjaunya, klik ikon panah bawah See file actions , lalu pilih View Dashboard.

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 ke 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 LookML dashboards secara default. Folder LookML dashboards terletak di folder Folders di navigasi sebelah kiri. Folder LookML dashboards berbeda dari folder lain dalam beberapa hal:

• Anda harus menyertakan dasbor LookML di setidaknya satu file model agar dasbor tersebut muncul di folder LookML dashboards.
• Untuk melihat folder LookML dashboards, pengguna harus memiliki izin see_lookml_dashboards.
• Untuk melihat dasbor dalam folder LookML dashboards, pengguna harus memiliki akses ke model LookML yang menyertakan dasbor.
• Untuk melihat tile tertentu dalam dasbor LookML, pelihat dasbor harus memiliki akses ke model LookML yang menjadi dasar tile tersebut.
• Untuk mengedit dasbor di folder LookML dashboards, Anda harus memiliki izin develop pada model yang menyertakan dasbor LookML.
• Untuk Explore from Here di tile tertentu dalam dasbor, pelihat dasbor harus memiliki izin explore untuk model yang menjadi dasar tile tersebut.
• Anda tidak dapat membuat folder di dalam folder LookML dashboards.
• Dalam Mode Produksi, daftar folder LookML dashboards dipaginasi (30 dasbor per halaman). Dalam Mode Pengembangan, semua dasbor LookML berada di satu halaman.
• Setiap dasbor LookML diurutkan dalam folder LookML dashboards menurut nama dasbor LookML yang ditentukan dalam kode dasbor LookML, bukan judul dasbor LookML. Akibatnya, dasbor mungkin tidak terlihat diurutkan menurut abjad berdasarkan judul.

Memindahkan dasbor LookML ke luar folder dasbor LookML

Jika Anda memiliki izin see_lookml_dashboards dan develop Looker serta akses ke model LookML yang disertakan dalam dasbor LookML, Anda dapat memindahkan dasbor LookML ke folder mana pun yang memiliki tingkat akses folder Manage Access, Edit.

Ada dua cara untuk memindahkan dasbor:

• Dari folder LookML dashboards, pilih dasbor yang akan dipindahkan, klik tombol Move 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 LookML dashboards, klik menu tiga titik untuk dasbor, pilih Move 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 LookML dashboards. 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 LookML Dashboard. Dari bagian LookML Dashboard, 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.

Saat dipindahkan ke luar folder LookML dashboards, dasbor LookML akan mewarisi kontrol akses folder tujuan. Untuk melihat dasbor LookML di folder lain, pengguna (termasuk pengguna sematan) harus memiliki izin see_looks atau see_user_dashboards selain akses ke folder tujuan dan ke model LookML dasbor. Pengguna yang hanya memiliki izin see_lookml_dashboards tidak dapat melihat dasbor LookML yang telah dipindahkan ke luar folder LookML dashboards.

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

Melihat LookML untuk dasbor LookML yang ada

Jika memiliki izin see_lookml, Anda dapat membuka LookML dasbor untuk dasbor LookML yang ada dengan memilih Go to LookML dari menu tiga titik Dashboard actions dasbor:

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

Memperluas dasbor LookML

Setelah membuat dasbor LookML, Anda dapat memperluas dasbor. Hal ini memungkinkan Anda 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.

Menambahkan agen dasbor ke dasbor LookML

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mengonfigurasi agen data dasbor Analisis Percakapan untuk dasbor LookML. Agen dasbor memungkinkan pelihat mengajukan pertanyaan tentang data dasbor dalam bahasa alami menggunakan antarmuka chat percakapan.

Untuk mengonfigurasi agen dasbor untuk dasbor LookML:

1. Tentukan agen dasbor dalam file LookML menggunakan parameter agent dengan is_dashboard_agent: yes dan instructions kustom Anda.
2. Di file .dashboard.lookml, kaitkan agen dengan dasbor LookML menggunakan parameter default_dashboard_agent. Kontrol akses chat dengan parameter enabled_dashboard_agent. Contoh:

- dashboard: sales_overview
  title: "Sales Overview"
  layout: newspaper
  enabled_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent

Anda dapat menguji petunjuk dan perilaku agen dalam Mode Pengembangan sebelum men-deploy-nya ke produksi. Untuk mengetahui detail lengkap tentang cara mengonfigurasi, menguji, dan mengelola agen dasbor LookML, lihat halaman dokumentasi Membuat dan mengelola agen data untuk dasbor LookML.

Meningkatkan performa dasbor menggunakan aggregate awareness

Developer LookML mungkin dapat meningkatkan performa dasbor LookML menggunakan aggregate awareness. Dengan aggregate awareness, developer dapat membuat tabel gabungan di bawah parameter LookML explore, yang dapat mengoptimalkan kueri untuk satu atau beberapa tile di dasbor.

Setelah membuat dan melihat dasbor LookML, Anda dapat menggunakan opsi Get aggregate table LookML di menu tiga titik Dashboard actions, yang terlihat jika Anda memiliki izin see_lookml.

Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi parameter aggregate_table.

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