Gestire un repository

Questo documento mostra come eseguire le seguenti operazioni in Dataform:

Prima di iniziare

  1. Crea un repository.
  2. (Facoltativo) Collega il tuo repository a un repository Git di terze parti.
  3. Crea e inizializza uno spazio di lavoro di sviluppo nel tuo repository.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare le attività descritte in questo documento, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Configura le impostazioni di Dataform e gestisci la posizione del pacchetto principale di Dataform: Dataform Admin (roles/dataform.admin) nei repository.
  • Aggiorna il pacchetto principale di Dataform e utilizza il controllo della versione in Dataform: Editor 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.

Configura le impostazioni del flusso di lavoro Dataform

Questa sezione mostra come modificare le impostazioni di elaborazione del flusso di lavoro Dataform per un repository specifico.

Ti consigliamo di modificare il file delle impostazioni per rinominare gli schemi o aggiungere variabili di compilazione personalizzate al repository.

Informazioni sulle impostazioni del repository

Ogni repository Dataform contiene un file di impostazioni del flusso di lavoro univoco. Il file contiene l'ID progetto Google Cloud e lo schema in cui Dataform pubblica gli asset in BigQuery. Dataform utilizza impostazioni predefinite che puoi sostituire in base alle tue esigenze modificando il file delle impostazioni.

A partire da Dataform Core 3.0.0, le impostazioni di flusso di lavoro vengono memorizzate nel file workflow_settings.yaml per impostazione predefinita. Nelle versioni precedenti di Dataform Core, le impostazioni di flusso di lavoro sono memorizzate nel file dataform.json. Il file workflow_settings.yaml Nucleo di Dataform 3.0 è compatibile con le versioni precedenti del file dataform.json. Puoi continuare a utilizzare il file dataform.json per archiviare le impostazioni del flusso di lavoro. Come best practice, devi eseguire la migrazione delle impostazioni del flusso di lavoro del repository al formato workflow_settings.yaml per la compatibilità futura.

Informazioni su workflow_settings.yaml

Il file workflow_settings.yaml, introdotto in Dataform Core 3.0, memorizza le impostazioni del flusso di lavoro Dataform nel formato YAML.

Il seguente esempio di codice mostra un file workflow_settings.yaml di esempio:

  defaultProject: my-gcp-project-id
  defaultDataset: dataform
  defaultLocation: australia-southeast2
  defaultAssertionDataset: dataform_assertions

Nell'esempio di codice precedente, le coppie chiave-valore sono descritte come segue:

  • defaultProject: l'ID del tuo progetto Google Cloud BigQuery.
  • defaultDataset: il set di dati BigQuery in cui Dataform crea gli asset, chiamato dataform per impostazione predefinita.
  • defaultLocation: la regione del set di dati BigQuery predefinito. In questa posizione, Dataform elabora il codice e archivia i dati eseguiti. Questa regione di elaborazione deve corrispondere alla posizione dei set di dati BigQuery, ma non deve corrispondere alla regione del repository Dataform. Per ulteriori informazioni sulle località dei set di dati BigQuery, consulta Località dei set di dati.
  • defaultAssertionDataset: il set di dati BigQuery in cui Dataform crea viste con i risultati delle asserzioni, chiamato dataform_assertions per impostazione predefinita.

Per maggiori informazioni sulle proprietà workflow_settings.yaml, consulta WorkflowSettings su GitHub.

Puoi accedere alle proprietà definite in workflow_settings.yaml nel codice Dataform come proprietà dell'oggetto dataform.projectConfig.

Si applicano le seguenti mappature dalle opzioni workflow_settings.yaml alle opzioni dataform.projectConfig accessibili tramite codice:

  • defaultProject => defaultDatabase
  • defaultDataset => defaultSchema
  • defaultAssertionDataset => assertionSchema
  • projectSuffix => databaseSuffix
  • datasetSuffix => schemaSuffix
  • namePrefix => tablePrefix

Il seguente esempio di codice mostra l'oggetto dataform.projectConfig a cui viene fatto riferimento in un'istruzione SELECT in una vista:

  config { type: "view" }
  SELECT ${when(
    !dataform.projectConfig.tablePrefix,
    "table prefix is set!",
    "table prefix is not set!"
  )}

Informazioni su dataform.json

Il file dataform.json memorizza le impostazioni del flusso di lavoro Dataform nel formato JSON.

Il seguente esempio di codice mostra un file dataform.json di esempio:

  {
    "warehouse": "bigquery",
    "defaultDatabase": "my-gcp-project-id",
    "defaultSchema": "dataform",
    "defaultLocation": "australia-southeast2",
    "assertionSchema": "dataform_assertions"
  }

Nell'esempio di codice precedente, le coppie chiave-valore sono descritte come segue:

  • warehouse: puntatore a BigQuery, dove Dataform crea gli asset.
  • defaultDatabase: l'ID del tuo progetto Google Cloud BigQuery.
  • defaultSchema: il set di dati BigQuery in cui Dataform crea gli asset.
  • defaultLocation: la regione del set di dati BigQuery predefinito. In questa posizione, Dataform elabora il codice e archivia i dati eseguiti. Questa regione di elaborazione deve corrispondere alla posizione dei set di dati BigQuery, ma non deve corrispondere alla regione del repository Dataform. Per ulteriori informazioni sulle località dei set di dati BigQuery, consulta Località dei set di dati.
  • assertionSchema: il set di dati BigQuery in cui Dataform crea viste con i risultati delle asserzioni, chiamato dataform_assertions per impostazione predefinita.

Puoi accedere alle proprietà definite nel file dataform.json nel codice del progetto come proprietà dell'oggetto dataform.projectConfig.

Configura i nomi degli schemi

Per configurare i nomi degli schemi, devi modificare le proprietà defaultDataset e defaultAssertionSchema nel file workflow_settings.yaml o le proprietà defaultSchema e assertionSchema nel file dataform.json.

Per configurare il nome di uno schema:

workflow_settings.yaml

  1. Nella tua area di lavoro di sviluppo, fai clic sul file workflow_settings.yaml nel riquadro File.

  2. Modifica il valore di defaultDataset, defaultAssertionSchema o di entrambi.

Il seguente esempio di codice mostra un nome defaultDataset personalizzato definito nel file workflow_settings.yaml:

  ...
  defaultDataset: mytables
  ...

dataform.json

  1. Nella tua area di lavoro di sviluppo, fai clic sul file dataform.json nel riquadro File.

  2. Modifica il valore di defaultSchema, assertionSchema o di entrambi.

Il seguente esempio di codice mostra un nome defaultSchema personalizzato definito nel file dataform.json:

{
  ...
  "defaultSchema": "mytables",
  ...
}

Creare variabili di compilazione personalizzate

Le variabili di compilazione contengono valori che puoi modificare con le override di compilazione in una configurazione di release o in una richiesta dell'API Dataform.

Dopo aver definito una variabile di compilazione in workflow_settings.yaml e averla aggiunta alle tabelle selezionate, puoi modificarne il valore in una configurazione di release o nelle sostituzioni di compilazione dell'API Dataform per eseguire le tabelle in modo condizionale.

Per ulteriori informazioni sull'esecuzione condizionale delle tabelle mediante variabili di compilazione, consulta Introduzione al ciclo di vita del codice in Dataform.

Per creare una variabile di compilazione che puoi utilizzare in un repository:

workflow_settings.yaml

  1. Vai allo spazio di lavoro di sviluppo Dataform.
  2. Nel riquadro File, seleziona il file workflow_settings.yaml.
  3. Inserisci il seguente snippet di codice:

    "vars": {
      "VARIABLE":"VALUE"
    }
    

    Sostituisci quanto segue:

    • VARIABLE: un nome per la variabile
    • VALUE: il valore predefinito della variabile di compilazione

Il seguente esempio di codice mostra la variabile di compilazione myVariableName impostata su myVariableValue nel file workflow_settings.yaml:

...
vars:
  myVariableName: myVariableValue
...

Il seguente esempio di codice mostra il file workflow_settings.yaml con la variabile di compilazione executionSetting impostata su dev:

defaultProject: default_bigquery_database
defaultLocation: us-west1
defaultDataset: dataform_data,
vars:
executionSetting: dev

dataform.json

  1. Vai allo spazio di lavoro di sviluppo Dataform.
  2. Nel riquadro File, seleziona il file dataform.json.
  3. Inserisci il seguente snippet di codice:

    "vars": {
      "VARIABLE":"VALUE"
    }
    

    Sostituisci quanto segue:

    • VARIABLE: un nome per la variabile
    • VALUE: con il valore predefinito della variabile di compilazione

Il seguente esempio di codice mostra la variabile di compilazione myVariableName impostata su myVariableValue nel file dataform.json:

{
  ...
  "vars": {
    "myVariableName": "myVariableValue"
  },
  ...
}

Il seguente esempio di codice mostra il file dataform.json con la variabile di compilazione executionSetting impostata su dev:

{
"warehouse": "bigquery",
"defaultSchema": "dataform_data",
"defaultDatabase": "default_bigquery_database".
"defaultLocation":"us-west-1",
"vars": {
"executionSetting":"dev"
}
}
Aggiungere una variabile di compilazione a una tabella

Per aggiungere una variabile di compilazione a un file di definizione della tabella SQLX:

  1. Vai allo spazio di lavoro di sviluppo Dataform.
  2. Nel riquadro File, seleziona un file di definizione della tabella SQLX.
  3. Nel file, inserisci una clausola when nel seguente formato:

    ${when(dataform.projectConfig.vars.VARIABLE === "SET_VALUE", "CONDITION")}
    

    Sostituisci quanto segue:

    • VARIABLE: il nome della variabile, ad esempio executionSetting
    • SET_VALUE: un valore per la variabile, ad esempio staging
    • CONDITION: una condizione per l'esecuzione della tabella

Il seguente esempio di codice mostra un file SQLX di definizione della tabella con una clausola when e la variabile executionSetting che esegue il 10% dei dati nell'impostazione di esecuzione di staging:

  select
    *
  from ${ref("data")}
  ${when(
    dataform.projectConfig.vars.executionSetting === "staging",
    "where mod(farm_fingerprint(id) / 10) = 0",
  )}

Il seguente esempio di codice mostra un file SQLX di definizione della vista con una clausola when e la variabile myVariableName:

  config { type: "view" }
  SELECT ${when(
    dataform.projectConfig.vars.myVariableName === "myVariableValue",
    "myVariableName is set to myVariableValue!",
    "myVariableName is not set to myVariableValue!"
  )}

Esegui la migrazione delle impostazioni del flusso di lavoro in workflow_settings.yaml

Per assicurarti che il file delle impostazioni di flusso di lavoro sia compatibile con le versioni future del framework di Dataform, devi eseguire la migrazione delle impostazioni di flusso di lavoro dal file dataform.json al file workflow_settings.yaml.

Il file workflow_settings.yaml sostituisce il file dataform.json.

Se Dataform Core è l'unico pacchetto di dipendenze nel tuo repository, il file workflow_settings.yaml sostituisce anche il file package.json. Per ulteriori informazioni sulla sostituzione del file package.json con il file workflow_settings.yaml, consulta Gestire il pacchetto principale di Dataform.

La tabella seguente mostra la mappatura delle proprietà delle impostazioni di flusso di lavoro dal file dataform.json al file workflow_settings.yaml:

Proprietà a dataform.json Proprietà a workflow_settings.yaml Descrizione
assertionSchema defaultAssertionDataset Obbligatorio. Il set di dati predefinito per le asserzioni.
defaultDatabase defaultProject Obbligatorio. Il nome predefinito del Google Cloud progetto.
defaultLocation defaultLocation Obbligatorio. La posizione BigQuery predefinita in cui Dataform creerà le tabelle. Per ulteriori informazioni sulle località BigQuery, consulta Località dei set di dati.
defaultSchema defaultDataset Obbligatorio. Il set di dati predefinito.
databaseSuffix projectSuffix Facoltativo. Il suffisso da aggiungere a tutti i riferimenti del progetto. Google Cloud
schemaSuffix datasetSuffix Facoltativo. Il suffisso da aggiungere a tutti i set di dati delle azioni.
tablePrefix namePrefix Facoltativo. Il prefisso da anteporre a tutti i nomi delle azioni.
vars vars Facoltativo. Variabili definite dall'utente rese disponibili per il codice del progetto durante la compilazione. Un oggetto contenente un elenco di coppie key: value.
warehouse - Obbligatorio in dataform.json. Deve essere impostato su bigquery. Non disponibile in workflow_settings.yaml.
- dataformCoreVersion Non disponibile in dataform.json. Installato in workflow_settings.yaml per impostazione predefinita per i nuovi repository. Per saperne di più, consulta Gestire il pacchetto principale di Dataform.

Per eseguire la migrazione delle impostazioni di flusso di lavoro in workflow_settings.yaml:

  1. Nella console Google Cloud, vai alla pagina Dataform.

    Vai a Dataform

  2. Seleziona un repository e poi uno spazio di lavoro.

  3. Nel riquadro File, fai clic su AggiungiAggiungi, quindi su Crea file.

  4. Nel campo Aggiungi un percorso del file, inserisci workflow_settings.yaml.

  5. Fai clic su Crea file.

  6. Nel file workflow_settings.yaml, aggiungi le impostazioni del file dataform.json, mappate al formato YAML.

  7. Nel riquadro File, fai clic sul menu Altro accanto a dataform.json, quindi su Elimina.

  8. Per confermare l'eliminazione di dataform.json, fai clic su Elimina.

Il seguente esempio di codice mostra le impostazioni del flusso di lavoro definite in un file dataform.json:

{
  "warehouse": "bigquery",
  "defaultDatabase": "dataform-demos",
  "defaultLocation": "US",
  "defaultSchema": "dataform",
  "assertionSchema": "dataform_assertions"
  "vars": {
    "environmentName": "development"
  }
}

Il seguente esempio di codice mostra il file dataform.json precedente convertito in workflow_settings.yaml:

defaultProject: dataform-demos
defaultLocation: US
defaultDataset: dataform
defaultAssertionDataset: dataform_assertions
vars:
    environmentName: "development"

Gestire il pacchetto principale di Dataform

Questa sezione mostra come gestire il pacchetto delle dipendenze del framework Dataform core e aggiornarlo all'ultima versione.

Dataform Core è il framework Dataform open source per lo sviluppo di flussi di lavoro con SQL, SQLX e JavaScript. Come best practice, utilizza sempre la versione più recente disponibile del framework di base Dataform. Per informazioni sulle release del framework di Dataform, consulta Release di Dataform su GitHub.

Gestire la posizione del pacchetto principale di Dataform

Quando inizili la prima area di lavoro in un repository, Dataform imposta automaticamente Dataform Core come pacchetto di dipendenze. A partire da Dataform Core 3.0.0, Dataform installa il pacchetto Dataform Core nel file workflow_settings.yaml per impostazione predefinita. Nelle versioni precedenti di Dataform Core, Dataform Core era impostato nel file package.json.

In Dataform core 3.0.0 e versioni successive, se Dataform core è l'unico pacchetto nel tuo repository, devi impostarlo nel file workflow_settings.yaml. Per i repository creati con versioni precedenti di Dataform Core, sposta il pacchetto Dataform Core in workflow_settings.yaml.

Il file package.json è necessario per installare pacchetti aggiuntivi in Dataform. Se il tuo repository utilizza pacchetti aggiuntivi, imposta il pacchetto di base Dataform in package.json in modo che tutti i pacchetti siano impostati in un'unica posizione. Se il tuo repository non ha il file package.json, crea il file package.json e sposta il pacchetto Dataform core per installare pacchetti aggiuntivi.

Sposta il nucleo di Dataform in workflow_settings.yaml

Per i repository creati con versioni di Dataform Core precedenti a 3.0.0, se non hai pacchetti di dipendenze diversi da Dataform Core, devi spostare il pacchetto Dataform Core dal file package.json al file workflow_settings.yaml ed eliminare il file package.json ridondante.

Per eseguire la migrazione del pacchetto principale di Dataform dal file package.json al file workflow_settings.yaml, procedi nel seguente modo:

  1. Nella console Google Cloud, vai alla pagina Dataform.

    Vai a Dataform

  2. Seleziona un repository e poi uno spazio di lavoro.

  3. Nel riquadro File, seleziona il file workflow_settings.yaml.

  4. Nel file workflow_settings.yaml, aggiungi il pacchetto di base Dataform nel seguente formato:

    dataformCoreVersion: "VERSION"
    
    

    Sostituisci VERSION con la versione più recente di Dataform, ad esempio 3.0.0.

  5. Nel riquadro File, fai clic sul menu Altro accanto al file package.json e poi su Elimina.

  6. Per confermare l'eliminazione del file dataform.json, fai clic su Elimina.

  7. Fai clic su Installa pacchetti.

Sposta il nucleo di Dataform in package.json

Il file package.json è necessario per installare pacchetti aggiuntivi in un repository. Se il tuo repository utilizza pacchetti aggiuntivi, devi memorizzare tutti i pacchetti, incluso il pacchetto principale di Dataform, nel file package.json.

Se il tuo repository non contiene il file package.json perché il pacchetto Dataform Core è impostato nel file workflow_settings.yaml, devi creare il file package.json per installare pacchetti aggiuntivi e poi spostare il pacchetto Dataform Core dal file workflow_settings.yaml al file package.json appena creato.

Per creare il file package.json e spostare il pacchetto Dataform Core:

  1. Nella console Google Cloud, vai alla pagina Dataform.

    Vai a Dataform

  2. Seleziona un repository e poi uno spazio di lavoro.

  3. Nel riquadro File, fai clic su AggiungiAggiungi, quindi su Crea file.

  4. Nel campo Aggiungi un percorso del file, inserisci package.json.

  5. Fai clic su Crea file.

  6. Nel file package.json, aggiungi il pacchetto di base Dataform nel seguente formato:

    {
        "dependencies": {
            "@dataform/core": "VERSION"
        }
    }
    

    Sostituisci VERSION con la versione più recente di Dataform, ad esempio 3.0.0.

  7. Fai clic su Installa pacchetti.

  8. Nel riquadro File, seleziona workflow_settings.yaml.

  9. Nel file workflow_settings.yaml, elimina la proprietà dataformCoreVersion.

Aggiornare il nucleo di Dataform

Testa sempre le nuove versioni del pacchetto in un ambiente non di produzione prima di eseguire il deployment nell'ambiente di produzione.

Per aggiornare il pacchetto delle dipendenze di Dataform di base:

  1. Cerca la versione più recente di @dataform/core nella pagina delle release di Dataform su GitHub.

  2. Nella console Google Cloud, vai alla pagina Dataform.

    Vai a Dataform

  3. Seleziona un repository e poi uno spazio di lavoro.

  4. Nel riquadro File, seleziona il file package.json o il file workflow_settings.yaml.

    La posizione in cui è impostato il pacchetto delle dipendenze di Dataform core dipende dalla versione di Dataform core e dall'utilizzo dei pacchetti. Per ulteriori informazioni, consulta Gestire la posizione del pacchetto principale di Dataform.

  5. Aggiorna il pacchetto delle dipendenze di Dataform con la versione più recente:

    package.json

    {
        "dependencies": {
            "@dataform/core": "VERSION"
        }
    }
    

    Sostituisci VERSION con la versione più recente di Dataform, ad esempio 3.0.0. Per evitare problemi con l'installazione del pacchetto, specifica esplicitamente la versione del pacchetto di Dataform di base. Non utilizzare altre opzioni dependencies del file package.json, ad esempio >version.

    workflow_settings.yaml

    dataformCoreVersion: "VERSION"
    

    Sostituisci VERSION con la versione più recente di Dataform, ad esempio 3.0.0.

  6. Fai clic su Installa pacchetti.

  7. Esegui il commit delle modifiche.

  8. Esegui il push delle modifiche nel repository.

Il seguente esempio di codice mostra la dipendenza @dataform/core aggiornata alla versione 3.0.0 nel file package.json:

{
    "dependencies": {
        "@dataform/core": "3.0.0"
    }
}

Controllo della versione del codice

Questa sezione 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 nello spazio di lavoro di sviluppo. Ad esempio, Dataform visualizza 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.

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 tuo 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 il pull da your-branch-name.

Esegui il commit delle modifiche

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

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

Per eseguire il commit delle modifiche dall'area 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 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. Nell'area di lavoro di sviluppo, seleziona un file interessato nel riquadro File.
  2. Modifica il file con le modifiche scelte.
  3. Esegui il commit delle modifiche.
  4. (Facoltativo) Invia modifiche.

Passaggi successivi