Share via

Format kodu źródłowego integracji usługi Git

  • Artykuł

Elementy w usłudze Microsoft Fabric są przechowywane w folderze. Folder zawierający element może znajdować się w katalogu głównym lub podkatalogu. Po połączeniu obszaru roboczego z usługą git połącz się z folderem zawierającym elementy. Każdy element w folderze jest reprezentowany we własnym podkatalogu. Te katalogi elementów mają taką samą nazwę jak element, po którym następuje typ elementu.

Zrzut ekranu przedstawiający katalog Git zawierający elementy.

Ważne

Ta funkcja jest dostępna w wersji zapoznawczej.

Każdy katalog elementów zawiera pliki definicji elementu i jeden lub dwa automatycznie wygenerowane pliki systemowe.

Pliki definicji elementu

Katalog każdego elementu ma określone obowiązkowe pliki, które definiują ten element.

Następujące elementy są obecnie obsługiwane w usłudze Microsoft Fabric:

Pliki notesu

Foldery notesu zawierają plik .py :

Zrzut ekranu przedstawiający drzewo katalogów z plikami w katalogu notesu.

Aby uzyskać instrukcje dotyczące korzystania z integracji z usługą Git z notesami, zobacz Notes source control and deployment (Kontrola źródła notesu i wdrażanie).

Pliki raportów podzielonych na strony

Foldery raportów podzielonych na strony zawierają plik rdl definiujący raport podzielony na strony. RDL (język definicji raportu) to reprezentacja XML definicji raportu podzielonego na strony.

Aby uzyskać więcej informacji o języku RDL, zobacz Report Definition Language (RDL). Aby uzyskać instrukcje dotyczące korzystania z integracji usługi Git z raportami podzielonymi na strony, zobacz Integracja usługi Git z raportami podzielonymi na strony.

Pliki raportów

Foldery raportów zawierają następujące pliki:

  • definition.pbir
  • report.json

Zrzut ekranu przedstawiający drzewo katalogów z plikami w katalogu raportu.

Aby uzyskać więcej informacji na temat folderów raportów i pełnej listy ich zawartości, zobacz Folder raportu projektu programu Power BI Desktop.

Pliki modelu semantycznego

Foldery modelu semantycznego zawierają następujące pliki:

  • definition.pbidataset
  • plik model.bim (format TMSL) LUB \definition folder (format TMDL)

Aby uzyskać więcej informacji na temat folderów modelu semantycznego i pełnej listy ich zawartości, zobacz folder semantyczny modelu projektu programu Power BI Desktop.

Automatycznie generowane pliki systemowe

Oprócz plików definicji elementów każdy katalog elementów zawiera jeden lub dwa automatycznie wygenerowane pliki systemowe, w zależności od używanej wersji:

  • Katalog w wersji 1 zawiera item.metadata.json i item.config.json. W przypadku korzystania z wersji 1 oba pliki muszą znajdować się w katalogu.
  • Katalog w wersji 2 zawiera plik .platform. Ten plik zawiera zawartość plików item.metadata.json i item.config.json. Jeśli masz ten plik, nie możesz mieć dwóch pozostałych plików. Jeśli używasz wersji 1 i zatwierdzasz zmiany, pliki systemowe są automatycznie aktualizowane do tej wersji.

Uwaga

Katalog musi zawierać item.metadata.json pliki i item.config.json lub.platform plik . Nie można mieć wszystkich trzech plików.

Plik platformy

W wersji 2 zamiast dwóch plików źródłowych w każdym katalogu elementów plik platformy łączy wszystkie informacje w jeden plik wraz z właściwością $schema . Jeśli masz ten plik, nie możesz mieć dwóch pozostałych plików.

{
    "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"
    }
}

Plik .platform zawiera następujące atrybuty:

  • version: numer wersji plików systemowych. Ta liczba służy do włączania zgodności z poprzednimi wersjami. Numer wersji elementu może być inny.
  • logicalId: automatycznie wygenerowany identyfikator między obszarami roboczymi reprezentujący element i jego reprezentację kontroli źródła.
  • type: (ciąg) Typ elementu (semantyczny model, raport itp.)
  • displayName: (ciąg) Nazwa elementu.
  • description: (ciąg opcjonalny) Opis elementu.

Uwaga

  • W polu typu jest rozróżniana wielkość liter. Nie zmieniaj sposobu automatycznego generowania lub może zakończyć się niepowodzeniem.
  • Chociaż zazwyczaj nie należy zmieniać identyfikatora logicznego lub nazwy wyświetlanej elementu, jednym wyjątkiem może być utworzenie nowego elementu przez skopiowanie istniejącego katalogu elementów. W takim przypadku należy zmienić identyfikator logiczny i nazwę wyświetlaną na unikatową w repozytorium.

Powiązana zawartość

Wprowadzenie do integracji z usługą Git.