Questa pagina è stata tradotta dall'API Cloud Translation.

Gestire un repository

Questo documento mostra come eseguire le seguenti operazioni in Dataform:

Configura le impostazioni del flusso di lavoro Dataform.
Gestisci il pacchetto principale Dataform.
Controlla la versione del codice.

Prima di iniziare

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 Dataform core: Amministrazione Dataform (roles/dataform.admin) sui repository.
Aggiorna il pacchetto Dataform Core e utilizza il controllo della versione in Dataform: Editor Dataform (roles/dataform.editor) sui workspace.

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci 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 workflow Dataform

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

Potresti voler modificare il file delle impostazioni per rinominare gli schemi o aggiungere variabili di compilazione personalizzate al tuo 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 ignorare per adattarle al meglio alle tue esigenze modificando il file delle impostazioni.

A partire da Dataform Core 3.0.0, le impostazioni del workflow vengono archiviate per impostazione predefinita nel file workflow_settings.yaml. Nelle versioni precedenti di Dataform Core, le impostazioni del workflow sono memorizzate nel file dataform.json. Il file Dataform core 3.0 workflow_settings.yaml è 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 migrare le impostazioni del flusso di lavoro del repository nel 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: il tuo ID progetto BigQuery Google Cloud .
defaultDataset: il set di dati BigQuery in cui Dataform crea gli asset, denominato dataform per impostazione predefinita.
defaultLocation (facoltativo): la località del set di dati BigQuery predefinito. Dataform utilizza questa posizione per elaborare il codice e archiviare i risultati. Questa località di elaborazione deve corrispondere a quella dei tuoi set di dati BigQuery. Tuttavia, non deve corrispondere alla posizione del repository Dataform.

Se non imposti il parametro defaultLocation, Dataform determina la posizione in base ai set di dati a cui fa riferimento la query SQL. Ecco come funziona:
- Se la query fa riferimento a set di dati della stessa località, Dataform utilizza quella località.
- Se la query fa riferimento a set di dati di due o più località diverse, si verifica un errore. Per informazioni dettagliate su questa limitazione, vedi Replica dei set di dati tra regioni.
- Se la query non fa riferimento a nessun set di dati, la località predefinita per Dataform è la multi-regione US. Per scegliere una località diversa, imposta la località predefinita. In alternativa, utilizza la variabile di sistema @@location nella query. Per ulteriori informazioni, consulta Specificare le posizioni.
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 i seguenti mapping 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: un puntatore a BigQuery, dove Dataform crea gli asset.
defaultDatabase: il tuo ID progetto BigQuery Google Cloud .
defaultSchema: il set di dati BigQuery in cui Dataform crea gli asset.
defaultLocation (facoltativo): la località del set di dati BigQuery predefinito. Dataform utilizza questa posizione per elaborare il codice e archiviare i risultati. Questa località di elaborazione deve corrispondere a quella dei tuoi set di dati BigQuery. Tuttavia, non deve corrispondere alla posizione del repository Dataform.

Se non imposti il parametro defaultLocation, Dataform determina la posizione in base ai set di dati a cui fa riferimento la query SQL. Ecco come funziona:
- Se la query fa riferimento a set di dati della stessa località, Dataform utilizza quella località.
- Se la query fa riferimento a set di dati di due o più località diverse, si verifica un errore. Per informazioni dettagliate su questa limitazione, vedi Replica dei set di dati tra regioni.
- Se la query non fa riferimento a nessun set di dati, la località predefinita per Dataform è la multi-regione US. Per scegliere una località diversa, imposta la località predefinita. In alternativa, utilizza la variabile di sistema @@location nella query. Per ulteriori informazioni, consulta Specificare le posizioni.
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.

Configurare i nomi degli schemi

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

Per configurare il nome di uno schema:

`workflow_settings.yaml`

Nello spazio di lavoro di sviluppo, nel riquadro File, fai clic sul file workflow_settings.yaml.
Modifica il valore di defaultDataset, defaultAssertionSchema o entrambi.

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

  ...
  defaultDataset: mytables
  ...

`dataform.json`

Nello spazio di lavoro di sviluppo, nel riquadro File, fai clic sul file dataform.json.
Modifica il valore di defaultSchema, assertionSchema o 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 gli override di compilazione in una configurazione di rilascio 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 rilascio o override di compilazione dell'API Dataform per eseguire le tabelle in modo condizionale.

Per saperne di più sull'esecuzione condizionale delle tabelle utilizzando le 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`

Vai al tuo workspace di sviluppo Dataform.
Nel riquadro File, seleziona il file workflow_settings.yaml.
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`

Vai al tuo workspace di sviluppo Dataform.
Nel riquadro File, seleziona il file dataform.json.
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 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, segui questi passaggi:

Vai al tuo workspace di sviluppo Dataform.
Nel riquadro File, seleziona un file di definizione della tabella SQLX.
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 workflow a `workflow_settings.yaml`

Per garantire che il file delle impostazioni del flusso di lavoro sia compatibile con le versioni future del framework principale di Dataform, devi eseguire la migrazione delle impostazioni del 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 repository, anche il file workflow_settings.yaml sostituisce 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 il mapping delle proprietà delle impostazioni del 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 del progetto Google Cloud predefinito.
`defaultLocation`	`defaultLocation`	Facoltativo. La località BigQuery predefinita in cui Dataform crea le tabelle. Se non è impostata, Dataform determina la posizione in base ai set di dati a cui fa riferimento la query SQL. Per saperne di più, vedi Specificare le località.
`defaultSchema`	`defaultDataset`	Obbligatorio. Il set di dati predefinito.
`databaseSuffix`	`projectSuffix`	Facoltativo. Il suffisso da aggiungere a tutti i riferimenti Google Cloud del progetto.
`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 che vengono rese disponibili al 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 del flusso di lavoro a workflow_settings.yaml:

Nella console Google Cloud , vai alla pagina Dataform.

Vai a Dataform
Seleziona un repository, quindi un workspace.
Nel riquadro File, fai clic su AggiungiAggiungi, quindi fai clic su Crea file.
Nel campo Aggiungi un percorso del file, inserisci workflow_settings.yaml.
Fai clic su Crea file.
Nel file workflow_settings.yaml, aggiungi le impostazioni del file dataform.json, mappate al formato YAML.
Nel riquadro File, fai clic sul menu Altro accanto a dataform.json, quindi fai clic su Elimina.
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 Dataform

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

Dataform Core è il framework Dataform open source per lo sviluppo di workflow con SQL, SQLX e JavaScript. Come best practice, utilizza sempre l'ultima versione disponibile del framework Dataform Core. Per informazioni sulle release del framework Dataform core, consulta la pagina Release di Dataform su GitHub.

Gestire la posizione del pacchetto principale Dataform

Quando inizializzi il primo workspace 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 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 repository utilizza pacchetti aggiuntivi, imposta il pacchetto Dataform core in package.json in modo che tutti i pacchetti vengano impostati in un'unica posizione. Se il repository non ha il file package.json, crea il file package.json e sposta il pacchetto principale Dataform per installare pacchetti aggiuntivi.

Sposta Dataform Core 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 Dataform dal file package.json al file workflow_settings.yaml:

Nella console Google Cloud , vai alla pagina Dataform.

Vai a Dataform
Seleziona un repository, quindi un workspace.
Nel riquadro File, seleziona il file workflow_settings.yaml.
Nel file workflow_settings.yaml, aggiungi il pacchetto Dataform core nel seguente formato:
```
dataformCoreVersion: "VERSION"
```
Sostituisci VERSION con l'ultima versione di Dataform, ad esempio 3.0.0.
Nel riquadro File, fai clic sul menu Altro accanto al file package.json e poi su Elimina.
Per confermare l'eliminazione del file dataform.json, fai clic su Elimina.
Fai clic su Installa pacchetti.

Sposta Dataform Core 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 Dataform core, nel file package.json.

Se il 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, quindi 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:

Nella console Google Cloud , vai alla pagina Dataform.

Vai a Dataform
Seleziona un repository, quindi un workspace.
Nel riquadro File, fai clic su AggiungiAggiungi, quindi fai clic su Crea file.
Nel campo Aggiungi un percorso del file, inserisci package.json.
Fai clic su Crea file.
Nel file package.json, aggiungi il pacchetto Dataform core nel seguente formato:
```
{
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}
```
Sostituisci VERSION con l'ultima versione di Dataform, ad esempio 3.0.0.
Fai clic su Installa pacchetti.
Nel riquadro File, seleziona workflow_settings.yaml.
Nel file workflow_settings.yaml, elimina la proprietà dataformCoreVersion.

Aggiorna Dataform Core

Testa sempre le nuove versioni dei pacchetti in un ambiente non di produzione prima di eseguirne il deployment nell'ambiente di produzione.

Per aggiornare il pacchetto di dipendenze principali di Dataform:

Cerca l'ultima versione di @dataform/core nella pagina delle release di Dataform su GitHub.
Nella console Google Cloud , vai alla pagina Dataform.

Vai a Dataform
Seleziona un repository, quindi un workspace.
Nel riquadro File, seleziona il file package.json o il file workflow_settings.yaml.

La posizione in cui è impostato il pacchetto di dipendenze Dataform Core dipende dalla versione di Dataform Core e dall'utilizzo dei pacchetti. Per saperne di più, consulta Gestire la posizione del pacchetto principale di Dataform.
Aggiorna il pacchetto di dipendenze principali di Dataform con l'ultima versione:
package.json
```
{
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}
```
Sostituisci VERSION con l'ultima versione di Dataform, ad esempio 3.0.0. Per evitare problemi con l'installazione del pacchetto, specifica esplicitamente la versione del pacchetto Dataform core. Non utilizzare altre opzioni dependencies del file package.json, ad esempio >version.
workflow_settings.yaml
```
dataformCoreVersion: "VERSION"
```
Sostituisci VERSION con l'ultima versione di Dataform, ad esempio 3.0.0.
Fai clic su Installa pacchetti.
Esegui il commit delle modifiche.
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 delle versioni in base allo stato delle modifiche nell'area di lavoro di sviluppo. Ad esempio, Dataform mostra l'opzione di commit solo quando ci sono modifiche locali non sottoposte a commit nel tuo workspace. Quando i file nel tuo spazio di lavoro sono una copia esatta del ramo predefinito o di monitoraggio, Dataform mostra lo stato Workspace è aggiornato.

Dataform mostra le seguenti opzioni di controllo delle versioni:

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

Esegui il pull delle modifiche

Se il workspace di sviluppo non è sincronizzato con il repository, Dataform visualizza l'opzione Pull. Per eseguire il pull delle modifiche dal repository allo spazio di lavoro di sviluppo:

Nella pagina Dataform, seleziona un repository.
Nella scheda Aree di lavoro di sviluppo, seleziona un'area di lavoro di sviluppo.
Nella pagina dell'area 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 connesso 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 workspace 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 non sottoposte a commit.

Per eseguire il commit delle modifiche dall'area di lavoro di sviluppo al repository:

Nella pagina Dataform, seleziona un repository.
Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
Nella pagina dell'area di lavoro di sviluppo, fai clic su Commit.
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 allo stato, al nome e al percorso del file.
3. Fai clic su Commit All changes (Esegui commit di tutte le modifiche) o Commit X changes (Esegui commit delle modifiche a X).
  
  Il nome del pulsante dipende dalla selezione dei file da eseguire.

Esegui il push delle modifiche

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

Nella pagina Dataform, seleziona un repository.
Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
Esegui il commit delle modifiche.
Nella pagina dell'area 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 connesso a un repository Git di terze parti, fai clic su Push su your-branch-name.

Annulla modifiche di cui non è stato eseguito il commit

Per ripristinare le modifiche di cui non è stato eseguito il commit:

Nella pagina Dataform, seleziona un repository.
Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
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 non è compatibile 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.

In genere, si verifica un conflitto di unione 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 manualmente un conflitto di unione 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:

Nel workspace di sviluppo, nel riquadro File, seleziona un file interessato.
Modifica il file con le modifiche che hai scelto.
Esegui il commit delle modifiche.
(Facoltativo) Esegui il push delle modifiche.

Passaggi successivi

Per scoprire di più sulle impostazioni del progetto Dataform, consulta il riferimento IProjectConfig.
Per scoprire come installare pacchetti aggiuntivi, vedi Installare un pacchetto in Dataform.
Per scoprire come creare una tabella, consulta Creare una tabella.

Gestire un repository Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Ruoli obbligatori

Configura le impostazioni del workflow Dataform

Informazioni sulle impostazioni del repository

Informazioni su workflow_settings.yaml

Informazioni su dataform.json

Configurare i nomi degli schemi

workflow_settings.yaml

dataform.json

Creare variabili di compilazione personalizzate

workflow_settings.yaml

dataform.json

Aggiungere una variabile di compilazione a una tabella

Esegui la migrazione delle impostazioni del workflow a workflow_settings.yaml

Gestire il pacchetto principale Dataform

Gestire la posizione del pacchetto principale Dataform

Sposta Dataform Core in workflow_settings.yaml

Sposta Dataform Core in package.json

Aggiorna Dataform Core

package.json

workflow_settings.yaml

Controllo della versione del codice

Esegui il pull delle modifiche

Esegui il commit delle modifiche

Esegui il push delle modifiche

Annulla modifiche di cui non è stato eseguito il commit

Risolvere i conflitti di unione

Passaggi successivi

Gestire un repository

Informazioni su `workflow_settings.yaml`

Informazioni su `dataform.json`

`workflow_settings.yaml`

`dataform.json`

`workflow_settings.yaml`

`dataform.json`

Esegui la migrazione delle impostazioni del workflow a `workflow_settings.yaml`

Sposta Dataform Core in `workflow_settings.yaml`

Sposta Dataform Core in `package.json`

`package.json`

`workflow_settings.yaml`