Membuat project LookML baru

Project adalah kumpulan file LookML yang menjelaskan hubungan antar-tabel database Anda dan cara Looker harus menafsirkan tabel tersebut. Anda dapat mempelajari lebih lanjut project di halaman dokumentasi Project LookML dan model pengembangan serta Istilah dan konsep LookML. Untuk mengetahui informasi tentang cara mengakses dan mengedit project yang ada, lihat halaman dokumentasi Mengakses dan mengedit informasi project.

Project LookML dapat berisi lebih dari satu file model. Namun, jika Anda ingin menentukan izin bagi pengguna untuk melihat dan mengedit LookML untuk file model tertentu, Anda mungkin ingin membuat project baru. Meskipun sebagian besar izin di Looker berlaku di level model, ada beberapa izin yang berlaku di level project, termasuk see_lookml, yang memungkinkan Anda melihat LookML untuk project, dan develop, yang memungkinkan Anda mengedit LookML.

Pengguna Looker dengan izin manage_models dapat membuat model LookML di instance Looker.

Membuat project

Perhatian: Halaman Project Baru di Looker yang dijelaskan dalam dokumentasi ini telah diganti dengan halaman Buat Model. Namun, Anda tetap dapat mengakses halaman Project Baru jika Anda menggunakan instance Looker (asli) dan admin Looker Anda telah mengaktifkan fitur lama Gunakan Halaman Pembuatan Project Lama, atau melalui banner informasi di bagian atas halaman Buat Model, atau dari tombol Tambahkan LookML di bagian Project Tertunda di halaman Project.

Untuk membuat project, lakukan langkah-langkah berikut:

1. Verifikasi bahwa Anda berada dalam Mode Pengembangan.

2. Pilih Project dari bagian Develop di panel navigasi.

   

3. Di halaman LookML Projects, pilih New LookML Project untuk memilih opsi project Anda.

   

Tindakan ini akan membuka halaman New Project, tempat Anda dapat menentukan setelan untuk project, termasuk nama dan titik awal project.

Looker dapat membuat project dengan beberapa cara, dan langkah-langkah yang dilakukan bergantung pada opsi Titik Awal yang Anda pilih di halaman Project Baru. Bagian berikut menjelaskan cara kerja titik awal ini:

• Membuat model secara otomatis dari database Anda
• Meng-clone repositori Git publik
• Membuat project kosong

Membuat model secara otomatis dari database Anda

Dari halaman Project Baru, tentukan opsi berikut untuk membuat model secara otomatis dari database.

1. Nama Project: Beri nama project Anda. Nama project peka huruf besar/kecil dan hanya mengizinkan karakter alfanumerik, _, ., dan -. Pilih nama project dengan cermat dan anggap sebagai ID permanen untuk project, karena Looker menggunakan nama project dengan cara berikut:

   • Untuk mengidentifikasi project untuk panggilan API yang memiliki parameter project_id.
   • Untuk mengidentifikasi project dalam database internal instance Looker.
   • Untuk mengidentifikasi project untuk impor project lokal.
   • Untuk menampilkan project di halaman LookML Projects.
   • Untuk menampilkan project di bagian Develop pada panel navigasi Looker.
   • Sebagai bagian dari URL untuk file project. Misalnya, pada instance Looker dengan URL example.looker.com, file manifes project untuk project bernama ecommerce dapat ditemukan di URL ini: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

2. Starting Point: Pilih Generate Model from Database Schema.

3. Koneksi: Dari menu drop-down, pilih nama koneksi database Anda.

4. Build Views From: Pilih salah satu opsi berikut:

   • 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 database.

5. Skema: Untuk membuat file hanya untuk satu skema di database Anda, masukkan nama skema di kolom teks Skema. Anda dapat mencantumkan beberapa skema, yang dipisahkan dengan koma.

   Catatan: Untuk koneksi ke database Databricks dengan Unity Catalog yang diaktifkan, Looker hanya dapat membuat model untuk katalog Databricks yang ditentukan dalam koneksi Looker ke database Databricks. Jika koneksi Anda tidak menentukan katalog, Looker hanya dapat membuat model untuk katalog default database Anda.

6. Abaikan Awalan: Untuk tidak menyertakan awalan tabel dalam nama file tampilan, masukkan awalan database Anda di kolom Abaikan Awalan. Kolom ini peka huruf besar/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 teks Ignore Prefixes, Looker akan membuat file tampilan bernama orders dan users.

Terakhir, klik Create Project untuk membuat project yang berisi model yang dihasilkan.

• Generator LookML membuat satu file model untuk project serta file tampilan untuk setiap tabel dalam database (kecuali jika ditentukan lain). Kemudian, Looker akan membuka project baru di Looker IDE.
• 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 otomatis mengisi deskripsi kolom dengan deskripsi dari metadata kolom BigQuery Anda, jika ada.

Generator juga membuat Jelajah untuk setiap tabel database. Untuk mulai membuat kueri data, gunakan panel Jelajah untuk memilih nama Jelajah.

Meng-clone repositori Git publik dari halaman New Project

Jika Anda memilih Clone Public Git Repository sebagai titik awal dari halaman New Project, Looker akan menyalin file dari repositori Git publik ke project LookML baru.

Looker mendukung cloning repositori Git publik menggunakan URL web HTTPS repositori.

Catatan: Jika repositori Git publik menggunakan "master" sebagai nama cabang utamanya, Looker tidak mendukung penggunaan HTTPS untuk terhubung ke repositori. Daripada meng-clone dengan HTTPS, Anda dapat menggunakan metode alternatif untuk membuat project kosong, lalu terhubung ke repositori publik menggunakan SSH.

Untuk meng-clone repositori Git publik yang ada ke dalam project Looker, ikuti langkah-langkah berikut:

1. Verifikasi bahwa Anda berada dalam Mode Pengembangan.
2. Dari bagian Develop di panel navigasi Looker, pilih Projects.

3. Di halaman LookML Projects, bergantung pada konfigurasi instance Anda, lakukan salah satu hal berikut:

   • Klik tombol New LookML Project untuk membuka halaman New Project.
   • Klik tombol New Model untuk membuka halaman Create a Model, lalu di banner informasi di halaman Create a Model, klik link click here untuk membuka halaman New Project.

4. Di kolom Project Name, beri nama project Anda. Nama project peka huruf besar/kecil dan tidak boleh menggunakan spasi atau karakter khusus tertentu. Pilih nama project dengan cermat dan anggap sebagai ID permanen untuk project, karena Looker menggunakan nama project dengan cara berikut:

   • Untuk mengidentifikasi project untuk panggilan API yang memiliki parameter project_id.
   • Untuk mengidentifikasi project dalam database internal instance Looker.
   • Untuk mengidentifikasi project untuk impor project lokal.
   • Untuk menampilkan project di halaman LookML Projects.
   • Untuk menampilkan project di bagian Develop pada panel navigasi Looker.
   • Sebagai bagian dari URL untuk file project. Misalnya, pada instance Looker dengan URL example.looker.com, file manifes project untuk project bernama ecommerce dapat ditemukan di URL ini: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

5. Untuk kolom Starting Point, pilih Clone Public Git Repository.

6. Di kolom Git Repository URL, masukkan URL untuk repositori Git publik. Pastikan URL dalam format https://github.com/example/my-repository.git.

7. Klik Create Project. Looker akan meng-clone repositori dan membuka IDE Looker ke project LookML baru dengan file project dari repositori yang di-clone.

Setelah Looker membuat project LookML baru, Anda harus menyiapkan kontrol versi Git dengan menghubungkan ke repositori Git. Lihat halaman dokumentasi Menyiapkan dan menguji koneksi Git untuk mengetahui prosedur menghubungkan ke Git menggunakan HTTPS atau SSH.

Bergantung pada situasi Anda, Anda dapat menyiapkan koneksi Git untuk mengirim perubahan ke repositori Git Anda sendiri, atau Anda dapat mengirim perubahan kembali ke repositori Git asli yang di-clone:

• Jika Anda ingin menggunakan file yang di-clone sebagai titik awal untuk project Anda sendiri yang terpisah dari repositori Git publik, siapkan koneksi Git project Anda agar mengarah ke repositori Git Anda sendiri dan kirim perubahan Anda ke sana.
• Jika Anda ingin memberikan kontribusi pembaruan kembali ke repositori Git publik yang Anda buat klonnya, dan Anda memiliki token akses pribadi dengan akses baca-tulis ke repositori publik, siapkan koneksi Git project Anda agar mengarah ke repositori Git publik dan kirim perubahan Anda ke sana.

Setelah menyiapkan koneksi Git ke repositori, Anda dapat mengedit file di Looker IDE, lalu menggunakan kontrol versi dan men-deploy perubahan ke produksi seperti pada project LookML standar.

Metode alternatif untuk meng-clone repositori Git publik

Cara termudah untuk meng-clone repositori Git publik adalah dengan menggunakan halaman Project Baru di Looker.

Atau, Anda dapat membuat fork repositori dan menghubungkannya ke project kosong di Looker dengan melakukan langkah-langkah berikut:

1. Buka penyedia Git Anda dan fork repositori.
2. Di Looker, buat project kosong seperti yang dijelaskan di bagian Membuat project kosong di halaman ini.
3. Setelah membuat project LookML kosong yang baru, siapkan koneksi Git project ke fork repositori Git Anda menggunakan HTTPS atau SSH.

Setelah menyiapkan koneksi Git ke fork repositori, Anda dapat mengedit file di Looker IDE, lalu menggunakan kontrol versi dan men-deploy perubahan ke produksi seperti pada project LookML standar.

Membuat project kosong

Jika Anda memilih Blank Project sebagai titik awal dari halaman New Project, Looker akan membuat project kosong sehingga Anda dapat membuat file LookML dari awal.

Untuk membuat project kosong, ikuti langkah-langkah berikut:

1. Verifikasi bahwa Anda berada dalam Mode Pengembangan.
2. Dari bagian Develop di panel navigasi Looker, pilih Projects.

3. Di halaman LookML Projects, bergantung pada konfigurasi instance Anda, lakukan salah satu hal berikut:

   • Klik tombol New LookML Project untuk membuka halaman New Project.
   • Klik tombol New Model untuk membuka halaman Create a Model, lalu di banner informasi di halaman Create a Model, klik link click here untuk membuka halaman New Project.

4. Di kolom Project Name, beri nama project Anda. Nama project peka huruf besar/kecil dan tidak boleh menggunakan spasi atau karakter khusus tertentu. Pilih nama project dengan cermat dan anggap sebagai ID permanen untuk project, karena Looker menggunakan nama project dengan cara berikut:

   • Untuk mengidentifikasi project untuk panggilan API yang memiliki parameter project_id.
   • Untuk mengidentifikasi project dalam database internal instance Looker.
   • Untuk mengidentifikasi project untuk impor project lokal.
   • Untuk menampilkan project di halaman LookML Projects.
   • Untuk menampilkan project di bagian Develop pada panel navigasi Looker.
   • Sebagai bagian dari URL untuk file project. Misalnya, pada instance Looker dengan URL example.looker.com, file manifes project untuk project bernama ecommerce dapat ditemukan di URL ini: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

5. Untuk kolom Starting Point, pilih Blank Project.

6. Klik Create Project. Looker akan membuat project dan membukanya di Looker IDE.

Langkah berikutnya

Setelah project dibuat, Anda dapat melakukan hal berikut:

• Buat secara manual model baru tambahan untuk project Anda.
• Mengedit file LookML yang ada.
• Konfigurasi model untuk digunakan dalam produksi.
• Ganti nama project.
• Hubungkan project Looker ke Git.