Bagikan melalui

Format kode sumber integrasi Git

Item di Microsoft Fabric disimpan dalam folder. Folder yang berisi item dapat berada di direktori akar atau subdirektori. Saat Anda menyambungkan ruang kerja Anda ke git, sambungkan ke folder yang berisi item. Setiap item dalam folder diwakili dalam subdirektorinya sendiri.

Nama direktori

Saat Anda menyimpan item baru di Git, integrasi Git secara otomatis membuat direktori untuk item tersebut.

Nama direktori item didasarkan pada aturan berikut:

  • Pola untuk namanya adalah {display name}.{public facing type}.
  • Jika perlu, perubahan berikut pada nama tampilan dibuat:
    • Karakter yang tidak valid diganti dengan nomor HTML.
    • Spasi di depan diganti dengan nomor HTML-nya.
    • Spasi atau titik di akhir diganti dengan nomor HTML-nya.
  • Jika nama folder tersebut tidak tersedia, nama logicalID (GUID) item digunakan alih-alih nama tampilan.

Misalnya, jika Anda memiliki item berikut di ruang kerja (perhatikan bahwa item pertama dan ketiga memiliki ruang depan dan belakang yang tidak terlihat masing-masing):

Cuplikan layar daftar item di ruang kerja Fabric.

Direktori berikut dibuat di repositori Git:

Cuplikan layar nama direktori Git yang berisi item Fabric.

  • Setelah dibuat, integrasi Git tidak pernah mengubah nama direktori. Bahkan jika Anda mengubah nama item, nama direktori tetap sama.
  • Jika Anda mengubah nama direktori item secara manual, pastikan untuk memperhitungkan dependensi item. Misalnya, jika Anda mengubah direktori model semantik maka Anda harus memastikan untuk memperbarui jalur model semantik dalam file dependensi laporan. Perlu diingat bahwa lokasi dependensi bervariasi di antara pengalaman Fabric yang berbeda. Mengubah nama direktori tidak menyebabkan perubahan masuk di ruang kerja.

Isi direktori

Setiap direktori item berisi file definisi item dan file sistem yang dihasilkan secara otomatis.

File definisi item

Setiap direktori item memiliki file tertentu yang diperlukan yang menentukan item tersebut.

Item berikut saat ini didukung di Microsoft Fabric:

Database yang direplikasi

Folder database terduplikat mengandung file .json yang menentukan database terduplikat.

Untuk petunjuk penggunaan integrasi Git dengan database yang dicerminkan, lihat CI/CD untuk database yang dicerminkan.

File buku catatan

Folder buku catatan berisi file .py :

Untuk instruksi tentang menggunakan integrasi Git dengan buku catatan, lihat Kontrol sumber buku catatan dan penyebaran.

File laporan yang dipaginasi

Folder laporan berhalaman berisi file .rdl yang menentukan laporan berhalaman. RDL (Report Definition Language) adalah representasi XML dari definisi laporan yang dipaginasi.

Untuk informasi selengkapnya tentang RDL, lihat Report Definition Language (RDL). Untuk petunjuk cara menggunakan integrasi Git dengan laporan berpaginasi, lihat Integrasi Git dengan laporan berpaginasi.

File laporan

Folder laporan berisi file berikut:

  • definition.pbir
  • report.json

Untuk informasi selengkapnya tentang folder laporan dan daftar lengkap kontennya, lihat folder laporan proyek Power BI Desktop.

File model semantik

Folder model semantik berisi file berikut:

  • definition.pbism
  • Folder \definisi dengan file TMDL

Untuk informasi selengkapnya tentang folder model semantik dan daftar lengkap kontennya, lihat folder model semantik proyek Power BI Desktop.

File sistem yang dihasilkan secara otomatis

Selain file definisi item, setiap direktori item berisi satu atau dua file sistem yang dibuat secara otomatis, tergantung pada versi mana yang Anda gunakan:

  • Direktori versi 1 berisi item.metadata.json dan item.config.json. Dengan V1, kedua file harus berada di direktori.
  • Direktori versi 2 berisi .platform. File ini mencakup konten file item.metadata.json dan item.config.json. Jika Anda memiliki file ini, Anda tidak dapat memiliki dua file lainnya. Jika Anda menggunakan versi 1 dan menerapkan perubahan, file sistem Anda akan diperbarui secara otomatis ke versi ini.

Catatan

Direktori Anda harus berisi item.metadata.json dan item.config.json file atau.platform file. Anda tidak bisa memiliki ketiga file sekaligus.

File platform

Di versi 2, alih-alih memiliki dua file sumber di setiap direktori item, file .platform menggabungkan semua informasi ke dalam satu file bersama dengan properti $schema . Jika Anda memiliki file ini, Anda tidak dapat memiliki dua file lainnya.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

File .platform berisi atribut berikut:

  • version: Nomor versi file sistem. Angka ini digunakan untuk mengaktifkan kompatibilitas mundur. Nomor versi item mungkin berbeda.
  • logicalId: (string) Pengidentifikasi lintas ruang kerja yang dihasilkan secara otomatis yang mewakili item dan representasi pengendalian sumbernya.
  • type: (string) Jenis item (model semantik, laporan, dll.)
  • displayName: (string) Nama item.
  • description: (string opsional) Deskripsi item.

Jika Anda mengganti nama artefak di ruang kerja dan folder artefak di Git memiliki akhiran '.', maka setelah komit, nama direktori dan di Git akan cocok.

LogicalId menyambungkan item di ruang kerja dengan item yang sesuai di cabang Git. Item dengan logicalId yang sama diasumsikan sama. LogicalId mempertahankan tautan meskipun nama atau direktori berubah. Karena cabang dapat disinkronkan ke beberapa ruang kerja, dimungkinkan untuk memiliki item di ruang kerja yang berbeda dengan logicalId yang sama, tetapi satu ruang kerja tidak dapat memiliki dua item dengan logicalId yang sama. LogicalId dibuat saat ruang kerja tersambung ke cabang Git atau item baru disinkronkan. LogicalId diperlukan agar integrasi Git berfungsi dengan baik. Oleh karena itu, penting untuk tidak mengubahnya dengan cara apa pun.

Catatan

Saat Anda menerapkan perubahan pada Git di versi 1, file sistem secara otomatis diperbarui ke versi 2 bersama dengan perubahan. Selain itu, setiap file baru yang diekspor dari mode pengembang Power BI Desktop akan disimpan dalam format file versi 2.

Catatan

  • Bidang jenis membedakan huruf besar/kecil. Jangan mengubah cara pembuatannya secara otomatis atau mungkin gagal.
  • Meskipun Anda umumnya tidak boleh mengubah logicalId atau nama tampilan item, satu pengecualian mungkin jika Anda membuat item baru dengan menyalin direktori item yang sudah ada. Dalam hal ini, Anda perlu mengubah logicalId dan nama tampilan menjadi sesuatu yang unik di repositori.

Konten terkait

Mulai menggunakan integrasi Git.

  • Last updated on