Apa itu integrasi Microsoft Fabric Git?

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

Catatan

Beberapa fitur untuk integrasi Git sedang dalam tahap 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 mengelola 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. Struktur ruang kerja, termasuk subfolder , dipertahankan di repositori Git.

Lihat daftar item yang didukung .

• Pelajari dasar-dasar Git dan konsep kontrol versi.

• Baca selengkapnya tentang proses integrasi Git.

• Baca tentang cara terbaik untuk mengelola cabang Git Anda.

Keamanan jaringan untuk integrasi Git

Keamanan tingkat ruang kerja di Microsoft Fabric memberikan kontrol terperinci atas akses data dan konektivitas jaringan dengan memungkinkan administrator mengonfigurasi perlindungan masuk dan keluar untuk masing-masing ruang kerja. Kontrol ini memastikan bahwa data sensitif tetap berada dalam batas jaringan tepercaya, dan terintegrasi dengan alat CI/CD seperti integrasi Git. Untuk informasi selengkapnya, lihat Keamanan jaringan untuk integrasi berkelanjutan/penyebaran berkelanjutan

Informasi privasi

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

• Pernyataan privasi Microsoft
• Gambaran umum perlindungan Data Azure DevOps Services
• Perjanjian perlindungan Data GitHub

Penyedia Git yang didukung

Penyedia Git berikut didukung:

• Azure DevOps (hanya berbasis cloud)
• GitHub (hanya berbasis cloud)
• GitHub Enterprise (hanya berbasis cloud)

Item yang didukung

Item berikut saat ini mendukung integrasi Git:

• Elemen Rekayasa Data

  • Lingkungan
  • GraphQL
  • Lakehouse(pratinjau)
  • Notebook
  • Definisi Pekerjaan Spark
  • Fungsi Data Pengguna

• Item Ilmu Data:

  • Eksperimen pembelajaran mesin(pratinjau)
  • Model pembelajaran mesin(pratinjau)
  • Agen Data(pratinjau)

• Item-item Pabrik Data

  • Salin Pekerjaan
  • Dataflow generasi 2
  • Pipeline
  • Database terulang
  • Pasang ADF
  • Kepingan salju bercermin(pratinjau)

• Item Intelijen Waktu Nyata

  • Aktivator(pratinjau)
  • Eventhouse
  • EventStream
  • Database KQL
  • Set Kueri KQL
  • Dasbor Waktu Nyata
  • Set Skema Peristiwa(pratinjau)
  • Peta(pratinjau)
  • Deteksi anomali(pratinjau)

• Item dalam Gudang Data

  • Gudang(pratinjau)
  • Katalog Azure Databricks Cermin

• Item-item Power BI:

  • Set Metrik (pratinjau)
  • Aplikasi organisasi(pratinjau)
  • Laporan paginasi(pratinjau)
  • Laporan (kecuali laporan yang tersambung ke model semantik yang dihosting di Azure Analysis Services, SQL Server Analysis Services, atau laporan yang diekspor oleh Power BI Desktop yang bergantung pada model semantik yang dihosting di MyWorkspace) (pratinjau)
  • Model semantik (kecuali himpunan data push, koneksi langsung ke Analysis Services, model v1) (pratinjau)

• Barang-barang database:

  • Database SQL
  • Cosmos Database(pratinjau)

• Grafik:

  • Grafik di Microsoft Fabric (pratinjau)

• Solusi industri:

  • Layanan kesehatan(pratinjau)
  • Kelompok Perawatan Kesehatan (pratinjau)

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.
• Jika Anda menggunakan identitas ruang kerja dalam satu artefak dan menerapkannya ke Git, identitas tersebut dapat diperbarui (kembali ke ruang kerja fabric) hanya di ruang kerja yang terhubung ke identitas yang sama. Hati-hati, karena ini juga mempengaruhi fitur seperti cabang keluar.
• Submodul tidak didukung.
• Sovereign cloud tidak didukung.
• Jika ruang kerja Anda berisi ratusan item, pertimbangkan untuk membaginya menjadi set artefak yang lebih kecil. Setiap set harus ditempatkan di ruang kerja terpisah dan ditautkan ke cabang Git yang berbeda, atau terhubung ke satu cabang yang diatur ke dalam folder yang berbeda.

Batasan Azure DevOps

• Azure DevOps tidak didukung jika Mengaktifkan validasi kebijakan Akses Kondisional IP diaktifkan.
• Jika ruang kerja dan repositori Git berada di dua wilayah geografis yang berbeda, admin penyewa harus mengaktifkan ekspor lintas geo.
• Jika organisasi Anda mengonfigurasi akses bersyarkat, pastikan Layanan Power BI memiliki kondisi yang sama yang diatur agar autentikasi berfungsi seperti yang diharapkan.
• Batas ukuran commit berikut diterapkan:
  • 25 MB menggunakan konektor Azure DevOps dengan Service Principal.
  • 125 MB menggunakan akun Microsoft Entra ID SSO bawaan dan konektor Azure DevOps dengan Prinsipal Pengguna.

Batasan GitHub

• Hanya versi cloud GitHub yang didukung. Solusi lokal tidak didukung.
• GitHub tidak dapat memberlakukan validasi lintas geo.
• Total ukuran gabungan file yang akan dikomit sekaligus dibatasi hingga 50 MB. Oleh karena itu, jika Anda memiliki beberapa item untuk dikomit, kadang-kadang perlu untuk memisahkannya menjadi beberapa komit terpisah. Untuk informasi selengkapnya tentang mengunggah file, kunjungi panduan pemecahan masalah kami.

Batasan GitHub Enterprise

Beberapa versi dan pengaturan GitHub Enterprise tidak didukung. Contohnya:

• GitHub Enterprise Cloud dengan lokasi penyimpanan data (ghe.com)
• GitHub Enterprise Server dengan domain kustom tidak didukung, bahkan jika instans dapat diakses secara publik
• Github Enterprise Server yang dihosting di jaringan privat
• daftar IP yang diizinkan

Pertimbangan migrasi Azure DevOps ke GitHub Enterprise

Jika tim Anda menggunakan Integrasi Fabric Git dan mengevaluasi migrasi dari Azure DevOps ke GitHub Enterprise, disarankan untuk menjalankan pengujian validasi untuk memastikan fungsionalitas Integrasi Git tetap tidak terpengaruh. Integrasi Fabric Git bergantung pada API penyedia Git yang mendasar, yang berbeda dalam kemampuan dan batasan antara Azure DevOps dan GitHub Enterprise, seperti yang dijelaskan di atas.

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.
• Ruang kerja dengan aplikasi templat yang diinstal tidak dapat disambungkan ke Git.
• MyWorkspace tidak dapat tersambung ke penyedia Git.

Batasan pada cabang dan folder

• Panjang maksimum nama cabang adalah 244 karakter.
• Panjang maksimum jalur lengkap untuk nama file adalah 250 karakter. Nama yang terlalu panjang tidak berhasil.
• Ukuran file maksimum adalah 25 MB.
• Struktur folder dipertahankan hingga 10 tingkat kedalaman.
• Mengunduh laporan/himpunan data sebagai .pbix dari layanan setelah menyebarkannya dengan integrasi Git tidak disarankan, karena hasilnya tidak dapat diandalkan. Sebaiknya gunakan PowerBI Desktop untuk mengunduh laporan/himpunan data sebagai .pbix.
• Jika nama tampilan item memiliki salah satu karakteristik ini, folder Git diganti namanya menjadi ID logis (Guid) dan jenis:
  • Memiliki lebih dari 256 karakter
  • Diakhir dengan . atau spasi
  • Berisi karakter terlarang seperti yang dijelaskan dalam batasan nama direktori
• Saat Anda menyambungkan ruang kerja yang memiliki folder ke Git, Anda perlu menerapkan perubahan pada repositori Git jika struktur folder tersebut berbeda.

Batasan nama direktori

• Nama direktori yang terhubung ke repositori Git memiliki batasan penamaan berikut:

  • Nama direktori tidak dapat dimulai atau diakhapi dengan spasi atau tab.
  • Nama direktori tidak boleh berisi salah satu karakter berikut: "/:<>\*|

• Folder item (folder yang berisi file item) tidak boleh berisi salah satu karakter berikut: ":<>\*?|. Jika Anda mengganti nama folder menjadi sesuatu yang menyertakan salah satu karakter ini, Git tidak dapat menyambungkan atau menyinkronkan dengan ruang kerja dan terjadi kesalahan.

Batasan ekspansi

• Fungsi Branch Out memerlukan izin yang tercantum dalam tabel izin.
• Harus ada kapasitas yang tersedia untuk tindakan ini.
• Semua batasan penamaan ruang kerja dan cabang berlaku saat membuat ruang kerja baru.
• 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.
• Saat membuat cabang baru, cabang tersebut dibuat tanpa menyalin pengaturan dari cabang asal. Sesuaikan pengaturan atau definisi apa pun untuk memastikan bahwa yang baru memenuhi kebijakan organisasi Anda.
• Saat beralih ke ruang kerja yang ada:
  • Ruang kerja target harus mendukung koneksi Git.
  • Pengguna harus menjadi admin ruang kerja target.
  • Ruang kerja target harus memiliki kapasitas.
  • Ruang kerja tidak dapat memiliki aplikasi templat.
• Perhatikan bahwa saat Anda bercabang ke ruang kerja, item apa pun yang tidak disimpan ke Git bisa hilang. Kami menyarankan agar Anda mengkomit item apa pun yang ingin Anda simpan sebelum bercabang.

Batasan sinkronisasi dan pengikatan

• Anda hanya dapat menyinkronkan satu arah pada satu waktu. Anda tidak bisa mengkomit dan memperbarui pada saat yang sama.
• Label sensitivitas tidak didukung dan mengekspor item dengan label sensitivitas mungkin dinonaktifkan. Untuk mengirim item yang memiliki label sensitivitas tanpa memerlukan 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, penyimpanan, atau pembatalan 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.
  • Mengunggah 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, saat Anda melakukan commit dari layanan, file-file ini diubah menjadi LF. Misalnya, jika Anda membuka laporan di desktop, simpan file proyek (.pbip) dan unggah ke Git menggunakan CRLF.
• Merefresh model semantik menggunakan API refresh yang ditingkatkan menyebabkan perbedaan Git terjadi setiap kali setelah refresh.

Konten terkait

• Mulai menggunakan integrasi Git
• Memahami proses integrasi Git