Membuat model data di LookML

LookML dan Looker IDE memungkinkan Anda menentukan model data, dimensi, dan hubungan yang dapat digunakan kembali berdasarkan tabel database Anda. Dalam panduan memulai ini, Anda akan membuat file model dan file tampilan, mengonfigurasi Explore, dan menguji dimensi baru menggunakan project LookML contoh di Looker (Google Cloud core). Anda juga akan mempelajari cara mengaktifkan Mode Pengembangan, menjelajahi IDE Looker, dan menggunakan Bantuan Cepat.

Sebelum memulai

Untuk mengikuti panduan memulai ini, Anda memerlukan hal berikut:

Peran yang diperlukan

Untuk menyelesaikan panduan memulai ini, Anda memerlukan peran Identity and Access Management (IAM) dan peran Looker yang sesuai.

Peran Identity and Access Management

Administrator Looker (Google Cloud core) memberi Anda akses ke aplikasi Looker (Google Cloud core) melalui sistem Identity and Access Management Google Cloud.

Untuk mendapatkan izin yang Anda perlukan untuk mengakses aplikasi Looker (Google Cloud core), minta administrator untuk memberi Anda peran IAM Looker Instance User (roles/looker.instanceUser) di project Google Cloud yang berisi instance Looker (Google Cloud core). Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin looker.instances.login, yang diperlukan untuk mengakses aplikasi Looker (Google Cloud core).

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Izin Looker

Anda memerlukan 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 panduan memulai ini, Anda akan menggunakan Mode Pengembangan agar dapat membuat perubahan pada file LookML dan menguji perubahan Anda di Explore.

Untuk mengaktifkan Mode Pengembangan, ikuti langkah-langkah berikut:

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

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

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

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

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

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

Membuat folder project baru

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

Untuk membuat folder di project Anda, ikuti langkah-langkah berikut:

  1. 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.

  2. Untuk nama folder baru, masukkan quickstart.

  3. Klik Create.

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

Informasi tambahan tentang folder IDE

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

Membuat file model LookML baru

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

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

  1. Di panel File Browser di Looker IDE, pilih menu tiga titik Folder Options untuk folder quickstart yang Anda buat dalam prosedur Membuat folder project baru.
  2. Dari menu Folder Options, pilih Create Model.
  3. Dalam dialog Create File, masukkan nama quickstart_practice untuk file baru, lalu klik Create. Looker akan membuat file quickstart_practice.model di folder quickstart dan membuka file baru di Looker IDE. Titik biru di samping file di panel File Browser menunjukkan bahwa file tersebut baru.
  4. Di panel File Browser, klik folder quickstart untuk meluaskannya dan melihat file quickstart_practice.model.
  5. Di Looker IDE, 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. Di bagian selanjutnya dalam panduan memulai ini, Anda akan membuat Eksplorasi di file model.

Informasi tambahan tentang file model

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

Membuat file tabel virtual LookML baru

Di LookML, tabel virtual 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 substitusi $ untuk mereferensikan kolom di bagian lain LookML Anda. 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 meminta Looker membuat file tampilan secara otomatis berdasarkan tabel yang ada di database Anda.

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

  1. Di panel File Browser di Looker IDE, pilih menu tiga titik Folder Options untuk folder quickstart yang Anda buat dalam prosedur Membuat folder project baru.
  2. Pilih Create View from Table dari menu Folder Options.

  3. Di halaman Create Views from Tables, klik kolom input Enter custom db, lalu ketik bigquery-public-data:

    Dialog Create Views from Tables.

  4. Tekan Enter untuk melihat set data publik BigQuery.

  5. Scroll daftar hingga Anda menemukan set data thelook_ecommerce.

  6. Klik set data thelook_ecommerce untuk meluaskannya.

  7. Pilih tabel order_items.

  8. Klik tombol Create Views di bagian bawah halaman.

Looker akan menampilkan file tabel virtual order_items di Looker IDE. 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:

Bantuan Cepat Looker IDE

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

  • Di panel editor IDE, Anda dapat mengklik kolom dan parameter dalam file LookML, dan panel Quick Help 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 Quick Help belum terbuka, Anda dapat membukanya dengan mengklik ikon Quick Help di Looker IDE:

Membuat Eksplorasi untuk tampilan Anda

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

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

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

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

  1. Di Looker IDE, buka file quickstart_practice.model.

  2. Dalam file quickstart_practice.model, ganti baris yang ada yang berisi parameter include dengan baris berikut:

    include: "/quickstart/order_items.view"

  3. Tambahkan baris baru di bawah parameter include, dan masukkan LookML berikut: alue, yang dapat Anda pilih dari kolom none explore: order_items {}

  4. Klik tombol Save Changes di bagian atas Looker IDE.

Explore ini adalah contoh paling dasar dari Explore yang memungkinkan pengguna mengkueri tampilan order_items. Dari titik awal ini, Anda dapat membangun Eksplorasi dengan berbagai cara.

Informasi tambahan tentang Eksplorasi

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

Membuat kolom baru

Setelah membuat file tampilan di bagian Membuat file tampilan LookML baru dalam 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 merepresentasikan atribut, fakta, atau nilai, yang dapat dipilih pengguna dari pemilih kolom dalam Explore dan dapat digunakan untuk memfilter kueri. Jika kolom tidak berada di dalam fungsi agregat seperti SUM, COUNT, dan sejenisnya, kolom tersebut adalah dimensi. Looker 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 dimensi individual 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 Explore yang mewakili informasi terukur tentang data Anda, seperti jumlah, hitungan, dll. Ukuran dideklarasikan dalam file tampilan dan dapat berupa jenis agregat atau non-agregat. Looker otomatis membuat ukuran type:count untuk file tabel virtual 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:

  1. 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.
  2. Di file quickstarts/order_items.view, buat baris baru sebelum parameter dimension pertama dalam file.

  3. Di baris baru, mulai ketik dimension. Saat Anda mengetik, Looker IDE akan menampilkan daftar kemungkinan parameter yang diawali dengan teks yang telah Anda ketik.

    • Gunakan tombol panah untuk membuka opsi dimension di daftar saran.
    • Tekan Enter untuk menyisipkan parameter yang dipilih ke LookML Anda. Looker akan menyisipkan parameter dimension baru di baris baru yang Anda buat.

  4. Untuk memberikan nama dimensi baru, klik di IDE sebelum {} dan ketik shipped_to_delivered_days.

  5. Klik di dalam {} dan tekan Enter untuk membuat baris baru di dalam {}.

  6. 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} ;;
}

  7. 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 menaungi nomor baris dengan warna hijau.

Informasi tambahan tentang kolom LookML

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

  • Untuk mengetahui informasi tentang kolom LookML secara umum, lihat halaman dokumentasi Referensi kolom LookML.
  • Untuk mengetahui informasi tentang jenis dimensi, filter, dan parameter yang dapat Anda buat dalam file tampilan, lihat halaman dokumentasi Jenis dimensi, filter, dan parameter.
  • Untuk mengetahui 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 Eksplorasi untuk tampilan guna membuat Eksplorasi untuk file tampilan order_items, Anda dapat melihat dimensi baru di UI Eksplorasi Looker.

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

  1. 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.

    Menu tindakan Lihat file, dengan opsi Explore Order Items - quickstart_practice yang dipilih.

  2. Di pemilih kolom Eksplorasi Order Items, klik label grup Other Dates untuk meluaskannya, lalu klik dimensi Shipped to Delivered Days untuk menambahkannya ke Eksplorasi. (Anda juga dapat menelusuri dimensi dengan mengetik Shipped to Delivered Days di kotak penelusuran pemilih kolom.)

  3. Di pemilih kolom Eksplorasi Order Items, klik label grup Shipped Date untuk meluaskannya, lalu klik dimensi Date untuk menambahkannya ke Eksplorasi.

  4. Di pemilih kolom Explore Order Items, klik label grup Delivered Date untuk meluaskannya, lalu klik dimensi Date untuk menambahkannya ke Explore.

  5. Klik tombol Run di bagian atas Explore.

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

Memvalidasi LookML Anda

Untuk keperluan panduan memulai ini, Anda tidak perlu memvalidasi LookML. Namun, di 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 secara penuh, yang akan memeriksa LookML Anda untuk menemukan error. Lihat halaman dokumentasi Memvalidasi LookML untuk mengetahui informasi selengkapnya.

Melakukan commit perubahan

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

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

File LookML dan Eksplorasi yang telah Anda lihat dalam panduan memulai ini hanya tersedia di cabang Git pribadi Anda saat dalam Mode Pengembangan. Jika ingin menyediakan model ini bagi pengguna lain di instance Looker (Google Cloud core), Anda harus melakukan commit 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 menjaga cabang Git pribadi tetap bersih dan menghindari deployment file ini secara tidak sengaja ke produksi, selesaikan langkah-langkah berikut untuk menghapus file yang Anda buat dalam panduan memulai ini:

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

Looker akan menghapus folder quickstart dan semua kontennya.

Langkah berikutnya