Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat model data di LookML

Pelajari cara menggunakan LookML dan Looker IDE untuk membuat model data Anda dengan cara yang terstruktur dan dapat digunakan kembali.

Cara termudah untuk membuat model data di Looker adalah dengan membuat Looker secara otomatis membuat file LookML yang didasarkan pada tabel di database Anda. Anda dapat berlatih melakukannya dengan panduan memulai Membuat model dari data sampel, dan Anda dapat melihat prosedur lengkapnya di halaman dokumentasi Membuat model LookML.

Tujuan panduan memulai ini adalah untuk menunjukkan cara menambahkan file LookML secara manual ke project dan cara membuat elemen LookML baru secara manual sehingga Anda dapat menyesuaikan project LookML dengan data dan kebutuhan spesifik Anda. Panduan memulai ini akan memandu Anda membuat file model LookML dan file tampilan LookML secara manual, membuat Jelajah untuk tampilan, membuat dimensi baru di file tampilan, dan menguji ukuran baru di UI Jelajah. Panduan memulai ini juga akan memandu Anda mengaktifkan Mode Pengembangan, menavigasi Looker IDE, dan menggunakan fitur Bantuan Cepat Looker IDE. Panduan memulai ini juga akan memberikan link ke dokumentasi yang relevan untuk mempelajari topik ini lebih lanjut.

Sebagai titik awal, panduan memulai ini menggunakan contoh project LookML yang dikonfigurasi secara otomatis di instance Looker (Google Cloud core).

Sebelum memulai

Untuk mengikuti panduan memulai ini, Anda memerlukan hal berikut:

Akses ke instance Looker (Google Cloud core):
- Instance harus menyertakan contoh project LookML.
- Project Google Cloud instance harus mengaktifkan BigQuery API. Peran IAM Looker Admin diperlukan untuk mengaktifkan BigQuery API.
  Mengaktifkan API
Akun pengguna Looker dengan peran Looker Admin atau izin develop.

Mengaktifkan Mode Pengembangan

Project Looker dapat berada dalam salah satu dari dua mode: Mode Produksi dan Mode Pengembangan. Mode Pengembangan memungkinkan Anda membuat perubahan pada file LookML dan melihat pratinjau pengaruhnya terhadap konten di instance Anda tanpa memengaruhi lingkungan produksi (yang dilihat pengguna lain). Lihat halaman dokumentasi Mode Pengembangan dan Mode Produksi untuk mengetahui informasi selengkapnya.

Untuk memulai cepat ini, Anda akan menggunakan Mode Pengembangan sehingga dapat membuat perubahan pada file LookML dan menguji perubahan di Jelajahi.

Untuk mengaktifkan Mode Pengembangan, ikuti langkah-langkah berikut:

Di halaman beranda Looker (inti Google Cloud), klik ikon Main menu Looker untuk meluaskan menu navigasi utama, jika belum diluaskan.
Pilih tombol Mode Pengembangan di bagian bawah menu.

Saat Mode Pengembangan diaktifkan, Looker akan menampilkan banner Mode Pengembangan di bagian atas layar.

Buka project LookML contoh di IDE Looker

Project LookML adalah kumpulan file LookML yang memberi tahu Looker cara terhubung ke database, cara membuat kueri data, dan cara menampilkan data di antarmuka pengguna. Dalam panduan memulai ini, Anda akan menggunakan contoh project LookML yang dikonfigurasi secara otomatis di instance Looker (Google Cloud core).

Untuk membuka file project LookML contoh di IDE Looker, ikuti langkah-langkah berikut:

Klik ikon Menu utama Looker dan pilih Kembangkan, jika menu Kembangkan belum ditampilkan.
Dari menu Develop, pilih sample_thelook_ecommerce.

Looker akan membuka panel File Browser di IDE Looker dan menampilkan contoh file project LookML.

Membuat folder project baru

Agar file yang Anda buat dalam panduan memulai ini terpisah dari file lainnya dalam project contoh LookML, Anda akan membuat folder project baru untuk file panduan memulai.

Untuk membuat folder dalam project, ikuti langkah-langkah berikut:

Di panel File Browser di Looker IDE, klik ikon Add file or folder di bagian atas panel, lalu pilih opsi Create Folder dari menu Add file or folder.
Untuk nama folder baru, masukkan quickstart.

Tips: LookML peka huruf besar/kecil. Secara umum, sebaiknya gunakan huruf kecil secara konsisten saat Anda memberi nama objek dan folder LookML. Lihat catatan penting untuk membuat file dan folder guna mengetahui batasan dan panduan untuk memberi nama file dan folder.
Klik Create.

Looker akan menambahkan folder baru ke panel File Browser di IDE Looker.

Informasi tambahan tentang folder IDE

Untuk mempelajari lebih lanjut cara menggunakan folder dalam project LookML, lihat halaman dokumentasi berikut:

Untuk membuat folder dan file Anda sendiri di masa mendatang, dan untuk pertimbangan dalam membuat folder di project Anda, lihat halaman dokumentasi Mengelola file dan folder LookML.
Untuk mempelajari lebih lanjut browser file IDE Looker, lihat halaman dokumentasi Menggunakan browser file IDE.

Membuat file model LookML baru

File model LookML menentukan koneksi database dan kumpulan Jelajah Looker yang menggunakan koneksi tersebut. Jelajah adalah titik awal bagi pengguna untuk membuat kueri data di Looker setelah data Anda dimodelkan di LookML (lihat Melihat dan berinteraksi dengan Jelajah di Looker).

Untuk membuat file model baru di project LookML, ikuti langkah-langkah berikut:

Di panel File Browser di Looker IDE, pilih menu Folder Options tiga titik untuk folder quickstart yang Anda buat dalam prosedur Membuat folder project baru.
Dari menu Folder Options, pilih Create Model.
Pada dialog Create File, masukkan nama quickstart_practice untuk file baru, lalu klik Create. Looker membuat file quickstart_practice.model di folder quickstart dan membuka file baru di IDE Looker. Titik biru di samping file di panel File Browser menunjukkan bahwa file tersebut baru.
Di panel File Browser, klik folder quickstart untuk meluaskannya dan melihat file quickstart_practice.model.
Di IDE Looker, klik file quickstart_practice.model untuk membukanya jika belum terbuka.

File quickstart_practice.model berisi contoh LookML yang dapat Anda gunakan sebagai titik awal untuk project Anda. Untuk saat ini, Anda dapat menyimpan file apa adanya. Nanti di panduan memulai, Anda akan membuat Jelajah di file model.

Informasi tambahan tentang file model

Untuk membuat file model Anda sendiri pada masa mendatang, perhatikan referensi berikut:

Untuk informasi tentang file model secara umum, lihat bagian File model di halaman dokumentasi File project LookML.
Untuk mengetahui prosedur lengkap dan opsi lain untuk membuat file dalam project Anda, lihat halaman dokumentasi Mengelola file dan folder LookML.
Untuk informasi tentang konvensi penamaan file LookML, lihat bagian Sebelum memulai: Konvensi penamaan file dan folder yang penting di halaman Mengelola file dan folder LookML.
Untuk mengetahui informasi tentang parameter LookML yang dapat Anda gunakan dalam file model, lihat halaman dokumentasi Parameter model.

Membuat file tampilan LookML baru

Di LookML, tampilan sesuai dengan satu tabel di database Anda atau satu tabel turunan. File tampilan menentukan tabel dalam database Anda yang akan dikueri dan kolom (dimensi dan ukuran) yang akan disertakan dari tabel database tersebut. Setelah menentukan kolom dalam file tampilan, Anda dapat menggunakan operator penggantian $ untuk mereferensikan kolom di bagian lain LookML. Hal ini memungkinkan Anda menentukan kolom di satu lokasi sekaligus menggunakannya di beberapa tempat dalam project LookML.

Ada beberapa cara untuk membuat file tampilan baru, tetapi cara termudah untuk memulai adalah dengan membuat Looker secara otomatis membuat file tampilan berdasarkan tabel yang ada di database Anda.

Agar Looker membuat file tampilan baru, ikuti langkah-langkah berikut:

Di panel File Browser di Looker IDE, pilih menu Folder Options tiga titik untuk folder quickstart yang Anda buat dalam prosedur Membuat folder project baru.
Pilih Create View from Table dari menu Folder Options.
Di halaman Create Views from Tables, klik kolom input Enter custom db dan ketik bigquery-public-data:
Tekan Enter untuk melihat set data publik BigQuery.
Scroll daftar hingga Anda menemukan set data thelook_ecommerce.
Klik set data thelook_ecommerce untuk meluaskannya.
Pilih tabel order_items.
Klik tombol Create Views di bagian bawah halaman.

Looker menampilkan file tampilan order_items di IDE Looker. Di panel File Browser, folder quickstart diperluas dan file tampilan order_items ditampilkan dengan titik biru untuk menunjukkan bahwa file tersebut adalah file baru.

Informasi tambahan tentang file tampilan

Untuk membuat file tampilan Anda sendiri di masa mendatang, perhatikan referensi berikut:

Untuk informasi tentang file tampilan secara umum, lihat bagian File tampilan di halaman dokumentasi File project LookML.
Untuk mengetahui prosedur lengkap dan opsi lain untuk membuat file dalam project Anda, lihat halaman dokumentasi Mengelola file dan folder LookML.
Untuk pertimbangan khusus terkait pembuatan file tampilan, lihat bagian Pertimbangan untuk membuat file tampilan di halaman Mengelola file dan folder LookML.
Untuk informasi tentang konvensi penamaan file LookML, lihat bagian Sebelum memulai: Konvensi penamaan file dan folder yang penting di halaman Mengelola file dan folder LookML.
Untuk mengetahui informasi tentang parameter LookML yang dapat Anda gunakan dalam file tampilan, lihat halaman dokumentasi Parameter tampilan.

Bantuan Cepat Looker IDE

Sekarang Anda telah membuat file model LookML dan file tampilan LookML. Pada langkah berikutnya dalam panduan memulai ini, Anda akan mulai mengedit file ini. Sebelum mulai mengedit, Anda harus memahami fitur Bantuan Cepat Looker IDE. Panel Bantuan Cepat memberikan penjelasan dan opsi untuk lokasi kursor saat ini dalam file LookML Anda:

Di panel editor IDE, Anda dapat mengklik kolom dan parameter dalam file LookML, dan panel Bantuan Cepat akan menampilkan opsi dan subparameter yang didukung untuk elemen LookML tersebut.
Di panel Bantuan Cepat, Anda dapat mengklik nama parameter untuk membuka halaman dokumentasi Looker untuk parameter tersebut.

Jika panel Bantuan Cepat belum terbuka, Anda dapat membukanya dengan mengklik ikon Bantuan Cepat di IDE Looker:

Membuat Jelajah untuk tampilan Anda

Setelah melakukan prosedur Membuat file model LookML baru dan prosedur Membuat file tampilan LookML baru, Anda dapat menentukan Jelajahi untuk file tampilan baru sehingga Anda dapat menggunakan Looker untuk mengkueri data yang telah Anda buat modelnya dalam file tampilan.

Eksplorasi biasanya ditentukan dalam file model. (Anda dapat membuat file Jelajah terpisah, tetapi untuk tujuan panduan memulai ini, Anda akan membuat Jelajah dalam file model.)

Dalam file LookML tempat Anda menentukan Jelajah, Anda harus menggunakan parameter include agar dapat mereferensikan file tampilan dalam definisi Jelajah. Prosedur ini akan memandu Anda melalui langkah-langkah ini.

Untuk membuat Jelajahi untuk file tampilan order_items, ikuti langkah-langkah berikut:

Di IDE Looker, buka file quickstart_practice.model.
Dalam file quickstart_practice.model, ganti baris yang ada yang berisi parameter include dengan baris berikut:
```
include: "/quickstart/order_items.view"
```
Tips: Anda dapat memverifikasi bahwa Anda telah berhasil menyertakan file tampilan order_items dengan mencari kotak pemberitahuan yang bertuliskan, "File yang disertakan: quickstart/order_items.view.lkml" di panel Bantuan Cepat. Jika Anda telah mencoba menyertakan file yang tidak ada (atau membuat kesalahan ketik dalam nama file), panel Bantuan Cepat akan menampilkan kotak pemberitahuan yang bertuliskan, "Penyertaan ini tidak cocok dengan file apa pun".
Tambahkan baris baru di bagian parameter include, lalu masukkan LookML berikut: nilai, yang dapat Anda pilih dari kolom none explore: order_items {}
Klik tombol Save Changes di bagian atas Looker IDE.

Jelajah ini adalah contoh paling dasar dari Jelajah yang memungkinkan pengguna membuat kueri tampilan order_items. Dari titik awal ini, Anda dapat membuat Jelajah dengan banyak cara.

Informasi tambahan tentang Jelajah

Untuk membuat Jelajah Anda sendiri di masa mendatang dan membuat Jelajah, perhatikan referensi berikut:

Untuk informasi selengkapnya tentang cara membuat Jelajah, lihat halaman dokumentasi Membuat dan mengedit Jelajah.
Untuk informasi tentang penggabungan di tampilan lain, lihat halaman dokumentasi Menggunakan penggabungan di LookML.
Untuk mengetahui informasi tentang parameter LookML yang dapat Anda gunakan untuk Jelajah, lihat halaman dokumentasi Menjelajahi parameter.
Untuk mengetahui informasi tentang membuat kueri data di halaman Jelajah di UI Looker, lihat halaman dokumentasi Melihat dan berinteraksi dengan Jelajah di Looker.

Membuat kolom baru

Setelah membuat file tampilan di bagian Membuat file tampilan LookML baru di panduan memulai ini, Anda dapat melihat kolom yang dibuat Looker secara otomatis. Saat Anda membuat file tampilan yang didasarkan pada tabel database, Looker akan otomatis membuat dimensi, grup dimensi, dan ukuran:

Dimensi adalah kolom yang mewakili atribut, fakta, atau nilai, yang dapat dipilih pengguna dari pemilih kolom dalam Jelajahi dan dapat digunakan untuk memfilter kueri. Jika kolom tidak berada di dalam fungsi agregat seperti SUM, COUNT, dan sejenisnya, kolom tersebut adalah dimensi. Looker secara otomatis membuat dimensi untuk setiap kolom dalam tabel database Anda.
Grup dimensi digunakan untuk membuat kumpulan dimensi berbasis waktu atau berbasis durasi sekaligus. Misalnya, grup dimensi untuk kolom stempel waktu akan berisi masing-masing dimensi untuk tanggal, bulan, kuartal, waktu, minggu, dan tahun. Looker otomatis membuat grup dimensi untuk kolom berbasis waktu yang dideteksi Looker di tabel database Anda.
Ukuran adalah kolom di Jelajahi yang mewakili informasi yang dapat diukur tentang data Anda, seperti jumlah, hitungan, dll. Ukuran dideklarasikan dalam file tampilan dan dapat berupa jenis agregat atau non-agregat. Looker akan otomatis membuat ukuran type:count untuk file tampilan Anda, yang setara dengan COUNT(*) di SQL.

Di bagian ini, Anda akan mempelajari cara menambahkan dimensi Anda sendiri secara manual ke file tampilan order_items.

Untuk membuat dimensi baru secara manual di file tampilan order_items, ikuti langkah-langkah berikut:

Buka file quickstarts/order_items.view jika belum terbuka: Di panel File Browser di Looker IDE, klik folder quickstart untuk meluaskannya, lalu klik file order_items.view untuk membukanya.
Di file quickstarts/order_items.view, buat baris baru sebelum parameter dimension pertama dalam file.
Pada baris baru, mulailah mengetik dimension. Saat Anda mengetik, Looker IDE akan menampilkan daftar kemungkinan parameter yang dimulai dengan teks yang telah Anda ketik.
- Gunakan tombol panah untuk membuka daftar saran ke opsi dimension.
- Tekan Enter untuk menyisipkan parameter yang dipilih ke dalam LookML Anda. Looker akan menyisipkan parameter dimension baru di baris baru yang Anda buat.
Tips: Saat Anda mengetik di IDE, lihat panel Bantuan Cepat untuk mengetahui informasi tentang parameter dan kemungkinan subparameter yang didukung di lokasi kursor Anda saat ini.
Untuk memberikan nama dimensi baru, klik di IDE sebelum {} dan ketik shipped_to_delivered_days.
Klik di dalam {} dan tekan Enter untuk membuat baris baru di dalam {}.
Lengkapi LookML untuk dimensi baru (Anda dapat menyalin dan menempelkan LookML berikut atau memasukkan LookML secara manual untuk melihat cara Looker IDE memberikan panduan):
```
dimension: shipped_to_delivered_days {
  group_label: "Other Dates"
  type: duration_day
  sql_start: ${shipped_raw} ;;
  sql_end: ${delivered_raw} ;;
}
```
Di bagian atas Looker IDE, klik tombol Save Changes.

Looker akan menyimpan file tampilan dengan dimensi baru Anda. Untuk baris baru dalam file, Looker IDE akan menandai nomor baris dengan warna hijau.

Informasi tambahan tentang kolom LookML

Untuk membuat kolom Anda sendiri pada masa mendatang, perhatikan referensi berikut:

Untuk informasi tentang kolom LookML secara umum, lihat halaman dokumentasi Referensi kolom LookML.
Untuk informasi tentang jenis dimensi, filter, dan parameter yang dapat Anda buat dalam file tampilan, lihat halaman dokumentasi Jenis dimensi, filter, dan parameter.
Untuk informasi tentang jenis ukuran yang dapat Anda buat dalam file tampilan, lihat halaman dokumentasi Jenis ukuran.

Melihat dan menguji perubahan di UI Looker

Jika Anda melakukan prosedur Membuat Jelajah untuk tampilan guna membuat Jelajah untuk file tampilan order_items, Anda dapat melihat dimensi baru di UI Jelajah Looker.

Untuk melihat dan menguji perubahan Anda di Jelajahi di UI Looker, ikuti langkah-langkah berikut:

Dari file quickstarts/order_items.view di Looker IDE, klik ikon panah See file actions di samping nama file tampilan di bagian atas panel editor file, lalu pilih opsi Explore Order Items - quickstart_practice.

Tips: Anda juga dapat membuka Jelajahi dari Menu utama Looker. Dari menu utama, jika Anda berada di menu Develop, klik panah Close Develop, lalu klik Explore. Di menu Jelajahi, klik Latihan Mulai Cepat untuk meluasnya (jika belum diluaskan), lalu klik Jelajahi Pesan Item.
Di pemilih kolom Jelajah Item Pesanan, klik label grup Tanggal Lainnya untuk meluaskannya, lalu klik dimensi Hari Pengiriman hingga Hari Pengiriman untuk menambahkannya ke Jelajah. (Anda juga dapat menelusuri dimensi dengan mengetik Shipped to Delivered Days di kotak penelusuran pemilih kolom.)
Di pemilih kolom Jelajahi Item Pesanan, klik label grup Tanggal Pengiriman untuk meluaskannya, lalu klik dimensi Tanggal untuk menambahkannya ke Jelajahi.
Di pemilih kolom Jelajah Item Pesanan, klik label grup Tanggal Pengiriman untuk meluaskannya, lalu klik dimensi Tanggal untuk menambahkannya ke Jelajah.
Klik tombol Run di bagian atas Pelajari.

Looker akan menjalankan kueri dan menampilkan hasilnya di bagian Data di Jelajahi. Untuk setiap baris, Anda dapat memverifikasi bahwa nilai di Order Items Shipped to Delivered Days menunjukkan jumlah hari yang benar antara nilai Order Items Shipped Date dan nilai Order Items Delivered Date.

Memvalidasi LookML

Untuk tujuan panduan memulai ini, Anda tidak perlu memvalidasi LookML. Namun, pada masa mendatang, saat Anda membuat project sendiri untuk membuat model data, sebaiknya ketahui alat Looker untuk memvalidasi LookML Anda.

Saat Anda mengedit LookML, Looker IDE akan memberi tahu Anda tentang error sintaksis yang belum terselesaikan dalam satu file (lihat halaman dokumentasi Ringkasan Looker IDE). Anda juga dapat melakukan validasi model penuh, yang akan memeriksa LookML Anda untuk menemukan error. Lihat halaman dokumentasi Memvalidasi LookML untuk mengetahui informasi selengkapnya.

Melakukan commit pada perubahan

Dalam panduan memulai ini, Anda menggunakan koneksi Git yang telah dikonfigurasi sebelumnya dan disiapkan untuk project LookML contoh. Namun, pada masa mendatang, saat membuat project sendiri untuk membuat model data, Anda harus menyiapkan koneksi Git untuk project tersebut.

Saat Anda melakukan perubahan pada file project LookML, IDE Looker akan menampilkan operasi yang berbeda untuk tombol Git di sudut kanan atas IDE. Tombol ini menampilkan berbagai operasi untuk memandu Anda melalui proses memvalidasi LookML dan men-deploy perubahan ke produksi.

File LookML dan Jelajahi yang telah Anda lihat dalam panduan memulai ini hanya tersedia di cabang Git pribadi saat dalam Mode Pengembangan. Jika ingin menyediakan model ini kepada pengguna lain di instance Looker (inti Google Cloud), Anda harus melakukan commit pada perubahan, menggabungkan cabang, dan men-deploy cabang produksi.

Untuk tujuan panduan memulai ini, Anda tidak akan men-deploy perubahan ke produksi. Sebagai gantinya, Anda akan menghapus file ini, seperti yang dijelaskan dalam prosedur Pembersihan.

Pembersihan

Untuk memaksimalkan performa Looker, model yang tidak diperlukan tidak boleh di-deploy ke produksi. Untuk mempertahankan cabang Git pribadi yang bersih dan menghindari deployment file ini ke produksi secara tidak sengaja, selesaikan langkah-langkah berikut untuk menghapus file yang Anda buat dalam panduan memulai ini:

Klik ikon Menu utama Looker dan pilih Kembangkan, jika menu Kembangkan belum ditampilkan.
Dari menu Develop, pilih sample_thelook_ecommerce.
Di panel File Browser di Looker IDE, pilih menu Folder Options tiga titik untuk folder quickstart yang Anda buat dalam prosedur Membuat folder project baru.
Pilih Hapus dari menu Folder Options.
Di jendela Hapus Folder, klik Hapus.

Looker akan menghapus folder quickstart dan semua kontennya.