Kontrol versi Git untuk notebook (warisan)

Penting

Dukungan integrasi Git untuk notebook lawas dihapus pada 31 Januari 2024. Databricks merekomendasikan agar Anda menggunakan folder Databricks Git untuk menyinkronkan pekerjaan Anda di Databricks dengan repositori Git jarak jauh.

Artikel ini menjelaskan cara menyiapkan kontrol versi Git untuk notebook (fitur warisan). Anda juga dapat menggunakan Databricks CLI atau Workspace API untuk mengimpor dan mengekspor notebook dan untuk melakukan operasi Git di lingkungan pengembangan lokal Anda.

Mengaktifkan dan menonaktifkan pembuatan versi Git

Secara default, kontrol versi diaktifkan. Untuk mengalihkan pengaturan ini:

  1. Buka Pengaturan>Pengaturan Ruang Kerja.
  2. Di bagian Lanjutan, nonaktifkan tombol alih Pembuatan Versi Git Notebook.

Konfigurasikan kontrol versi

Untuk mengonfigurasi kontrol versi, buat kredensial akses di penyedia Git Anda, lalu tambahkan kredensial tersebut ke Azure Databricks.

Menggunakan versi notebook

Anda mengelola versi notebook di panel Riwayat. Buka panel riwayat dengan mengklik ikon riwayat versi bilah sisi kanan.

Riwayat versi

Catatan

Anda tidak dapat memodifikasi buku catatan saat panel riwayat terbuka.

  1. Klik ikon riwayat versi di bilah samping kanan. Bilah status Git menampilkan Git: Tidak ditautkan.

    Bilah status Git

  2. Klik Git: Tidak tertaut.

    Dialog Preferensi Git tampil. Saat pertama kali Anda membuka notebook, Statusnya adalah Unlink, karena notebook tersebut tidak ada di GitHub.

    Preferensi git - tautkan buku catatan baru

  3. Di bidang Status, klik Link.

  4. Di bidang Link, tempel URL repositori GitHub.

  5. Klik turun-bawah Cabang dan pilih cabang atau ketik nama cabang baru.

  6. Di bidang Jalur di folder Git, tentukan di mana di repositori untuk menyimpan file Anda.

    Notebook Python memiliki ekstensi file default yang disarankan .py. Jika Anda menggunakan .ipynb, buku catatan Anda akan menyimpan dalam format buku catatan iPython. Jika file sudah ada di GitHub, Anda dapat langsung menyalin dan menempelkan URL file.

  7. Pilih Simpan untuk menyelesaikan link notebook Anda. Jika file ini sebelumnya tidak ada, minta dengan opsi Simpan file ini ke repo GitHub Anda akan ditampilkan.

  8. Ketik sebuah pesan dan klik Simpan.

Menyimpan buku catatan untuk GitHub

Meskipun perubahan yang Anda buat pada buku catatan Anda disimpan secara otomatis ke riwayat versi Azure Databricks, perubahan tidak secara otomatis bertahan pada GitHub.

  1. Klik ikon riwayat versi di bilah samping kanan untuk membuka panel riwayat.

    Panel riwayat - simpan sekarang

  2. Klik Simpan Sekarang untuk menyimpan buku catatan Anda ke GitHub. Dialog "Simpan Versi Buku Catatan" muncul.

  3. Secara opsional, masukkan pesan untuk menjelaskan perubahan Anda.

  4. Pastikan Juga komit ke Git dipilih.

    Simpan versi

  5. Klik Simpan.

Mengembalikan atau memperbarui buku catatan ke versi dari GitHub

Setelah Anda menautkan buku catatan, Azure Databricks menyinkronkan riwayat Anda dengan Git setiap kali Anda membuka kembali panel riwayat. Versi yang disinkronkan dengan Git memiliki hash komit sebagai bagian dari entri.

  1. Klik ikon riwayat versi di bilah samping kanan untuk membuka panel riwayat.

    Panel riwayat

  2. Pilih entri di panel riwayat. Azure Databricks menampilkan versi itu.

  3. Klik Pulihkan versi ini.

  4. Klik Konfirmasi untuk mengonfirmasi bahwa Anda ingin memulihkan versi tersebut.

  1. Klik ikon riwayat versi di bilah samping kanan untuk membuka panel riwayat.

  2. Bilah status Git menampilkan Git: Sinkron.

    Panel riwayat - gambar simpan sekarang

  3. Klik Git: Disinkronkan.

    Preferensi git - batalkan tautan buku catatan

  4. Dalam dialog Preferensi Git, klik Batalkan tautan.

  5. Klik Simpan.

  6. Klik Konfirmasi untuk mengonfirmasi bahwa Anda ingin memutuskan tautan notebook dari kontrol versi.

Gunakan cabang

Anda dapat bekerja di cabang repositori mana pun dan membuat cabang baru di dalam Azure Databricks.

Membuat cabang

  1. Klik ikon riwayat versi di bilah samping kanan untuk membuka panel riwayat.

  2. Klik bilah status Git untuk membuka panel GitHub.

  3. Klik menu tarik-turun Branch.

  4. Masukkan nama cabang.

    Buat cabang

  5. Pilih opsi Buat Cabang di bagian bawah menu tarik-turun. Cabang induk ditunjukkan. Anda selalu bercabang dari cabang yang Anda pilih saat ini.

Buat pull request

  1. Klik ikon riwayat versi di bilah samping kanan untuk membuka panel riwayat.

  2. Klik bilah status Git untuk membuka panel GitHub.

    Preferensi git - buat permintaan pull

  3. Klik Create PR. GitHub membuka halaman pull request untuk branch tersebut.

Menentukan ulang dasar cabang

Anda juga dapat menentukan ulang dasar cabang Anda di dalam Azure Databricks. Tautan Rebase ditampilkan jika ada commit baru di cabang induk. Hanya pembentukan dasar ulang di atas cabang default repositori induk yang didukung.

Rebase

Misalnya, asumsikan bahwa Anda sedang mengerjakan databricks/reference-apps. Anda mem-fork-nya ke akun Anda sendiri (misalnya, brkyvz) dan mulai bekerja pada cabang yang disebut my-branch. Jika pembaruan baru didorong ke databricks:master, tombol Rebase akan ditampilkan, dan Anda akan dapat mengambil perubahan ke cabang brkyvz:my-branch Anda.

Rebasing bekerja sedikit berbeda di Azure Databricks. Asumsikan struktur cabang berikut:

Struktur cabang sebelum rebase

Setelah rebase, struktur cabang terlihat seperti:

Struktur cabang setelah rebase

Apa yang berbeda di sini adalah bahwa Commits C5 dan C6 tidak berlaku di atas C4. Mereka muncul sebagai perubahan lokal di buku catatan Anda. Konflik penggabungan muncul sebagai berikut:

Gabungkan konflik

Anda kemudian dapat berkomitmen untuk GitHub sekali lagi menggunakan tombol Simpan Sekarang.

Apa yang terjadi jika seseorang bercabang dari cabang saya yang baru saja saya tentukan ulang dasarnya?

Jika cabang Anda (misalnya, branch-a) adalah basis untuk cabang lain (branch-b), dan Anda menentukan ulang dasar, Anda tidak perlu khawatir! Setelah pengguna juga melakukan rebase pada branch-b, semuanya akan berjalan dengan baik. Praktik terbaik dalam situasi ini adalah menggunakan cabang terpisah untuk setiap notebook.

Praktik terbaik untuk tinjauan kode

Azure Databricks mendukung percabangan Git.

  • Anda dapat menautkan buku catatan ke cabang mana pun di repositori. Azure Databricks merekomendasikan penggunaan cabang terpisah untuk setiap buku catatan.
  • Selama proses pengembangan, Anda dapat menautkan notebook ke fork repositori atau ke cabang non-default di repositori utama. Untuk mengintegrasikan perubahan di hulu, Anda dapat menggunakan tautan Buat PR dalam dialog Preferensi Git di Azure Databricks untuk membuat permintaan tarik GitHub. Tautan Buat PR hanya muncul jika Anda tidak sedang bekerja di repositori induk pada cabang default.

Pemecahan Masalah

Jika Anda menerima kesalahan yang terkait menyinkronkan riwayat GitHub, verifikasi hal berikut:

  • Anda hanya bisa menautkan buku catatan ke repositori Git yang diinisialisasi yang tidak kosong. Uji URL di browser web.
  • Token akses pribadi GitHub harus aktif.
  • Untuk menggunakan repositori GitHub privat, Anda harus memiliki izin untuk membaca repositori.
  • Jika buku catatan ditautkan ke cabang GitHub yang diganti namanya, perubahan tidak secara otomatis tercermin di Azure Databricks. Anda harus menautkan ulang notebook ke cabang secara manual.

Bermigrasi ke folder Databricks Git

Pengguna yang perlu bermigrasi ke folder Databricks Git dari kontrol versi Git warisan dapat menggunakan panduan berikut:

  • Last updated on