Introduzione allo sviluppo in un'area di lavoro

Questo documento ti aiuta a comprendere il concetto di aree di lavoro in Dataform e le loro capacità.

In Dataform, interagisci con il codice del flusso di lavoro SQL in un'area di lavoro di sviluppo. Un'area di lavoro di sviluppo è la tua copia modificabile di un repository. In un'area di lavoro, puoi creare, modificare o eliminare i contenuti del repository senza influire sugli altri che lavorano sullo stesso repository, quindi eseguire il commit e il push delle modifiche nel repository.

Puoi sviluppare il tuo flusso di lavoro SQL con Dataform core o JavaScript. Dataform compila il tuo codice in query SQL in tempo reale.

In un'area di lavoro di sviluppo, puoi eseguire le seguenti attività:

Componenti di un'area di lavoro di sviluppo

Un'area di lavoro di sviluppo Dataform è composta dalle seguenti schede:

Codice
Contiene un ambiente di sviluppo in cui puoi sviluppare query, controllare le modifiche e attivare l'esecuzione in BigQuery.
Grafico compilato
Mostra il flusso di lavoro SQL compilato definito nella tua area di lavoro come grafo diretto aciclico (DAG) diretto. Se nel flusso di lavoro SQL sono presenti errori di compilazione, la scheda mostra un messaggio di errore anziché il grafico.
Esecuzioni
Mostra i log di tutte le esecuzioni attivate nell'area di lavoro. Puoi anche visualizzare le azioni e i relativi dettagli per un'esecuzione selezionata. Per ulteriori informazioni, consulta la pagina Esaminare i log di esecuzione dell'area di lavoro.

Componenti della scheda Codice

La scheda Codice di un'area di lavoro di sviluppo contiene i seguenti componenti che consentono di sviluppare flussi di lavoro SQL:

Riquadro dei file
Mostra la struttura dei file dell'area di lavoro. Salva automaticamente le modifiche alla struttura del file.
Riquadro di controllo della versione
Mostra lo stato del controllo della versione dell'area di lavoro e le opzioni di controllo della versione.
Riquadro di sviluppo
Mostra il file attualmente modificato. Salva automaticamente le modifiche al file.
Pulsante Esegui
Esegui un'anteprima della query SQL compilata.
Stato della compilazione
Mostra lo stato di compilazione del codice nell'area di lavoro.
Riquadro dei metadati
Mostra i metadati del file attualmente modificato.
Riquadro delle query compilate
Compila le query nel file attualmente modificato in SQL. Se la compilazione della query non riesce, vengono visualizzati gli errori di compilazione. Se la compilazione delle query ha esito positivo, mostra le query compilate e le convalida tramite esecuzioni di test su BigQuery. Se la convalida della query non va a buon fine, vengono visualizzati errori di convalida. Se la convalida della query ha esito positivo, mostra quanti byte verrà utilizzata dall'esecuzione delle query in BigQuery.
Menu a discesa Avvia esecuzione
Mostra le opzioni per attivare l'esecuzione dell'intero flusso di lavoro nell'area di lavoro o degli elementi selezionati.

Componenti della scheda Grafico compilato

La scheda Grafico compilato mostra un grafico interattivo del tuo flusso di lavoro SQL compilato. Il grafico mostra tutte le azioni nel flusso di lavoro SQL e le relazioni tra loro.

Puoi aumentare e diminuire lo zoom e utilizzare il trascinamento per navigare nel grafico.

Puoi filtrare il grafico in base alle seguenti proprietà:

  • Nome
  • Etichetta
  • Digita
    • Asserzione
    • Dichiarazione
    • Tabella incrementale
    • Visualizzazione materializzata
    • Suite operativa
    • Tabella
    • Sconosciuto
    • Visualizza

Puoi selezionare più filtri contemporaneamente. Dataform li applicherà con la condizione OR.

Puoi fare clic su un'azione nel grafico per visualizzarne i dettagli nei riquadri seguenti:

Riquadro dei metadati
Mostra il nome completo, il tipo, le dipendenze e le dipendenze dell'azione selezionata.
Riquadro della query
Mostra la query SQL compilata dell'azione selezionata.

Controllo della versione in un'area di lavoro

In un'area di lavoro, interagisci con il repository tramite il controllo della versione basato su Git. Le modifiche apportate ai file nell'area di lavoro iniziano come modifiche locali senza impegno che puoi eseguire, quindi esegui il push al tuo repository in modo che diventino disponibili per tutti gli utenti.

Se il repository è connesso a un provider Git remoto, esegui il push delle modifiche dall'area di lavoro al ramo di sviluppo principale. Selezioni il ramo principale quando connetti il repository al provider Git remoto. In un repository Dataform non connesso, esegui il push delle modifiche al ramo predefinito.

Puoi anche estrarre le modifiche dal repository Dataform o dal repository remoto e unirle a modifiche locali nell'area di lavoro di sviluppo. Per ulteriori informazioni sul controllo della versione in Dataform, consulta Controllo della versione del codice.

Passaggi successivi