Mulai menggunakan integrasi Git

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

• Menyambungkan ke repositori Git
• Menerapkan perubahan
• Pembaruan dari Git
• Putuskan sambungan dari Git

Sebaiknya baca ringkasan integrasi Git sebelum Anda mulai.

Prasyarat

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

Prasyarat Kain

Untuk mengakses fitur integrasi Git, Anda memerlukan kapasitas Fabric. Kapasitas Fabric diperlukan untuk menggunakan semua elemen Fabric yang didukung. Jika Anda belum memilikinya, daftar untuk uji coba gratis. Pelanggan yang sudah memilikikapasitas Power BI Premium , dapat menggunakan kapasitas tersebut, tetapi perlu diingat bahwa SKU Power BI tertentu hanya mendukung item Power BI.

Selain itu, sakelar penyewa berikut harus diaktifkan dari portal Admin:

• Pengguna dapat membuat item Fabric
• Pengguna dapat menyinkronkan item ruang kerja dengan repositori Git mereka
• Hanya untuk pengguna GitHub: Pengguna dapat menyinkronkan item ruang kerja dengan repositori GitHub

Sakelar ini dapat diaktifkan oleh admin penyewa, admin kapasitas, atau admin ruang kerja, tergantung pada pengaturan organisasi Anda.

Prasyarat Git

Integrasi Git saat ini didukung untuk Azure DevOps dan GitHub. Untuk menggunakan integrasi Git dengan ruang kerja Fabric, Anda memerlukan hal berikut di Azure DevOps atau GitHub:

Menyambungkan ruang kerja ke repositori Git

Menyambungkan ke repositori Git

Hanya admin ruang kerja yang dapat menyambungkan ruang kerja ke repositori, 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 Repositori Azure atau GitHub, ikuti langkah-langkah berikut:

1. Masuk ke Fabric dan navigasi ke ruang kerja yang ingin Anda sambungkan.

2. Masuk ke pengaturan Ruang Kerja

   

3. Pilih Integrasi Git.

4. Pilih penyedia Git Anda. Saat ini, Azure DevOps dan GitHub didukung.

Sambungkan ke ruang kerja

Jika ruang kerja sudah tersambung ke GitHub, ikuti instruksi untuk Menyambungkan ke ruang kerja bersama.

Pilih Sambungkan 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 Menyambungkan dan menyinkronkan.

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.

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 komit.

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 terbaru. Perubahan pada folder juga diperbarui. Baca selengkapnya tentang memperbarui.

Untuk memperbarui ruang kerja, ikuti langkah-langkah berikut:

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

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

Setelah pembaruan berhasil diselesaikan, status item berubah menjadi Disinkronkan.

Memutuskan sambungan sebuah ruang kerja dari Git

Hanya admin ruang kerja yang dapat memutuskan sambungan ruang kerja dari Git 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
4. Pilih Putuskan sambungan lagi untuk mengonfirmasi.

Perizinan

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

Pertimbangan dan batasan

Batasan integrasi Git secara 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.
• Submodul tidak didukung.
• Sovereign cloud tidak didukung.

Batasan GitHub Enterprise

Beberapa pengaturan GitHub Enterprise tidak didukung. Contohnya:

• Daftar IP yang diizinkan
• Jaringan privat
• Domain kustom

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.

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.
• Struktur folder dipertahankan hingga 10 tingkat kedalaman.
• Anda tidak dapat mengunduh laporan/himpunan data sebagai .pbix dari layanan setelah menyebarkannya dengan integrasi Git.
• Jika nama tampilan item memiliki salah satu karakteristik ini, folder Git diganti namanya menjadi ID logis (Guid) dan jenis:
  • Memiliki lebih dari 256 karakter
  • Berakhir 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 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 Pengembangan

• Branch out memerlukan izin yang tercantum dalam izin tabel.
• Harus ada kapasitas yang tersedia untuk tindakan ini.
• Semua batasan penamaan workspace dan cabang berlaku saat bercabang ke workspace baru.
• Hanya item-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.
• Ketika membuat cabang baru, cabang tersebut dibuat tanpa menyalin pengaturan dari cabang asli. Sesuaikan pengaturan atau definisi apa pun untuk memastikan bahwa yang baru memenuhi kebijakan organisasi Anda.
• Saat bercabang 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 menyelesaikan item yang ingin Anda simpan sebelum membuat cabang.

Batasan sinkronisasi dan pencatatan

• Anda hanya dapat menyinkronkan satu arah pada satu waktu. Anda tidak dapat melakukan komit dan memperbarui secara bersamaan.
• Label sensitivitas tidak didukung dan mengekspor item dengan label sensitivitas mungkin dinonaktifkan. Untuk menyimpan item yang memiliki label sensitivitas tanpa menggunakan label sensitivitas, mintalah bantuan kepada administrator Anda.
• Bekerja dengan barang terbatas. Item yang tidak didukung dalam folder diabaikan.
• Nama duplikat tidak diperbolehkan. Bahkan jika Power BI mengizinkan duplikasi nama, tindakan pembaruan, komit, 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 melakukan commit perubahan pada model semantik, file bim akan tercatat sebagai telah diubah dan kolom yang dimodifikasi dipindahkan ke bagian belakang array columns. Ini karena mesin AS yang menghasilkan file bim mendorong kolom yang diganti namanya ke akhir array. Perubahan ini tidak memengaruhi cara item beroperasi.
  • Menyerahkan file yang menggunakan pemisah baris CRLF. Layanan ini menggunakan LF (umpan baris) pemutusan baris. Jika Anda memiliki file item di repositori Git dengan jeda baris CRLF, ketika Anda meng-commit dari layanan, file ini diubah menjadi LF. Misalnya, jika Anda membuka laporan di desktop, simpan file proyek (.pbip) dan unggah ke Git menggunakan CRLF.
• Menyegarkan model semantik menggunakan Enhanced refresh API menyebabkan perbedaan Git setelah setiap penyegaran.

Konten terkait

• Memahami proses integrasi Git
• Mengelola cabang Git
• Praktik terbaik integrasi Git