Bagikan melalui

Format kode sumber integrasi Git

  • Artikel

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

Konten 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:

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. 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 file dan item.config.json atau .platform file. Anda tidak dapat memiliki ketiga file.

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.

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.