Mengelola file dan folder LookML

File project LookML diatur ke dalam folder di bagian file browser di IDE Looker. Halaman ini memberikan petunjuk untuk membuat dan mengelola folder dan file dalam project LookML.

Untuk informasi tentang struktur dan tujuan setiap jenis file dalam project LookML, lihat halaman dokumentasi Jenis file dalam project LookML.

Sebelum memulai: Konvensi penamaan file dan folder yang penting

Saat membuat file dan folder, sebaiknya perhatikan konvensi penamaan berikut:

• Kepekaan huruf besar/kecil: LookML peka huruf besar/kecil. Pastikan untuk mematuhi konvensi project saat memberi nama folder. Misalnya, jika konvensi Anda adalah menggunakan semua huruf kecil dalam project, Anda sebaiknya memberi nama folder views, bukan Views. Hal ini akan membuat perbedaan terutama saat Anda perlu menentukan jalur file, seperti saat menyertakan file. Secara umum, sebaiknya gunakan huruf kecil secara konsisten saat Anda memberi nama objek dan folder LookML.
• Spasi dan karakter khusus: Nama file tidak boleh menyertakan spasi atau salah satu karakter berikut: / ? * : | " < > %
• Ekstensi file: Saat membuat file LookML dengan Looker IDE, Looker akan otomatis menambahkan ekstensi .lkml ke akhir nama file jika Anda tidak menyertakan ekstensi secara manual. Misalnya, jika Anda memasukkan nama file flights_data_tests, Looker akan memberi nama file flights_data_tests.lkml.
• Mengubah nama yang ditampilkan dari objek LookML: Jika Anda ingin mengubah nama yang ditampilkan dari model atau objek LookML, sebaiknya gunakan parameter label atau parameter alias, bukan mengganti nama file atau objek. Parameter label dan alias mengubah nama yang ditampilkan sambil mempertahankan URL dasar yang digunakan untuk email atau sistem lainnya. Secara umum, Anda harus melakukan tindakan pencegahan agar perubahan model tidak terlalu invasif. Jika Anda perlu mengganti nama model atau objek, gunakan Pemvalidasi Konten untuk memperbarui semua referensi ke model atau objek.

Membuat folder

Anda dapat membuat folder untuk berbagai jenis file (seperti file tampilan atau file model). Anda bahkan dapat membuat subfolder, yang sangat berguna jika Anda ingin include subset tampilan.

Catatan: Saat membuat folder, perlu diingat bahwa LookML peka huruf besar/kecil. Pastikan untuk mematuhi konvensi project saat memberi nama folder. Hal ini penting, terutama saat Anda perlu menentukan jalur file, seperti saat menyertakan file. Secara umum, sebaiknya gunakan huruf kecil secara konsisten saat Anda memberi nama objek dan folder LookML. Lihat catatan penting untuk membuat file dan folder guna mengetahui batasan dan panduan untuk memberi nama file dan folder.

Untuk membuat folder:

1. Pilih opsi Buat Folder dari menu yang sesuai:
   • Untuk membuat folder baru di tingkat teratas struktur direktori, gunakan menu Tambahkan file atau folder, yang dapat Anda akses dengan memilih ikon + (plus) di bagian atas panel File Browser.
   • Untuk membuat subfolder baru di folder yang sudah ada, gunakan menu Folder Options tiga titik untuk folder yang ada.
2. Masukkan nama untuk folder baru.
3. Pilih Create.

Folder baru ditambahkan ke panel navigasi.

Membuat file

Looker akan otomatis membuat file model dan file tampilan berdasarkan database Anda saat Anda membuat model. Untuk project yang ada, Anda dapat membuat file baru secara manual.

Catatan: Sebaiknya gunakan Looker IDE untuk menambahkan file ke project LookML, baik dengan membuatnya di Looker IDE seperti yang dijelaskan nanti di bagian ini atau dengan menguploadnya di Looker IDE. Jika Anda membuat file di luar Looker IDE, lalu menggunakan Looker IDE untuk Pull from (production branch), pastikan untuk menggunakan konvensi penamaan yang benar dan menyertakan ekstensi .lkml dalam nama file (atau explore.lkml untuk file Jelajahi). Jika nama file menyertakan karakter yang tidak didukung, browser file Looker IDE akan menampilkan nama file dalam warna merah, dan Anda tidak akan dapat melihat konten file hingga Anda mengganti nama file dengan karakter yang didukung. Selain itu, IDE Looker tidak akan menampilkan file sama sekali jika file tidak memiliki ekstensi .lkml.

Untuk membuat file baru di project LookML:

1. Pilih menu yang sesuai:

   • Untuk membuat file baru di tingkat teratas struktur direktori, gunakan menu Tambahkan file atau folder, yang dapat Anda akses dengan memilih ikon + (plus) di bagian atas panel File Browser.
   • Untuk membuat file baru di folder yang sudah ada, gunakan menu Folder Options tiga titik untuk folder yang ada.

2. Pilih jenis file LookML yang ingin dibuat. Pilih link dalam daftar berikut untuk deskripsi yang lebih mendetail tentang setiap jenis file. Anda dapat membuat jenis file berikut:

   • File model dengan ekstensi file .model.lkml
   • Melihat file dengan ekstensi file .view.lkml*
   • File manifes project yang selalu diberi nama manifest.lkml**
   • File dasbor dengan ekstensi file .dashboard.lookml
   • File dokumen dengan ekstensi file .md
   • File string lokalitas dengan ekstensi file .strings.json***
   • File LookML generik, yang digunakan untuk jenis file berikut:
     • Menjelajahi file dengan ekstensi file .explore.lkml****
     • File pengujian data dengan ekstensi file .lkml
     • File perincian dengan ekstensi file .lkml
     • File lain yang Anda gunakan untuk menyimpan elemen LookML
   Catatan:

   ^* Lihat bagian Pertimbangan untuk membuat file tampilan di halaman ini untuk mengetahui petunjuk tentang metode alternatif untuk membuat file tampilan, termasuk petunjuk untuk menambahkan file tampilan berdasarkan tabel database.

   ^** File manifes project hanya dapat dibuat dengan memilih ikon + (plus) untuk membuka menu Add file or folder di bagian atas browser file di Looker IDE, dan hanya jika project belum memiliki file manifes. Hal ini karena project hanya dapat memiliki satu file manifes, dan file manifes harus berada di tingkat root struktur direktori project.

   ^*** Opsi Create Locale Strings File hanya tersedia dari ikon Add file or folder + (plus) di bagian atas browser file di Looker IDE, tetapi setelah file string lokalitas dibuat (atau diupload), Anda dapat memindahkan file ke folder. Jika Anda membuat file string lokalitas untuk melokalkan model dan juga ingin memanfaatkan pelokalan UI native Looker, Anda harus memberi nama file string menggunakan kode lokalitas tertentu yang dapat ditemukan di bagian Lokalitas di halaman dokumentasi Pengguna.

   ^**** Saat Anda membuat file Eksplorasi, file tersebut harus memiliki ekstensi .explore.lkml di akhir nama filenya. Jika mengupload file, Anda harus menggunakan ekstensi .explore.lkml lengkap. Jika Anda menggunakan Looker IDE untuk membuat file dengan opsi File LookML Umum, Looker akan menambahkan .lkml ke akhir nama file jika ekstensi tidak ada, tetapi Anda tetap harus menambahkan bagian .explore dari ekstensi ke nama file secara manual. Misalnya, untuk membuat file Jelajah yang disebut flights menggunakan Looker IDE, Anda dapat memasukkan flights.explore atau flights.explore.lkml, dan file tersebut akan diberi nama flights.explore.lkml.

3. Di pop-up Create File, masukkan nama untuk file baru. Lihat catatan penting untuk membuat file dan folder guna mengetahui batasan dan panduan untuk memberi nama file.

4. Pilih Create. File baru akan ditampilkan di tempat Anda membuatnya. Jika perlu, Anda dapat dengan mudah memindahkannya ke folder lain.

Penting: Setelah membuat file, pastikan untuk menggunakan parameter include jika Anda ingin mereferensikan elemen dari file dalam file LookML lain di project Anda. Lihat halaman dokumentasi parameter include untuk mengetahui informasi selengkapnya.

Catatan: Jika admin Looker Anda telah mengaktifkan fitur Labs Pembuatan LookML yang Ditingkatkan, menu Tambahkan file atau folder + (plus) di bagian atas panel File Browser akan menampilkan opsi untuk Buat LookML dari Database selain opsi yang tercantum di sini.

Pertimbangan untuk membuat file tampilan

Sebagian besar developer LookML memulai dengan satu atau beberapa file tampilan yang dibuat secara otomatis saat project LookML dibuat dari kumpulan tabel dalam database. Namun, selain metode yang dijelaskan di halaman ini untuk membuat file tampilan kosong dan untuk mengupload file, ada banyak cara bagi developer Looker dalam Mode Pengembangan untuk menambahkan file tampilan ke project LookML:

• Membuat file tampilan berdasarkan tabel dalam database:

  • Membuat file tampilan dari tabel database saat pertama kali terhubung ke database, seperti yang dijelaskan di halaman dokumentasi Membuat model LookML
  • Membuat file tampilan dari tabel database untuk project yang sudah terhubung ke database, seperti yang dijelaskan di bagian Menambahkan tampilan baru dari tabel database yang ada di halaman ini

• Membuat file tampilan untuk tabel turunan:

  • Memulai dengan file tampilan kosong menggunakan salah satu opsi yang dijelaskan di halaman ini, lalu menentukan tabel turunan secara manual, seperti yang dijelaskan di bagian Menentukan tabel turunan native di LookML di halaman dokumentasi Membuat tabel turunan native
  • Meminta Looker membuat LookML tabel turunan dari Jelajahi, seperti yang dijelaskan di bagian Menggunakan Jelajahi untuk mulai menentukan tabel turunan native di halaman dokumentasi Membuat tabel turunan native
  • Meminta Looker membuat LookML tabel turunan dari kueri SQL Runner, seperti yang dijelaskan di halaman dokumentasi Menggunakan SQL Runner untuk membuat tabel turunan

Untuk menggunakan tampilan baru, tambahkan ke file model menggunakan parameter explore, atau gunakan parameter join untuk menggabungkannya ke Jelajah yang ada dalam file model Anda.

Menambahkan tampilan baru dari tabel database yang ada

Anda dapat membuat file tampilan dari tabel database yang ada saat berada dalam Mode Pengembangan.

1. Dalam project, pilih menu Tambahkan file atau folder dengan memilih + (plus) di bagian atas daftar file project di Looker IDE, atau Anda dapat memilih menu folder untuk membuat file di dalam folder.

2. Pilih Create View From Table.

3. Looker menampilkan daftar tabel yang terkait dengan salah satu koneksi Anda. Untuk mengubah koneksi, gunakan menu drop-down Koneksi di kiri atas.

4. Pilih tabel yang ingin Anda gunakan untuk membuat tampilan dengan mencentang kotak di sebelah kiri nama tabel. Anda dapat menciutkan dan meluaskan database atau skema dalam daftar ini untuk mengakses semua tabel yang tersedia.

5. Scroll ke bagian bawah halaman, lalu pilih Buat Tampilan.

6. Looker menghasilkan tampilan yang berisi LookML untuk semua kolom tabel.

Mengupload file

Anda juga dapat mengupload file ke project dari komputer. Hal ini berguna jika Anda telah membuat file data JSON atau file LookML secara lokal di komputer.

Catatan: Lihat catatan penting untuk membuat file dan folder guna mengetahui batasan dan panduan untuk memberi nama file.

Untuk mengupload file ke project, gunakan fungsi tarik lalu lepas di IDE Looker:

1. Buka file project Anda.
2. Tarik file dari komputer Anda ke IDE Looker. File akan ditampilkan di root struktur direktori Anda.
3. Setelah file diupload, pindahkan item ke folder lain.

Penting: Setelah mengupload file, pastikan untuk menggunakan parameter include jika Anda ingin mereferensikan file atau elemen dari file dalam file LookML lain di project Anda. Lihat halaman dokumentasi parameter include untuk mengetahui informasi selengkapnya.

Menghapus file dan folder

Hapus folder atau file dengan memilih Hapus dari menu File Options tiga titik item di panel kiri IDE.

Catatan: Menghapus folder juga akan menghapus kontennya, jadi berhati-hatilah saat menghapus folder. Sebelum menghapus folder, lakukan hal berikut:

• Pastikan Anda ingin menghapus file dalam folder, atau pindahkan file ke lokasi lain sebelum menghapus folder.
• Pastikan folder tidak berisi file apa pun yang dirujuk dalam pernyataan include di project Anda. Lihat bagian Menggunakan include dengan folder IDE di halaman dokumentasi parameter include untuk mengetahui informasi tentang penggunaan include dengan folder IDE.

Saat Anda menghapus folder, IDE akan menampilkan pop-up konfirmasi. Pop-up menentukan jumlah item yang disertakan dalam penghapusan, yang mencakup folder dan file apa pun di dalam folder.

Catatan: Jika Anda menghapus file model, model tidak akan dihapus dari set model tempat model tersebut berada. Jika file model baru dibuat dengan nama yang sama dengan model yang dihapus, model baru akan disertakan dalam set model yang menyertakan model yang dihapus. Hal ini dapat mengakibatkan pemberian akses yang tidak diinginkan ke file model baru. Admin Looker dapat mengedit set model dan menghapus model yang dihapus untuk mencegah masalah ini.

Menghapus file dan folder secara massal

Untuk menghapus folder dan file secara massal:

Catatan: Menghapus folder akan menghapus semua kontennya. Sebelum menghapus folder, pastikan Anda ingin menghapus file dalam folder tersebut. Jika Anda ingin menyimpannya, pindahkan file ke lokasi lain sebelum menghapus folder.

1. Pilih ikon Edit Massal di bagian atas panel File Browser.

   

2. Pilih item yang akan dihapus. Jumlah file yang dipilih ditampilkan di samping header Select Files.

   

   • Untuk memilih atau membatalkan pilihan file satu per satu, luaskan foldernya, lalu centang kotak di samping nama file.
   • Untuk memilih atau membatalkan pilihan seluruh folder dan kontennya, centang kotak di samping nama folder.
   • Untuk memilih seluruh bagian daftar direktori, gunakan Shift-klik. Centang kotak untuk item teratas dalam rentang, lalu tahan tombol Shift dan centang kotak untuk item terakhir dalam daftar. Kedua item dan semua item di antaranya akan dipilih. Anda juga dapat mengklik item dengan Shift untuk memilih item dan semua item di atasnya dalam daftar direktori.

3. Pilih ikon tempat sampah Hapus Item. IDE kemudian akan menampilkan menu pop-up yang mencantumkan item yang dipilih.

   

4. Konfirmasi item yang akan dihapus dengan memilih Ya, Hapus, atau kembali ke pemilihan item dengan memilih Batal.

5. Pilih X di header Select Files untuk keluar dari mode edit massal.

Memindahkan item dalam project dengan folder

Untuk memindahkan file, tarik lalu lepas file atau folder ke folder lain.

Folder tujuan tidak perlu diperluas untuk menerima folder atau file lain. Folder akan otomatis diperluas saat Anda mengarahkan kursor ke folder tersebut.

Catatan: Saat Anda mengubah jalur file, pastikan untuk memperbarui pernyataan include di project Anda agar cocok dengan jalur file baru. Lihat bagian Menggunakan include dengan folder IDE di halaman dokumentasi parameter include untuk mengetahui informasi tentang penggunaan include dengan folder IDE.

Selain itu, perlu diketahui bahwa saat Anda mengubah jalur file, Git akan menghapus file secara efektif dan membuat file baru dengan jalur file baru. Artinya, histori Git untuk file tersebut akan kosong, karena Git menganggapnya sebagai file baru. Untuk melihat histori Git file sebelum dipindahkan, gunakan antarmuka Git untuk membuka file di lokasi aslinya dan melihat histori Git dari sana. (Logika yang sama berlaku untuk file yang diganti namanya, karena Git secara efektif menghapus file dan membuat file baru dengan nama yang berbeda.)

Memindahkan file dan folder secara massal

Untuk memindahkan folder dan file secara massal:

1. Pilih ikon Edit Massal di bagian atas panel File Browser.

   

2. Pilih item yang akan dipindahkan. Jumlah file yang dipilih ditampilkan di samping header Select Files.

   

   • Untuk memilih atau membatalkan pilihan file satu per satu, luaskan foldernya, lalu centang kotak di samping nama file.
   • Untuk memilih atau membatalkan pilihan seluruh folder dan kontennya, centang kotak di samping nama folder.
   • Untuk memilih seluruh bagian daftar direktori, gunakan Shift-klik. Centang kotak untuk item teratas dalam rentang, lalu tahan tombol Shift dan centang kotak untuk item terakhir dalam daftar. Kedua item dan semua item di antaranya akan dipilih. Anda juga dapat mengklik item dengan Shift untuk memilih item dan semua item di atasnya dalam daftar direktori.

3. Pilih ikon folder Pindahkan Item untuk memilih opsi. IDE kemudian akan menampilkan menu pop-up pemilihan folder.

   

4. Di menu pop-up Pindahkan ke, pilih folder untuk item yang dipilih, atau pilih Folder Baru untuk membuat folder baru. Nama project akan menampilkan jalur file folder yang telah Anda pilih di bagian atas halaman menu berikutnya. Untuk memindahkan item ke direktori utama project, pilih Pindahkan tanpa memilih folder.

5. Konfirmasi tujuan yang dipilih dengan memilih Pindahkan, buat folder baru dalam folder yang dipilih dengan memilih Folder Baru, atau kembali ke menu opsi folder utama dengan memilih link nama project di jalur file.

6. Pilih X di header Select Files untuk keluar dari mode edit massal.

Catatan: Setelah mengubah jalur file, pastikan untuk memperbarui pernyataan include apa pun dalam project Anda agar cocok dengan jalur file baru. Lihat bagian Menggunakan include dengan folder IDE di halaman dokumentasi parameter include untuk mengetahui informasi tentang penggunaan include dengan folder IDE.

Selain itu, perlu diketahui bahwa saat Anda mengubah jalur file, Git akan menghapus file secara efektif dan membuat file baru dengan jalur file baru. Artinya, histori Git untuk file tersebut akan kosong, karena Git menganggapnya sebagai file baru. Untuk melihat histori Git file sebelum dipindahkan, gunakan antarmuka Git untuk membuka file di lokasi aslinya dan melihat histori Git dari sana. (Logika yang sama berlaku untuk file yang diganti namanya, karena Git secara efektif menghapus file dan membuat file baru dengan nama yang berbeda.)