Come si usa Noeva ETL
Noeva ETL esegue processi di integrazione dati: prende dati da uno o più sistemi (un database, dei file su S3 o SFTP, i file di un workspace Noeva), li controlla, li trasforma e li scrive dove servono. Ogni processo è codice versionato: non si modifica da un'interfaccia grafica, e ogni cambiamento passa da una revisione prima di arrivare in produzione.
Questa parte della documentazione è per chi i processi li usa: li consulta, li avvia, ne legge l'esito. Se invece devi crearne uno, il percorso è Creare con Claude Code.
Tre cose da sapere
Un processo è un grafo
Ogni processo è un grafo di nodi: sorgenti da cui entrano i dati, trasformazioni, eventuali lookup su database, join, sink in cui i dati vengono scritti. Il diagramma che vedi nell'app è la topologia reale di ciò che viene eseguito, non un disegno fatto a parte. Per capire cosa fa ciascun nodo, prova il grafo interattivo.
Ogni esecuzione produce un report
Una run finisce in uno di tre stati — success, partial, failed — e lascia un report con i record letti, scritti e scartati, nodo per nodo. È il report che colora i nodi nell'app e che decide l'esito mostrato nella lista. Come leggerlo: Leggere l'esito di una run.
Nessun record sparisce in silenzio
Un record che non rispetta le regole ha sempre un percorso esplicito: finisce in uno scarto (il dead-letter), viene catturato da un ramo di gestione degli errori, oppure ferma la run. Non esiste un terzo modo in cui un dato si perde senza che il report lo conti.
Dove parte un processo
| Da dove | Chi | Cosa succede |
|---|---|---|
| Pulsante Esegui nell'app desktop | chi segue il processo | la run parte subito e l'app mostra l'avanzamento sul grafo |
| Job del workspace Noeva | automatico | il worker prende il job, esegue il processo e riporta l'esito sul workspace |
Riga di comando, etl run <nome> | chi gestisce l'ambiente | una esecuzione, il report stampato come JSON, poi il comando termina |
Il dettaglio operativo di ciascuna modalità è nei runbook: server e worker insieme, solo worker, esecuzione batch.
Cosa la piattaforma non fa, per scelta
Non ha un editor grafico dei processi e non conserva i dati che muove: esegue, riporta, e lascia a chi la invoca la decisione su cosa archiviare. Il perché è nella panoramica di prodotto.
Prossimi passi
- L'app desktop: la lista dei processi, il grafo, lo storico delle esecuzioni.
- Leggere l'esito di una run: stati, contatori, scarti.