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:

1. Accedere a Power BI e passare all'area di lavoro con cui connettersi.

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

3. Selezionare Integrazione Git. Si accede automaticamente all'account Azure Repos registrato all'utente di Microsoft Entra connesso a Fabric.

   

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

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

Eseguire il commit in Git

Per eseguire il commit delle modifiche nel ramo Git, seguire questa procedura:

1. Passare all'area di lavoro.

2. Selezionare l'icona controllo del codice sorgente. Questa icona mostra il numero di modifiche di cui non è stato eseguito il commit.

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

4. Selezionare gli elementi di cui si vuole eseguire il commit. Per selezionare tutti gli elementi, selezionare la casella superiore.

5. Aggiungere un commento nella casella. Se non si aggiunge un commento, viene aggiunto automaticamente un messaggio predefinito.

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

Annulla modifica salvata

Dopo aver salvato le modifiche nell'area di lavoro, se si decide di non eseguire il commit di tali modifiche in Git, è possibile annullare le modifiche e ripristinare lo stato precedente. Per annullare le modifiche, seguire questa procedura:

1. Passare all'area di lavoro.

2. Selezionare il pulsante Controllo del codice sorgente. Questo pulsante mostra anche il numero di modifiche di cui non è stato eseguito il commit.

3. 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 modificato è nuovo, modificato, conflitto o eliminato.

4. Selezionare le modifiche da annullare.

5. Selezionare Annulla.

   

6. Selezionare di nuovo Annulla per confermare.

   

Gli elementi selezionati nell'area di lavoro ripristinano la modalità di sincronizzazione dell'ultima sincronizzazione dell'area di lavoro.

Importante

Se si elimina un elemento e quindi si annullano le modifiche, l'elemento viene creato di nuovo e alcuni metadati potrebbero andarsi persi. Ad esempio, le etichette di riservatezza non vengono mantenute e devono essere reimpostate e il proprietario dell'elemento è impostato sull'utente corrente.

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:

1. Passare all'area di lavoro.
2. Selezionare l'icona controllo del codice sorgente.
3. Selezionare la scheda Aggiornamenti del riquadro Controllo del codice sorgente. Viene visualizzato un elenco con tutti gli elementi modificati nel ramo dall'ultimo aggiornamento.
4. 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:

1. Passare alle impostazioni dell'area di lavoro

2. Selezionare Integrazione Git

3. Selezionare Disconnetti area di lavoro

   

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

• Informazioni sul processo di integrazione git
• Gestire i rami Git
• Procedure consigliate per l'integrazione di Git