Mengelola file dan folder LookML

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

Untuk mendapatkan 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 Anda membuat file dan folder, yang terbaik adalah mengingat konvensi penamaan berikut:

• Peka huruf besar/kecil: LookML peka huruf besar/kecil. Pastikan untuk mematuhi konvensi proyek saat memberi nama folder Anda. Misalnya, jika konvensi Anda adalah menggunakan semua huruf kecil dalam project, sebaiknya beri nama folder views bukan Views. Hal ini akan menimbulkan 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 menamainya flights_data_tests.lkml.
• Mengubah nama objek LookML yang ditampilkan: Jika Anda ingin mengubah nama model atau objek LookML yang ditampilkan, pertimbangkan untuk menggunakan 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 lain. Secara umum, Anda harus melakukan tindakan pencegahan agar perubahan model sebisa mungkin tidak invasif. Jika Anda perlu mengganti nama model atau objek, gunakan Validator Konten untuk memperbarui semua referensi ke model atau objek tersebut.

Membuat folder

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

Catatan: Saat Anda membuat folder, perlu diingat bahwa LookML peka huruf besar/kecil. Pastikan untuk mematuhi konvensi proyek saat memberi nama folder Anda. 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 pemberian nama file serta folder.

Untuk membuat folder:

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

Folder baru akan ditambahkan ke panel navigasi.

Membuat file

Anda dapat otomatis membuat file model dan melihat file berdasarkan database saat membuat project baru. Untuk project yang sudah ada, Anda dapat membuat file baru secara manual.

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

Untuk membuat file baru dalam project LookML Anda:

1. Pilih menu yang sesuai:

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

2. Pilih jenis file LookML yang ingin Anda buat. Pilih tautan dalam daftar berikut untuk deskripsi yang lebih terperinci tentang setiap jenis {i>file<i}. Anda dapat membuat jenis file berikut:

   • File model dengan ekstensi file .model.lkml
   • Lihat file dengan ekstensi file .view.lkml*
   • File manifes project yang selalu bernama manifest.lkml**
   • File dasbor dengan ekstensi file .dashboard.lookml
   • File dokumen dengan ekstensi file .md
   • Lokalkan file string 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
     • Memperbaiki file dengan ekstensi file .lkml
     • File lain yang Anda gunakan untuk menampung elemen LookML
   Catatan:

   ^* Lihat bagian Pertimbangan untuk membuat file tampilan di halaman ini guna 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 file browser di Looker IDE, dan hanya jika project belum memiliki file manifes. Ini karena sebuah proyek hanya dapat memiliki satu file manifes, dan file manifes harus ditempatkan di tingkat akar struktur direktori proyek.

   ^*** Opsi Create Locale Strings File hanya tersedia dari ikon Add file or folder + (plus) di bagian atas file browser di Looker IDE, tetapi setelah file string lokal 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 pada halaman dokumentasi Pengguna.

   ^**** Saat Anda membuat file Jelajah, file tersebut harus memiliki ekstensi .explore.lkml di akhir nama filenya. Jika Anda 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 ekstensi ke nama file secara manual. Misalnya, untuk membuat file Jelajah bernama flights menggunakan Looker IDE, Anda dapat memasukkan flights.explore atau flights.explore.lkml, dan file akan diberi nama flights.explore.lkml.

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

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

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

Catatan: Jika admin Looker Anda telah mengaktifkan fitur Lab Peningkatan LookML Generation, menu Tambahkan file atau folder + (plus) di bagian atas panel Browser File akan menampilkan opsi untuk Membuat 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 dihasilkan 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 yang dapat dilakukan 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.
  • Menghasilkan 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 dalam bagian Menentukan tabel turunan native di LookML pada halaman dokumentasi Membuat tabel turunan native
  • Meminta Looker membuat tabel turunan LookML dari Jelajah, seperti yang dijelaskan di bagian Menggunakan Jelajah untuk mulai menentukan tabel turunan native di halaman dokumentasi Membuat tabel turunan native
  • Meminta Looker membuat tabel turunan LookML dari kueri SQL Runner, seperti yang dijelaskan di halaman dokumentasi Menggunakan SQL Runner untuk membuat tabel turunan

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

Menambahkan tampilan baru dari tabel database yang ada

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

1. Dalam project, pilih menu Add file or folder dengan memilih tanda + (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 akan menampilkan daftar tabel yang terkait dengan salah satu koneksi Anda. Untuk mengubah sambungan, gunakan drop-down Koneksi di kiri atas.

4. Pilih tabel yang ingin Anda buat 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 Create Views.

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

Mengupload file

Anda juga dapat mengupload file ke project Anda dari komputer. Hal ini berguna jika Anda 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 penamaan file.

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

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

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

Menghapus file dan folder

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

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

• Verifikasi bahwa Anda ingin menghapus file di folder, atau pindahkan file ke lokasi lain sebelum menghapus folder.
• Pastikan folder tersebut tidak berisi file yang dirujuk dalam pernyataan include di project Anda. Lihat bagian Menggunakan include dengan folder IDE dari halaman dokumentasi parameter include untuk mengetahui informasi tentang cara menggunakan 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 kumpulan model mana pun yang memiliki model tersebut. Jika file model baru dibuat dengan nama yang sama seperti model yang dihapus, model baru tersebut akan disertakan dalam set model apa pun yang menyertakan model yang dihapus. Hal ini dapat menyebabkan pemberian akses yang tidak diinginkan ke file model baru. Admin Looker dapat mengedit kumpulan 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 tersebut.

1. Pilih ikon Bulk Edit 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 setiap file, 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. Pilih kotak centang untuk item teratas dalam rentang, lalu tekan dan tahan tombol Shift dan pilih kotak centang untuk item terakhir dalam daftar. Item dan semua item di antaranya akan dipilih. Anda juga dapat menekan {i>Shift<i}-klik pada sebuah item untuk memilih item dan semua yang ada di atasnya dalam daftar direktori.

3. Pilih ikon tempat sampah Delete Items. 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 pilihan item dengan memilih Batal.

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

Memindahkan item dalam project dalam 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 diluaskan saat Anda mengarahkan kursor ke atasnya.

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

Selain itu, perlu diketahui bahwa saat Anda mengubah jalur file, Git akan menghapus file tersebut secara efektif dan membuat file baru dengan jalur file baru. Artinya, histori Git untuk file ini akan kosong, karena Git menganggapnya sebagai file baru. Untuk melihat histori Git file sebelum dipindahkan, gunakan antarmuka Git Anda untuk membuka file di lokasi aslinya, lalu lihat 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 Bulk Edit 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 setiap file, 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. Pilih kotak centang untuk item teratas dalam rentang, lalu tekan dan tahan tombol Shift dan pilih kotak centang untuk item terakhir dalam daftar. Item dan semua item di antaranya akan dipilih. Anda juga dapat menekan {i>Shift<i}-klik pada sebuah item untuk memilih item dan semua yang ada di atasnya dalam daftar direktori.

3. Pilih ikon folder Move Items 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 dari folder yang Anda pilih di bagian atas halaman menu berikutnya. Untuk memindahkan item ke direktori utama project, pilih Move tanpa folder yang dipilih.

5. Konfirmasi tujuan yang dipilih dengan memilih Move, buat folder baru dalam folder yang dipilih dengan memilih New Folder, 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 dalam project Anda agar cocok dengan jalur file baru. Lihat bagian Menggunakan include dengan folder IDE dari halaman dokumentasi parameter include untuk mengetahui informasi tentang cara menggunakan include dengan folder IDE.

Selain itu, perlu diketahui bahwa saat Anda mengubah jalur file, Git akan menghapus file tersebut secara efektif dan membuat file baru dengan jalur file baru. Artinya, histori Git untuk file ini akan kosong, karena Git menganggapnya sebagai file baru. Untuk melihat histori Git file sebelum dipindahkan, gunakan antarmuka Git Anda untuk membuka file di lokasi aslinya, lalu lihat 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.)