Bagikan melalui

Kontrol dan penyebaran sumber buku catatan

  • Artikel

Artikel ini menjelaskan cara kerja integrasi Git dan alur penyebaran untuk notebook di Microsoft Fabric. Pelajari cara menyiapkan koneksi ke repositori Anda, mengelola buku catatan Anda, dan menyebarkannya di berbagai lingkungan.

Integrasi Notebook Git

Notebook Fabric menawarkan integrasi Git untuk kontrol sumber dengan Azure DevOps. Dengan integrasi Git, Anda dapat mencadangkan dan membuat versi notebook Anda, kembali ke tahap sebelumnya sesuai kebutuhan, berkolaborasi, atau bekerja sendiri menggunakan cabang Git, dan mengelola siklus hidup konten notebook Anda sepenuhnya dalam Fabric.

Catatan

Mulai Oktober 2024, Integrasi git Notebook mendukung pertahankan hubungan pemetaan Lingkungan terlampir saat menyinkronkan ke ruang kerja baru, yang berarti ketika Anda menerapkan buku catatan dan lingkungan terlampir bersama-sama ke repositori git, dan menyinkronkannya ke ruang kerja lain, buku catatan dan lingkungan yang baru dibuat akan terikat bersama-sama. Peningkatan ini akan berdampak pada Notebook dan Lingkungan dependen yang sudah ada versinya di git, id Fisik lingkungan terlampir dalam konten metadata buku catatan akan diganti dengan Id Logis, perubahan akan tercermin pada tampilan diff.

Menyiapkan sambungan

Dari pengaturan ruang kerja, Anda dapat dengan mudah menyiapkan koneksi ke repositori Anda untuk menerapkan dan menyinkronkan perubahan. Untuk menyiapkan koneksi, lihat Mulai menggunakan integrasi Git. Setelah tersambung, item Anda, termasuk buku catatan, muncul di panel Kontrol sumber.

Cuplikan layar panel kontrol sumber ruang kerja.

Setelah Anda berhasil menerapkan instans notebook ke repositori Git, Anda akan melihat struktur folder buku catatan di repositori.

Anda sekarang dapat menjalankan operasi di masa mendatang, seperti Membuat permintaan pull.

Representasi notebook di Git

Gambar berikut adalah contoh struktur file setiap item buku catatan dalam repositori:

Cuplikan layar struktur file repositori Git notebook.

Saat Anda menerapkan item buku catatan ke repositori Git, kode buku catatan dikonversi ke format kode sumber, bukan file .ipynb standar. Misalnya, notebook PySpark dikonversi ke file notebook-content.py. Pendekatan ini memungkinkan tinjauan kode yang lebih mudah menggunakan fitur diff bawaan.

Dalam file sumber konten item, metadata (termasuk lakehouse default dan lingkungan terlampir), sel markdown, dan sel kode dipertahankan dan dibedakan. Pendekatan ini mendukung pemulihan yang tepat saat Anda menyinkronkan kembali ke ruang kerja Fabric.

Output sel buku catatan tidak disertakan saat menyinkronkan ke Git.

Cuplikan layar format konten repositori Git notebook.

Catatan

  • Saat ini, file di sumber daya Notebook tidak diterapkan ke repositori. Menerapkan file-file ini didukung dalam rilis yang akan datang.
  • Kami menyarankan Anda untuk mengelola notebook dan lingkungan dependennya di ruang kerja yang sama, dan menggunakan git untuk mengontrol versi item notebook dan lingkungan , sistem Fabric Git akan menangani hubungan pemetaan saat menyinkronkan buku catatan dan lingkungan terlampir ke ruang kerja baru.
  • ID lakehouse default bertahan di notebook saat Anda menyinkronkan dari repositori ke ruang kerja Fabric. Jika Anda menerapkan notebook dengan lakehouse default, Anda harus merujuk item lakehouse yang baru dibuat secara manual. Untuk informasi selengkapnya, lihat Integrasi Lakehouse Git.

Notebook dalam alur penyebaran

Anda juga dapat menggunakan alur Penyebaran untuk menyebarkan kode buku catatan Anda di berbagai lingkungan, seperti pengembangan, pengujian, dan produksi. Fitur ini dapat memungkinkan Anda untuk menyederhanakan proses pengembangan Anda, memastikan kualitas dan konsistensi, dan mengurangi kesalahan manual dengan operasi kode rendah yang ringan. Anda juga dapat menggunakan aturan penyebaran untuk mengkustomisasi perilaku notebook Anda saat disebarkan, seperti mengubah lakehouse default buku catatan.

Catatan

  • Anda menggunakan desain baru alur penyebaran sekarang, UI lama dapat diakses dengan menonaktifkan 'Alur Penyebaran Baru'.
  • Mulai oktober, Notebook Fabric mendukung fitur pengikatan otomatis yang akan mengikat lakehouse default dan lingkungan terpasang dalam ruang kerja yang sama saat menyebarkan ke tahap berikutnya. Perubahan akan berdampak pada notebook yang ada dalam alur penyebaran.
    • Lakehouse default dan lingkungan terlampir (ketika semua item dependen berada di ruang kerja yang sama) akan digantikan oleh item yang baru dibuat di ruang kerja target, perubahan metadata notebook akan disorot dalam tampilan berbeda di putaran penyebaran berikutnya.
    • Anda dapat mengatur aturan penyebaran untuk lakehouse default untuk mengambil alih lakehouse yang diikat secara otomatis.
  • Masalah yang diketahui: Status sel beku di buku catatan akan hilang selama penyebaran. Saat ini kami sedang mengerjakan tugas terkait.

Gunakan langkah-langkah berikut untuk menyelesaikan penyebaran notebook Anda menggunakan alur penyebaran.

  1. Buat alur penyebaran baru atau buka alur penyebaran yang ada. (Untuk informasi selengkapnya, lihat Mulai menggunakan alur penyebaran.)

  2. Tetapkan ruang kerja ke tahap yang berbeda sesuai dengan tujuan penyebaran Anda.

  3. Pilih, tampilkan, dan bandingkan item termasuk buku catatan di antara berbagai tahap, seperti yang diperlihatkan dalam contoh berikut. Lencana yang disorot menunjukkan jumlah item yang diubah antara tahap sebelumnya dan tahap saat ini.

    Cuplikan layar notebook dalam alur penyebaran.

  4. Pilih Sebarkan untuk menyebarkan buku catatan Anda di seluruh tahap Pengembangan, Pengujian, dan Produksi.

    Cuplikan layar pilih item dan sebarkan.

    Cuplikan layar penyebaran konten pop-up.png.

  5. (Opsional.) Anda dapat memilih Aturan penyebaran untuk membuat aturan penyebaran untuk proses penyebaran. Entri aturan penyebaran berada pada tahap target untuk proses penyebaran.

    Cuplikan layar entri aturan penyebaran.

    Fabric mendukung parameterisasi lakehouse default untuk setiap instans notebook saat menyebarkan dengan aturan penyebaran. Tiga opsi tersedia untuk menentukan target default lakehouse: Sama dengan source lakehouse, N/A(no default lakehouse), dan lakehouse lainnya.

    Cuplikan layar set default lakehouse.

    Anda dapat mencapai isolasi data aman dengan menyiapkan aturan ini. Lakehouse default notebook Anda digantikan oleh yang Anda tentukan sebagai target selama penyebaran.

    Catatan

    Saat mengatur lakehouse default dalam aturan penyebaran, ID Lakehouse harus dimiliki. Anda bisa mendapatkan id lakehouse dari tautan URL item. Aturan penyebaran memiliki prioritas yang lebih tinggi daripada pengikatan otomatis, lakehouse yang diikat otomatis akan ditimpa ketika ada aturan penyebaran yang dikonfigurasi.

  6. Pantau status penyebaran dari Riwayat penyebaran.

Konten terkait