Format kodu źródłowego integracji usługi Git
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.
Nazwa katalogu
Po zapisaniu nowego elementu w usłudze Git integracja z usługą Git automatycznie tworzy katalog dla tego elementu.
Nazwa katalogu elementów jest oparta na następujących regułach:
- Wzorzec nazwy to
{display name}.{public facing type}. - W razie potrzeby zostaną wprowadzone następujące zmiany w nazwie wyświetlanej:
- Jeśli nazwa tego folderu jest niedostępna, zamiast nazwy wyświetlanej zostanie użyta nazwa logicznego identyfikatora GUID (identyfikator GUID) elementu.
Jeśli na przykład masz następujące elementy w obszarze roboczym (zwróć uwagę, że pierwsze i trzecie elementy mają odpowiednio niewidoczne miejsce wiodące i końcowe):
W repozytorium Git są tworzone następujące katalogi:
- Po utworzeniu integracja z usługą Git nigdy nie zmienia nazwy katalogu. Nawet jeśli zmienisz nazwę elementu, nazwa katalogu pozostanie taka sama.
- Jeśli ręcznie zmienisz nazwę katalogu elementów, pamiętaj, aby uwzględnić zależności elementu. Jeśli na przykład zmienisz katalog modelu semantycznego, pamiętaj, aby zaktualizować ścieżkę modelu semantycznego w pliku zależności raportu. Należy pamiętać, że lokalizacje zależności różnią się między różnymi środowiskami sieci szkieletowej. Zmiana nazwy katalogu nie powoduje zmiany przychodzącej w obszarze roboczym.
Zawartość katalogu
Każdy katalog elementów zawiera pliki definicji elementu i automatycznie generowane pliki systemowe.
Pliki definicji elementu
Katalog każdego elementu ma określone, wymagane 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 :
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
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 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.