Controllo della versione del codice

Questo documento mostra come usare il controllo della versione in Dataform per tenere traccia dello sviluppo.

Dataform utilizza Git per tenere traccia di ogni modifica apportata ai file all'interno di un repository.

In un repository Dataform, interagisci direttamente con il repository Git.

In un repository connesso, interagisci con il ramo di monitoraggio del repository remoto che hai configurato durante la connessione del repository.

Dataform mostra le opzioni di controllo della versione in base allo stato delle modifiche nell'area di lavoro di sviluppo. Ad esempio, Dataform mostra l'opzione di commit solo se esistono modifiche locali di cui non è stato eseguito il commit nell'area di lavoro. Se i file nell'area di lavoro sono una copia esatta del ramo predefinito o di monitoraggio, Dataform mostra lo stato L'area di lavoro è aggiornata.

Dataform mostra le seguenti opzioni di controllo della versione:

Esegui il commit di X modifiche
Esegui il commit del numero X di modifiche locali nell'area di lavoro o nei file modificati selezionati. Dataform mostra le modifiche di cui non è stato eseguito il commit.
Esegui il push al ramo predefinito
Esegui il push delle modifiche di cui hai eseguito il commit al ramo predefinito. Questa opzione è disponibile in un repository Dataform se non sono presenti modifiche di cui non è stato eseguito il commit dell'area di lavoro.
Push a your-branch-name
Esegui il push delle modifiche di cui hai eseguito il commit a your-branch-name. Questa opzione è disponibile in un repository collegato a un repository Git di terze parti se non sono presenti modifiche di cui non è stato eseguito il commit nell'area di lavoro.
Esegui il pull dal ramo predefinito
Aggiorna le aree di lavoro con le modifiche recenti del ramo predefinito. Questa opzione è disponibile in un repository Dataform se non sono presenti modifiche di cui non è stato eseguito il commit o di cui non è stato eseguito il push nell'area di lavoro.
Pull da your-branch-name
Aggiorna la tua area di lavoro con le modifiche recenti di your-branch-name. Questa opzione è disponibile in un repository collegato a un repository Git di terze parti se non sono presenti modifiche di cui non hai eseguito il commit o il push nell'area di lavoro.
Ripristina l'ultimo commit
Ripristina i file nell'area di lavoro al loro stato dall'ultimo commit.

Prima di iniziare

  1. Seleziona o Crea un repository.
  2. (Facoltativo) Connetti il repository a un repository Git di terze parti.
  3. Seleziona o Crea un'area di lavoro di sviluppo.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare il controllo della versione in Dataform, chiedi all'amministratore di concederti il ruolo IAM Editor Dataform (roles/dataform.editor) per le aree di lavoro. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Esegui il pull delle modifiche

Se l'area di lavoro di sviluppo non è sincronizzata con il repository, Dataform mostra l'opzione Pull. Per eseguire il pull delle modifiche dal repository nell'area di lavoro di sviluppo, segui questi passaggi:

  1. Nella pagina Dataform, seleziona un repository.
  2. Nella scheda Aree di lavoro di sviluppo, seleziona un'area di lavoro di sviluppo.
  3. Nella pagina dell'area di lavoro di sviluppo, segui questi passaggi:
    1. Se ti trovi in un repository Dataform, fai clic su Pull dal ramo predefinito.
    2. Se ti trovi in un repository collegato a un repository Git di terze parti, fai clic su Pull da your-branch-name.

Esegui il commit delle modifiche

Dopo aver apportato una modifica in un'area di lavoro di sviluppo, Dataform mostra l'opzione Commit. Puoi eseguire il commit di tutte le modifiche locali o dei file selezionati.

Nella finestra di dialogo Nuovo commit, Dataform mostra le modifiche di cui non è stato eseguito il commit.

Per eseguire il commit delle modifiche dall'area di lavoro di sviluppo al repository, segui questi passaggi:

  1. Nella pagina Dataform, seleziona un repository.
  2. Nella pagina del repository, seleziona un'area di lavoro di sviluppo.
  3. Nella pagina dell'area di lavoro di sviluppo, fai clic su Esegui il commit.

  4. Nel riquadro Nuovo commit, procedi nel seguente modo:

    1. Nel campo Aggiungi un messaggio di commit, inserisci una descrizione per il commit.

    2. Seleziona i file modificati di cui vuoi eseguire il commit.

      Se non selezioni alcun file, Dataform esegue il commit di tutte le modifiche locali. Puoi filtrare i file modificati in base a stato, nome e percorso.

    3. Fai clic su Esegui il commit di tutte le modifiche o Esegui il commit di X modifiche.

      Il nome del pulsante dipende dalla selezione di file di cui eseguire il commit.

Esegui il push delle modifiche

Dataform mostra l'opzione Push dopo aver eseguito il commit delle modifiche. Per eseguire il push delle modifiche dall'area di lavoro di sviluppo al repository, segui questi passaggi:

  1. Nella pagina Dataform, seleziona un repository.
  2. Nella pagina del repository, seleziona un'area di lavoro di sviluppo.
  3. Esegui il commit delle modifiche.
  4. Nella pagina dell'area di lavoro di sviluppo, segui questi passaggi:
    1. Se ti trovi in un repository Dataform, fai clic su Push al ramo predefinito.
    2. Se ti trovi in un repository collegato a un repository Git di terze parti, fai clic su Invia a your-branch-name.

Annulla modifiche di cui non è stato eseguito il commit

Per annullare le modifiche di cui non è stato eseguito il commit, segui questi passaggi:

  1. Nella pagina Dataform, seleziona un repository.
  2. Nella pagina del repository, seleziona un'area di lavoro di sviluppo.
  3. Sopra il riquadro File, fai clic sul menu Altro, quindi seleziona Ripristina l'ultimo commit.

Risolvere i conflitti di unione

Può verificarsi un conflitto di unione quando una modifica locale nell'area di lavoro di sviluppo non è compatibile con una modifica apportata al ramo di monitoraggio predefinito del repository. I conflitti di unione di solito si verificano quando più utenti modificano contemporaneamente lo stesso file.

Si verifica un conflitto di unione in genere quando esegui il pull da un ramo dopo che un utente diverso ha eseguito il push di una modifica in conflitto allo stesso ramo. Devi risolvere un conflitto di unione manualmente modificando il file interessato.

Il seguente esempio di codice mostra un conflitto di unione visualizzato in un file SQLX:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Per risolvere un conflitto di unione:

  1. Nel riquadro File dell'area di lavoro di sviluppo, seleziona un file interessato.
  2. Modifica il file con le modifiche che hai scelto.
  3. Esegui il commit delle modifiche.
  4. (Facoltativo) Esegui il push delle modifiche.

Passaggi successivi