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.

Konvensi penamaan file dan folder yang penting

Saat membuat file dan folder, 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 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 untuk membuat perubahan model seaman mungkin. 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.

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 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 yang didasarkan pada database Anda saat Anda membuat model. Untuk project yang ada, Anda dapat membuat file baru secara manual.

Untuk membuat file baru dalam 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 ada, gunakan menu Folder Options tiga titik untuk folder yang ada.

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

  3. Pada dialog Create File, masukkan nama untuk file baru. Lihat bagian konvensi penamaan file dan folder penting untuk mengetahui batasan dan panduan dalam memberi nama file.

  4. Pilih Create. File baru akan ditampilkan di tempat Anda membuatnya. Anda dapat memindahkannya ke folder lain jika perlu.

Pertimbangan untuk membuat file

Perhatikan pertimbangan berikut saat Anda membuat file:

  • Sebaiknya gunakan Looker IDE untuk menambahkan file ke project LookML, baik dengan membuatnya di Looker IDE 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.
  • 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.
  • Jika Anda membuat file yang disusun bertingkat dalam tujuh folder atau lebih, File Explorer tidak akan menampilkan file tersebut.
  • 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. Namun, 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 bawaan Looker, Anda harus memberi nama file string menggunakan kode lokalitas tertentu, yang dapat Anda temukan 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.

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:

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. Buka bagian bawah halaman dan pilih Buat Tampilan.

  6. Looker membuat 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.

Untuk mengupload file ke project, gunakan fungsi tarik lalu lepas di IDE Looker untuk mengikuti langkah-langkah berikut:

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

Menghapus file dan folder

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

  • Pastikan Anda ingin menghapus file dalam folder, atau pindahkan file ke lokasi lain sebelum menghapus folder.
  • Pastikan folder tidak berisi file 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.

Untuk menghapus folder atau file, pilih Hapus dari menu tiga titik File Options item di panel kiri IDE.

Saat Anda menghapus folder, IDE akan menampilkan dialog konfirmasi. Dialog menentukan jumlah item yang disertakan dalam penghapusan, yang mencakup folder dan file apa pun di dalam folder.

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

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

  • Pastikan Anda ingin menghapus file dalam folder, atau pindahkan file ke lokasi lain sebelum menghapus folder.
  • Pastikan folder tidak berisi file 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.

Untuk menghapus folder dan file secara massal, ikuti langkah-langkah berikut:

  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, serta semua item di antaranya, akan dipilih. Anda juga dapat menekan Shift dan mengklik item untuk memilih item tersebut dan setiap item sebelumnya dalam daftar direktori.

  3. Pilih ikon tempat sampah Hapus Item. IDE kemudian akan menampilkan dialog 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 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.

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

Selain itu, perhatikan bahwa saat Anda mengubah jalur file, Git akan menghapus file secara efektif dan membuat file baru dengan jalur 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, serta semua item di antaranya, akan dipilih. Anda juga dapat menekan Shift dan mengklik item untuk memilih item dan setiap file sebelumnya dalam daftar direktori

  3. Pilih ikon folder Pindahkan Item untuk memilih opsi. IDE kemudian akan menampilkan dialog pemilihan folder.

  4. Pada dialog Pindahkan ke, pilih folder untuk item yang dipilih, atau pilih Folder Baru untuk membuat folder baru. Nama project akan menampilkan jalur 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.

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

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

Selain itu, perhatikan bahwa saat Anda mengubah jalur file, Git akan menghapus file secara efektif dan membuat file baru dengan jalur 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.)