Gestire un'area di lavoro con Git (anteprima)
Questo articolo illustra le attività di base seguenti nello strumento di integrazione Git di Microsoft Fabric:
- Connessione a un repository Git
- Eseguire il commit delle modifiche
- Aggiornamento da Git
- Disconnettersi da Git
Prima di iniziare, è consigliabile leggere la panoramica dell'integrazione di Git.
Importante
Questa funzionalità è disponibile in anteprima.
Prerequisiti
Per integrare Git con l'area di lavoro di Microsoft Fabric, è necessario configurare i prerequisiti seguenti in Azure DevOps e Fabric.
Prerequisiti di Azure DevOps
- Un account Azure attivo registrato allo stesso utente che usa l'area di lavoro Infrastruttura. Creare un account gratuito.
- Accesso a un repository esistente.
Prerequisiti dell'infrastruttura
Per accedere alla funzionalità di integrazione git, è necessario uno dei seguenti:
- Licenza di Power BI Premium. Una licenza di Power BI Premium supporta solo tutti gli elementi di Power BI.
- Capacità dell'infrastruttura. Per usare tutti gli elementi di Fabric supportati, è necessaria una capacità infrastruttura.
Inoltre, l'amministratore dell'organizzazione deve abilitare l'opzione Users can create Fabric items tenant from the Amministrazione portal (Gli utenti possono creare il tenant degli elementi dell'infrastruttura dal portale di Amministrazione).
Connessione un'area di lavoro in un repository di Azure
Solo un amministratore dell'area di lavoro può connettere un'area di lavoro a un repository di Azure, ma una volta connessa, chiunque abbia l'autorizzazione può funzionare nell'area di lavoro. Se non si è un amministratore, chiedere assistenza all'amministratore per la connessione. Per connettere un'area di lavoro a un repository di Azure, seguire questa procedura:
Accedere a Power BI e passare all'area di lavoro con cui connettersi.
Passare alle impostazioni dell'area di lavoro
Nota
Se non viene visualizzata l'icona Impostazioni area di lavoro, selezionare i puntini di sospensione (tre punti) e quindi le impostazioni dell'area di lavoro.
Selezionare Integrazione Git. Si accede automaticamente all'account Azure Repos registrato all'utente di Microsoft Entra connesso a Fabric.
Dal menu a discesa specificare i dettagli seguenti sul ramo a cui si vuole connettersi:
Nota
È possibile connettere un'area di lavoro a un ramo e a una cartella alla volta.
- Azienda
- Progetto
- Repository Git
- Ramo (selezionare un ramo esistente usando il menu a discesa oppure selezionare + Nuovo ramo per creare un nuovo ramo. È possibile connettersi a un solo ramo alla volta.
- Cartella (selezionare una cartella esistente nel ramo o immettere un nome per creare una nuova cartella. Se non si seleziona una cartella, il contenuto verrà creato nella cartella radice. È possibile connettersi a una sola cartella alla volta.
Selezionare Connessione e sincronizzazione.
Durante la sincronizzazione iniziale, se l'area di lavoro o il ramo Git è vuoto, il contenuto viene copiato dal percorso non vuoto a quello vuoto. Se sia l'area di lavoro che il ramo Git hanno contenuto, viene chiesto quale direzione deve andare la sincronizzazione. Per altre informazioni su questa sincronizzazione iniziale, vedere Connessione e sincronizzazione.
Dopo la connessione, l'area di lavoro visualizza informazioni sul controllo del codice sorgente che consente all'utente di visualizzare il ramo connesso, lo stato di ogni elemento nel ramo e l'ora dell'ultima sincronizzazione.
Per mantenere l'area di lavoro sincronizzata con il ramo Git, eseguire il commit di tutte le modifiche apportate nell'area di lavoro nel ramo Git e aggiornare l'area di lavoro ogni volta che chiunque crea nuovi commit nel ramo Git.
Eseguire il commit delle modifiche in Git
Dopo aver eseguito la connessione a una cartella Git, modificare l'area di lavoro come di consueto. Tutte le modifiche salvate vengono salvate solo nell'area di lavoro. Quando si è pronti, è possibile eseguire il commit delle modifiche nel ramo Git oppure annullare le modifiche e ripristinare lo stato precedente. Altre informazioni sui commit.
Per eseguire il commit delle modifiche nel ramo Git, seguire questa procedura:
Passare all'area di lavoro.
Selezionare l'icona controllo del codice sorgente. Questa icona mostra il numero di modifiche di cui non è stato eseguito il commit.
Selezionare la scheda Modifiche del riquadro Controllo del codice sorgente. Viene visualizzato un elenco con tutti gli elementi modificati e un'icona che indica se l'elemento è nuovo, modificato, in conflitto o eliminato.
Selezionare gli elementi di cui si vuole eseguire il commit. Per selezionare tutti gli elementi, selezionare la casella superiore.
Aggiungere un commento nella casella. Se non si aggiunge un commento, viene aggiunto automaticamente un messaggio predefinito.
Selezionare Commit.
Dopo il commit delle modifiche, gli elementi di cui è stato eseguito il commit vengono rimossi dall'elenco e l'area di lavoro punterà al nuovo commit a cui è sincronizzato.
Al termine del commit, lo stato degli elementi selezionati cambia da Non commit a Sincronizzato.
Aggiornare l'area di lavoro da Git
Ogni volta che chiunque esegue il commit di una nuova modifica al ramo Git connesso, viene visualizzata una notifica nell'area di lavoro pertinente. Usare il riquadro Controllo del codice sorgente per eseguire il pull delle modifiche più recenti, unire o ripristinare l'area di lavoro e aggiornare gli elementi live. Altre informazioni sull'aggiornamento.
Per aggiornare un'area di lavoro, seguire questa procedura:
- Passare all'area di lavoro.
- Selezionare l'icona controllo del codice sorgente.
- Selezionare la scheda Aggiornamenti del riquadro Controllo del codice sorgente. Viene visualizzato un elenco con tutti gli elementi modificati nel ramo dall'ultimo aggiornamento.
- Selezionare Aggiorna tutto.
Dopo l'aggiornamento, l'elenco degli elementi viene rimosso e l'area di lavoro punterà al nuovo commit in cui è sincronizzato.
Al termine dell'aggiornamento, lo stato degli elementi viene modificato in Sincronizzato.
Disconnettere un'area di lavoro da Git
Solo un amministratore dell'area di lavoro può disconnettere un'area di lavoro da un repository di Azure. Se non si è un amministratore, chiedere all'amministratore di assistenza per la disconnessione. Se si è un amministratore e si vuole disconnettere il repository, seguire questa procedura:
Passare alle impostazioni dell'area di lavoro
Selezionare Integrazione Git
Selezionare Disconnetti area di lavoro
Selezionare di nuovo Disconnetti per confermare.
Autorizzazioni
Le azioni che è possibile eseguire in un'area di lavoro dipendono dalle autorizzazioni disponibili sia nell'area di lavoro che in Azure DevOps. Per una descrizione più dettagliata delle autorizzazioni, vedere Autorizzazioni.
Considerazioni e limitazioni
Durante il processo Commit in Git , il servizio Fabric elimina tutti i file all'interno della cartella dell'elemento che non fanno parte della definizione dell'elemento. I file non correlati non presenti in una cartella di elementi non vengono eliminati.
Dopo aver eseguito il commit delle modifiche, è possibile notare alcune modifiche impreviste all'elemento che non è stato apportato. Queste modifiche sono semanticamente insignificanti e possono verificarsi per diversi motivi. Ad esempio:
Modifica manuale del file di definizione dell'elemento. Queste modifiche sono valide, ma potrebbero essere diverse da quelle eseguite tramite gli editor. Ad esempio, se si rinomina una colonna del modello semantico in Git e si importa questa modifica nell'area di lavoro, al successivo commit delle modifiche apportate al modello semantico, il file bim verrà registrato come modificato e la colonna modificata viene inserita nella parte posteriore della
columns
matrice. Questo perché il motore AS che genera i file bim esegue il push delle colonne rinominate alla fine della matrice. Questa modifica non influisce sul funzionamento dell'elemento.Commit di un file che utilizza interruzioni di riga CRLF . Il servizio usa interruzioni di riga LF (avanzamento riga). Se nel repository Git sono presenti file di elementi con interruzioni di riga CRLF , quando si esegue il commit dal servizio questi file vengono modificati in LF. Ad esempio, se si apre un report sul desktop, salvare il progetto con estensione pbip e caricarlo in Git usando CRLF.
Se si verificano problemi con queste azioni, assicurarsi di comprendere le limitazioni della funzionalità di integrazione Git.
Contenuto correlato
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per