Membuat model LookML

Halaman dokumentasi ini menjelaskan langkah-langkah untuk otomatis membuat model LookML dasar dari koneksi database Anda menggunakan halaman Create a Model. Halaman Create a Model juga dapat digunakan untuk membuat project yang akan menampung 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 Create a Model, Anda harus menjadi Admin Looker atau memiliki izindevelop.

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 Projects dari bagian Develop di panel navigasi.

  3. Pilihan ini akan membuka halaman LookML Projects. Halaman LookML Projects 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 Create a Model dari tombol Create, selesaikan langkah-langkah berikut.

  1. Dari menu navigasi utama, klik tombol Create.
  2. Pilih LookML Model 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. Setelah setiap bagian, klik Next untuk menyimpan input Anda dan melanjutkan ke bagian berikutnya.

  1. Select Database Connection:

    • Select database connection: 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 Connect your database to 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 tersebut, 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 nama tersebut sebagai ID permanen untuk project. Project baru dikonfigurasi menggunakan repositori Git kosong.

    • Centang kotak Generate a Readme file that gives more information about using 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 Next untuk menyimpan entri Anda dan melanjutkan ke bagian berikutnya.

  2. Select Tables:

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

  3. Select Primary Keys:

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

  4. Select Explores to Create:

    • Pilih setiap tabel virtual yang ingin Anda gunakan sebagai tabel virtual dasar untuk Eksplorasi. Untuk setiap tabel virtual yang dipilih, sistem akan otomatis menggabungkan sebanyak mungkin tabel virtual lainnya. Hanya tabel virtual yang memiliki kunci utama yang diidentifikasi pada langkah sebelumnya yang dapat digunakan dalam gabungan.
    • Langkah ini bersifat opsional; untuk melewatinya, jangan pilih tabel virtual.
    • Klik tombol Next untuk menyimpan entri Anda dan melanjutkan ke bagian berikutnya.

  5. Enter Model Name:

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

    • Selesaikan dan Lihat Model: Looker akan mengarahkan Anda ke file di Looker IDE.
    • Complete and Explore Data: Looker akan mengarahkan Anda ke Eksplorasi yang sesuai dengan file tabel virtual pertama yang dipilih di bagian Select Explores to Create.

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

Kapan Anda perlu mengonfigurasi model

Mengonfigurasi model berguna karena alasan berikut:

  • Menentukan bahwa nama model tertentu mengacu pada model tertentu dalam project tertentu.
  • Menetapkan koneksi yang diizinkan untuk digunakan oleh 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 berada dalam Mode Pengembangan. Namun, jika konfigurasi model ada, kueri apa pun akan dibatasi oleh konfigurasi tersebut meskipun dalam Mode Pengembangan.

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

Model harus memiliki konfigurasi dalam skenario berikut:

  • Saat model didorong ke produksi untuk pertama kalinya. Jika model tidak dikonfigurasi, kueri apa pun pada model tersebut akan gagal setelah model berada dalam Mode Produksi. Saat model didorong dari Mode Pengembangan ke produksi untuk pertama kalinya, Looker akan mengonfigurasi model secara otomatis jika nama model tersebut 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 ada atau sebelum project ada. Kemudian, saat developer LookML membuat model, koneksi yang diizinkan untuk model tersebut sudah dikonfigurasi, dan developer dapat menjalankan kueri dengan berhasil.

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 project untuk menemukan model dengan nama tersebut. Model pertama yang ditemukan dengan nama tersebut akan digunakan untuk menjalankan kueri.

Mengonfigurasi model yang direncanakan

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 file model.

Admin juga dapat menentukan koneksi database mana yang dapat digunakan oleh model, atau dapat menentukan bahwa model diizinkan menggunakan koneksi saat ini atau mendatang. Developer Looker menggunakan parameter connection LookML untuk menentukan dalam file model koneksi mana yang harus digunakan model. Jika developer menentukan koneksi yang tidak diizinkan oleh 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 Pending Projects pada halaman Projects.

Membuat project kosong

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

Halaman Create a Model membuat project dengan file LookML yang disertakan. Namun, Anda dapat meminimalkan file LookML yang dibuat dengan hanya menyelesaikan bagian berikut di halaman Create a Model:

  • Select Database Connection
  • Select Tables
  • Enter Model Name

Biarkan bagian yang tersisa tidak diisi.

Klik tombol Complete and View Model, yang akan mengarahkan Anda ke project di Looker IDE. 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: