Membuat model LookML

Halaman dokumentasi ini menjelaskan langkah-langkah untuk membuat model LookML dasar secara otomatis dari koneksi database Anda menggunakan halaman Buat Model. Halaman Create a Model juga dapat digunakan untuk membuat project yang akan menyimpan model Anda.

Ada juga opsi lain untuk membuat file model:

Mengakses halaman Create a Model

Akses halaman Create a Model dengan cara berikut:

Untuk mengakses halaman Create a Model, Anda harus berada dalam Mode Pengembangan.

Untuk mengakses halaman Buat Model, Anda harus menjadi Admin Looker atau memiliki izin develop.

Dari bagian Develop

Untuk mengakses halaman Create a Model dari bagian Develop, selesaikan langkah-langkah berikut.

  1. Klik Develop di panel navigasi kiri.

  2. Pilih Project dari bagian Develop di panel navigasi.

  3. Pilihan ini akan membuka halaman Project LookML. Halaman Project LookML memungkinkan Anda melihat semua project yang dapat Anda akses, beserta modelnya masing-masing. Dari halaman LookML Projects, pilih tombol New Model untuk membuka halaman Create a Model.

Dari tombol Create

Untuk mengakses halaman Buat Model dari tombol Buat, selesaikan langkah-langkah berikut.

  1. Dari menu navigasi utama, klik tombol Buat.
  2. Pilih Model LookML dari menu drop-down. Tindakan ini akan membuka halaman Create a Model.

Membuat model

Halaman Create a Model dibagi menjadi beberapa bagian. Untuk membuat model, selesaikan langkah-langkah di bagian berikut ini. Setelah setiap bagian, klik Berikutnya untuk menyimpan input Anda dan melanjutkan ke bagian berikutnya.

  1. Pilih Koneksi Database:

    • Pilih koneksi database: Pilih koneksi database dari menu drop-down. Anda juga dapat memilih opsi Create New Connection dari menu drop-down. Tindakan ini akan mengarahkan Anda ke halaman Menghubungkan database ke Looker tempat Anda dapat membuat koneksi baru.

    • Jika Anda memiliki akses ke project yang sudah menggunakan koneksi, project tersebut akan muncul setelah koneksi dipilih. Anda dapat memilih untuk menambahkan model baru ke project yang sudah ada, atau Anda dapat memilih untuk membuat project LookML baru untuk model Anda.

    • Nama Project LookML: Jika Anda ingin membuat project LookML baru untuk model, masukkan nama project di kolom ini. Nama project peka huruf besar/kecil dan hanya mengizinkan karakter alfanumerik, _, ., dan -. Pilih nama project dengan cermat dan anggap sebagai ID permanen untuk project tersebut. Project baru dikonfigurasi menggunakan repositori Git sederhana.

    • Centang kotak Buat file Readme yang memberikan informasi selengkapnya tentang penggunaan LookML jika Anda ingin Looker menambahkan file README ke project baru. File README berisi pengantar LookML beserta link dan referensi untuk membantu developer LookML baru.

    • Klik tombol Berikutnya untuk menyimpan entri dan melanjutkan ke bagian berikutnya.

  2. Select Tables:

    • Jika Anda menggunakan koneksi BigQuery, pilih project Google Cloud tempat set data berada dari menu drop-down Select GCP project, atau telusuri project di kolom Search Project Name. Secara default, project penyimpanan Google Cloud ditampilkan di menu drop-down, jika ada; jika tidak ada, project penagihan Google Cloud akan ditampilkan.
    • Dalam tabel, pilih set data (BigQuery) atau skema (dialek lain) yang akan digunakan dalam model.
    • Setelah set data atau skema dipilih, gunakan panah di sebelah kanan setiap nama set data atau skema untuk membuka tab Tables dan pilih setiap tabel yang ingin Anda sertakan. Tampilan akan dibuat dari tabel.
    • Setelah tabel dipilih, gunakan panah di sebelah kanan setiap nama tabel untuk membuka tab Kolom dan pilih setiap kolom yang ingin Anda sertakan.
    • Abaikan Awalan: Jika Anda ingin mengabaikan awalan tabel dalam nama file tampilan yang dihasilkan, masukkan awalan database dalam daftar yang dipisahkan koma di kolom ini. Kolom ini peka huruf besar/kecil. Anda dapat mencantumkan beberapa awalan, yang dipisahkan koma. Misalnya, tabel Anda berjudul dwh_orders dan DBS_users. Jika Anda memasukkan dwh, DBS di kolom Abaikan Awalan, Looker akan membuat file tampilan bernama orders dan users.
    • Impor deskripsi kolom: Centang kotak ini untuk menggunakan deskripsi kolom yang tersedia di database sebagai deskripsi LookML untuk dimensi yang dihasilkan.
    • Klik tombol Berikutnya untuk menyimpan entri dan melanjutkan ke bagian berikutnya.

  3. Pilih Kunci Utama:

    • Pilih kunci utama untuk setiap tabel yang Anda pilih. Tindakan ini membantu Looker menggabungkan tabel Anda dengan lebih baik.
    • Langkah ini bersifat opsional; untuk melewatinya, jangan pilih kunci utama apa pun.
    • Klik tombol Berikutnya untuk menyimpan entri dan melanjutkan ke bagian berikutnya.

  4. Pilih Jelajah untuk Dibuat:

    • Pilih setiap tampilan yang ingin Anda gunakan sebagai tampilan dasar untuk Jelajahi. Untuk setiap tampilan yang dipilih, sistem akan otomatis bergabung dengan sebanyak mungkin tampilan lainnya. Hanya tampilan yang memiliki kunci utama yang diidentifikasi pada langkah sebelumnya yang dapat digunakan dalam join.
    • Langkah ini bersifat opsional; untuk melewatinya, jangan pilih tampilan apa pun.
    • Klik tombol Berikutnya untuk menyimpan entri dan melanjutkan ke bagian berikutnya.

  5. Masukkan Nama Model:

  6. Klik salah satu tombol berikut untuk membuat file model dan, jika dipilih, project baru:

    • Complete and View Model: Looker akan mengarahkan Anda ke file di Looker IDE.
    • Lengkapi dan Jelajahi Data: Looker akan mengarahkan Anda ke Jelajah yang sesuai dengan file tampilan pertama yang dipilih di bagian Pilih Jelajah yang Akan Dibuat.

  7. Jika Anda membuat project baru dan ingin menghubungkannya ke repositori yang berbeda dengan repositori Git biasa yang digunakan Looker untuk pembuatan project, klik tombol Reset Git Connection di tab Configuration pada halaman Project Settings project untuk menyelesaikan proses tersebut.

Saat Anda perlu mengonfigurasi model

Mengonfigurasi model berguna karena alasan berikut:

  • Ini menentukan bahwa nama model tertentu merujuk ke model tertentu dalam project tertentu.
  • Ini menetapkan koneksi yang diizinkan untuk digunakan model.

Konfigurasi model tidak diperlukan untuk admin (atau developer dengan izin manage_models atau manage_project_models) saat mereka berada dalam Mode Pengembangan. Hal ini memungkinkan developer LookML bekerja saat dalam Mode Pengembangan. Namun, jika konfigurasi model sudah ada, kueri apa pun akan dibatasi oleh konfigurasi tersebut bahkan dalam Mode Pengembangan.

Meskipun developer LookML menentukan koneksi yang diinginkan dalam file model, admin mengontrol koneksi yang diizinkan di halaman Project LookML. Jika model menentukan penggunaan koneksi yang tidak diizinkan dalam konfigurasi model, koneksi tersebut tidak diizinkan.

Model harus memiliki konfigurasi dalam skenario berikut:

  • Saat model di-push ke production untuk pertama kalinya. Jika model tidak dikonfigurasi, kueri apa pun pada model tersebut akan gagal setelah model berada dalam Mode Produksi. Saat model di-push dari Mode Pengembangan ke produksi untuk pertama kalinya, Looker akan mengonfigurasi model secara otomatis jika nama model unik untuk instance Looker. Namun, jika Anda memiliki model yang dikonfigurasi dengan nama yang sama di project lain, Looker tidak akan otomatis mengonfigurasi model tersebut.
  • Selama pengembangan. Jika Anda memiliki developer yang tidak diberi izin manage_models (yang disertakan dalam peran admin) atau izin manage_project_models, model harus dikonfigurasi sebelum developer tersebut dapat menjalankan kueri pada model tersebut. Anda dapat mengonfigurasi model sebelum model atau project ada. Kemudian, saat developer LookML membuat model, koneksi yang diizinkan model sudah dikonfigurasi, dan developer dapat berhasil menjalankan kueri.

Looker memungkinkan developer yang memiliki izin manage_models atau manage_project_models menjalankan kueri pada model yang tidak dikonfigurasi dalam Mode Pengembangan. Looker melakukannya dengan menelusuri model dengan nama tersebut di project. Model pertama yang ditemukan dengan nama tersebut akan digunakan untuk menjalankan kueri.

Mengonfigurasi model terencana

Tombol Configure New Model di bagian atas halaman LookML Projects dapat digunakan oleh admin Looker untuk menambahkan konfigurasi untuk model yang ada atau untuk model yang direncanakan yang belum ada.

Mengonfigurasi model terlebih dahulu berguna jika developer belum diberi izin manage_models atau izin manage_project_models. Jika admin mengonfigurasi model untuk developer, mereka akan dapat menjalankan kueri segera setelah membuat atau membuat file model.

Admin juga dapat menentukan koneksi database mana yang dapat digunakan oleh model, atau dapat menentukan bahwa model diizinkan untuk menggunakan koneksi saat ini atau mendatang. Developer Looker menggunakan parameter connection LookML untuk menentukan koneksi yang harus digunakan model dalam file model. Jika developer menentukan koneksi yang belum diizinkan admin dalam konfigurasi model, kueri apa pun pada model tersebut tidak akan berjalan.

Saat admin mengonfigurasi model baru terlebih dahulu dan membuat project baru sebagai bagian dari konfigurasi tersebut, project tersebut akan ditampilkan di bagian Project Tertunda di halaman Project.

Membuat project kosong

Membuat project kosong dapat berguna saat Anda ingin membuat file LookML dari awal.

Halaman Buat Model membuat project dengan menyertakan file LookML. Namun, Anda dapat meminimalkan file LookML yang dihasilkan dengan hanya melengkapi bagian berikut di halaman Buat Model:

  • Pilih Koneksi Database
  • Pilih Tabel
  • Masukkan Nama Model

Biarkan bagian yang tersisa tidak selesai.

Klik tombol Complete and View Model, yang akan mengarahkan Anda ke project di IDE Looker. Setelah berada di IDE, Anda dapat menghapus file LookML yang tidak diinginkan, untuk membuat project kosong.

Langkah berikutnya

Setelah model atau project dibuat, Anda dapat melakukan tindakan berikut: