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:
- Aktifkan Mode Pengembangan.
- Di menu Develop, buka project Anda.
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.
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:
- Setelah membuat kueri dan visualisasi yang ingin ditambahkan ke dasbor, klik menu roda gigi Tindakan jelajahi di Eksplorasi.
Pilih Get LookML untuk mengekspos LookML.
Jendela Get LookML akan muncul. Dengan memilih Dashboard di jendela, pilih semua LookML dan salin.
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:
- Buat filter dasbor itu sendiri menggunakan parameter dasbor
filters
dan subparameternya. - 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 parameterexplore
danfield
. Jika Anda menyertakan parameterexplore
danfield
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:
- Simpan file
.dashboard.lookml
dengan mengklik tombol Save Changes di sudut kanan atas file. - Sertakan dasbor dalam file model yang relevan dan simpan perubahan pada file tersebut.
- 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
.