Mengontrol versi kode Anda

Dokumen ini menunjukkan cara menggunakan kontrol versi di Dataform untuk melacak pengembangan.

Dataform menggunakan Git untuk melacak setiap perubahan yang dibuat pada file di dalam repositori.

Di repositori Dataform, Anda berinteraksi langsung dengan repositori Git.

Di repositori yang terhubung, Anda berinteraksi dengan cabang pelacakan repositori jarak jauh yang Anda konfigurasi selama menghubungkan repositori.

Dataform menampilkan opsi kontrol versi berdasarkan status perubahan di ruang kerja pengembangan Anda. Misalnya, Dataform menampilkan opsi commit hanya jika ada perubahan lokal yang belum di-commit di ruang kerja Anda. Jika file di ruang kerja Anda adalah salinan persis dari cabang default atau pelacakan, Dataform akan menampilkan status Ruang kerja sudah yang terbaru.

Dataform menampilkan opsi kontrol versi berikut:

Melakukan commit perubahan X
Commit jumlah perubahan lokal X di ruang kerja Anda atau file yang diubah yang dipilih. Dataform menampilkan perubahan yang tidak di-commit.
Push ke cabang default
Kirim perubahan yang di-commit ke cabang default Anda. Opsi ini tersedia di repositori Dataform jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja.
Kirim ke your-branch-name
Kirim perubahan yang di-commit ke your-branch-name. Opsi ini tersedia di repositori yang terhubung ke repositori Git pihak ketiga jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja.
Menarik dari cabang default
Memperbarui ruang kerja dengan perubahan terbaru dari cabang default Anda. Opsi ini tersedia di repositori Dataform jika Anda tidak memiliki perubahan yang di-commit atau di-push di ruang kerja.
Menarik dari your-branch-name
Perbarui ruang kerja Anda dengan perubahan terbaru dari your-branch-name. Opsi ini tersedia di repositori yang terhubung ke repositori Git pihak ketiga jika Anda tidak memiliki perubahan yang belum di-commit atau belum di-push di ruang kerja.
Kembalikan ke commit terakhir
Pulihkan file di ruang kerja Anda ke statusnya dari commit terakhir.

Sebelum memulai

  1. Pilih atau Buat repositori.
  2. Opsional: Hubungkan repositori Anda ke repositori Git pihak ketiga.
  3. Pilih atau Buat ruang kerja pengembangan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menggunakan kontrol versi di Dataform, minta administrator untuk memberi Anda peran IAM Dataform Editor (roles/dataform.editor) di ruang kerja. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menarik perubahan

Jika ruang kerja pengembangan tidak sinkron dengan repositori, Dataform akan menampilkan opsi Pull. Untuk menarik perubahan dari repositori ke ruang kerja pengembangan, ikuti langkah-langkah berikut:

  1. Di halaman Dataform, pilih repositori.
  2. Di tab Ruang kerja pengembangan, pilih ruang kerja pengembangan.
  3. Di halaman ruang kerja pengembangan, lakukan hal berikut:
    1. Jika Anda berada di repositori Dataform, klik Pull from default branch.
    2. Jika Anda berada di repositori yang terhubung ke repositori Git pihak ketiga, klik Pull from your-branch-name.

Melakukan commit perubahan

Setelah Anda membuat perubahan di ruang kerja pengembangan, Dataform akan menampilkan opsi Commit. Anda dapat melakukan commit semua perubahan lokal atau file yang dipilih.

Dalam dialog New commit, Dataform menampilkan perubahan yang tidak di-commit.

Untuk melakukan perubahan dari ruang kerja pengembangan ke repositori, ikuti langkah-langkah berikut:

  1. Di halaman Dataform, pilih repositori.
  2. Di halaman repositori, pilih ruang kerja pengembangan.
  3. Di halaman ruang kerja pengembangan, klik Commit.

  4. Di panel New commit, lakukan hal berikut:

    1. Di kolom Add a commit message, masukkan deskripsi untuk commit Anda.

    2. Pilih file yang diubah yang ingin Anda commit.

      Jika Anda tidak memilih file apa pun, Dataform akan melakukan commit pada semua perubahan lokal. Anda dapat memfilter file yang diubah menurut status file, nama file, dan jalur.

    3. Klik Commit All changes, atau Commit X changes.

      Nama tombol bergantung pada pilihan file yang akan di-commit.

Mendorong perubahan

Dataform menampilkan opsi Push setelah Anda melakukan commit perubahan. Untuk mengirim perubahan dari ruang kerja pengembangan ke repositori, ikuti langkah-langkah berikut:

  1. Di halaman Dataform, pilih repositori.
  2. Di halaman repositori, pilih ruang kerja pengembangan.
  3. Lakukan commit perubahan.
  4. Di halaman ruang kerja pengembangan, lakukan hal berikut:
    1. Jika Anda berada di repositori Dataform, klik Push to default branch.
    2. Jika Anda berada di repositori yang terhubung ke repositori Git pihak ketiga, klik Push to your-branch-name.

Mengembalikan perubahan yang belum di-commit

Untuk mengembalikan perubahan yang belum di-commit, ikuti langkah-langkah berikut:

  1. Di halaman Dataform, pilih repositori.
  2. Di halaman repositori, pilih ruang kerja pengembangan.
  3. Di atas panel Files, klik menu More, lalu pilih Revert to last commit.

Menyelesaikan konflik penggabungan

Konflik penggabungan dapat terjadi jika perubahan lokal di ruang kerja pengembangan Anda tidak kompatibel dengan perubahan yang telah dilakukan pada cabang pelacakan default repositori Anda. Konflik penggabungan biasanya terjadi saat beberapa pengguna mengedit file yang sama secara bersamaan.

Anda mengalami konflik penggabungan biasanya saat menarik dari cabang setelah pengguna lain telah mendorong perubahan yang bertentangan ke cabang yang sama. Anda perlu menyelesaikan konflik penggabungan secara manual dengan mengedit file yang terpengaruh.

Contoh kode berikut menunjukkan konflik penggabungan yang ditampilkan dalam file SQLX:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Untuk menyelesaikan konflik penggabungan, ikuti langkah-langkah berikut:

  1. Di ruang kerja pengembangan, di panel Files, pilih file yang terpengaruh.
  2. Edit file dengan perubahan yang Anda pilih.
  3. Lakukan commit perubahan.
  4. Opsional: Tekan perubahan.

Langkah selanjutnya