Membangun dasbor LookML

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

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

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

Selain itu, Anda harus memiliki akses ke model LookML untuk setiap data 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 ditampilkan di 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 browser file di Looker IDE untuk membuat file dasbor LookML di luar folder project yang ada. Atau, klik menu tiga titik Opsi Folder pada folder untuk membuat file di dalam folder. Klik Create Dashboard untuk membuat file dasbor.

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

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. Fitur ini juga akan mengisi file terlebih dahulu dengan beberapa contoh parameter elemen dasbor, yang dikelompokkan berdasarkan parameter dasbor elements, serta menentukan fungsi dan tampilan kartu dasbor, teks, dan tombol. File .dashboard.lookml yang baru dibuat berisi dasbor LookML 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 sesuai keinginan, selama 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 dasbor yang telah diisi sebelumnya LookML dari file, menyalin dasbor LookML dari dasbor yang ditentukan pengguna, dan menempelkannya ke file dasbor Anda.
  • Menyalin LookML dasbor dari elemen: Anda dapat menyalin dasbor LookML dari Explore atau Look dan menempelkannya ke file dasbor Anda.

Saat Anda membuat dasbor, ingatlah praktik terbaik untuk konstruksi dasbor. Temukan informasi dan rekomendasi tentang cara membuat dasbor berperforma tinggi di halaman 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 Explore untuk membuat kueri yang ingin diubah menjadi elemen dasbor:

  1. Setelah membuat kueri dan visualisasi yang ingin ditambahkan ke dasbor, klik menu roda gigi Tindakan jelajahi di Eksplorasi.
  2. Pilih Get LookML untuk mengekspos LookML.

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

    Di bagian atas jendela Get LookML, terdapat tab untuk Dashboard, Aggregate Table, dan Derived Table LookML.

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

  • Pastikan Anda berada dalam Mode Pengembangan agar dapat mengedit file dasbor.
  • Tempel 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 di file dasbor.

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

Menambahkan filter

Setelah Anda 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 untuk berbagai kemungkinan alasan, misalnya:

  • Menyesuaikan periode 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. Dua jenisnya adalah:

  • Filter yang Anda masukkan ke elemen dasbor, yang tidak dapat diubah oleh pelihat dasbor,
  • Filter dasbor, yang dapat diubah oleh pelihat dasbor

Filter hard code ke dalam elemen dasbor

Filter yang Anda rancang langsung ke elemen dasbor, yang tidak dapat diubah pengguna, biasanya dibuat secara otomatis pada langkah salinan 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

Anda dapat membuat filter dasbor yang dapat diubah pengguna dalam dua langkah:

  1. Buat filter dasbor itu sendiri menggunakan parameter dasbor filters dan subparameternya.
  2. Terapkan filter dasbor ke elemen dasbor menggunakan parameter elemen dasbor listen.

Membuat filter dasbor

Langkah pertama adalah membuat filter yang berinteraksi dengan pengguna. Untuk melakukannya, tambahkan bagian filters ke file dasbor Anda, yang akan terlihat seperti ini:

- dashboard: dashboard_name
  # possibly some other dashboard parameters here

  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

Berbagai opsi dan parameter untuk filter ini dijelaskan secara lebih mendetail di halaman dokumentasi Parameter dasbor. Salah satu hal terpenting untuk diingat adalah jenis {i>input<i} yang Anda harapkan dari pengguna. Anda dapat menetapkan type ke filter, yang akan menyebabkannya menerima jenis input tertentu, seperti angka, tanggal, atau string. Atau, Anda dapat menggunakan filter type untuk mengaitkan filter dengan kolom LookML dasar. Dalam hal ini, Looker akan otomatis memilih jenis input yang benar dan, jika kolom LookML dasarnya adalah type: string, memberikan saran filter ke pelihat dasbor.

Seperti yang dijelaskan di halaman dokumentasi Parameter dasbor, 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 harus menerapkannya ke elemen yang sesuai menggunakan parameter listen. Idenya adalah elemen tersebut "memproses" satu atau beberapa filter untuk input pengguna, lalu melakukan penyesuaian. Parameter ini berlaku untuk semua jenis elemen selain type: text dan type: button, dan detail penggunaannya muncul di halaman dokumentasi untuk setiap jenis visualisasi individual. Untuk contoh representatif tentang cara kerja listen, lihat Parameter diagram area untuk dasbor LookML.

Misalnya, Anda mungkin memiliki elemen yang terlihat seperti ini:

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

Anda dapat melihat bahwa elemen ini sudah memiliki parameter filters yang membatasi elemen ke pesanan yang disetujui (menggunakan filter order.status: 'approved'). Hal ini tidak dapat diubah oleh pengguna.

Misalnya Anda ingin pengguna dapat memfilter elemen ini menggunakan filter dasbor yang dibuat sebelumnya dalam contoh ini. Untuk melakukannya, tambahkan parameter listen seperti ini:

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

Jika Anda tidak ingin pengguna dapat menyesuaikan tanggal atau kategori, jangan tambahkan parameter listen. Anda hanya perlu menambahkan listen ke elemen yang Anda ingin dapat disesuaikan pengguna.

Anda akan melihat bahwa sintaksis listen berfungsi dengan terlebih dahulu menulis nama filter yang Anda buat, lalu menulis nama kolom tempat Anda ingin menerapkan input pengguna.

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

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

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

Menyertakan file dasbor dalam model

Agar dasbor Anda dapat dipratinjau dalam Mode Pengembangan atau terlihat dalam produksi, dasbor harus disertakan dalam file model yang menjadi dasar dasbor menggunakan pernyataan include.

Praktik yang umum adalah menyertakan semua dasbor LookML dalam sebuah model dengan 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. Pada file .dashboard.lookml yang ingin Anda lihat pratinjaunya, klik ikon panah bawah See file actions, lalu pilih View Dashboard.

Anda dapat membuat 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 tepat dapat melihatnya. Metode untuk memublikasikan dasbor sama dengan memublikasikan perubahan lain ke LookML pada instance, 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 terletak di folder Folders pada navigasi sebelah kiri. Folder dasbor LookML bersifat unik dari folder lain dalam beberapa hal:

  • Anda harus menyertakan dasbor LookML di setidaknya satu file model agar 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 tersebut.
  • Untuk melihat kartu tertentu dalam dasbor LookML, pelihat dasbor harus memiliki akses ke model LookML yang menjadi dasar kartu.
  • Untuk mengedit dasbor di folder dasbor LookML, Anda harus memiliki izin develop pada model yang mencakup dasbor LookML.
  • Untuk Jelajahi dari Sini di kartu tertentu dalam dasbor, pelihat dasbor harus memiliki izin explore untuk model yang menjadi dasar kartu.
  • Anda tidak dapat membuat folder di dalam folder dasbor LookML.

Memindahkan dasbor LookML di luar folder dasbor LookML

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

Ada dua cara untuk memindahkan dasbor:

  • Dari folder dasbor LookML, pilih dasbor yang akan dipindahkan, klik tombol Pindahkan di bagian atas dasbor, lalu pilih folder yang ingin Anda pindahkan dasbornya. Lihat halaman dokumentasi Mengatur dan mengelola konten untuk informasi selengkapnya.
  • Dari folder dasbor LookML, klik menu tiga titik untuk dasbor, pilih Pindahkan dari menu, dan 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. Namun, tidak seperti dasbor yang ditentukan pengguna, dasbor LookML tidak dapat diganti namanya atau dipindahkan ke sampah dari folder.

Jika nilai parameter dashboard pada 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 dasbor LookML untuk dasbor LookML yang ada dengan memilih Go to LookML dari menu Dashboard actions tiga titik pada 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 dasbornya. Ini memungkinkan Anda membuat dasbor kedua berdasarkan dasbor asli, kemungkinan menambahkan atau mengganti beberapa setelan. Kemudian, jika Anda mengubah dasbor pertama, dasbor kedua mewarisi perubahan tersebut secara otomatis (kecuali jika diganti di dasbor kedua). Lihat halaman dokumentasi Menggunakan kembali kode dengan diperluas untuk informasi selengkapnya.

Meningkatkan performa dasbor menggunakan awareness agregat

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

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

Untuk informasi selengkapnya, lihat halaman dokumentasi parameter aggregate_table.