Halaman ini menyediakan langkah-langkah untuk membuat project baru dan otomatis membuat model dasar dari database Anda.
Ada opsi lain untuk membuat file project: Anda dapat membuat project kosong dan membuat modelnya secara manual, atau untuk meng-clone repositori Git publik yang ada, lihat halaman dokumentasi Membuat project LookML baru.
Membuat model dari database Anda secara otomatis
Klik Develop di panel menu dan pastikan Anda berada dalam Development Mode.
Pilih Project dari bagian Develop di panel navigasi.
Dari halaman Project LookML, pilih New LookML Project:
- Halaman Project LookML memungkinkan Anda melihat semua project bersama dengan modelnya masing-masing. Anda dapat menggunakan halaman ini untuk membuat, melihat, dan mengonfigurasi project.
Dalam dialog New Project, tetapkan opsi untuk project Anda:
- Beri nama project Anda.
- Untuk Titik Awal, pilih Generate Model from Database Schema.
- Dari menu drop-down Connection, pilih nama koneksi database Anda.
- Dari Build Views From, pilih salah satu opsi:
- Semua Tabel: Generator LookML membuat file tampilan untuk setiap tabel di database Anda.
- Tabel Tunggal: Generator LookML membuat tampilan untuk satu tabel di database Anda. Jika Anda memilih opsi ini, masukkan nama tabel {i>database<i}.
- Jika ingin membuat file hanya untuk satu skema dalam database Anda, masukkan nama skema di kolom teks Schemas. Anda dapat mencantumkan beberapa skema yang dipisahkan dengan koma.
- Untuk tidak menyertakan awalan tabel dari nama file tampilan, masukkan awalan database di kolom teks Abaikan Awalan. Kolom ini peka huruf besar/kecil. Anda dapat mencantumkan beberapa awalan yang dipisahkan dengan koma. Misalnya, tabel Anda diberi judul
dwh_orders
danDBS_users
. Jika Anda memasukkandwh, DBS
di kolom teks Abaikan Awalan, Looker akan membuat file tampilan bernamaorders
danusers
.
Klik Buat Project.
- Generator LookML membuat satu file model untuk project, dan file tampilan untuk setiap tabel dalam database (kecuali jika ditentukan lain). Kemudian, Looker akan membuka project baru di IDE Looker.
- Generator LookML membuat folder IDE untuk file tampilan dan model Anda. Jika database Anda memiliki lebih dari satu skema, generator LookML akan membuat folder untuk skema.
Untuk koneksi BigQuery, jika Anda membuat project LookML dari database, Looker akan mengisi deskripsi kolom secara otomatis dengan deskripsi dari metadata kolom BigQuery Anda, jika ada.
Generator juga membuat Explore untuk setiap tabel database. Untuk mulai membuat kueri data, gunakan panel Jelajah untuk memilih nama Jelajah.
Untuk mengganti nama project setelah membuatnya, lihat bagian Mengganti nama project di halaman dokumentasi Mengakses dan mengedit informasi project.
Anda dapat membuat model baru tambahan secara manual untuk project seperti yang dijelaskan di halaman dokumentasi Memahami model dan melihat file, mengonfigurasinya untuk digunakan dalam produksi seperti yang dibahas di bagian Saat Anda perlu mengonfigurasi model di halaman ini, dan menemukan petunjuk lebih lanjut di halaman dokumentasi Membuat project LookML baru.
Setelah file model dibuat atau dibuat secara manual, lihat halaman dokumentasi Menyiapkan dan menguji koneksi Git untuk mengetahui informasi tentang cara menghubungkan project Looker Anda ke Git. Anda dapat merekam perubahan pada file LookML dan mengelola versi file Anda.
Pembuatan LookML yang lebih baik
Jika admin Looker Anda telah mengaktifkan fitur Lab Peningkatan LookML Generation, Looker akan menambahkan elemen tambahan ke project saat Anda membuat project dari database:
- Looker akan menambahkan file README ke project baru. File README berisi pengantar LookML beserta link dan sumber daya untuk membantu developer LookML baru.
- Looker menambahkan beberapa penjelasan komentar inline ke file model dan setiap file tampilan.
- Jika tampilan memiliki setidaknya satu dimensi
type: number
yang tidak berisi stringid
dalam namanya, Looker akan membuat ukurantype: sum
dan ukurantype: average
, yang keduanya didasarkan pada dimensi pertama menurut abjad daritype: number
yang tidak berisi stringid
dalam namanya.
Saat Anda perlu mengonfigurasi model
Mengonfigurasi model berguna untuk alasan berikut:
- Ini menetapkan bahwa nama model yang diberikan mengacu pada model tertentu dalam project tertentu.
- Model ini menetapkan koneksi yang boleh digunakan model.
Konfigurasi model tidak diperlukan untuk admin (atau developer dengan izin manage_models
atau manage_project_models
) saat admin berada dalam Mode Pengembangan. Ini memungkinkan developer LookML bekerja dengan mudah saat berada dalam Mode Pengembangan. Akan tetapi, jika konfigurasi model memang ada, kueri akan dibatasi oleh konfigurasi itu bahkan dalam Mode Pengembangan.
Meskipun developer LookML menentukan koneksi yang diinginkan dalam file model, admin akan mengontrol koneksi yang diizinkan di halaman Project LookML. Jika model menetapkan menggunakan koneksi yang tidak diperbolehkan dalam konfigurasi model, maka koneksi itu tidak diperbolehkan.
Model harus memiliki konfigurasi dalam skenario berikut:
- Saat model didorong ke produksi untuk pertama kalinya. Jika model tidak dikonfigurasi, semua kueri 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 mengonfigurasi model tersebut secara otomatis.
- Selama pengembangan. Jika Anda memiliki developer yang tidak diberi izin
manage_models
(yang disertakan dalam peranadmin
) atau izinmanage_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 project dan model, koneksi yang diizinkan model sudah dikonfigurasi, dan developer dapat menjalankan kueri dengan sukses.
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 model dengan nama tersebut. Model pertama yang ditemukan dengan nama tersebut akan digunakan untuk menjalankan kueri.