Inizia con l'integrazione di Git

Questo articolo illustra le attività di base seguenti nello strumento di integrazione Git di Microsoft Fabric:

• Connettersi a un repository Git
• Confermare le modifiche
• Aggiornamento da Git
• Disconnettersi da Git

Prima di iniziare, è consigliabile leggere la panoramica dell'integrazione di Git .

Prerequisiti

Per integrare Git con l'area di lavoro Microsoft Fabric, è necessario configurare i prerequisiti seguenti per Fabric e Git.

Prerequisiti per il tessuto

Per accedere alla funzionalità di integrazione Git, è necessaria una capacità Fabric. È necessaria una capacità di Fabric per utilizzare tutti gli elementi supportati da Fabric. Se non è ancora disponibile, iscriversi per ottenere una versione di valutazione gratuita. I clienti che hanno già una capacità Power BI Premium possono usare tale capacità, ma tenere presente che determinati SKU di Power BI supportano solo gli elementi di Power BI.

Inoltre, le seguenti opzioni del tenant devono essere abilitate dal portale di amministrazione:

• Gli utenti possono creare elementi Fabric: è necessario in caso di utilizzo di artifact Fabric
• Gli utenti possono sincronizzare gli elementi dell'area di lavoro con i propri repository Git
• Creare aree di lavoro (solo se si desidera espandere verso una nuova area di lavoro).
• Utenti possono sincronizzare gli elementi dell'area di lavoro con repository GitHub: solo per gli utenti GitHub

Queste opzioni possono essere abilitate dall'amministratore tenant, dall'amministratore di capacità o dall'amministratore dell'area di lavoro, a seconda delle impostazioni dell'organizzazione.

I prerequisiti di Git

L'integrazione git è attualmente supportata per Azure DevOps e GitHub. Per usare l'integrazione di Git con l'area di lavoro fabric, è necessario quanto segue in Azure DevOps o GitHub:

Azure DevOps

• Un account Azure DevOps Active registrato allo stesso utente Fabric (supportato anche se l'organizzazione Azure DevOps risiede in un tenant diverso da quello di Fabric). Creare un account gratuito.
• Access a un repository esistente.

GitHub

• Un account di GitHub attivo. Creare un account GitHub.

• Uno dei seguenti token di accesso personale:

  • Un token dettagliato (scelta consigliata) con autorizzazioni di lettura e scrittura dei contenuti sotto le autorizzazioni del repository:

    

    Per usare questo token con GitHub Enterprise, seguire le istruzioni these.

  • Crea un token classico di GitHub con scopi del repository abilitati:

    

Connettere un'area di lavoro a un repository Git

Connettersi a un repository Git

Solo un amministratore dell'area di lavoro può connettere un'area di lavoro a un repository, ma una volta connessi, 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 Azure o GitHub, seguire questa procedura:

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

2. Passare alle impostazioni dell'area di lavoro

   

3. Selezionare Integrazione con Git.

4. Selezionare il provider Git. Attualmente sono supportati Azure DevOps e GitHub.

Connessione a Azure DevOps

Se si seleziona Azure DevOps, selezionare Connect per accedere automaticamente all'account Azure Repos registrato all'utente di Microsoft Entra connesso a Fabric.

Se si è già eseguito l'accesso a Azure da Fabric usando un account diverso, selezionare l'account dall'elenco e selezionare Connetti.

Se è la prima volta che si accede da Fabric o si vuole aggiungere un nuovo account, selezionare Aggiungi account.

Se è la prima volta che ci si connette, è necessario autorizzare l'utente. Specificare le informazioni seguenti:

• Nome visualizzato : deve essere univoco per ogni utente
• Azure DevOps URL - URL del repository Azure DevOps. L'URL deve essere nel formato https://dev.azure.com/{organization}/{project}/_git/{repository} o https://{organization}.visualstudio.com/{project}/_git/{repo}.
• Autenticazione: è possibile eseguire l'autenticazione con OAuth2 o un principal del servizio. Per altre informazioni, vedere Azure DevOps - Integrazione git con entità servizio

Dopo aver eseguito l'accesso, selezionare Connetti per consentire a Fabric di accedere all'account

Connessione a GitHub

Se si seleziona GitHub, è necessario accedere all'account GitHub. Se è già stato eseguito l'accesso a GitHub, selezionare l'account dall'elenco e selezionare Connetti.

Se è la prima volta che si accede da Fabric o si vuole aggiungere un nuovo account, selezionare Aggiungi account.

Se è la prima volta che ci si connette, è necessario autorizzare il tuo utente GitHub. Specificare le informazioni seguenti:

• Nome visualizzato - deve essere univoco per ogni utente GitHub
• Token di accesso personale - token di accesso personale classico o granulare
• URL del repository (facoltativo per github.com, obbligatorio per ghe.com): se non si inserisce un URL, è possibile connettersi a qualsiasi repository github.com a cui si ha accesso. Se si immette un URL, è possibile connettersi solo a quel repository.

Dopo aver eseguito l'accesso, selezionare Connect per consentire a Fabric di accedere al tuo account GitHub.

Connettersi a un'area di lavoro

Se l'area di lavoro è già connessa a Azure DevOps/GitHub, seguire le istruzioni per Connessione a un'area di lavoro condivisa.

Connessione del ramo Azure DevOps

1. Dal menu a discesa specificare i dettagli seguenti sul ramo a cui ci si vuole connettere:

   • Organization
   • Project
   • 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 (digitare il nome di una cartella esistente o immettere un nome per creare una nuova cartella. Se si lascia vuoto il nome della cartella, il contenuto viene creato nella cartella radice. È possibile connettersi a una sola cartella alla volta.

Connessione ramo GitHub

1. Dal menu a discesa specificare i dettagli seguenti sul ramo a cui ci si vuole connettere:

   • URL del repository. Se si è connessi a GitHub usando un token con ambito, l'URL viene compilato automaticamente ed è possibile connettersi solo a tale repository.
   • 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 (digitare il nome di una cartella esistente o immettere un nome per creare una nuova cartella. Se si lascia vuoto il nome della cartella, il contenuto viene creato nella cartella radice. È possibile connettersi a una sola cartella alla volta.

Selezionare Connettersi e sincronizzare.

Durante la sincronizzazione iniziale, se l'area di lavoro o il ramo Git è vuoto, il contenuto viene copiato dalla posizione non vuota a quella vuota. Se sia l'area di lavoro che il ramo Git hanno contenuto, viene chiesto in quale direzione deve andare la sincronizzazione. Per altre informazioni su questa sincronizzazione iniziale, vedere Connettersi e sincronizzare.

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.

Esegui il commit delle modifiche su 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.

Effettuare il commit su Git

Per eseguire il commit delle modifiche al 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 non sottoposte a commit.

3. Selezionare Le modifiche nel pannello di controllo Del codice sorgente . Viene visualizzato un elenco con tutti gli elementi modificati e un'icona che indica se l'elemento è nuovo , modificato , conflitto , stessa modifica o eliminato .

4. Selezionare gli elementi su cui eseguire il commit. Spuntare la casella superiore per selezionare tutti gli elementi.

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 cui è stato eseguito il commit vengono rimossi dall'elenco e l'area di lavoro ora fa riferimento al nuovo commit sincronizzato.

Al termine del commit completato con successo, lo stato degli elementi selezionati cambia da Non impegnato a Sincronizzato.

Eseguire il commit su branch standalone

Il commit nel ramo autonomo è una funzionalità di integrazione Git che consente di creare un nuovo ramo ed eseguire il commit delle modifiche correnti in un'unica azione. In altre parole, invece di eseguire il commit nel ramo connesso, è possibile diramare in tempo reale: il sistema attiverà un nuovo ramo Git e salverà il lavoro senza dover uscire o passare dal ramo originale.

1. Passare all'area di lavoro.
2. Selezionare l'icona Controllo del codice sorgente. Questa icona mostra il numero di modifiche non sottoposte a commit.
3. Selezionare Le modifiche nel pannello di controllo Del codice sorgente . Viene visualizzato un elenco con tutti gli elementi modificati e un'icona che indica se l'elemento è nuovo , modificato , conflitto , stessa modifica o eliminato .
4. Selezionare gli elementi su cui eseguire il commit. Spuntare la casella superiore per selezionare tutti gli elementi.
5. Aggiungere un commento nella casella. Se non si aggiunge un commento, viene aggiunto automaticamente un messaggio predefinito.
6. Selezionare Commit to new branch (Esegui commit in un nuovo ramo).

Importante

Tenere presente quanto segue:

• il ramo appena creato non verrà connesso all'area di lavoro esistente.
• il ramo appena creato sarà basato sull'ultimo stato di sincronizzazione dell'area di lavoro corrente.
• questa funzionalità è possibile quando sono presenti aggiornamenti in ingresso, anche se il commit predefinito è disabilitato.
• Lo stato dell'area di lavoro corrente non verrà modificato a causa di questo commit e rimane invariato.

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 di tali elementi. Segui questi passaggi per annullare le modifiche:

1. Passare all'area di lavoro.

2. Selezionare il pulsante Controllo del codice sorgente . Questo pulsante mostra anche il numero di modifiche non sottoposte a commit.

3. Selezionare Modifiche nel pannello di 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. Inserire un segno di spunta nella casella I understand that workspace items may be deleted and can't be restored (Non è possibile ripristinare gli elementi dell'area di lavoro) e selezionare Annulla.

   

6. Selezionare di nuovo Annulla per confermare. La finestra di dialogo visualizzata può variare a seconda che vengano rilevati o meno elementi che verranno eliminati. La prima schermata non mostra eliminazioni. Il secondo, se vengono rilevate eliminazioni.

   

   

Gli elementi selezionati nell'area di lavoro ritornano al modo in cui erano al momento dell'ultima sincronizzazione dell'area di lavoro.

Importante

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

L'annullamento degli elementi aggiunti eliminerà definitivamente l'elemento.

Aggiorna l'area di lavoro da Git

Ogni volta che chiunque esegue il commit di una nuova modifica al ramo Git connesso, appare una notifica nell'area di lavoro pertinente. Usare il pannello controllo codice sorgente per importare le modifiche più recenti, integrare o annullare nell'area di lavoro e aggiornare gli elementi attivi. Vengono aggiornate anche le modifiche apportate alle cartelle. Altre informazioni sull'aggiornamento.

Per aggiornare un'area di lavoro, attenersi alla procedura seguente:

1. Passare all'area di lavoro.
2. Selezionare l'icona Controllo del codice sorgente.
3. Selezionare Aggiornamenti dal control panel di origine. Appare un elenco con tutti gli elementi modificati nel ramo dall'ultimo aggiornamento.
4. Selezionare Aggiorna tutto.

5. Nella finestra di dialogo di conferma selezionare Aggiorna.

Dopo l'aggiornamento, l'elenco di elementi viene rimosso e l'area di lavoro punta alla nuova area di lavoro in cui è sincronizzata.

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 Git. Se non si è un amministratore, chiedere assistenza all'amministratore 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 Disconnetti nuovamente per confermare.

Autorizzazioni

Le azioni che si possono eseguire in un'area di lavoro dipendono dalle autorizzazioni disponibili sia nell'area di lavoro che nel repository Git. Per una descrizione più dettagliata delle autorizzazioni, vedere Autorizzazioni.

Contenuto correlato

• Informazioni sul processo di integrazione con Git
• Gestire i branch di Git
• Procedure consigliate per l'integrazione di Git