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. Direktori item ini memiliki nama yang sama dengan item diikuti dengan tipe item.

Penting

Fitur ini dalam pratinjau.

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

File definisi item

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

Item berikut saat ini didukung di Microsoft Fabric:

• Notebook
• Laporan yang diberi nomor halaman
• Laporan
• Model semantik

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 paginated berisi file .rdl yang menentukan laporan paginated. RDL (Report Definition Language) adalah representasi XML dari definisi laporan yang dipaginasi.

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

Laporkan file

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.pbidataset
• file model.bim (format TMSL) ATAU folder \definition (format 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. Saat menggunakan 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 file dan item.config.json atau.platform file. Anda tidak dapat memiliki ketiga file.

Versi 2

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: Pengidentifikasi lintas ruang kerja yang dihasilkan secara otomatis yang mewakili item dan representasi kontrol sumbernya.
• type: (string) Jenis item (model semantik, laporan, dll.)
• displayName: (string) Nama item.
• description: (string opsional) Deskripsi item.

Versi 1

JIKA Anda menggunakan versi 1, Anda memiliki dua file di setiap direktori item:

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

File metadata

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

File item.metadata.json berisi atribut berikut:

• type: (string) Jenis item (model semantik, laporan, dll.)
• displayName: (string) Nama item
• description: (string opsional) Deskripsi item

Untuk mengganti nama item, ubah displayName dalam file 'item.metadata.json'. Mengubah nama folder tidak mengubah nama tampilan item di ruang kerja.

File konfigurasi

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

File item.config.json berisi atribut berikut:

• version: Nomor versi file sistem. Angka ini digunakan untuk mengaktifkan kompatibilitas mundur. Nomor versi item mungkin berbeda.
• logicalId: Pengidentifikasi lintas ruang kerja yang dihasilkan secara otomatis yang mewakili item dan representasi kontrol sumbernya.

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