Mengontrol versi kode Anda

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

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

Di repositori Dataform, Anda berinteraksi langsung dengan repositori Git.

Dalam repositori yang terhubung, Anda berinteraksi dengan cabang pelacakan dari repositori jarak jauh yang Anda konfigurasikan selama menghubungkan repositori.

Dataform menampilkan opsi kontrol versi berdasarkan status perubahan di ruang kerja pengembangan Anda. Misalnya, Dataform menampilkan opsi commit hanya ketika ada perubahan lokal yang tidak di-commit di ruang kerja Anda. Jika file di ruang kerja Anda merupakan salinan persis dari cabang default atau pelacakan, Dataform akan menampilkan status Workspace is up to date.

Dataform menampilkan opsi kontrol versi berikut:

Lakukan X perubahan
Commit jumlah perubahan lokal X di ruang kerja Anda atau file yang diubah yang dipilih. Dataform menampilkan perubahan yang tidak di-commit.
Kirim ke cabang default
Kirim perubahan yang di-commit ke cabang default Anda. Opsi ini tersedia di repositori Dataform jika Anda tidak memiliki perubahan yang tidak di-commit di ruang kerja Anda.
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 tidak ada perubahan yang tidak di-commit di ruang kerja Anda.
Ambil dari cabang default
Perbarui ruang kerja Anda dengan perubahan terbaru dari cabang default. Opsi ini tersedia di repositori Dataform jika Anda tidak memiliki perubahan commit yang tidak di-commit atau tidak didorong di ruang kerja Anda.
Ambil 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 commit yang tidak di-commit atau tidak didorong di ruang kerja Anda.
Kembalikan ke commit terakhir
Pulihkan file di ruang kerja Anda ke status dari commit terakhir Anda.

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 Anda perlukan untuk 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.

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

Perubahan pull

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

  1. Di halaman Dataform, pilih repositori.
  2. Di tab Development workspace, 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 dalam repositori yang terhubung ke repositori Git pihak ketiga, klik Pull from your-branch-name.

Commit perubahan

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

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

Untuk meng-commit 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 telah diubah yang ingin Anda commit.

      Jika Anda tidak memilih file apa pun, Dataform meng-commit semua perubahan lokal. Anda dapat memfilter file yang diubah berdasarkan 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.

Perubahan push

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

  1. Di halaman Dataform, pilih repositori.
  2. Di halaman repositori, pilih ruang kerja pengembangan.
  3. 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 dalam repositori yang terhubung ke repositori Git pihak ketiga, klik Push to your-branch-name.

Mengembalikan perubahan yang tidak di-commit

Untuk mengembalikan perubahan yang tidak 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.

Mengatasi konflik penggabungan

Konflik penggabungan dapat terjadi jika perubahan lokal di ruang kerja pengembangan Anda tidak kompatibel dengan perubahan yang telah dibuat 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 yang berbeda mengirim perubahan yang bertentangan ke cabang yang sama. Anda perlu mengatasi konflik penggabungan secara manual dengan mengedit file yang terpengaruh.

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

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

Untuk mengatasi 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. Commit perubahan.
  4. Opsional: Perubahan push.

Langkah selanjutnya