Mengelola ruang kerja dengan Git (pratinjau)

Artikel ini memandikan Anda melalui tugas dasar berikut di alat integrasi Git Microsoft Fabric:

Disarankan untuk membaca gambaran umum integrasi Git sebelum Anda mulai.

Penting

Fitur ini dalam pratinjau.

Prasyarat

Untuk mengintegrasikan Git dengan ruang kerja Microsoft Fabric, Anda perlu menyiapkan prasyarat berikut di Azure DevOps dan Fabric.

Prasyarat Azure DevOps

  • Akun Azure aktif yang terdaftar untuk pengguna yang sama yang menggunakan ruang kerja Fabric. Buat akun gratis.
  • Akses ke repositori yang ada.

Prasyarat Fabric

Untuk mengakses fitur integrasi Git, Anda memerlukan salah satu hal berikut:

  • Lisensi Power BI Premium. Lisensi premium Power BI hanya mendukung semua item Power BI.
  • Kapasitas fabric. Kapasitas Fabric diperlukan untuk menggunakan semua item Fabric yang didukung.

Selain itu, administrator organisasi Anda harus mengaktifkan sakelar penyewa Item Fabric dari portal Admin.

Cuplikan layar sakelar Fabric diaktifkan.

Koneksi ruang kerja ke repositori Azure

Hanya admin ruang kerja yang dapat menyambungkan ruang kerja ke Azure Repo, tetapi setelah tersambung, siapa pun yang memiliki izin dapat bekerja di ruang kerja. Jika Anda bukan admin, mintalah bantuan admin untuk menyambungkan. Untuk menyambungkan ruang kerja ke Azure Repo, ikuti langkah-langkah berikut:

  1. Masuk ke Power BI dan navigasikan ke ruang kerja yang ingin Anda sambungkan.

  2. Masuk ke pengaturan Ruang Kerja

    Cuplikan layar ruang kerja dengan ikon pengaturan ruang kerja ditampilkan di bagian atas.

    Catatan

    Jika Anda tidak melihat ikon Pengaturan ruang kerja, pilih elipsis (tiga titik) lalu pengaturan ruang kerja. Cuplikan layar ruang kerja dengan tautan pengaturan ruang kerja ditampilkan dari elipsis.

  3. Pilih Integrasi Git. Anda secara otomatis masuk ke akun Azure Repos yang terdaftar ke pengguna Microsoft Entra yang masuk ke Fabric.

    Cuplikan layar jendela pengaturan ruang kerja dengan integrasi Git dipilih.

  4. Dari menu dropdown, tentukan detail berikut tentang cabang yang ingin Anda sambungkan:

    Catatan

    Anda hanya dapat menyambungkan ruang kerja ke satu cabang dan satu folder sekaligus.

    • Organisasi
    • Proyek
    • Repositori Git
    • Cabang (Pilih cabang yang ada menggunakan menu drop-down, atau pilih + Cabang Baru untuk membuat cabang baru. Anda hanya dapat tersambung ke satu cabang pada satu waktu.)
    • Folder (Pilih folder yang sudah ada di cabang atau masukkan nama untuk membuat folder baru. Jika Anda tidak memilih folder, konten akan dibuat di folder akar. Anda hanya bisa tersambung ke satu folder pada satu waktu.)
  5. Pilih Koneksi dan sinkronkan.

Selama sinkronisasi awal, jika ruang kerja atau cabang Git kosong, konten disalin dari lokasi yang tidak kosong ke yang kosong. Jika ruang kerja dan cabang Git memiliki konten, Anda akan ditanya ke arah mana sinkronisasi harus pergi. Untuk informasi selengkapnya tentang sinkronisasi awal ini, lihat Koneksi dan sinkronisasi.

Setelah Anda tersambung, Ruang Kerja menampilkan informasi tentang kontrol sumber yang memungkinkan pengguna melihat cabang yang tersambung, status setiap item di cabang dan waktu sinkronisasi terakhir.

Cuplikan layar ikon kontrol sumber dan informasi Git lainnya.

Untuk menjaga ruang kerja Anda tetap sinkron dengan cabang Git, lakukan perubahan apa pun yang Anda buat di ruang kerja ke cabang Git, dan perbarui ruang kerja Anda setiap kali ada yang membuat penerapan baru ke cabang Git.

Menerapkan perubahan pada git

Setelah Anda berhasil tersambung ke folder Git, edit ruang kerja Anda seperti biasa. Perubahan apa pun yang Anda simpan hanya disimpan di ruang kerja. Setelah siap, Anda dapat menerapkan perubahan ke cabang Git, atau Anda dapat membatalkan perubahan dan kembali ke status sebelumnya. Baca selengkapnya tentang penerapan.

Untuk menerapkan perubahan Anda ke cabang Git, ikuti langkah-langkah berikut:

  1. Buka ruang kerja.

  2. Pilih ikon Kontrol sumber. Ikon ini memperlihatkan jumlah perubahan yang tidak dilakukan. Cuplikan layar ikon kontrol sumber dengan angka 2 yang menunjukkan bahwa ada dua perubahan yang harus diterapkan.

  3. Pilih tab Perubahan dari panel Kontrol sumber. Daftar muncul dengan semua item yang Anda ubah, dan ikon yang menunjukkan apakah item baru , dimodifikasi, konflik , atau dihapus .

  4. Pilih item yang ingin Anda terapkan. Untuk memilih semua item, centang kotak atas.

  5. Tambahkan komentar dalam kotak. Jika Anda tidak menambahkan komentar, pesan default ditambahkan secara otomatis.

  6. Pilih Terapkan.

    Cuplikan layar jendela kontrol sumber dengan dua perubahan dipilih untuk diterapkan.

Setelah perubahan diterapkan, item yang diterapkan dihapus dari daftar, dan ruang kerja akan menunjuk ke penerapan baru yang disinkronkan.

Cuplikan layar jendela kontrol sumber yang menyatakan bahwa tidak ada perubahan yang harus diterapkan.

Setelah penerapan berhasil diselesaikan, status item terpilih berubah dari Tidak Dikomit ke Disinkronkan.

Memperbarui ruang kerja dari Git

Setiap kali ada yang melakukan perubahan baru ke cabang Git yang terhubung, pemberitahuan akan muncul di ruang kerja yang relevan. Gunakan panel Kontrol sumber untuk menarik perubahan terbaru, menggabungkan, atau kembali ke ruang kerja dan memperbarui item langsung. Baca selengkapnya tentang memperbarui.

Untuk memperbarui ruang kerja, ikuti langkah-langkah berikut:

  1. Buka ruang kerja.
  2. Pilih ikon Kontrol sumber.
  3. Pilih tab Pembaruan dari panel Kontrol sumber. Daftar muncul dengan semua item yang diubah di cabang sejak pembaruan terakhir.
  4. Pilih Perbarui semua.

Cuplikan layar panel kontrol sumber dengan tab pembaruan terbuka dan tombol perbarui semua dipilih.

Setelah berhasil diperbarui, daftar item dihapus, dan ruang kerja akan menunjuk ke penerapan baru yang disinkronkan.

Cuplikan layar jendela kontrol sumber yang menyatakan bahwa Anda berhasil memperbarui ruang kerja.

Setelah pembaruan berhasil diselesaikan, status item berubah menjadi Disinkronkan.

Memutuskan sambungan ruang kerja dari Git

Hanya admin ruang kerja yang dapat memutuskan sambungan ruang kerja dari Azure Repo. Jika Anda bukan admin, mintalah bantuan admin untuk memutuskan sambungan. Jika Anda adalah admin dan ingin memutuskan sambungan repositori Anda, ikuti langkah-langkah berikut:

  1. Masuk ke pengaturan Ruang Kerja

  2. Pilih integrasi Git

  3. Pilih Putuskan sambungan ruang kerja

    Cuplikan layar pengaturan ruang kerja dengan opsi putuskan sambungan ruang kerja.

  4. Pilih Putuskan sambungan lagi untuk mengonfirmasi.

    Cuplikan layar pengaturan ruang kerja yang menanyakan apakah Anda yakin ingin memutuskan sambungan.

Izin

Tindakan yang dapat Anda ambil di ruang kerja bergantung pada izin yang Anda miliki di ruang kerja dan Azure DevOps. Untuk diskusi izin yang lebih rinci, lihat Izin.

Pertimbangan dan batasan

  • Selama proses Penerapan ke Git, layanan Fabric menghapus file apa pun di dalam folder item yang bukan bagian dari definisi item. File yang tidak terkait yang tidak ada dalam folder item tidak dihapus.

  • Setelah menerapkan perubahan, Anda mungkin melihat beberapa perubahan tak terduga pada item yang tidak Anda buat. Perubahan ini secara semantik tidak signifikan dan dapat terjadi karena beberapa alasan. Contohnya:

    • Mengubah file definisi item secara manual. Perubahan ini valid, tetapi mungkin berbeda dari jika dilakukan melalui editor. Misalnya, jika Anda mengganti nama kolom model semantik di Git dan mengimpor perubahan ini ke ruang kerja, saat berikutnya Anda menerapkan perubahan pada model semantik, file bim akan mendaftar sebagai diubah dan kolom yang dimodifikasi didorong ke bagian columns belakang array. Ini karena mesin AS yang menghasilkan file bim mendorong kolom yang diganti namanya ke akhir array. Perubahan ini tidak memengaruhi cara item beroperasi.

    • Menerapkan file yang menggunakan hentian baris CRLF . Layanan ini menggunakan hentian baris LF (umpan baris). Jika Anda memiliki file item di repositori Git dengan jeda baris CRLF , ketika Anda menerapkan dari layanan, file-file ini diubah ke LF. Misalnya, jika Anda membuka laporan di desktop, simpan proyek .pbip dan unggah ke Git menggunakan CRLF.

  • Jika Anda mengalami masalah dengan tindakan ini, pastikan Anda memahami batasan fitur integrasi Git.