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à:
- Configurare le impostazioni di Dataform
- Crea tabelle di tutti i tipi supportati
- Tabelle Document
- Tabelle partizionate
- Aggiungere etichette BigQuery e tag di criteri alle tabelle
- Configurare impostazioni aggiuntive della tabella
- Dichiara le origini dati per il tuo flusso di lavoro SQL
- Aggiungi operazioni SQL personalizzate e tag al flusso di lavoro SQL
- Attiva l'esecuzione del flusso di lavoro SQL o delle sue azioni selezionate
- Monitorare i log di esecuzione
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
- Per scoprire come creare e inizializzare un'area di lavoro, consulta Creare un'area di lavoro.
- Per scoprire come eseguire il controllo della versione del codice Dataform, consulta Eseguire il controllo della versione del codice.
- Per scoprire come eseguire un'anteprima per testare una query SQL, consulta Anteprima delle query SQL.