L'app desktop
L'app desktop di Noeva ETL mostra i processi del workspace, il loro grafo e le loro esecuzioni, e permette di avviarli. Non modifica i processi: la loro struttura sta nel codice, e si cambia con una revisione (Creare con Claude Code).
Accesso
Si accede con le credenziali Noeva. Il pulsante Guida nell'header apre questa documentazione dentro l'app, raggiungibile anche prima del login: i link verso GitHub o altri siti si aprono nel browser di sistema.
La lista dei processi
Dopo l'accesso si apre la lista dei processi ETL. Per ciascuno trovi la descrizione, qualche metrica sulla topologia e l'esito e la data dell'ultima esecuzione. Puoi cercare per nome, ordinare e filtrare per esito.
L'esito mostrato è quello dell'ultima run del workspace, chiunque l'abbia avviata: un processo lanciato da un collega non risulta "mai eseguito".
Se la lista mostra un errore
La lista chiede gli esiti delle ultime run al server Noeva. Se non risponde, al posto dei processi compare l'errore con il pulsante Riprova: non viene mostrata una lista parziale, che darebbe esiti sbagliati.
Il pannello del processo
Selezionare un processo non apre subito il grafo: apre un pannello laterale con lo storico delle esecuzioni e due azioni, Apri il grafo ed Esegui. Dallo storico puoi andare direttamente al grafo nello stato di una run passata.
Il grafo
Il grafo di un processo ha un indirizzo suo, che puoi condividere. I nodi hanno lo stesso colore in tutta la documentazione e nell'app:
| Nodo | Cosa rappresenta |
|---|---|
| source | da dove entrano i dati: una tabella, una cartella di file |
| transform | un controllo o una trasformazione, senza accesso a sistemi esterni |
| lookup | una query in sola lettura per arricchire i record |
| join | l'unione di due flussi su una chiave |
| try-catch | un punto che cattura gli errori a valle e li devia su un ramo |
| sink | dove i dati vengono scritti |
| dead-letter | il ramo rosso tratteggiato degli scarti |
Ogni card mostra il tipo di connettore e dove punta, e le colonne che attraversano il nodo, in entrata e in uscita. Selezionando un nodo si apre il pannello di dettaglio con tutta la configurazione del connettore, in sola lettura e con i valori sensibili mascherati.
Avviare una run
Esegui, dalla lista o dal pannello, avvia la run e porta al grafo, dove l'avanzamento si aggiorna nodo per nodo. Puoi tornare alla lista mentre la run procede: l'avanzamento non si interrompe.
Un processo appena creato
Due cose da sapere quando un processo nuovo è appena stato approvato:
- Compare nella lista solo dopo un riavvio del server ETL. L'elenco dei grafi si costruisce all'avvio di
etl serve: aggiornare la pagina non basta. - Il pulsante Esegui va abilitato a parte. L'avvio manuale passa da un elenco di processi ammessi nel server Noeva, allineato a mano. Finché il nome nuovo non è lì, il processo si vede ma Esegui risponde con un errore.
Rivedere una run passata
Nel grafo, lo storico delle esecuzioni sta in un pannello laterale. Selezionare una run ne proietta l'esito sul grafo: ogni nodo si colora per come è andato, con i suoi contatori. La barra del grafo dice sempre quale esecuzione stai guardando, e l'indirizzo della pagina la include: condividerlo porta un collega esattamente lì.
Il messaggio d'errore di una run fallita è troncato a una riga nell'elenco; il comando accanto lo apre per intero in una finestra, da cui si può selezionare e copiare.
Prossimo passo
Leggere l'esito di una run: cosa significano gli stati e i contatori, e dove finiscono i record scartati.