Bekerja dengan browser file IDE

Cara termudah untuk mengakses Looker IDE adalah melalui menu Develop Looker. Lihat Mengakses file project untuk mengetahui detail dan opsi lainnya.

Looker IDE mendukung folder untuk file project Anda. Folder ditampilkan di panel navigasi sebelah kiri IDE. Jika developer Looker Anda belum mengatur file project ke dalam folder, project Anda akan memiliki struktur file datar, dengan file yang dicantumkan menurut abjad di panel Browser File.

Berikut adalah contoh project dengan developer yang telah menambahkan folder untuk berbagai jenis file project, seperti Jelajah, model, dan tampilan:

Anda dapat memilih ikon pada toolbar di bagian atas panel File Browser untuk menciutkan semua folder, memindahkan dan menghapus file dan folder, menelusuri file project, atau membuat folder baru dan file baru.

Menciutkan sidebar IDE

Anda dapat menampilkan atau menyembunyikan browser file IDE dengan menggunakan pintasan keyboard Command-B (Mac) atau Ctrl+B (Windows) atau dengan memilih ikon file browser:

Mengelola file dan folder

Setiap file atau folder di panel samping kiri memiliki menu yang menampilkan tindakan yang tersedia untuk item tersebut. Pilih menu tiga titik Tindakan Folder (untuk folder) atau menu Tindakan File (untuk file) di sebelah kanan nama file untuk membuka menu. Untuk item yang memiliki nama panjang atau yang disarangkan dalam beberapa folder, Anda dapat mengakses menu dengan men-scroll di panel kiri.

Anda dapat membuat folder dan file, mengupload file, serta menghapus dan memindahkan file dan folder menggunakan file browser. Untuk informasi selengkapnya, lihat halaman dokumentasi Mengelola file dan folder LookML.

Saat mengatur file LookML dengan folder, Anda harus melakukan commit terhadap perubahan dan men-deploy-nya ke produksi sebelum developer Looker lain dapat melihatnya. Hal ini sama seperti perubahan apa pun yang Anda lakukan pada project LookML Anda.

Folder project yang diimpor

Jika Anda mengimpor project, Looker IDE akan membuat folder imported_projects secara otomatis. File dari project lokal dan project jarak jauh tercantum dalam folder imported_projects. Pilih file project yang diimpor dari daftar file di imported_projects untuk melihat konten file tersebut.

Karena tidak dapat diedit, file project yang diimpor tidak akan terlihat saat Anda mengedit file secara massal di IDE untuk memindahkan atau menghapus file tersebut.

Mengatur project yang ada dengan folder IDE

Jika project Anda sebelumnya memiliki struktur file datar lama, atau jika ingin menata ulang file dalam folder, Anda dapat memilih untuk mempertahankan struktur ini; tetapi jika Anda memilih untuk mengatur file project ke dalam folder, kami sangat menyarankan agar Anda melakukan persiapan berikut:

• Rencanakan struktur file terlebih dahulu dengan semua developer.
• Pastikan semua developer Looker Anda telah men-deploy semua update mereka ke produksi. Jika developer memiliki perubahan yang belum di-deploy, cabang mereka akan mencerminkan struktur file yang ada saat terakhir kali diambil dari produksi. Jika proyek memiliki struktur file datar pada saat itu, versi file developer akan didorong ke produksi di lokasi aslinya, sehingga Anda akan mendapatkan dua salinan file. Selain itu, jika developer telah membatalkan deployment perubahan selama proses migrasi ke folder, developer tersebut akan mengalami konflik penggabungan saat mereka menarik dari produksi setelah migrasi.
• Terapkan pembekuan kode sementara pada semua developer Anda hingga project sepenuhnya dimigrasikan ke struktur direktori baru.
• Tetapkan satu developer untuk memindahkan file. Prosedur di bawah ini mengasumsikan satu developer akan memigrasikan project ke folder IDE. Jika Anda perlu meminta beberapa developer untuk memindahkan file, bagi tugas di antara developer untuk menghindari konflik penggabungan. Jika Anda menemukan konflik penggabungan, lihat halaman dokumentasi Menggunakan kontrol versi dan men-deploy untuk mendapatkan informasi tentang cara menyelesaikannya.

Catatan: Perlu diketahui bahwa saat memindahkan file di Git, Anda secara efektif menghapus file tersebut dan membuat file baru dengan jalur file baru. Hal ini berarti histori Git untuk file tersebut akan kosong, karena Git akan menganggapnya sebagai file baru. Untuk melihat histori Git file sebelum dipindahkan, gunakan antarmuka Git Anda untuk membuka file di lokasi aslinya dan lihat histori Git dari sana.

Setelah semua developer mendorong dan melakukan perubahan serta menjeda semua pekerjaan pada project, Anda dapat memigrasikan project ke struktur direktori yang baru.

Tetapkan satu developer untuk melakukan semua langkah berikut:

1. Pastikan semua update di semua cabang pengembangan telah di-deploy ke produksi. Hal ini mencakup cabang pengembangan developer yang melakukan migrasi ke folder IDE.
2. Memastikan semua developer lain telah berhenti membuat perubahan pada project.
3. Ambil dari produksi.
4. Buat folder project.
5. Pindahkan file project ke dalam folder, satu file dalam satu waktu atau menggunakan pengeditan massal.
6. Memvalidasi LookML project. Anda mungkin akan melihat beberapa error dan peringatan LookML, karena pernyataan include dan map_layer menggunakan referensi ke lokasi file yang kemungkinan akan dipindahkan selama prosedur ini.

7. Perbarui pernyataan include dan map_layer apa pun di project Anda agar sesuai dengan jalur baru file. Selain itu, Anda mungkin melihat error validasi LookML untuk objek yang direferensikan yang tidak dapat ditemukan lagi karena jalur filenya telah berubah. Untuk informasi selengkapnya, lihat dokumentasi tentang menggunakan include dengan folder IDE dan tentang menggunakan map_layer dengan folder IDE.

   Tips: Anda dapat menggunakan karakter pengganti guna membuat perbaikan sementara untuk error dan peringatan validasi LookML yang dihasilkan dari pernyataan include. Dengan menggunakan file tampilan sebagai contoh, Anda dapat menentukan include: "/**/*.view" untuk menyertakan semua file di semua folder project Anda. Ini akan mencegah masalah validasi LookML saat Anda terus mengembangkan. Namun, ini bukan solusi yang direkomendasikan untuk jangka panjang, karena menyertakan lebih banyak file daripada yang dibutuhkan dapat memengaruhi performa.

8. Commit perubahan.

9. Deploy update ke produksi.

10. Beri tahu developer Looker lainnya bahwa mereka sekarang dapat mengambil update dari produksi dan melanjutkan pengembangan dalam project.