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 funzionalità.

In Dataform, interagisci con il codice del tuo flusso di lavoro SQL in un'area di lavoro di sviluppo. Un'area di lavoro di sviluppo è la copia modificabile di un repository. In un'area di lavoro puoi creare, modificare o eliminare i contenuti del repository senza influire sugli altri utenti che lavorano sullo stesso repository, quindi eseguire il commit delle modifiche ed eseguirne il push 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 esplorare i file, sviluppare query, controllare la versione delle modifiche e attivare l'esecuzione su BigQuery.
Grafico compilato
Visualizza il flusso di lavoro SQL compilato definito nell'area di lavoro come grafo diretto aciclico interattivo (DAG). Se sono presenti errori di compilazione nel flusso di lavoro SQL, nella scheda viene visualizzato un messaggio di errore anziché il grafico.
Esecuzioni
Visualizza 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 maggiori informazioni, consulta 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 File
Mostra la struttura dei file dell'area di lavoro. Salva automaticamente le modifiche alla struttura del file. I file selezionati si aprono in schede del riquadro di sviluppo. Nel campo Digita per effettuare la ricerca, puoi cercare file o directory nell'area di lavoro in base al percorso.
Riquadro di controllo della versione
Visualizza lo stato del controllo della versione dell'area di lavoro e le opzioni di controllo della versione.
Riquadro di sviluppo
Visualizza i file aperti in schede. Salva automaticamente le modifiche apportate ai file modificati.
Pulsante Esegui
Esegue un'anteprima della query SQL compilata.
Pulsante Formato
Formatta il tuo codice JavaScript o core Dataform.
Stato compilazione
Visualizza 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, visualizza le query compilate e le convalida tramite prove 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 il numero di byte utilizzati dall'esecuzione delle query su BigQuery.
Menu a discesa Avvia esecuzione
Mostra le opzioni per attivare l'esecuzione dell'intero flusso di lavoro nell'area di lavoro o nei suoi elementi selezionati.

Componenti della scheda Grafico compilato

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

Puoi aumentare e diminuire lo zoom e trascinare il grafico.

Puoi filtrare il grafico in base alle seguenti proprietà:

  • Nome
  • Tag
  • Tipo
    • Asserzione
    • Dichiarazione
    • Tabella incrementale
    • Vista 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 seguenti riquadri:

Riquadro dei metadati
Mostra il nome completo, il tipo, le dipendenze e i dipendenti dell'azione selezionata.
Riquadro delle query
Visualizza 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 non impegnate di cui eseguire il commit, quindi vengono sottoposte a push nel repository in modo che siano disponibili per tutti gli utenti del repository.

Se il repository è connesso a un provider Git remoto, esegui il push delle modifiche dall'area di lavoro al ramo di sviluppo principale. Puoi selezionare 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 eseguire il pull delle modifiche dal repository Dataform o dal repository remoto e unirle alle 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