Controllo della versione del codice

Questo documento mostra come utilizzare 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 quando sono presenti modifiche locali non committate nella tua area di lavoro. Quando i file nello spazio di lavoro sono una copia esatta del ramo predefinito o di monitoraggio, Dataform mostra lo stato Workspace is up to date (Spazio di lavoro aggiornato).

Dataform mostra le seguenti opzioni di controllo della versione:

Esegui il commit delle modifiche X
Esegui il commit del numero X di modifiche locali nello spazio di lavoro o dei file modificati selezionati. Dataform mostra le modifiche non committate.
Esegui il push sul branch predefinito
Esegui il push delle modifiche committate al ramo predefinito. Questa opzione è disponibile in un repository Dataform se non sono presenti modifiche non committate nello spazio di lavoro.
Push a your-branch-name
Esegui il push delle modifiche committate su your-branch-name. Questa opzione è disponibile in un repository collegato a un repository Git di terze parti se non sono presenti modifiche non committate nello spazio di lavoro.
Esegui il pull dal branch predefinito
Aggiorna gli spazi di lavoro con le modifiche recenti del branch predefinito. Questa opzione è disponibile in un repository Dataform se non hai modifiche non committate o non inviate nel tuo spazio di lavoro.
Pull da your-branch-name
Aggiorna lo spazio 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 non committate o non sottoposte a push nel tuo workspace.
Ripristina l'ultimo commit
Ripristina i file nello spazio di lavoro allo stato dell'ultimo commit.

Prima di iniziare

  1. Seleziona o crea un repository.
  2. (Facoltativo) Collega il tuo 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 delle versioni in Dataform, chiedi all'amministratore di concederti il ruolo IAM Editor di Dataform (roles/dataform.editor) negli spazi di lavoro. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Esegui il pull delle modifiche

Se lo spazio di lavoro di sviluppo non è sincronizzato con il repository, Dataform mostra l'opzione Pull. Per estrarre le modifiche dal repository nello spazio di lavoro di sviluppo:

  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 Spazio di lavoro di sviluppo:
    1. Se ti trovi in un repository Dataform, fai clic su Esegui il pull dal ramo predefinito.
    2. Se ti trovi in un repository collegato a un repository Git di terze parti, fai clic su Esegui pull da your-branch-name.

Esegui il commit delle modifiche

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

Nella finestra di dialogo Nuovo commit, Dataform mostra le modifiche non committate.

Per eseguire il commit delle modifiche dallo spazio di lavoro di sviluppo al repository:

  1. Nella pagina Dataform, seleziona un repository.
  2. Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
  3. Nella pagina dello spazio di lavoro di sviluppo, fai clic su Esegui commit.

  4. Nel riquadro Nuovo commit:

    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 allo stato, al nome e al percorso.

    3. Fai clic su Commit All changes (Esegui commit di tutte le modifiche) o su Commit X changes (Esegui commit di X modifiche).

      Il nome del pulsante dipende dalla selezione dei file da committare.

Eseguire il push delle modifiche

Dataform mostra l'opzione Push dopo aver eseguito il commit delle modifiche. Per eseguire il push delle modifiche dallo spazio di lavoro di sviluppo al repository:

  1. Nella pagina Dataform, seleziona un repository.
  2. Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
  3. Esegui il commit delle modifiche.
  4. Nella pagina Spazio di lavoro di sviluppo:
    1. Se ti trovi in un repository Dataform, fai clic su Esegui il push sul branch predefinito.
    2. Se ti trovi in un repository collegato a un repository Git di terze parti, fai clic su Esegui push in your-branch-name.

Annulla modifiche di cui non è stato eseguito il commit

Per ripristinare le modifiche non committate:

  1. Nella pagina Dataform, seleziona un repository.
  2. Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
  3. Sopra il riquadro File, fai clic sul menu Altro e poi seleziona Ripristina ultimo commit.

Risolvere i conflitti di unione

Un conflitto di unione può verificarsi quando una modifica locale nell'area di lavoro di sviluppo è incompatibile con una modifica apportata al ramo di monitoraggio predefinito del repository. I conflitti di unione si verificano in genere quando più utenti modificano contemporaneamente lo stesso file.

Un conflitto di unione si verifica in genere quando esegui il pull da un ramo dopo che un altro utente ha eseguito il push di una modifica in conflitto nello 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. Nella tua area di lavoro di sviluppo, nel riquadro File, seleziona un file interessato.
  2. Modifica il file con le modifiche scelte.
  3. Esegui il commit delle modifiche.
  4. (Facoltativo) Invia modifiche.

Passaggi successivi