Confronta e commit le modifiche in Fabric

L'esperienza di confronto e commit in Microsoft Fabric mostra le differenze tra la tua area di lavoro e il ramo Git connesso. Prima di effettuare un commit, annullare, aggiornare o risolvere un conflitto, puoi ispezionare i file modificati in confronto fianco a fianco o inline. Quando si esaminano le modifiche dell'area di lavoro, è possibile eseguire il commit direttamente nella stessa schermata.

Note

Quando fai commit a un Fabric element, tutti i file modificati in quell'elemento sono inclusi nel commit. Per gli elementi Fabric supportati, è possibile eseguire un commit a livello di file, permettendo di compilare file specifici all'interno dell'elemento e lasciare i file rimanenti non confermati. Il commit a livello di file è attualmente in anteprima ed è disponibile anche tramite l'API Commit To Git.

Questo articolo spiega come rivedere le modifiche dello spazio di lavoro, gli aggiornamenti Git in arrivo e i conflitti; come effettuare il commit delle modifiche dello spazio di lavoro; e comprendere gli scenari supportati e i limiti.

Cosa puoi fare

  • Rivedi le modifiche allo spazio di lavoro prima di impegnarti.
  • Eseguire il commit di elementi di Fabric o di un sottoinsieme dei file per gli elementi supportati (Anteprima).
  • Consulta le modifiche in arrivo di Git prima di aggiornare lo spazio di lavoro.
  • Confronta gli elementi in conflitto prima di risolverli.

Dove puoi rivedere le modifiche

Puoi aprire l'esperienza di confronto da più sedi. La tabella seguente riassume i punti di ingresso.

Posizione Cosa puoi recensire
Scheda Modifiche Modifiche nel workspace dall'ultima sincronizzazione con Git. Il lato del confronto relativo al workspace è evidenziato in verde.
Scheda Aggiornamenti Modifiche nel branch Git collegato dall'ultima sincronizzazione di Git. Il lato Git nel confronto è evidenziato in verde.
Dialogo sul conflitto Elementi contrastanti in tre modalità di confronto: Last sync vs. remote, Workspace vs. remote e Last sync vs. workspace.
Singolo oggetto Le differenze dell'elemento selezionato in una vista ampliata. Gli altri elementi restano compressi ma sono ancora disponibili nella finestra di dialogo.

Rivedi e commit le modifiche allo spazio di lavoro

Usa la scheda Modifiche per ispezionare le modifiche apportate nello spazio di lavoro e scegliere su cosa fare commit su Git.

  1. Nella parte superiore dell'area di lavoro, seleziona Controllo del codice sorgente e quindi la scheda Modifiche.

  2. Seleziona Rivedi e conferma le modifiche nella parte superiore del riquadro per aprire tutte le modifiche dell'area di lavoro. Per iniziare con un elemento specifico, punta verso l'elemento e seleziona Revisiona e invia modifiche accanto ad esso.

    Screenshot della scheda Modifiche con opzioni per rivedere tutte le modifiche o quelle di un singolo elemento.

  3. Nella finestra di dialogo di confronto, espandi l'elemento e rivedi i suoi file cambiati. Un'icona identifica ogni file come nuovo, modificato o cancellato. Puoi ispezionare i cambiamenti in modalità fianco a fianco o in linea. Usa l'opzione di confronto nella finestra di dialogo per passare tra una vista basata su cartelle e una vista a lista piatta degli elementi dello spazio di lavoro.

    Schermata delle differenze a livello di file per un elemento nella finestra di dialogo di confronto.

  4. Seleziona la casella a livello di elemento per includere tutti i file dell'elemento, oppure seleziona le caselle singole per includere solo quei file nel commit. I file di sistema richiesti vengono selezionati automaticamente e non possono essere esclusi dal commit.

    Note

    Il commit a livello di file è in anteprima ed è disponibile solo per gli elementi supportati nello stato Modificato .

  5. Inserisci un messaggio di commit, poi seleziona Confermi. Se hai selezionato solo alcuni file in un elemento, Fabric mostra un avviso che un commit parziale potrebbe lasciare la definizione dell'elemento incompleta o invalida. Ad esempio, eseguire il commit di una vista Warehouse senza la tabella da cui dipende può impedire l'importazione dell'elemento. Per ripristinare una definizione valida, correggi manualmente i file in Git o effettua un commit dei file rimanenti richiesti.

    Schermata di un avviso di convalida per un commit parziale a livello di singolo file.

    I file non selezionati rimangono non commessi, quindi puoi continuare a lavorarci e includerli in un commit successivo. Questo ti consente di confermare il lavoro completato senza aspettare che l'intero elemento sia pronto.

Conserva le selezioni dei file per un commit successivo

Puoi chiudere il dialogo di confronto senza perdere le selezioni dei file. Fabric mantiene i file selezionati nel riquadro controllo del codice sorgente. Un elemento parzialmente selezionato mostra una casella di spunta parzialmente selezionata, e il suo tooltip elenca i file selezionati. Puoi riaprire la finestra di dialogo di confronto o fare commit direttamente dal pannello senza selezionare di nuovo i file.

Schermata di una selezione parziale a livello di file nel riquadro del controllo del codice sorgente.

Consulta gli aggiornamenti in arrivo

Usa la scheda Aggiornamenti per ispezionare le modifiche nel ramo Git connesso prima di aggiornare lo spazio di lavoro.

  1. In cima al tuo spazio di lavoro, seleziona Controllo del codice sorgente, quindi seleziona la scheda Aggiornamenti.
  2. Seleziona Rivedi modifiche in alto nel pannello per aprire tutte le modifiche in arrivo. Per iniziare con un elemento specifico, punta l'elemento e seleziona Rivisa modifiche accanto ad esso.

Screenshot della scheda Aggiornamenti con opzioni per rivedere tutti gli aggiornamenti o l'aggiornamento per un singolo elemento.

  1. Nel dialogo di confronto, rivedi i cambiamenti in arrivo.

Screenshot degli aggiornamenti in arrivo nella finestra di dialogo di confronto.

  1. Torna alla scheda Aggiornamenti per continuare l'operazione di aggiornamento.

Esaminare i conflitti

Usa il dialogo di confronto per esaminare le differenze prima di decidere come risolvere un conflitto. Puoi aprire la finestra di confronto per un oggetto in conflitto in uno dei due modi:

  • Seleziona l'elemento in conflitto nella scheda Cambiamenti o Aggiornamenti .

  • Apri la vista di confronto dalla finestra di dialogo Risoluzione dei conflitti.

    Screenshot di una finestra di dialogo di conflitto con l'opzione di aprire la visualizzazione di confronto.

Scegli una modalità di confronto

Per un elemento in conflitto, usa il menu in alto a destra della finestra di dialogo di confronto per scegliere una di queste modalità di confronto:

  • Ultima sincronizzazione e remoto: confronta l'ultima sincronizzazione dell'area di lavoro con la versione Git e la versione attuale del branch Git connesso.

  • Workspace vs. remote: Confronta la versione attuale dello workspace con la versione Git branch connessa attuale.

  • Last sync vs. workspace: confronta l'ultima sincronizzazione dello workspace con la versione Git con le modifiche attuali della versione dello workspace.

    Screenshot della finestra di confronto per un oggetto in conflitto con tutte e tre le modalità di confronto disponibili nel menu a tendina.

Elementi che supportano il commit a livello di file

Il commit a livello di file (Anteprima) è disponibile solo per i seguenti elementi:

File di sistema e modifiche alla piattaforma

File di sistema, metadati e modifiche alle versioni della piattaforma partecipano alla sincronizzazione Git. Quando Fabric rileva una differenza in uno di questi file, segna l'elemento come Modificato e lo mostra nella scheda Modifiche o Aggiornamenti.

Le modifiche ai file di sistema sono rappresentate da / nell'elenco delle modifiche o degli aggiornamenti.

Screenshot di una modifica di file di sistema rappresentata da una barra nella lista delle modifiche.

Nella maggior parte dei casi, puoi rivedere le modifiche ai file di sistema come altre modifiche. Ad esempio, un aggiornamento di una versione della piattaforma potrebbe aggiungere ed eliminare file di sistema senza modificare il contenuto che hai modificato.

Durante un commit a livello di file, i file di sistema richiesti vengono selezionati automaticamente e non possono essere esclusi dal commit.

Per altre informazioni, vedere File di sistema generati automaticamente.

Considerazioni e limitazioni

  • La finestra di dialogo di confronto non mostra il contenuto dei file binari o di file più grandi di 1 MB.
  • Lo stato Git può rilevare un cambiamento solo di codifica, come un file caricato manualmente su Git con una codifica diversa, anche quando la finestra di dialogo di confronto non mostra differenza.
  • Il commit a livello di file è in anteprima ed è disponibile solo per gli elementi supportati nello stato Modificato .
  • Non è supportato eseguire il commit in un altro branch dalla funzione di confronto del codice, anche quando il riquadro Controllo del codice sorgente contiene una selezione parziale.