Mengakses dan mengedit informasi project

Halaman Project LookML menyediakan daftar semua project LookML di instance Looker dan menampilkan semua model di setiap project.

Untuk mengakses halaman project LookML, lakukan langkah-langkah berikut:

1. Buka panel Develop dengan memilih opsi Develop di panel navigasi.
2. Di panel Develop, pilih Projects.

Membuat project

Halaman dokumentasi ini mengasumsikan bahwa Anda telah membuat project menggunakan salah satu metode berikut:

• sebagai bagian dari pembuatan model melalui halaman Create a Model di Looker
• sebagai project kosong melalui halaman Create a Model di Looker
• menggunakan proses lama untuk membuat project

Melihat project yang ada dan modelnya

Untuk melihat daftar project yang ada, buka halaman Project LookML.

Dalam Mode Produksi, halaman Project LookML mencantumkan project yang telah dibuat dan di-push ke produksi. Dalam Mode Pengembangan, halaman ini mencantumkan project yang telah Anda ambil dari produksi atau yang telah Anda buat sendiri dalam Mode Pengembangan. Halaman Project LookML mencakup kategori dasar berikut:

• Bagian atas: Project yang tercantum di bagian atas telah dibuat dan dapat menyertakan file model dan tampilan yang dihasilkan. Jika Anda adalah admin Looker, atau jika Anda memiliki izin develop untuk setidaknya satu model dalam project, Anda dapat melihat project di panel Develop dan di bagian atas halaman.
• Bagian Project Tertunda: Project yang tercantum di bagian Project Tertunda adalah project tempat admin Looker telah mengonfigurasi koneksi yang diizinkan untuk model, tetapi developer Looker belum menambahkan LookML. Jika memiliki izin develop, Anda dapat melihat project ini.
• Bagian Project Marketplace: Project yang tercantum di bagian Project Marketplace dibuat saat aplikasi, blok, atau plugin diinstal menggunakan Looker Marketplace.

Catatan: Untuk melihat project, Anda harus memiliki izin manage_models, atau izin develop untuk minimal satu model dalam project. Jika memiliki izin manage_models, atau memiliki izin manage_project_models untuk setidaknya satu model dalam project, Anda dapat menambahkan atau mengedit konfigurasi untuk model apa pun yang terkait dengan project yang tercantum.

Untuk informasi tentang cara menentukan project baru atau model baru untuk project yang ada, lihat halaman dokumentasi Membuat Model.

Melihat listingan untuk project

Halaman LookML Projects menampilkan elemen berikut untuk setiap project:

• Kolom Project: Nama project. Setiap project mungkin memiliki satu atau beberapa model yang tercantum di sampingnya. Pilih nama project untuk membuka LookML untuk project tersebut.
• Kolom Model: Kumpulan file model LookML untuk project tertentu. Jika lingkungan Mode Pengembangan Anda berbeda dengan produksi, daftar ini dapat berubah antara Mode Pengembangan dan Mode Produksi. Misalnya, Anda mungkin telah membuat model baru dalam Mode Pengembangan yang belum di-push ke produksi.
• Kolom Masalah konfigurasi: Jika ada masalah pada model, model akan menampilkan status yang menunjukkan masalah pada konfigurasi.
• Tombol Konfigurasikan: Jika tombol Konfigurasikan tersedia untuk project, Anda dapat menambahkan atau mengedit konfigurasi model untuk project tersebut.

Jika ada masalah dengan model, model akan menampilkan status yang menunjukkan masalah pada konfigurasi.

Masalah	Penjelasan
File model LookML belum ada	Anda akan melihat masalah ini jika seseorang mengonfigurasi model di halaman ini, tetapi belum membuat file LookML yang sesuai untuk model tersebut.
Konfigurasi diperlukan untuk penggunaan	Anda melihat masalah ini jika seseorang membuat file model LookML baru di project yang ada, tetapi belum mengonfigurasinya di halaman ini.
Koneksi 'x' tidak ada	connection yang dideklarasikan dalam file model tidak ada (misalnya jika seseorang salah mengejanya atau belum membuatnya).
Model 'x' tidak diizinkan untuk menggunakan koneksi 'y'	connection yang dideklarasikan dalam file model tidak diizinkan sesuai dengan konfigurasi di halaman ini.
Model bernama 'x' sudah dikonfigurasi di project 'y'	Nama model harus unik dalam instance Looker Anda, meskipun berada dalam project yang berbeda.

Melihat listingan untuk project Marketplace

Bagian Project Marketplace di halaman Project LookML mencantumkan project yang dibuat selama penginstalan aplikasi, blok, atau plugin Marketplace. Listingan untuk setiap project Marketplace menyertakan elemen berikut:

• Listingan: Link ke listingan untuk aplikasi, blok, atau plugin di Looker Marketplace.
• Project: Nama project. Anda dapat mengklik nama project untuk melihat atau mengedit LookML-nya.
• Tombol View LookML atau Edit LookML: Anda dapat membuka project Marketplace dengan memilih tombol View LookML untuk project inti hanya baca blok Marketplace, atau Edit LookML untuk project konfigurasinya, yang dapat disesuaikan. Untuk informasi selengkapnya tentang cara menyesuaikan blok Marketplace, lihat halaman dokumentasi Menyesuaikan Blok Marketplace Looker.
• Model: Kumpulan file model LookML untuk project tertentu.
• Tombol Konfigurasikan: Jika tombol Konfigurasikan tersedia di samping listingan project, Anda dapat menambahkan atau mengedit konfigurasi model project.

Melihat listingan untuk project yang tertunda

Bagian Project Tertunda berisi project dan model yang dikonfigurasi, tetapi belum memiliki LookML yang dibuat atau ditentukan secara manual.

Mengonfigurasi model sebelum project ada berguna jika Anda memiliki developer yang belum diberi izin manage_models atau manage_project_models. Karena model telah dikonfigurasi, developer tersebut dapat menjalankan kueri segera setelah mereka membuat project dan model tersebut. Saat project dibuat, listingan untuk project tersebut akan dipindahkan ke bagian atas halaman Project LookML.

Bagian Project Tertunda mencakup elemen berikut:

• Kolom Project: Bagian ini mencantumkan project yang dikonfigurasi, tetapi belum dibuat. Nama project di kolom ini adalah nama project yang diinginkan. Pilih nama project untuk menampilkan halaman New Project tempat Anda dapat membuat project tersebut. Anda harus berada dalam Mode Pengembangan untuk membuka halaman Project Baru.
• Kolom Models: Nama model yang ditentukan saat membuat konfigurasi model.
• Kolom Allowed connections: Kolom di sebelah kanan nama model menampilkan koneksi yang diizinkan untuk model ini saat konfigurasi model dibuat.
• Tombol Konfigurasi: Tombol Konfigurasi memungkinkan Anda mengubah nama project dan koneksi yang diizinkan untuk model ini.
• Tombol Tambahkan LookML: Tombol Tambahkan LookML akan membuka halaman Project Baru untuk project tersebut, tempat Anda dapat membuat LookML secara otomatis berdasarkan kumpulan tabel di database.

Menambahkan dan mengedit konfigurasi model

Jika tombol Konfigurasikan tersedia di samping listingan project yang ada, Anda dapat menambahkan atau mengedit konfigurasi model project.

Jika model tidak memiliki konfigurasi, saat Anda mengklik Konfigurasikan, Looker akan menampilkan jendela Konfigurasikan Model. Di jendela Configure a Model, Anda dapat menentukan nama model, nama project, dan koneksi yang tersedia untuk model.

Daftar koneksi hanya menyertakan koneksi yang dapat digunakan dengan project model. Koneksi yang dikonfigurasi untuk digunakan di semua project memiliki label (Instance wide).

Anda juga dapat mengklik tombol Configure New Model di bagian atas halaman Projects untuk membuka jendela Configure a Model. Dalam skenario ini, Anda dapat menggunakan jendela Configure a Model untuk membuat dan mengonfigurasi model baru. Model baru tidak akan memiliki LookML, tetapi akan dikaitkan dengan koneksi. Untuk menyelesaikan proses ini, masukkan nama baru untuk model di kolom Model dan lengkapi kolom Project dengan nama baru atau pilih nama yang sama dengan model, pilih koneksi, lalu klik Save. Kemudian, Anda atau developer Looker lain dapat menambahkan LookML ke project baru untuk menentukan model.

Jika model memiliki konfigurasi, saat Anda mengklik Configure, Looker akan menampilkan jendela Edit Model Configuration. Di jendela Edit Konfigurasi Model, Anda dapat mengubah koneksi yang tersedia untuk model.

Saat mengedit konfigurasi untuk model, Anda dapat melihat nama model, tetapi tidak dapat mengganti namanya. Model diberi nama sesuai dengan nama file yang Anda gunakan saat mengedit file model di IDE Looker.

Di kolom Project, Anda dapat menentukan bahwa model harus dikaitkan dengan project yang berbeda. Misalnya, jika Anda membuat project baru yang menyertakan model dengan nama yang sama, Anda dapat mentransisikan konfigurasi model agar dikaitkan dengan model project baru.

Di kolom Allowed Connections, Anda dapat membatasi model untuk menggunakan daftar koneksi tertentu, atau Anda dapat mengizinkan model untuk menggunakan koneksi apa pun (semua koneksi saat ini dan mendatang).

Mengganti nama project

Saat admin Looker membuat project LookML, admin akan memberikan nama project. Nama project harus dianggap sebagai ID permanen untuk project, karena Looker menggunakan nama project dengan cara berikut:

• Untuk mengidentifikasi project untuk panggilan API yang memiliki project_id sebagai parameter.
• Untuk mengidentifikasi project di database internal instance Looker.
• Untuk mengidentifikasi project untuk impor project lokal.
• Untuk menampilkan project di halaman Project LookML.
• 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.

Jika memiliki izin manage_models Looker, Anda dapat mengubah nama project LookML di halaman Project Configuration project. Developer Looker yang bukan admin dapat melihat halaman Project Configuration, tetapi tidak dapat mengubah opsi di halaman tersebut.

Peringatan: Jika mengganti nama project LookML, Anda harus melakukan tindakan berikut:

• Perbarui parameter local_dependency di file manifes LookML dari project LookML apa pun yang menggunakan impor project lokal untuk mengimpor project yang diganti namanya.
• Perbarui aplikasi web dengan panggilan API yang menggunakan parameter project_id untuk merujuk ke project.
• Perbarui parameter project_name di file manifes LookML dari project LookML yang diganti namanya, jika project memiliki file manifes.
• Perbarui bookmark browser atau URL tersimpan, jika Anda atau developer LookML Anda mengandalkan URL untuk mengakses file LookML project yang diganti namanya.

Untuk mengganti nama project, lakukan langkah-langkah berikut:

1. Pastikan Anda telah mengaktifkan Mode Pengembangan.
2. Buka project Anda di IDE Looker.
3. Di project Anda, klik Settings di menu navigasi IDE untuk membuka panel setelan project.
4. Pilih Configuration di panel setelan project.
5. Gunakan kolom Nama di bagian Konfigurasi Project untuk mengedit nama project Anda.
6. Di halaman Project Configuration, klik Save Project Configuration untuk menyimpan nama project baru.

Menghapus project

Jika Anda adalah admin Looker, Anda dapat menghapus project yang ada dengan setelan project project tersebut. Untuk melihat setelan project, buka project Anda, lalu klik Setelan di menu navigasi IDE.

Penting: Memilih tombol Delete Project akan menghapus semua LookML dari project, di semua lingkungan pengembangan dan produksi di seluruh instance Looker Anda. Pastikan Anda ingin menghapus project sebelum memilih tombol ini. Setelah Anda menghapus project, operasi penghapusan tidak dapat dibatalkan, dan sulit serta melelahkan untuk memulihkan project yang dihapus.

Project yang dihapus tidak akan muncul lagi di bagian Project di halaman Project LookML, tetapi masih muncul di bagian Project yang Dikonfigurasi.

Untuk menghapus konfigurasi project, yang akan menghapus project dari lingkungan pengembangan Anda sepenuhnya:

1. Buka project Anda di IDE Looker.
2. Di project Anda, klik Settings di menu navigasi IDE untuk membuka panel setelan project.
3. Di panel setelan project, pilih Konfigurasi untuk melihat konfigurasi project.
4. Di bagian Project Configuration, pilih Delete Project.
5. Di jendela Delete Project, verifikasi peringatan dan perubahan yang tidak disinkronkan yang akan hilang jika project dihapus.
6. Jika Anda yakin bahwa project harus dihapus, ketik nama project di kolom. Untuk membatalkan operasi dan kembali ke project, gunakan tombol Kembali di browser.
7. Klik tombol Permanently Delete <project name>.