Formato del codice sorgente dell'integrazione Git
Gli elementi in Microsoft Fabric vengono archiviati in una cartella. La cartella contenente l'elemento può essere nella directory radice o in una sottodirectory. Quando si collega l'area di lavoro a Git, collegarsi alla cartella contenente gli elementi. Ogni elemento nella cartella è rappresentato nella propria sottodirectory.
Nome della directory
Quando si salva un nuovo elemento in Git, l'integrazione git crea automaticamente una directory per tale elemento.
Il nome della directory dell'elemento si basa sulle regole seguenti:
- Il modello per il nome è
{display name}.{public facing type}. - Se necessario, vengono apportate le modifiche seguenti al nome visualizzato:
- Se il nome della cartella non è disponibile, viene usato il nome del GUID (LogicalID) dell'elemento anziché il nome visualizzato.
Ad esempio, se sono presenti gli elementi seguenti in un'area di lavoro (si noti che il primo e il terzo elemento hanno rispettivamente uno spazio iniziale e finale invisibile):
Nel repository Git vengono create le directory seguenti:
- Una volta creata, l'integrazione Git non modifica mai il nome di una directory. Anche se si modifica il nome dell'elemento, il nome della directory rimane invariato.
- Se si modifica manualmente il nome di una directory di elementi, assicurarsi di tenere conto delle dipendenze dell'elemento. Ad esempio, se si modifica la directory di un modello semantico, è necessario assicurarsi di aggiornare il percorso di tale modello semantico nel file di dipendenza del report. Si tenga presente che le posizioni delle dipendenze variano tra diverse esperienze Fabric. La modifica del nome della directory non causa una modifica in ingresso nell'area di lavoro.
Contenuto della directory
Ogni directory di elementi contiene i file di definizione dell'elemento e i file di sistema generati automaticamente.
File di definizione dell'elemento
La directory di ogni elemento include file specifici e obbligatori che definiscono tale elemento.
Attualmente, gli elementi seguenti sono supportati in Microsoft Fabric:
File di notebook
Le cartelle del notebook contengono un file .py:
Per istruzioni sull'uso dell'integrazione Git con i notebook, vedere Controllo del codice sorgente e distribuzione del notebook.
File dei report impaginati
Le cartelle dei report impaginati contengono un file .rdl che definisce il report impaginato. Report Definition Language (RDL) è una rappresentazione XML di una definizione di report impaginato.
Per ulteriori informazioni su RDL, vedere Report Definition Language (RDL). Per istruzioni sull'uso dell'integrazione Git con i report impaginati, vedere Integrazione Git con report impaginati.
File di report
Le cartelle dei report contengono i seguenti file:
- definition.pbir
- report.json
Per ulteriori informazioni sulle cartelle dei report e un elenco completo dei relativi contenuti, vedere Cartella dei report di progetto di Power BI Desktop.
File del modello semantico
Le cartelle del modello semantico contengono i file seguenti:
- definition.pbidataset
- file model.bim (formato TMSL) O cartella \definition (formato TMDL)
Per altre informazioni sulle cartelle dei modelli semantici e un elenco completo dei relativi contenuti, vedere Cartella del modello semantico del progetto di Power BI Desktop.
File di sistema generati automaticamente
Oltre ai file di definizione dell'elemento, ciascuna directory di elementi contiene uno o due file di sistema generati automaticamente, a seconda della versione in uso:
- Una directory versione 1 contiene item.metadata.json e item.config.json. Con V1, entrambi i file devono trovarsi nella directory .
- Una directory versione 2 contiene una .piattaforma. Questo file include il contenuto dei file item.metadata.json e item.config.json. Se si dispone di tale file, non è possibile disporre degli altri due file. Se si usa la versione 1 e si esegue il commit delle modifiche, i file di sistema vengono aggiornati automaticamente in questa versione.
Nota
La directory deve contenere i file item.metadata.json e item.config.json o il file .platform. Non è possibile disporre di tutti e tre i file.
File piattaforma
Nella versione 2, invece di avere due file di origine in ciascuna directory di elementi, il file piattaforma combina tutte le informazioni in un unico file insieme a una proprietà $schema. Se si dispone di tale file, non è possibile disporre degli altri due file.
{
"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"
}
}
Il file .platform contiene i seguenti attributi:
version: numero di versione dei file di sistema. Questo numero è usato per consentire la compatibilità con le versioni precedenti. Il numero di versione dell'elemento potrebbe essere diverso.logicalId: identificatore dell'area di lavoro incrociata generato automaticamente che rappresenta un elemento e la relativa rappresentazione del controllo del codice sorgente.type: (stringa) tipo di elemento (modello semantico, report, ecc.)displayName: (stringa) il nome dell'elemento.description: (stringa facoltativa) descrizione dell'elemento.
Nota
- Il campo tipo applica la distinzione tra maiuscole e minuscole. Non modificare il modo in cui viene generato automaticamente, altrimenti potrebbe non funzionare.
- Sebbene non sia generalmente consigliabile modificare logicalId o nome visualizzato di un elemento, è possibile che si verifichi un'eccezione nel caso in cui si crei un nuovo elemento copiando una directory di elementi esistente. In tal caso, è necessario modificare logicalId e nome visualizzato in qualcosa di unico nel repository.