Questo documento mostra come eseguire le seguenti operazioni in Dataform:
- Configura le impostazioni del flusso di lavoro Dataform.
- Gestisci il pacchetto principale di Dataform.
- Esegui il controllo della versione del codice.
Prima di iniziare
- Crea un repository.
- (Facoltativo) Collega il tuo repository a un repository Git di terze parti.
- 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, chiamatodataform
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, chiamatodataform_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, chiamatodataform_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
Nella tua area di lavoro di sviluppo, fai clic sul file
workflow_settings.yaml
nel riquadro File.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
Nella tua area di lavoro di sviluppo, fai clic sul file
dataform.json
nel riquadro File.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
- Vai allo spazio di lavoro 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 allo spazio di lavoro 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: 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:
- Vai allo spazio di lavoro 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
- VARIABLE: il nome della variabile, ad esempio
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
:
Nella console Google Cloud, vai alla pagina Dataform.
Seleziona un repository e poi uno spazio di lavoro.
Nel riquadro File, fai clic su AggiungiAggiungi, quindi 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 filedataform.json
, mappate al formato YAML.Nel riquadro File, fai clic sul menu Altro accanto a
dataform.json
, quindi 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 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:
Nella console Google Cloud, vai alla pagina Dataform.
Seleziona un repository e poi uno spazio di lavoro.
Nel riquadro File, seleziona il file
workflow_settings.yaml
.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
.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 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:
Nella console Google Cloud, vai alla pagina Dataform.
Seleziona un repository e poi uno spazio di lavoro.
Nel riquadro File, fai clic su AggiungiAggiungi, quindi 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 di base Dataform nel seguente formato:{ "dependencies": { "@dataform/core": "VERSION" } }
Sostituisci VERSION con la versione più recente 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
.
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:
Cerca la versione più recente di
@dataform/core
nella pagina delle release di Dataform su GitHub.Nella console Google Cloud, vai alla pagina Dataform.
Seleziona un repository e poi uno spazio di lavoro.
Nel riquadro File, seleziona il file
package.json
o il fileworkflow_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.
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 opzionidependencies
del filepackage.json
, ad esempio>version
.workflow_settings.yaml
dataformCoreVersion: "VERSION"
Sostituisci VERSION con la versione più recente di Dataform, ad esempio
3.0.0
.Fai clic su Installa pacchetti.
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:
- Nella pagina Dataform, seleziona un repository.
- Nella scheda Aree di lavoro di sviluppo, seleziona un'area di lavoro di sviluppo.
- Nella pagina Spazio di lavoro di sviluppo:
- Se ti trovi in un repository Dataform, fai clic su Esegui il pull dal ramo predefinito.
- 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:
- Nella pagina Dataform, seleziona un repository.
- Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
- Nella pagina dello spazio di lavoro di sviluppo, fai clic su Esegui commit.
Nel riquadro Nuovo commit:
- Nel campo Aggiungi un messaggio commit, inserisci una descrizione per il commit.
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.
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:
- Nella pagina Dataform, seleziona un repository.
- Nella pagina del repository, seleziona uno spazio di lavoro di sviluppo.
- Esegui il commit delle modifiche.
- Nella pagina Spazio di lavoro di sviluppo:
- Se ti trovi in un repository Dataform, fai clic su Esegui il push sul branch predefinito.
- 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:
- 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 è 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:
- Nell'area di lavoro di sviluppo, seleziona un file interessato nel riquadro File.
- Modifica il file con le modifiche scelte.
- Esegui il commit delle modifiche.
- (Facoltativo) Invia modifiche.
Passaggi successivi
- Per scoprire di più sulle impostazioni del progetto Dataform, consulta la guida di riferimento di
IProjectConfig
. - Per scoprire come installare pacchetti aggiuntivi, consulta Installare un pacchetto in Dataform.
- Per scoprire come creare una tabella, consulta Creare una tabella.