Bagikan melalui

Apa itu integrasi Microsoft Fabric Git?

  • Artikel

Artikel ini menjelaskan kepada pengembang cara mengintegrasikan kontrol versi Git dengan alat manajemen siklus hidup (ALM) Aplikasi Microsoft Fabric.

Catatan

Beberapa item untuk integrasi Git sedang dalam pratinjau. Untuk informasi selengkapnya, lihat daftar item yang didukung.

Integrasi Git di Microsoft Fabric memungkinkan pengembang untuk mengintegrasikan proses pengembangan, alat, dan praktik terbaik mereka langsung ke platform Fabric. Hal ini memungkinkan pengembang yang mengembangkan di Fabric untuk:

  • Mencadangkan dan membuat versi pekerjaan mereka
  • Kembali ke tahap sebelumnya sesuai kebutuhan
  • Berkolaborasi dengan orang lain atau bekerja sendiri menggunakan cabang Git
  • Menerapkan kemampuan alat kontrol sumber yang familier untuk mengelola item Fabric

Integrasi dengan kontrol sumber berada di tingkat ruang kerja. Pengembang dapat membuat versi item yang mereka kembangkan dalam ruang kerja dalam satu proses, dengan visibilitas penuh ke semua item mereka. Hanya beberapa item yang saat ini didukung, tetapi daftar item yang didukung bertambah.

  • Baca kontrol versi dan Git untuk memastikan Anda terbiasa dengan konsep Git dasar.

  • Baca selengkapnya tentang proses integrasi Git.

  • Baca tentang cara terbaik untuk mengelola cabang Git Anda.

Informasi privasi

Sebelum mengaktifkan integrasi Git, pastikan Anda meninjau pernyataan privasi berikut:

Penyedia Git yang didukung

Penyedia Git berikut didukung:

Item yang didukung

Item berikut saat ini didukung:

Jika ruang kerja atau direktori Git memiliki item yang tidak didukung, ruang kerja masih dapat disambungkan, tetapi item yang tidak didukung diabaikan. Mereka tidak disimpan atau disinkronkan, tetapi tidak dihapus juga. Mereka muncul di panel kontrol sumber tetapi Anda tidak dapat menerapkan atau memperbaruinya.

Pertimbangan dan batasan

Batasan integrasi Git umum

  • Metode autentikasi dalam Fabric harus setidaknya sekuat metode autentikasi untuk Git. Misalnya, jika Git memerlukan autentikasi multifaktor, Fabric juga perlu memerlukan autentikasi multifaktor.
  • Himpunan Data Power BI yang tersambung ke Analysis Services saat ini tidak didukung.
  • Ruang kerja dengan aplikasi templat yang diinstal tidak dapat disambungkan ke Git.
  • Sovereign cloud tidak didukung.
  • Akun Azure DevOps harus didaftarkan ke pengguna yang sama yang menggunakan ruang kerja Fabric.
  • Admin penyewa harus mengaktifkan ekspor lintas geo jika ruang kerja dan repositori Git berada di dua wilayah geografis yang berbeda.
  • Ukuran penerapan dibatasi hingga 125 MB.

Batasan GitHub Enterprise

Beberapa pengaturan GitHub Enterprise tidak didukung. Contohnya:

Batasan ruang kerja

  • Hanya admin ruang kerja yang dapat mengelola koneksi ke Git Repo seperti menyambungkan, memutuskan sambungan, atau menambahkan cabang.
    Setelah tersambung, siapa pun dengan izin dapat bekerja di ruang kerja.
  • Struktur folder ruang kerja tidak tercermin dalam repositori Git. Item ruang kerja dalam folder diekspor ke direktori akar.

Batasan cabang dan folder

  • Panjang maksimum nama cabang adalah 244 karakter.
  • Panjang maksimum jalur lengkap untuk nama file adalah 250 karakter. Nama yang lebih panjang gagal.
  • Ukuran file maksimum adalah 25 MB.
  • Anda tidak dapat mengunduh laporan/himpunan data sebagai .pbix dari layanan setelah menyebarkannya dengan integrasi Git.
  • Saat menamai folder di Git, ID logis (Guid) ditambahkan sebagai awalan sebelum jenis jika nama tampilan item:
    • Memiliki lebih dari 256 karakter
    • Diakhir dengan . atau spasi
    • Berisi salah satu karakter berikut: " / : : ? < > \ * |

Batasan pencabangan

  • Percabangan memerlukan izin yang tercantum dalam tabel izin.
  • Harus ada kapasitas yang tersedia untuk tindakan ini.
  • Semua batasan penamaan ruang kerja dan cabang berlaku saat bercabang ke ruang kerja baru.
  • Saat bercabang, ruang kerja baru dibuat dan pengaturan dari ruang kerja asli tidak disalin. Sesuaikan pengaturan atau definisi apa pun untuk memastikan bahwa ruang kerja baru memenuhi kebijakan organisasi Anda.
  • Hanya item yang didukung Git yang tersedia di ruang kerja baru.
  • Daftar cabang terkait hanya menampilkan cabang dan ruang kerja yang memiliki izin untuk dilihat.
  • Integrasi Git harus diaktifkan.

Batasan sinkronisasi dan penerapan

  • Anda hanya dapat menyinkronkan satu arah pada satu waktu. Anda tidak dapat menerapkan dan memperbarui secara bersamaan.
  • Label sensitivitas tidak didukung dan mengekspor item dengan label sensitivitas mungkin dinonaktifkan. Untuk menerapkan item yang memiliki label sensitivitas tanpa label sensitivitas, mintalah bantuan administrator Anda.
  • Bekerja dengan item terbatas. Item yang tidak didukung dalam folder diabaikan.
  • Nama duplikat tidak diperbolehkan. Bahkan jika Power BI mengizinkan duplikasi nama, tindakan pembaruan, penerapan, atau urungkan gagal.
  • B2B tidak didukung.
  • Resolusi konflik sebagian dilakukan di Git.
  • Selama proses Penerapan ke Git, layanan Fabric menghapus file 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. Misalnya:
    • 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.
  • Merefresh model semantik menggunakan API refresh yang ditingkatkan menyebabkan git berbeda setelah setiap refresh.

Konten terkait