Introduzione allo sviluppo in uno spazio di lavoro

Questo documento ti aiuta a comprendere il concetto di spazi di lavoro in Dataform e le relative funzionalità.

In Dataform, interagisci con il codice del tuo flusso di lavoro SQL in un workspace di sviluppo. Uno spazio di lavoro di sviluppo è la tua copia modificabile di un repository. In uno spazio di lavoro, puoi creare, modificare o eliminare i contenuti del repository senza influire sugli altri utenti che lavorano nello stesso repository, quindi eseguire il commit e il push delle modifiche al repository.

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

In uno spazio di lavoro di sviluppo, puoi eseguire le seguenti attività:

Componenti di uno spazio di lavoro di sviluppo

Uno spazio di lavoro di sviluppo Dataform è composto dalle seguenti schede:

Codice
Contiene un ambiente di sviluppo in cui puoi esplorare i file, sviluppare query, controllare la versione delle modifiche ed eseguire l'esecuzione in BigQuery.
Grafico compilato
Mostra il flusso di lavoro SQL compilato definito nella tua area di lavoro come grafico di diretto aciclico (DAG) interattivo. 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 nello spazio di lavoro. Puoi anche visualizzare le azioni e i relativi dettagli per un'esecuzione selezionata. Per ulteriori informazioni, consulta Monitorare i log di esecuzione.

Componenti della scheda Codice

La scheda Codice di uno spazio di lavoro di sviluppo contiene i seguenti componenti che consentono di sviluppare flussi di lavoro SQL:

Riquadro File
Mostra la struttura dei file della tua area di lavoro. Salva automaticamente le modifiche alla struttura del file. I file selezionati si aprono nelle schede del riquadro di sviluppo. Nel campo Digita per effettuare la ricerca, puoi cercare file o directory nello spazio di lavoro in base al percorso.
Riquadro del controllo delle versioni
Mostra lo stato del controllo delle versioni della tua area di lavoro e le opzioni di controllo delle versioni.
Riquadro Sviluppo
Mostra i file aperti in schede. Salva automaticamente le modifiche ai file modificati.
Pulsante Esegui
Esegue un'anteprima della query SQL compilata.
Pulsante Formato
Formatta il codice JavaScript o di Dataform core.
Stato della compilazione
Visualizza lo stato di compilazione del codice nella tua area di lavoro.
Riquadro Metadati
Mostra i metadati del file attualmente modificato.
Riquadro Query compilate
Compila le query nel file attualmente modificato in SQL. Se la compilazione della query non va a buon fine, vengono visualizzati gli errori di compilazione. Se la compilazione delle query è riuscita, vengono visualizzate le query compilate e validate tramite prove a vuoto su BigQuery. Se la convalida della query non va a buon fine, vengono visualizzati gli errori di convalida. Se la convalida della query è andata a buon fine, viene visualizzato il numero di byte che l'esecuzione delle query in BigQuery utilizzerebbe.
Menu a discesa Avvia esecuzione
Mostra le opzioni per attivare l'esecuzione dell'intero flusso di lavoro nella tua area di lavoro o in alcuni 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 nel flusso di lavoro SQL e le relazioni tra di 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
  • Tag
  • Tipo
    • affermazione
    • Dichiarazione
    • Tabella incrementale
    • Visualizzazione materializzata
    • Operazioni
    • 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 Metadati
Mostra il nome completo, il tipo, le dipendenze e gli elementi dipendenti dell'azione selezionata.
Riquadro Query
Visualizza la query SQL compilata dell'azione selezionata.

Controllo delle versioni in uno spazio di lavoro

In uno spazio di lavoro, interagisci con il repository tramite il controllo della versione basato su Git. Le modifiche apportate ai file nello spazio di lavoro iniziano come modifiche locali non committate che puoi committare e poi inviare al repository in modo che diventino disponibili per tutti gli utenti del repository.

Se il repository è connesso a un provider Git remoto, esegui il push delle modifiche dalla tua area di lavoro al ramo di sviluppo principale. Seleziona il branch principale quando colleghi il tuo repository al provider Git remoto. In un repository Dataform non connesso, esegui il push delle modifiche al ramo predefinito.

Puoi anche estrarre eventuali modifiche dal repository Dataform o dal repository remoto e unirli alle modifiche locali nello spazio di lavoro di sviluppo. Per ulteriori informazioni sul controllo della versione in Dataform, consulta Eseguire il controllo della versione del codice.

Passaggi successivi