Menggunakan kontrol versi dan melakukan deployment

Halaman ini mengasumsikan bahwa project Anda telah disiapkan untuk kontrol versi. Jika Anda melihat tombol Configure Git, bukan pilihan yang dijelaskan di halaman ini, Anda harus menyiapkan Git untuk project Anda terlebih dahulu.

Looker menggunakan Git untuk mencatat perubahan dan mengelola versi file. Setiap project LookML sesuai dengan repositori Git, dan setiap cabang developer berkorelasi dengan cabang Git.

Looker dapat dikonfigurasi agar berfungsi dengan banyak penyedia Git, seperti GitHub, GitLab, dan Bitbucket. Lihat halaman dokumentasi Menyiapkan dan menguji koneksi Git untuk mengetahui informasi tentang cara menyiapkan Git untuk project Looker Anda.

Menggunakan cabang Git

Salah satu manfaat utama Git adalah developer Looker dapat bekerja di cabang, versi repositori file yang terisolasi. Anda dapat mengembangkan dan menguji tanpa memengaruhi pengguna lain. Sebagai developer di Looker, Anda menggunakan cabang Git setiap kali berada dalam Mode Pengembangan.

Fitur utama Git lainnya adalah kemudahan berkolaborasi dengan developer lain yang disediakannya. Anda dapat membuat cabang dan (jika diinginkan) membuat perubahan, lalu developer lain dapat beralih ke cabang tersebut untuk meninjau atau membuat perubahan pada cabang. Jika developer lain telah melakukan perubahan pada cabang, Looker akan menampilkan tombol Pull Remote Changes. Anda harus menarik perubahan yang di-commit tersebut ke cabang sebelum membuat perubahan tambahan.

Anda juga dapat menghapus cabang selain cabang master, cabang saat ini, atau cabang pribadi developer.

Cabang pribadi

Saat pertama kali Anda masuk ke Mode Pengembangan, Looker akan otomatis membuat cabang Git pribadi Anda. Cabang pribadi Anda dimulai dengan dev- dan menyertakan nama Anda.

Cabang pribadi Anda bersifat khusus untuk Anda, dan tidak dapat dihapus. Cabang pribadi Anda bersifat hanya baca bagi semua developer lain. Jika berkolaborasi dengan developer lain dalam sebuah project, sebaiknya buat cabang baru agar orang lain dapat beralih ke cabang tersebut dan berkontribusi pada perubahan juga.

Membuat cabang Git baru

Jika Anda sedang mengerjakan perbaikan sederhana dan tidak berkolaborasi dengan developer lain, cabang pribadi biasanya merupakan tempat yang tepat untuk bekerja. Anda dapat menggunakan cabang pribadi untuk melakukan update cepat, lalu melakukan commit pada perubahan dan mendorongnya ke produksi.

Namun, Anda juga dapat membuat cabang Git baru selain cabang pribadi Anda. Cabang Git baru akan berguna dalam situasi berikut:

  • Anda bekerja sama dengan developer lain. Karena cabang pribadi Anda hanya dapat dibaca oleh developer lain, jika ingin berkolaborasi dengan orang lain, Anda harus membuat cabang Git baru agar developer lain dapat menulis ke cabang tersebut. Saat berkolaborasi dengan orang lain, pastikan untuk mengambil perubahan setiap kali Anda melanjutkan pekerjaan. Dengan begitu, Anda akan memiliki update terbaru dari semua developer sebelum melanjutkan pekerjaan.
  • Anda mengerjakan beberapa kumpulan fitur sekaligus. Terkadang Anda mungkin sedang mengerjakan project besar, tetapi ingin menyelesaikan masalah kecil atau melakukan perbaikan cepat. Dalam hal ini, Anda dapat melakukan commit perubahan ke cabang yang sedang digunakan, lalu membuat atau beralih ke cabang lain untuk mengerjakan kumpulan fitur terpisah. Anda dapat melakukan perbaikan di cabang baru, lalu men-deploy perubahan cabang tersebut ke produksi — sebelum melanjutkan pekerjaan di cabang asli.

Sebelum membuat cabang baru:

  • Jika memiliki konflik penggabungan di cabang saat ini, Anda harus menyelesaikan konflik sebelum dapat membuat cabang baru.
  • Jika ada perubahan yang belum di-commit di cabang saat ini, Anda harus melakukan commit perubahan di cabang saat ini sebelum membuat cabang baru.
  • Jika Anda ingin membuat cabang yang dimulai dari cabang pengembangan yang ada (bukan cabang produksi), dapatkan versi terbaru cabang pengembangan terlebih dahulu dengan beralih ke cabang pengembangan tersebut, lalu tarik perubahan jarak jauh untuk menyinkronkan versi lokal cabang tersebut.

Untuk membuat cabang Git baru:

  1. Pastikan Anda telah mengaktifkan Mode Pengembangan.

  2. Buka file project Anda di menu Develop.

  3. Pilih ikon Git di menu ikon sebelah kiri untuk membuka panel Tindakan Git.

  4. Pilih menu drop-down Lihat Cabang.

  5. Pilih Cabang Baru.

  6. Di jendela Cabang Baru, masukkan nama untuk cabang Anda. Perhatikan bahwa ada batasan untuk nama cabang Git; untuk persyaratan penamaan, lihat Aturan untuk memberi nama cabang Git di halaman ini.

  7. Pilih menu drop-down Create From, lalu pilih cabang yang ada untuk digunakan sebagai titik awal cabang baru Anda.

  8. Pilih Buat untuk membuat cabang.

Atau, Anda dapat membuat cabang Git dari tab Pengelolaan Cabang di setelan project.

Aturan untuk memberi nama cabang Git

Looker menggunakan persyaratan konvensi penamaan cabang yang ditentukan oleh Git.

Nama cabang Git tidak boleh:

  • Berisi karakter spasi
  • Berisi dua titik: ..
  • Berisi garis miring terbalik: \
  • Berisi urutan: @{
  • Berisi tanda tanya: ?
  • Berisi tanda kurung siku buka: [
  • Berisi karakter kontrol ASCII: ~ atau \^ atau :
  • Mulai dengan titik: .
  • Mulai dengan awalan: dev- (disediakan untuk cabang pribadi developer Looker)
  • Akhiri dengan garis miring: /
  • Akhiri dengan ekstensi: .lock

Selain itu, nama cabang hanya boleh berisi tanda bintang (*) jika tanda bintang mewakili seluruh komponen jalur (misalnya, foo/* atau bar/*/baz), dalam hal ini tanda bintang akan ditafsirkan sebagai karakter pengganti, bukan sebagai bagian dari nama cabang yang sebenarnya.

Beralih ke cabang Git lain

Jika memiliki konflik penggabungan di cabang saat ini, Anda harus menyelesaikan konflik sebelum dapat beralih ke cabang lain.

Selain itu, jika memiliki perubahan yang belum di-commit di cabang saat ini, Anda tidak dapat beralih ke cabang yang ada hingga melakukan commit perubahan di cabang saat ini.

Untuk beralih ke cabang Git yang berbeda, ikuti langkah-langkah berikut:

  1. Dalam project, buka panel Git Actions dengan memilih ikon Git di menu ikon sebelah kiri.
  2. Di panel Git Actions, pilih menu drop-down cabang Git di sebelah kanan nama cabang Git Anda saat ini.
  3. Pilih cabang yang ingin Anda alihkan dengan memilihnya di menu, atau dengan mengetik nama cabang di kotak penelusuran. Penelusuran nama cabang tidak peka huruf besar/kecil. Misalnya, Anda dapat menelusuri "DEV" dan melihat semua cabang dengan nama yang menyertakan "dev", "DEV", "Dev", dan sebagainya.

Mengelola cabang Git

Tab Pengelolaan Cabang di setelan project menampilkan tabel semua cabang Git untuk project Looker. Untuk membuka tab Pengelolaan Cabang, buka setelan project terlebih dahulu dengan memilih ikon Setelan dari menu ikon sebelah kiri. Selanjutnya, pilih tab Pengelolaan Cabang.

Di tab Pengelolaan Cabang, Anda dapat:

  1. Buat cabang baru dengan memilih tombol Cabang Baru. Lihat bagian Membuat cabang Git baru di halaman ini untuk mengetahui informasi selengkapnya.
  2. Telusuri nama cabang di Kotak Penelusuran.
  3. Muat ulang tabel dengan memilih tombol Muat ulang.
  4. Urutkan tabel dengan memilih nama kolom.

Tabel ini mencakup informasi berikut:

  • Nama: Nama cabang Git. Cabang pribadi developer Looker dimulai dengan dev- dan menyertakan nama depan dan belakang developer.
  • Status: Perbedaan antara versi lokal cabang dan versi jarak jauh cabang. Misalnya, status 3 commits behind berarti versi lokal cabang Anda tertinggal dari versi jarak jauh cabang sebesar tiga commit. Karena Looker selalu menggunakan master versi jarak jauh, tab Pengelolaan Cabang tidak menampilkan status cabang master versi lokal. Cabang master selalu dapat dianggap sebagai yang terbaru.
  • Terakhir Diperbarui: Jumlah waktu sejak developer Looker melakukan commit ke cabang.
  • Tindakan: Tombol untuk menghapus cabang, atau alasan cabang tidak memenuhi syarat untuk dihapus.

Menghapus cabang Git

Dari tab Pengelolaan Cabang, Anda dapat menghapus cabang yang memiliki tombol Hapus di tabel. Anda tidak dapat menghapus cabang berikut:

Dalam tabel, cabang ini tidak memiliki tombol Hapus. Sebagai gantinya, kolom Tindakan pada tabel menunjukkan alasan cabang tidak dapat dihapus.

Anda tidak dapat memulihkan cabang setelah dihapus. Saat Anda menghapus cabang, Looker akan menghapus versi lokal cabang dan versi jarak jauh cabang.

Namun, jika cabang dibuat oleh developer Looker lain, atau jika developer lain telah memeriksa cabang, developer tersebut akan tetap memiliki versi lokal cabang. Jika developer Looker melakukan commit ke versi lokal cabang dan mendorongnya ke produksi, Anda akan melihat versi jarak jauh cabang tersebut lagi. Tindakan ini dapat berguna jika Anda ingin memulihkan cabang. Jika tidak, saat Anda menghapus cabang, semua developer Looker lainnya harus menghapus cabang yang sama untuk memastikan bahwa cabang tersebut tidak dapat muncul kembali secara tidak sengaja oleh seseorang yang mendorongnya ke jarak jauh.

Untuk menghapus satu atau beberapa cabang Git dari project Anda, buka setelan project terlebih dahulu dengan memilih ikon Setelan dari menu ikon sebelah kiri. Kemudian, pilih tab Pengelolaan Cabang. Di tab Pengelolaan Cabang, Anda dapat menghapus cabang dengan dua cara:

  1. Hapus beberapa cabang dengan memilih kotak centang cabang terlebih dahulu, lalu memilih Hapus Cabang yang Dipilih.
  2. Hapus satu cabang dengan memilih Hapus di samping nama cabang.

Menjalankan perintah Git di Looker

Looker memiliki antarmuka bawaan yang terintegrasi dengan layanan Git Anda. Looker menampilkan tombol Git di sudut kanan atas IDE LookML.

Tombol Git menampilkan opsi yang berbeda-beda, bergantung pada tahap Anda dalam proses membuat perubahan dan men-deploy ke produksi. Secara umum, opsi yang ditampilkan pada tombol adalah panduan terbaik untuk tindakan Anda berikutnya.

Jika cabang developer Anda disinkronkan dengan cabang produksi, tombol Git akan menampilkan pesan Terbaru dan tidak dapat dipilih.

Setelah project dikonfigurasi untuk Git, Anda dapat memilih tombol Git Actions untuk membuka panel Git Actions.

Perintah yang tersedia di panel Tindakan Git bergantung pada posisi Anda dalam proses membuat perubahan dan men-deploy ke produksi.

Mendapatkan perubahan Anda ke produksi

Dengan integrasi Looker Git default, Looker akan meminta developer untuk mengikuti alur kerja Git berikut:

Artinya, dengan integrasi Git default, semua developer menggabungkan perubahan mereka ke dalam cabang yang disebut master, dan commit terbaru di cabang master adalah yang digunakan untuk lingkungan produksi Looker.

Untuk penerapan Git lanjutan, Anda dapat menyesuaikan alur kerja ini:

  • Anda dapat meminta developer mengirimkan permintaan pull untuk cabang produksi Git, bukan mengizinkan developer menggabungkan perubahan mereka melalui IDE Looker. Lihat halaman dokumentasi Mengonfigurasi setelan kontrol versi project untuk mengetahui detailnya.
  • Anda dapat menggunakan kolom Git Production Branch Name untuk menentukan cabang mana dari repositori Git yang harus digunakan Looker sebagai cabang target tempat cabang developer Looker digabungkan. Lihat halaman dokumentasi Mengonfigurasi setelan kontrol versi project untuk mengetahui detailnya.
  • Anda dapat menggunakan mode deployment lanjutan untuk menentukan SHA commit atau nama tag yang berbeda untuk di-deploy ke lingkungan produksi Looker, bukan menggunakan commit terbaru di cabang produksi. (Jika ingin men-deploy commit dari cabang lain, Anda dapat menggunakan webhook atau endpoint API mode deploy lanjutan.) Lihat halaman dokumentasi Mode deployment lanjutan untuk mengetahui detailnya.

Jika Anda melihat tombol Configure Git, bukan pilihan yang dijelaskan di bagian ini, Anda harus menyiapkan Git untuk project Anda terlebih dahulu.

Melihat perubahan yang belum di-commit

IDE LookML memiliki beberapa indikator yang ditampilkan saat Anda berada dalam Mode Pengembangan dan memiliki perubahan yang belum di-commit, seperti yang dijelaskan di bagian Menandai penambahan, perubahan, dan penghapusan di halaman dokumentasi Ringkasan IDE Looker.

Anda bisa mendapatkan ringkasan perbedaan untuk semua file dengan memilih opsi View Uncommitted Changes dari panel Git Actions.

Di jendela Perubahan yang Belum Di-commit ke Project, Looker menampilkan ringkasan semua perubahan yang belum di-commit dan disimpan di semua file project. Untuk setiap perubahan, Looker menampilkan hal berikut:

  • Nama file yang diganti dan nama file yang ditambahkan.
    • Nama file yang diganti (ditunjukkan dengan ---) dan nama file yang ditambahkan (ditunjukkan dengan +++). Dalam banyak kasus, hal ini dapat menampilkan versi file yang sama, dengan revisi yang diidentifikasi oleh --- a/ dan +++ b/.
    • File yang dihapus ditampilkan sebagai pengganti file null (+++ /dev/null).
    • File yang ditambahkan ditampilkan sebagai pengganti file null (--- /dev/null).
  • Nomor baris tempat perubahan dimulai.

    Misalnya, -101,4 +101,4 menunjukkan bahwa, pada baris ke-101 dalam file, 4 baris dihapus dan 4 baris ditambahkan. File yang dihapus dengan 20 baris akan menampilkan -1,20 +0,0 untuk menunjukkan bahwa, pada baris pertama dalam file, 20 baris telah dihapus dan diganti dengan nol baris.
  • Teks yang diperbarui:
    • Baris yang dihapus ditampilkan dengan warna merah.
    • Garis yang ditambahkan akan ditampilkan dengan warna hijau.

Untuk menampilkan ringkasan perbedaan untuk satu file, pilih opsi Lihat Perubahan dari menu file.

Melakukan commit perubahan

Setelah Anda membuat dan menyimpan perubahan pada project LookML, IDE mungkin mengharuskan Anda memvalidasi LookML. Tombol Git menampilkan teks Validasi LookML dalam skenario ini.

Apakah hal ini diperlukan bergantung pada setelan project Anda untuk kualitas kode. Untuk mengetahui informasi selengkapnya tentang Validator Konten, lihat halaman dokumentasi Memvalidasi LookML.

Jika developer lain telah melakukan perubahan pada cabang produksi sejak Anda terakhir kali mengupdate cabang lokal, Looker mengharuskan Anda mengambil update tersebut dari cabang produksi. Tombol Git menampilkan teks Pull from Production dalam skenario ini.

Jika project Anda diaktifkan untuk mode deployment lanjutan, tombol Git akan menampilkan teks Pull from Primary Branch.

Setelah Anda menyimpan perubahan (dan memperbaiki peringatan atau error LookML, jika diperlukan) dan menarik dari produksi (jika diperlukan), tombol Git akan menampilkan teks Commit Changes & Push.

Jika diinginkan, Anda dapat meninjau perubahan yang belum di-commit terlebih dahulu sebelum melakukan commit.

Jika Anda sudah siap melakukan commit pada perubahan, gunakan tombol Git untuk melakukan commit pada perubahan ini ke cabang saat ini. Looker menampilkan kotak dialog Commit, yang mencantumkan file yang telah ditambahkan, diubah, atau dihapus.

Masukkan pesan yang menjelaskan perubahan Anda secara singkat, lalu hapus centang pada kotak di samping file yang tidak ingin Anda sertakan dalam sinkronisasi. Kemudian, pilih Commit untuk melakukan commit pada perubahan.

Memeriksa PDT yang belum di-build

Jika Anda telah melakukan perubahan pada PDT apa pun dalam project, sebaiknya semua PDT dibuat saat Anda men-deploy ke produksi sehingga tabel dapat langsung digunakan sebagai versi produksi. Untuk memeriksa status PDT dalam project, pilih ikon Project Health untuk membuka panel Project Health, lalu pilih tombol Validate PDT Status.

Lihat halaman dokumentasi Tabel turunan di Looker untuk mengetahui informasi selengkapnya tentang cara memeriksa PDT yang belum di-build di project LookML dan cara menggunakan tabel turunan dalam Mode Pengembangan.

Menjalankan pengujian data

Project Anda dapat menyertakan satu atau beberapa parameter test yang menentukan pengujian data untuk memverifikasi logika model LookML Anda. Lihat halaman dokumentasi parameter test untuk mengetahui informasi tentang cara menyiapkan pengujian data di project Anda.

Jika project Anda berisi pengujian data dan Anda berada dalam Mode Pengembangan, Anda dapat memulai pengujian data project dengan beberapa cara:

  1. Jika setelan project Anda dikonfigurasi untuk mewajibkan pengujian data lulus sebelum men-deploy file ke produksi, IDE akan menampilkan tombol Run Tests setelah Anda commit perubahan pada project untuk menjalankan semua pengujian untuk project Anda, terlepas dari file mana yang menentukan pengujian. Anda harus lulus pengujian data sebelum dapat men-deploy perubahan ke produksi.
  2. Pilih tombol Run Data Tests di panel Project Health. Looker akan menjalankan semua pengujian data dalam project Anda, terlepas dari file mana yang menentukan pengujian.
  3. Pilih opsi Run LookML Tests dari menu file. Looker hanya akan menjalankan pengujian yang ditentukan dalam file saat ini.

Setelah Anda menjalankan pengujian data, panel Project Health akan menampilkan progres dan hasil.

  • Pengujian data lulus jika pernyataan pengujian benar untuk setiap baris dalam kueri pengujian. Lihat halaman dokumentasi parameter test untuk mengetahui detail tentang cara menyiapkan pernyataan dan kueri pengujian.
  • Jika pengujian data gagal, panel Project Health akan memberikan informasi tentang alasan pengujian gagal, apakah pengujian menemukan error dalam logika model Anda atau apakah pengujian itu sendiri yang tidak valid.
  • Dari hasil pengujian data, Anda dapat memilih nama pengujian data untuk langsung membuka LookML untuk pengujian data, atau Anda dapat memilih tombol Explore Query untuk membuka Jelajah dengan kueri yang ditentukan dalam pengujian data.

Men-deploy ke produksi

Setelah Anda melakukan commit perubahan ke cabang, Looker IDE akan meminta Anda untuk menggabungkan perubahan ke cabang utama. Jenis perintah yang akan Anda lihat di IDE akan bergantung pada konfigurasi project Anda:

  • Jika project Anda dikonfigurasi untuk mode deployment lanjutan, IDE akan meminta Anda untuk menggabungkan perubahan ke cabang utama. Setelah Anda menggabungkan commit, developer Looker dengan izin deploy dapat men-deploy commit ke produksi menggunakan pengelola deployment IDE Looker, atau menggunakan webhook atau endpoint API.
  • Jika project Anda dikonfigurasi untuk integrasi Git menggunakan permintaan pull, Anda akan diminta untuk membuka permintaan pull menggunakan antarmuka penyedia Git Anda.
  • Jika tidak, dengan integrasi Looker Git default, jika Anda memiliki izin deploy, IDE Looker akan meminta Anda untuk menggabungkan perubahan ke cabang produksi dan men-deploy perubahan ke versi produksi instance Looker Anda.

Mode deploy lanjutan

Dengan integrasi Looker Git default, developer Looker melakukan commit perubahan ke cabang pengembangan, lalu menggabungkan cabang pengembangan ke cabang produksi. Kemudian, saat Anda men-deploy ke lingkungan Looker, Looker akan menggunakan commit terbaru di cabang produksi. (Lihat bagian Mendapatkan perubahan ke produksi di halaman ini untuk mengetahui alur kerja Git default dan opsi lainnya untuk implementasi Git lanjutan.)

Jika Anda tidak ingin selalu menggunakan commit terbaru di cabang produksi untuk lingkungan Looker, developer dengan izin deploy dapat menggunakan mode deployment lanjutan untuk menentukan commit yang tepat yang akan digunakan untuk lingkungan Looker Anda. Hal ini berguna dalam alur kerja developer multi-lingkungan, dengan setiap lingkungan mengarah ke versi codebase yang berbeda. Hal ini juga memberi satu atau beberapa developer atau administrator kontrol yang lebih besar atas perubahan yang di-deploy ke produksi.

Jika mode deployment lanjutan diaktifkan, Looker IDE tidak akan meminta developer untuk men-deploy perubahan mereka ke produksi. Sebagai gantinya, IDE meminta developer untuk menggabungkan perubahan mereka ke dalam cabang produksi. Dari sana, perubahan hanya dapat di-deploy dengan cara berikut:

  • Menggunakan pengelola deployment di IDE Looker
  • Memicu webhook

  • Menggunakan endpoint API

Lihat halaman dokumentasi Mode deployment lanjutan untuk mengetahui detailnya.

Memeriksa dampak perubahan Anda

Setelah membuat perubahan tersedia untuk organisasi, Anda dapat menggunakan validasi konten untuk memastikan Anda tidak telah membatalkan validasi dasbor atau Tampilan tersimpan. Anda akan memiliki kesempatan untuk memperbaikinya jika ada.

Menangani masalah umum

Saat mengerjakan model, Anda mungkin perlu:

  • Membatalkan perubahan

    Terkadang Anda mungkin ingin membatalkan perubahan pemodelan data. Jika belum disimpan, Anda cukup memuat ulang atau keluar dari halaman, lalu menerima perintah peringatan. Jika telah menyimpan perubahan, Anda dapat mengembalikan perubahan yang belum di-commit seperti yang dijelaskan di bagian Mengembalikan perubahan yang belum di-commit.

  • Menangani konflik penggabungan dengan pekerjaan developer lain

    Jika Anda memiliki lebih dari satu developer yang mengerjakan model data, Git biasanya menangani situasi tersebut. Namun, terkadang Git memerlukan manusia untuk menyelesaikan konflik penggabungan.

Beberapa perubahan, seperti mengubah nama kolom, dapat memengaruhi dasbor dan Tampilan yang ada. Seperti yang disebutkan sebelumnya, setelah membuat perubahan tersedia untuk organisasi, Anda dapat menggunakan validasi konten untuk memeriksa konten dan memperbaiki masalah apa pun.

Mengembalikan perubahan yang belum di-commit

Saat mengerjakan cabang pengembangan pribadi, Anda dapat mengembalikan perubahan yang belum di-commit yang telah Anda simpan jika tidak ingin men-deploynya. Anda dapat mengembalikan semua perubahan yang belum di-commit untuk semua file dalam project atau hanya perubahan dalam satu file.

Untuk mengembalikan perubahan yang tidak di-commit untuk semua file:

  1. Pilih opsi Kembalikan ke... di panel Tindakan Git.
  2. Pilih opsi kembalikan:
    • Untuk mengembalikan hanya perubahan yang belum di-commit, pilih Kembalikan perubahan yang belum di-commit. Anda juga dapat memilih link Lihat perubahan untuk melihat perubahan yang akan dikembalikan.
    • Untuk mengembalikan semua perubahan, termasuk perubahan yang belum di-commit dan yang telah di-commit, pilih Kembalikan ke Produksi
  3. Untuk menyelesaikan proses pembatalan, pilih Konfirmasi.

Untuk mengembalikan penambahan atau penghapusan apa pun dalam konten satu file, pilih opsi Kembalikan Perubahan dari menu file tersebut:

Saat mengganti nama file, Anda pada dasarnya menghapus file asli dan membuat file baru dengan nama baru. Karena melibatkan lebih dari satu file, Anda tidak dapat menggunakan opsi Kembalikan File untuk mengurungkan penggantian nama file. Jika Anda ingin mengurungkan penggantian nama file, gunakan opsi Kembalikan ke... dari panel Tindakan Git.

Selain itu, jika Anda telah menghapus file, file tersebut tidak akan lagi ditampilkan di browser file IDE. Jika Anda ingin mengembalikan penghapusan file, gunakan opsi Kembalikan ke... dari panel Tindakan Git.

Menyelesaikan konflik penggabungan

Biasanya, Git dapat otomatis menggabungkan perubahan baru Anda dengan versi produksi file LookML. Konflik penggabungan terjadi saat Git menemukan perubahan yang bertentangan dan tidak dapat mengidentifikasi perubahan mana yang harus dipertahankan, biasanya saat developer lain telah membuat perubahan sejak Anda terakhir kali melakukan pull dan Anda telah membuat perubahan di area yang sama. Jika Anda memiliki konflik penggabungan dalam kode, Looker akan menampilkan peringatan Konflik penggabungan setelah Anda melakukan perubahan dan menarik dari produksi.

Jika Looker menampilkan peringatan konflik penggabungan, sebaiknya selesaikan konflik penggabungan sebelum melakukan perubahan lebih lanjut. Mendorong konflik penggabungan ke produksi akan menyebabkan error penguraian yang dapat mencegah eksplorasi data Anda. Jika Anda adalah pengguna Git tingkat lanjut dan ingin melanjutkan dengan mendorong perubahan, pilih tombol Don't Resolve.

Dalam file LookML itu sendiri, baris dengan konflik ditandai seperti ini:

<<<<<<< HEAD
Your code
&#61;&#61;&#61;&#61;&#61;&#61;&#61;
Production code
>>>>>>> branch 'master'

Looker menampilkan penanda penggabungan berikut untuk menunjukkan konflik penggabungan:

  • <<<<<<< HEAD menandai awal baris yang bertentangan.
  • >>>>>>> branch 'master' menandai akhir baris yang bertentangan.
  • ======= memisahkan setiap versi kode sehingga Anda dapat membandingkannya.

Dalam contoh sebelumnya, your code mewakili perubahan yang Anda commit, dan production code mewakili kode tempat Git tidak dapat menggabungkan perubahan Anda secara otomatis.

Untuk menyelesaikan konflik penggabungan:

  1. Temukan file dengan konflik penggabungan. Looker menandai file ini dengan warna merah, atau Anda juga dapat menelusuri project untuk menemukan penanda penggabungan, seperti <<<< atau HEAD, untuk menemukan semua konflik dalam project Anda. Anda juga dapat menemukan file yang terpengaruh dengan memilih link files di peringatan penggabungan yang muncul di panel Git Actions.
  2. Di file, buka baris dengan konflik penggabungan dan hapus versi teks yang TIDAK ingin Anda simpan, dan hapus juga semua penanda konflik penggabungan.

  3. Simpan file, lalu ulangi langkah-langkah sebelumnya untuk file lain yang ditandai dengan konflik penggabungan.

  4. Setelah menyelesaikan semua konflik penggabungan dan menghapus semua penanda penggabungan dari project, komit perubahan dan deploy ke produksi.

Setelah Anda menyelesaikan konflik penggabungan dan mendorong resolusi ke produksi, developer lain dapat mengambil dari produksi dan melanjutkan pekerjaan seperti biasa.

Pembersihan sampah memori Git

Pengumpulan sampah Git membersihkan file yang tidak diperlukan dan mengompresi revisi file untuk mengoptimalkan repositori Git Anda. Pengumpulan sampah Git (git gc) dijalankan secara otomatis saat instance Looker Anda diupdate atau dimulai ulang. Agar tidak terlalu sering menjalankan git gc, Looker menunggu selama 30 hari sejak git gc terakhir, lalu menjalankan git gc pada mulai ulang berikutnya.

Dalam kasus yang jarang terjadi, Anda mungkin mencoba Push Changes to Remote atau Push Branch to Remote saat git gc sedang berjalan. Jika Looker menampilkan error, tunggu satu atau dua menit, lalu coba lagi untuk menerapkan perubahan.