Cara menggunakan integrasi Git untuk pengembangan dan penerapan gudang

Berlaku untuk: ✅ Gudang di Microsoft Fabric

Artikel ini menjelaskan cara bekerja dengan integrasi dan Fabric Data Warehouse Git Fabric.

Important

Fitur ini sedang dalam tahap pratinjau.

Ini mencakup alur kerja pengembangan umum termasuk membuat cabang, memperbarui repositori Git, menyinkronkan perubahan kembali ke ruang kerja Fabric, dan mengkomitkan perubahan gudang ke Git. Alur kerja ini membantu memungkinkan kontrol versi, kolaborasi, dan penerapan perubahan skema gudang yang terkontrol.

Alur Kerja Git untuk Fabric Data Warehouse

Dari halaman pengaturan Workspace , Anda dapat dengan mudah mengatur koneksi ke penyedia git Anda. Untuk menyiapkan koneksi, lihat Mulai menggunakan integrasi Git. Ikuti petunjuk untuk Menghubungkan ke repositori Git di Azure DevOps atau GitHub sebagai penyedia Git.

Buat atau checkout/pindah cabang

Anda dapat mengelola cabang Git untuk ruang kerja Fabric Data Warehouse Anda. Anda dapat membuat cabang baru, beralih antar cabang, atau bercabang ke ruang kerja terpisah.

Tangkapan layar dari portal Fabric pada jendela Cabang Saat Ini dan daftar dropdown.

  • Cek cabang baru: Buat cabang baru untuk pekerjaan ini. Selalu bekerja di cabang baru yang sedang beroperasi, bukan main. Untuk menyambungkan ruang kerja saat ini ke cabang baru sambil mempertahankan status ruang kerja yang ada, pilih Periksa cabang baru.

  • Cabang ke workspace lain: Untuk informasi lebih lanjut tentang membuat atau menghubungkan workspace ke cabang, lihat Kembangkan menggunakan workspace lain.

  • Beralih antar cabang yang sudah ada: Saat Anda beralih cabang, ruang kerja akan tersinkronisasi dengan cabang baru dan semua item di ruang kerja akan ditimpa. Untuk informasi lebih lanjut, lihat Beralih cabang.

Saat Anda melakukan cabang alur kerja, setiap gudang menganalisis ketergantungannya dengan gudang lain untuk menentukan urutan sinkronisasi item agar alur kerja bercabang berjalan sesuai harapan.

Pelajari selengkapnya tentang memeriksa cabang baru di Mengatasi konflik di Git.

Kembangkan secara lokal menggunakan proyek basis data

Anda dapat melakukan pengembangan lokal dengan bekerja dengan proyek database gudang dari repositori Git Anda. Anda bahkan dapat mengembangkan proyek database gudang secara offline.

  1. Kloning repositori Git yang berisi proyek database gudang.
  2. Buka proyek database secara lokal, misalnya, di Visual Studio Code dengan ekstensi proyek database SQL.
  3. Lakukan pembaruan skema atau perubahan skrip langsung di proyek database.
  4. Validasi perubahan secara lokal dengan membangun proyek basis data untuk mencegah kesalahan apa pun.
  5. Setelah pengembangan selesai, komitkan dan kirim perubahan Anda ke cabang Git jarak jauh. Setelah didorong, definisi proyek yang diperbarui dapat disinkronkan kembali ke ruang kerja Fabric melalui alur kerja integrasi Git.

Sinkronkan perubahan dari Git kembali ke workspace

Setelah menyelesaikan pengembangan di fitur atau cabang kerja (bukan di main), Anda dapat menyinkronkan definisi proyek database yang diperbarui dari Git kembali ke ruang kerja Fabric sehingga gudang mencerminkan perubahan terbaru yang disetujui.

  1. Jika Anda membuat cabang fitur sebelumnya (misalnya, saat pembuatan atau checkout cabang), pertama-tama buat pull request untuk meninjau dan menggabungkan perubahan Anda ke cabang target. Pull request hanyalah permintaan untuk menggabungkan perubahan dari satu cabang ke cabang lain.

  2. Setelah pull request digabungkan di Git, buka Source Control di ruang kerja Fabric.

  3. Perbarui atau sinkronkan workspace dari repositori Git untuk menerapkan perubahan terbaru ke gudang.

    Tangkapan layar dari portal Fabric yang menampilkan tombol Update all di jendela kontrol sumber, dan perubahan yang menunggu untuk diterapkan ke gudang.

  4. Jika terjadi konflik saat sinkronisasi perubahan antara Git dan workspace Fabric, ikuti panduan penyelesaian konflik dan selesaikan konflik.

Lakukan perubahan dan komit pembaruan gudang ke Git

Jika Anda perlu melakukan perubahan langsung ke gudang hidup, Anda masih dapat memperbarui kontrol sumber dari definisi gudang hidup.

Tip

Untuk mengelola perubahan skema dalam format terstruktur dan dikontrol versi, bekerja dengan file skema gudang dalam proyek basis data. Anda dapat merencanakan perubahan skema pada gudang, seperti yang dijelaskan dalam Kembangkan secara lokal dengan menggunakan proyek basis data, daripada melakukan perubahan secara bertahap langsung ke status gudang langsung seperti yang dijelaskan di bagian ini.

Untuk meninjau dan mengkomit perubahan Anda ke repositori Git:

  1. Untuk membuat atau memodifikasi objek gudang, jalankan pernyataan T-SQL di editor kueri SQL Fabric portal, SQL Server Management Studio (SSMS),ekstensi MSSQL untuk Visual Studio Code, atau alat kueri lainnya. Perubahan ini memperbarui skema gudang hidup.

  2. Buka Source Control di ruang kerja Fabric.

  3. Gudang yang dimodifikasi akan muncul sebagai item perubahan yang tertunda dalam daftar perubahan.

  4. Selama alur kerja branch-out atau sinkronisasi workspace-ke-Git, sistem melakukan ekstraksi skema dengan menggunakan ekstraksi inkremental berbasis DacFx. Ekstraksi skema hanya menangkap perubahan skema yang relevan. Tinjau perubahan yang terdeteksi:

    • Bandingkan definisi item gudang dengan versi cabang saat ini.
    • Validasi perbedaan skema untuk item individual atau beberapa item.
  5. Pilih item gudang yang ingin Anda komitmen.

  6. Tambahkan pesan commit dan komit perubahan ke repositori Git.

    Tangkapan layar menu kontrol sumber di portal Fabric, menampilkan dialog commit dan pesan commit opsional.

  7. Setelah berkomitmen:

    • Buka repositori Git.
    • Verifikasi perubahan melalui riwayat commit dan item proyek database yang diperbarui.

    Misalnya, sebuah commit yang menghapus Address kolom dari dbo.Customers:

    Tangkapan layar dari portal Fabric yang menunjukkan perbedaan antara kedua commit tersebut.