@noeva/etl-core 1.0.0-next.0 → 1.0.0-next.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/dist/cli.js +143 -117
- package/dist/guida/404.html +2 -2
- package/dist/guida/GUIDA_SVILUPPO.html +9 -6
- package/dist/guida/TECHNICAL_OVERVIEW.html +5 -5
- package/dist/guida/assets/{GUIDA_SVILUPPO.md.B_lGYssk.js → GUIDA_SVILUPPO.md.D13C7Zwu.js} +5 -2
- package/dist/guida/assets/{GUIDA_SVILUPPO.md.B_lGYssk.lean.js → GUIDA_SVILUPPO.md.D13C7Zwu.lean.js} +1 -1
- package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.C9V6rGhh.js → TECHNICAL_OVERVIEW.md.DQP0pWc8.js} +1 -1
- package/dist/guida/assets/{app.Bgu6oi0F.js → app.BMz6ZZYF.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.B3bE99g8.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.ByJkVQg0.js → VPLocalSearchBox.D8gO6gDY.js} +1 -1
- package/dist/guida/assets/chunks/{theme.DvCzVyXX.js → theme.DV62mViB.js} +2 -2
- package/dist/guida/connectors/README.html +3 -3
- package/dist/guida/connectors/file.html +3 -3
- package/dist/guida/connectors/http.html +3 -3
- package/dist/guida/connectors/imap.html +3 -3
- package/dist/guida/connectors/jira.html +3 -3
- package/dist/guida/connectors/noeva.html +3 -3
- package/dist/guida/connectors/oauth.html +3 -3
- package/dist/guida/connectors/postgres.html +3 -3
- package/dist/guida/connectors/process.html +3 -3
- package/dist/guida/connectors/sendgrid.html +3 -3
- package/dist/guida/connectors/smtp.html +3 -3
- package/dist/guida/connectors/sqlserver.html +3 -3
- package/dist/guida/conventions/node-columns.html +3 -3
- package/dist/guida/conventions/node-descriptor.html +3 -3
- package/dist/guida/conventions/run-report.html +3 -3
- package/dist/guida/conventions/run-trace.html +3 -3
- package/dist/guida/conventions/variabili-del-core.html +3 -3
- package/dist/guida/conventions/versioni-di-pipeline.html +3 -3
- package/dist/guida/guide/claude-code/index.html +3 -3
- package/dist/guida/guide/claude-code/prompt.html +3 -3
- package/dist/guida/guide/claude-code/strumenti.html +3 -3
- package/dist/guida/guide/grafo.html +3 -3
- package/dist/guida/guide/usare/app-desktop.html +3 -3
- package/dist/guida/guide/usare/esito-di-una-run.html +3 -3
- package/dist/guida/guide/usare/index.html +3 -3
- package/dist/guida/hashmap.json +1 -1
- package/dist/guida/index.html +3 -3
- package/dist/guida/nodes/README.html +3 -3
- package/dist/guida/nodes/action.html +3 -3
- package/dist/guida/nodes/ai.html +3 -3
- package/dist/guida/nodes/join.html +3 -3
- package/dist/guida/nodes/lookup.html +3 -3
- package/dist/guida/nodes/pipeline.html +3 -3
- package/dist/guida/nodes/route.html +3 -3
- package/dist/guida/nodes/sink.html +3 -3
- package/dist/guida/nodes/source.html +3 -3
- package/dist/guida/nodes/task.html +3 -3
- package/dist/guida/nodes/transform.html +3 -3
- package/dist/guida/nodes/try-catch.html +3 -3
- package/dist/guida/nodes/union.html +3 -3
- package/dist/guida/pipelines/README.html +3 -3
- package/dist/guida/pipelines/crm-leads-sync.html +3 -3
- package/dist/guida/pipelines/cross-workspace-csv-merge.html +3 -3
- package/dist/guida/pipelines/movimenti-per-conto.html +3 -3
- package/dist/guida/pipelines/orders-enriched-daily.html +3 -3
- package/dist/guida/pipelines/test-posta.html +3 -3
- package/dist/guida/runbooks/aggiornamento-pm2.html +3 -3
- package/dist/guida/runbooks/deployment.html +3 -3
- package/dist/guida/runbooks/etl-worker.html +3 -3
- package/dist/guida/runbooks/graph-server.html +3 -3
- package/dist/guida/runbooks/mask-key.html +3 -3
- package/dist/guida/runbooks/oauth-google-posta.html +3 -3
- package/dist/guida/runbooks/rollback-di-pipeline.html +3 -3
- package/dist/guida/runbooks/scd2-rehash.html +3 -3
- package/dist/guida/runbooks/sql-task-truncate-swap.html +3 -3
- package/dist/guida/runbooks/stato-incrementale.html +3 -3
- package/dist/guida/sub-pipelines/README.html +3 -3
- package/dist/guida/sub-pipelines/riepilogo-ordini.html +3 -3
- package/docs/.vitepress/lib/published-docs.ts +4 -3
- package/kit/blocco-agents.md +7 -1
- package/package.json +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.B3k7jzMh.js +0 -1
- /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.C9V6rGhh.lean.js → TECHNICAL_OVERVIEW.md.DQP0pWc8.lean.js} +0 -0
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/runbooks_rollback-di-pipeline.md.6US0Wsdc.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span>
|
|
27
27
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> pipeline:rollback</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">pipelin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">N</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --motivo</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "<perché si ritira la versione>"</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --ticket</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">chiave</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> Jir</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">a</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span></span></code></pre></div><p>Scegli <code><N></code> dalla sezione <strong>Versioni</strong> della scheda della pipeline: dev'essere una versione che è stata <strong>in cima a <code>main</code></strong>. Una versione rimasta in un branch e superata prima del merge non è mai andata in produzione, e il comando la rifiuta elencando quelle che lo sono state. Il <code>fetch</code> serve: il comando legge <code>origin/main</code> così com'è in locale.</p><p>Per leggere lo stato del worker invece di quello locale aggiungi <code>--workspace <id></code> (servono <code>NOEVA_API_BASE_URL</code> e <code>NOEVA_API_KEY</code>, come per <code>etl state show</code>). Il comando ne usa solo la lettura.</p><p>Il comando crea <code>hotfix/rollback-<pipeline>-v<N></code> da <code>origin/main</code> e prepara le modifiche <strong>senza committarle</strong>:</p><ul><li>la cartella è quella che la pipeline ha su <code>main</code>: se su <code>dev</code> è stata spostata, il comando la ritrova dal nome negli snapshot di <code>main</code>;</li><li>la cartella della pipeline torna com'era nell'ultimo commit di <code>main</code> con la vN, file aggiunti dopo compresi (spariscono) e file tolti dopo compresi (tornano);</li><li><code>changelog.ts</code> e <code>versions/</code> restano quelli di <code>main</code>, e il changelog guadagna la voce nuova;</li><li>lo snapshot del piano della versione nuova viene rigenerato, in un processo a parte che carica il codice ripristinato.</li></ul><p>Alla fine stampa il branch, il commit da cui ha ripreso la cartella, lo stato salvato e le source che la versione ritirata aggiungeva o toglieva. Tieni quell'output: va nella PR.</p><p>La voce nuova registra la versione del core installata (<code>core</code>), e la riga <strong>Core</strong> del resoconto la confronta con quella della voce della vN: la cartella ripristinata gira sul core di oggi, non su quello con cui la vN è andata in produzione. Se i due differiscono, guarda lo snapshot nel diff: il piano può non essere più quello della vN. Se serve anche il core di allora, il rollback giusto è il downgrade del core, o il rollback del deploy.</p><p>Se il comando si ferma prima (exit 2) non ha toccato nulla: il messaggio dice perché. Gli esiti sono nella tabella della <a href="./../conventions/versioni-di-pipeline#etl-versions-rollback">convenzione</a>.</p><h2 id="_2-se-la-cartella-vecchia-non-gira-piu" tabindex="-1">2. Se la cartella vecchia non gira più <a class="header-anchor" href="#_2-se-la-cartella-vecchia-non-gira-piu" aria-label="Permalink to "2. Se la cartella vecchia non gira più""></a></h2><p>Il core di oggi può non essere più quello con cui la vN girava (la riga <strong>Core</strong> del resoconto lo dice, se la voce della vN lo registra). Succede in due modi:</p><ul><li>il comando esce con <strong>1</strong>: lo snapshot non si genera, perché la cartella non si carica (un import che non c'è più, una firma cambiata). Il branch è già pronto, con la voce scritta;</li><li>il comando riesce, ma il gate del repo (<code>pnpm exec etl ci</code>; nel core <code>pnpm run check</code>) fallisce sul typecheck o sui test della pipeline.</li></ul><p>In entrambi i casi <strong>adatta a mano</strong> la cartella sul branch di hotfix, il minimo per farla compilare contro il core di oggi. Resta un rollback: nella voce del changelog aggiungi alle Modifiche cosa hai adattato. Poi:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> pipeline:snapshot</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">pipelin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # --force se lo snapshot c'è già ed è cambiato</span></span>
|
|
28
28
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> exec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ci</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # nel repo del core: pnpm run check</span></span></code></pre></div><p>Se l'adattamento diventa una riscrittura, fermati: a quel punto una correzione in avanti su un <code>hotfix/*</code> normale costa meno, e dice meglio cosa è successo.</p><h2 id="_3-lo-stato-di-pipeline" tabindex="-1">3. Lo stato di pipeline <a class="header-anchor" href="#_3-lo-stato-di-pipeline" aria-label="Permalink to "3. Lo stato di pipeline""></a></h2><p>Il rollback non tocca lo stato. La PR <strong>dichiara</strong> cosa farne, guardando l'output del comando:</p><table tabindex="0"><thead><tr><th>Situazione</th><th>Di solito</th></tr></thead><tbody><tr><td>Nessuna source cambiata fra le due versioni</td><td><strong>Mantieni.</strong> La vN riparte dal watermark a cui era arrivata la versione ritirata.</td></tr><tr><td>Una source che la versione ritirata <strong>aggiungeva</strong>, con stato salvato</td><td>Mantieni: dopo il rollback il nodo non c'è, e lo stato resta fermo. Se la versione tornerà, ripartirà da lì.</td></tr><tr><td>Una source che la versione ritirata <strong>toglieva</strong>, con stato salvato</td><td>Lo stato è quello di prima del ritiro: la source rilegge dal vecchio watermark. Con sink idempotenti va bene; altrimenti reset in avanti.</td></tr><tr><td>La versione ritirata ha cambiato <strong>cosa</strong> misura il watermark di una source</td><td><strong>Reset</strong> del nodo: il valore salvato non ha più senso per il codice della vN.</td></tr><tr><td>La versione ritirata ha scritto dati sbagliati da rileggere</td><td>Reset all'indietro al valore prima della versione ritirata: la vN rilegge quella finestra. Sistemare i dati scritti resta un lavoro a parte, caso per caso.</td></tr></tbody></table><p>Il reset si fa <strong>dopo il deploy</strong>, con l'operazione esplicita di <a href="./stato-incrementale#reset">Stato di pipeline e watermark § Reset</a>, e col motivo che cita il rollback:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> state</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> reset</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">pipelin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --node</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [--to </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"><</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">valor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --reason</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "rollback alla v<N> (<ticket>)"</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --workspace</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span></span></code></pre></div><h2 id="_4-revisione-della-pr-di-hotfix" tabindex="-1">4. Revisione della PR di hotfix <a class="header-anchor" href="#_4-revisione-della-pr-di-hotfix" aria-label="Permalink to "4. Revisione della PR di hotfix""></a></h2><p>Committa, pusha e apri la PR <strong>verso <code>main</code></strong>. Chi rivede controlla:</p><ul><li>[ ] il diff tocca <strong>solo</strong> <code>src/pipelines/<pipeline>/</code> (cartella, <code>changelog.ts</code>, il nuovo <code>versions/v<M>.plan.json</code>); niente core, connettori o altre pipeline;</li><li>[ ] la voce del changelog ha il numero giusto (la versione su <code>main</code> più uno), <code>rollbackTo</code> con la vN e un motivo comprensibile, il ticket, la versione del core (<code>core</code>) e gli eventuali adattamenti fra le Modifiche;</li><li>[ ] <code>pnpm exec etl ci</code> (nel core <code>pnpm run check</code>) è verde: sul branch <code>hotfix/*</code> il gate si confronta con <code>origin/main</code>, non con <code>dev</code>;</li><li>[ ] la descrizione riporta l'output del comando e la <strong>dichiarazione sullo stato</strong> (mantieni, o quale nodo resettare e a che valore);</li><li>[ ] il diff della scheda (sezione Versioni) non segnala «rompe il contratto» in modo inatteso: tornare indietro può togliere colonne che a valle si leggono già.</li></ul><p>Dopo il merge segue il deploy normale (<a href="./deployment">Deploy</a>, <a href="./etl-worker">Worker</a>), poi l'eventuale reset dello stato.</p><h2 id="_5-back-merge-in-staging-e-dev" tabindex="-1">5. Back-merge in <code>staging</code> e <code>dev</code> <a class="header-anchor" href="#_5-back-merge-in-staging-e-dev" aria-label="Permalink to "5. Back-merge in `staging` e `dev`""></a></h2><p>Come ogni hotfix, il codice di <code>main</code> torna in <code>staging</code> e in <code>dev</code> con una PR ciascuno. Sul back-merge il gate si confronta con <code>dev</code>, ed è lì che può scattare una collisione di numero.</p><p><strong><code>dev</code> non ha toccato la pipeline.</strong> Il back-merge passa così com'è.</p><p><strong><code>dev</code> ha già una versione nuova della stessa pipeline</strong> (la regressione è lì, o ci sono altri lavori in corso). Il numero che il rollback ha preso su <code>main</code> può essere già occupato su <code>dev</code>, e il gate lo dice: <code>la vM è già presa</code>. Si risolve sul branch di back-merge, così:</p><ol><li>La voce del rollback <strong>tiene il suo numero</strong>: è andata in produzione, e una run lo porta già nel report.</li><li>La voce in lavorazione su <code>dev</code> <strong>scala</strong> al numero successivo: rinumera la voce in <code>changelog.ts</code> e rinomina il suo snapshot (<code>git mv versions/vM.plan.json versions/vM+1.plan.json</code> prima del merge, o risolvi il conflitto tenendo lo snapshot di <code>main</code> per la vM).</li><li>Il <strong>codice</strong> della cartella resta quello di <code>dev</code>, non quello del rollback: è il lavoro che deve arrivare dopo. Ma la regressione che il rollback ha ritirato non deve ripartire alla prossima promozione: se è ancora nel codice di <code>dev</code>, correggila prima di promuovere.</li><li><code>pnpm run pipeline:snapshot <pipeline> --force</code> per la versione di <code>dev</code>, poi <code>pnpm exec etl ci</code>. Il gate accetta lo snapshot della vM sostituito perché è cambiata anche la sua voce: la vM ora è il rollback. Uno snapshot di <code>dev</code> cambiato con la voce di prima resta invece una violazione.</li></ol><p>Lo stesso vale per un ticket in un branch di feature che ha già fatto il bump: allinealo con <code>git merge origin/dev</code> dopo il back-merge e rinumera come sopra.</p><h2 id="escalation" tabindex="-1">Escalation <a class="header-anchor" href="#escalation" aria-label="Permalink to "Escalation""></a></h2><ul><li>Primo livello: l'owner della pipeline, dalla sua scheda in <code>docs/pipelines/</code>.</li><li>Secondo livello: il team BI/ETL, che decide fra rollback adattato e correzione in avanti quando la cartella vecchia non regge il core di oggi.</li></ul></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/runbooks/oauth-google-posta" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>OAuth2 per una casella Google (IMAP + SMTP)</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/runbooks/scd2-rehash" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>rehash di una dimensione storicizzata</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
29
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
29
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
30
30
|
|
|
31
31
|
</body>
|
|
32
32
|
</html>
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/runbooks_scd2-rehash.md.DtmuXA67.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">-- SQL Server</span></span>
|
|
28
28
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">SELECT</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> COUNT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">*</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">FROM</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> dbo</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">dim_cliente</span></span>
|
|
29
29
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">WHERE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> valid_to </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">IS</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> NULL</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> AND</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> riga_hash </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">NOT</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> LIKE</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 'v2:%'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span></code></pre></div><p>Atteso: <code>0</code>, a meno delle entità che la sorgente non manda più. Dopo un cambio di sole colonne il prefisso è lo stesso, e questa query non dice niente: vale il passo seguente.</p></li><li><p>Una run normale sulla <strong>stessa data di riferimento</strong> del punto 2 riporta tutto invariato: <code>written: 0</code> e <code>versions: { opened: 0, closed: 0, corrected: 0, unchanged: N }</code>, con <code>N</code> uguale al numero dei record in arrivo. Un <code>opened</code> o un <code>corrected</code> diverso da zero va capito prima di riprendere lo scheduling.</p></li></ol><h2 id="_6-dopo" tabindex="-1">6. Dopo <a class="header-anchor" href="#_6-dopo" aria-label="Permalink to "6. Dopo""></a></h2><p>Riprendere le run schedulate.</p><h2 id="_7-cosa-non-fa" tabindex="-1">7. Cosa non fa <a class="header-anchor" href="#_7-cosa-non-fa" aria-label="Permalink to "7. Cosa non fa""></a></h2><ul><li><strong>Non ricalcola le versioni chiuse</strong>, che tengono l'hash vecchio. Il sink confronta solo le versioni correnti, quindi prefissi misti nella storia sono attesi.</li><li><strong>Non rileva i cambi avvenuti fra l'ultima run e il rehash.</strong> Dichiara «i dati di oggi corrispondono alla versione corrente»: per questo i punti 2 e 4 stanno vicini.</li><li><strong>Non ripara una <code>entity</code> o un ordine di <code>naturalKey</code> cambiati.</strong> Quelli riscrivono le chiavi di versione, e non sono un rehash.</li><li><strong>Non apre versioni</strong> per le chiavi che non ne hanno una corrente.</li></ul><h2 id="_8-se-va-storto" tabindex="-1">8. Se va storto <a class="header-anchor" href="#_8-se-va-storto" aria-label="Permalink to "8. Se va storto""></a></h2><table tabindex="0"><thead><tr><th>Sintomo</th><th>Azione</th></tr></thead><tbody><tr><td>Il rehash fallisce a metà</td><td>È idempotente: si riesegue, e le versioni già ricalcolate risultano <code>unchanged</code>. Ogni <code>load</code> è una transazione, quindi non resta niente a metà dentro un blocco</td></tr><tr><td>«Un altro caricamento sta scrivendo su …»</td><td>Una run è ancora in corso sulla stessa tabella: aspettare che finisca, poi rieseguire</td></tr><tr><td>Una run normale è partita al posto del rehash</td><td>Ha aperto una versione per riga. Ripristinare la tabella dal backup del punto 2, poi rifare il rehash</td></tr><tr><td>Dopo il rehash la verifica riporta <code>opened</code> diverso da zero</td><td>Le colonne di <code>hashRow</code> non corrispondono a quelle scritte dal sink: vedi i due avvisi nella scheda del connettore</td></tr></tbody></table><h2 id="escalation" tabindex="-1">Escalation <a class="header-anchor" href="#escalation" aria-label="Permalink to "Escalation""></a></h2><ul><li>Primo livello: owner della pipeline.</li><li>Secondo livello: team BI/ETL, con il report delle run dei punti 2, 4 e 5.</li></ul></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/runbooks/rollback-di-pipeline" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>rollback di una pipeline</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>task SQL, truncate e scambio di tabelle</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
30
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
30
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
31
31
|
|
|
32
32
|
</body>
|
|
33
33
|
</html>
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/runbooks_sql-task-truncate-swap.md.C8viT-fp.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">ALTER</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TABLE</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> dwh</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">ordini_staging</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> RENAME </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TO</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ordini;</span></span>
|
|
57
57
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">ALTER</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> TABLE</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> dwh</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">ordini_swap</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> RENAME </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">TO</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ordini_staging;</span></span>
|
|
58
58
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">COMMIT</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span></code></pre></div><p>Va fatto <strong>prima</strong> della run successiva, e la schedulazione va sospesa finché non si è capito perché i dati nuovi erano sbagliati.</p><h2 id="chi-autorizza" tabindex="-1">Chi autorizza <a class="header-anchor" href="#chi-autorizza" aria-label="Permalink to "Chi autorizza""></a></h2><p>Un task <code>destructive</code> è un'operazione distruttiva: chiede <strong>conferma esplicita e un runbook</strong>. In pratica:</p><ul><li><strong>Prima esecuzione in produzione</strong> di una pipeline con un task distruttivo: la autorizza l'owner della pipeline, per iscritto sul ticket, dopo una run completa in un ambiente non di produzione. La scheda della pipeline elenca i task distruttivi e le tabelle che toccano.</li><li><strong>Un <code>TRUNCATE</code> sulla tabella in uso</strong> (non sullo staging) non è write-then-swap: fra il truncate e la fine del caricamento la tabella è vuota. Serve un'autorizzazione a parte, e di norma la risposta è usare lo scambio.</li><li><strong>Una modifica agli statement</strong> di un task distruttivo passa dalla review come ogni modifica al codice: nel DAG e nella PR lo statement è visibile, e <code>destructive: true</code> lo segnala.</li><li><strong>Un agente</strong> non esegue mai una pipeline contro un sistema di produzione senza una richiesta esplicita, e non lancia i test di integrazione dei task SQL fuori dai database locali: quei test si saltano da soli se l'host non è la macchina locale.</li></ul><h2 id="escalation" tabindex="-1">Escalation <a class="header-anchor" href="#escalation" aria-label="Permalink to "Escalation""></a></h2><ul><li>Primo livello: l'owner della pipeline, dalla sua scheda.</li><li>Secondo livello: chi amministra il database, se resta una tabella <code>*_swap</code> o un lock che non si libera.</li></ul></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/runbooks/scd2-rehash" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>rehash di una dimensione storicizzata</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/runbooks/stato-incrementale" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>stato di pipeline e watermark</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
59
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
59
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
60
60
|
|
|
61
61
|
</body>
|
|
62
62
|
</html>
|
|
@@ -9,9 +9,9 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/guida/core/assets/style.BNn_AkzN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.BMz6ZZYF.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.DV62mViB.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/runbooks_stato-incrementale.md.hGZ8FlbZ.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">limit</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 10</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span></code></pre></div><h2 id="diagnosi-per-reason" tabindex="-1">Diagnosi per <code>reason</code> <a class="header-anchor" href="#diagnosi-per-reason" aria-label="Permalink to "Diagnosi per `reason`""></a></h2><table tabindex="0"><thead><tr><th><code>reason</code></th><th>Cosa significa</th><th>Cosa fare</th></tr></thead><tbody><tr><td><code>failed</code></td><td>run fallita: lo stato è fermo</td><td>niente sullo stato: si corregge e si rilancia</td></tr><tr><td><code>partial</code></td><td>run con scarti, e la pipeline non dichiara <code>commitOn: "partial"</code></td><td>§ Finestra bloccata</td></tr><tr><td><code>records_lost</code></td><td>run con scarti che <strong>non</strong> sono tutti dead-letter per record</td><td>§ Record persi</td></tr><tr><td><code>skipped</code></td><td>la source non è partita: un nodo da cui dipende (<code>after</code>) non è riuscito</td><td>guardare <code>nodes[].skipped.because</code> nel report, e quel nodo</td></tr><tr><td><code>no_records</code></td><td>la source non ha visto righe</td><td>normale solo alla prima run su una sorgente vuota: con <code>>=</code> una run successiva rilegge almeno il confine</td></tr><tr><td><code>generation_mismatch</code></td><td>un reset è avvenuto durante la run</td><td>niente: la run successiva parte dal valore del reset</td></tr><tr><td><code>type_mismatch</code></td><td>lo store ha un valore di un altro tipo</td><td>§ Tipo cambiato</td></tr><tr><td><code>store_error</code></td><td>i sink hanno scritto, il commit no. Un errore transitorio (API giù, <code>5xx</code>) si ritenta fino a tre volte; uno permanente no</td><td>verificare l'API o il disco; la run successiva rilegge la stessa finestra</td></tr></tbody></table><p>Con <code>store_error</code> la run resta <code>success</code>: i dati ci sono. Non serve rilanciare a mano, ma finché il commit non riesce ogni run rilegge la stessa finestra.</p><p><strong>Allarme consigliato:</strong> tre run consecutive della stessa pipeline con <code>committed: false</code> e la stessa <code>reason</code>. Una è rumore, tre sono una finestra che non avanza.</p><h2 id="procedure" tabindex="-1">Procedure <a class="header-anchor" href="#procedure" aria-label="Permalink to "Procedure""></a></h2><h3 id="finestra-bloccata-partial-la-pipeline-resta-sulla-stessa-finestra" tabindex="-1">Finestra bloccata (<code>partial</code>: la pipeline resta sulla stessa finestra) <a class="header-anchor" href="#finestra-bloccata-partial-la-pipeline-resta-sulla-stessa-finestra" aria-label="Permalink to "Finestra bloccata (`partial`: la pipeline resta sulla stessa finestra)""></a></h3><ol><li>Dal report, leggere <code>rejectedReasons</code> e la dead-letter: errore transitorio o record strutturalmente invalido (poison pill)?</li><li><strong>Transitorio</strong> (un'API giù che manda in dead-letter molti record): correggere la causa e rilanciare. Il watermark avanza alla prima run <code>success</code>.</li><li><strong>Poison pill:</strong> correggere il dato a monte. Se non si può, far scrivere gli scarti in una dead-letter <strong>durevole e rielaborabile</strong> e dichiarare <code>graph("…", { commitOn: "partial" })</code>: è una modifica di codice, in PR, non un'operazione.</li><li><strong>Mai</strong> sbloccare con un reset in avanti senza aver messo al sicuro i record scartati: il watermark li supererebbe per sempre.</li></ol><h3 id="record-persi-records-lost" tabindex="-1">Record persi (<code>records_lost</code>) <a class="header-anchor" href="#record-persi-records-lost" aria-label="Permalink to "Record persi (`records_lost`)""></a></h3><p>La pipeline dichiara <code>commitOn: "partial"</code>, ma in questa run uno scarto non ha conservato i record: un guard ha chiuso uno stream (circuit-breaker, <code>assert</code> in gate fallito, sink interrotto), oppure un nodo è stato saltato.</p><ol><li>Nel report cercare i nodi con <code>skipped</code> e i <code>try-catch</code> con <code>caught > 0</code>: <code>caughtErrors</code> dice quale nodo ha fallito e perché.</li><li>Correggere la causa e rilanciare. Non c'è altro da fare sullo stato: non è avanzato, quindi la run successiva rilegge la finestra intera.</li></ol><h3 id="istanza-connettore-cambiata-la-run-fallisce-prima-di-estrarre" tabindex="-1">Istanza connettore cambiata (la run fallisce prima di estrarre) <a class="header-anchor" href="#istanza-connettore-cambiata-la-run-fallisce-prima-di-estrarre" aria-label="Permalink to "Istanza connettore cambiata (la run fallisce prima di estrarre)""></a></h3><p>La run si ferma con un <code>ConfigError</code> che nomina questo runbook quando il valore salvato ha un altro <code>instanceId</code> rispetto alla source.</p><ol><li>Confermare che la sorgente sia <strong>davvero</strong> cambiata: altro database, altro host.</li><li><strong>Stessa sorgente, altro id dell'istanza</strong> (rinominata nel registry): reset con <code>--to</code> al valore corrente. Il reset azzera l'<code>instanceId</code>, e il commit successivo lo rilega.</li><li><strong>Sorgente diversa:</strong> reset senza <code>--to</code>, poi una run. È un full reload: vedi sotto.</li></ol><h3 id="tipo-cambiato-la-run-fallisce-prima-di-estrarre" tabindex="-1">Tipo cambiato (la run fallisce prima di estrarre) <a class="header-anchor" href="#tipo-cambiato-la-run-fallisce-prima-di-estrarre" aria-label="Permalink to "Tipo cambiato (la run fallisce prima di estrarre)""></a></h3><p>La colonna di watermark è passata da intero a timestamp, o viceversa. <strong>Un reset non lo risolve:</strong> il reset conserva il tipo della chiave, anche senza <code>--to</code>, e la run continuerebbe a fallire.</p><p>Una chiave è <code>(pipeline, workspace, nodeId)</code>: per cambiare tipo si <strong>cambia l'id del nodo source</strong> nel grafo (in PR). La source nuova non ha stato, parte da <code>initial</code> e scrive una chiave sua; quella vecchia resta nello storico, inerte. È un full reload: vedi sotto.</p><h3 id="backfill-di-un-intervallo" tabindex="-1">Backfill di un intervallo <a class="header-anchor" href="#backfill-di-un-intervallo" aria-label="Permalink to "Backfill di un intervallo""></a></h3><p>Un backfill è una run con un <strong>override del watermark</strong>:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">pipelin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --params</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '{"watermark":{"<nodeId>":"2026-09-01 00:00:00"}}'</span></span>
|
|
30
30
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">pipelin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --workspace</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --params</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '{"watermark":{"<nodeId>":"2026-09-01 00:00:00"}}'</span></span></code></pre></div><p>Dal worker, lo stesso oggetto in <code>input_data</code> del processo.</p><ol start="0"><li><strong>Un override in avanti salta righe.</strong> Se il valore è <strong>oltre</strong> quello salvato, la run legge da lì, committa il massimo visto, e le righe fra i due valori non vengono mai estratte. Un backfill parte sempre da un valore <strong>più vecchio</strong> di quello salvato: controllare prima con <code>etl state show</code>.</li><li>L'override vince in lettura: la source parte da lì. Il nome del nodo dev'essere quello di una source incrementale della pipeline, altrimenti la run fallisce subito (un refuso non passa per un backfill riuscito).</li><li>Lo stato <strong>non arretra</strong>: al commit vale il massimo fra il valore salvato e quello visto.</li><li>Intervalli grandi: più run per finestre, verificando l'idempotenza (sink con chiave naturale). L'override fissa solo l'inizio: la fine la decide la query.</li><li>Traccia: il report della run (<code>origin: "override"</code>) e <code>processes.input_data</code>.</li></ol><h3 id="reset" tabindex="-1">Reset <a class="header-anchor" href="#reset" aria-label="Permalink to "Reset""></a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> state</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> reset</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">pipelin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --node</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --to</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">valor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --reason</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "<testo>"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [--workspace </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"><</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
|
|
31
31
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">etl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> state</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> reset</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">pipelin</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --node</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> <</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --reason</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "<testo>"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [--workspace </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"><</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">></span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> # cancella il valore</span></span></code></pre></div><ol><li><code>--reason</code> è obbligatorio: finisce nello storico. L'autore è <code>--actor</code>, altrimenti <code>ETL_STATE_ACTOR</code>, altrimenti l'utente del sistema operativo. È <strong>dichiarato</strong>, non autenticato: l'autorizzazione è la chiave API.</li><li>Senza <code>--to</code> il valore si cancella: la run successiva riparte da <code>initial</code>.</li><li><code>--to</code> dev'essere del tipo già salvato. Una chiave mai committata non ha un tipo: si può solo resettare senza valore.</li><li>Il reset alza la <strong>generazione</strong>: le run in corso su quella source non committano (<code>generation_mismatch</code>). Meglio farlo a worker fermo o fra una run e l'altra.</li><li>Verificare con <code>etl state show</code> che l'evento sia nello storico, con motivo e autore.</li></ol><p>Un reset sullo stato del worker (<code>--workspace</code>) tocca uno stato condiviso: richiede la stessa attenzione di un'operazione distruttiva, perché un reset in avanti salta record.</p><h3 id="full-reload" tabindex="-1">Full reload <a class="header-anchor" href="#full-reload" aria-label="Permalink to "Full reload""></a></h3><p>Reset senza <code>--to</code>, poi una run. <strong>Stimare prima il volume:</strong> è un'estrazione completa della sorgente, e un sink con <code>retry</code> la scrive a blocchi.</p><h3 id="il-file-di-stato-locale-e-corrotto" tabindex="-1">Il file di stato locale è corrotto <a class="header-anchor" href="#il-file-di-stato-locale-e-corrotto" aria-label="Permalink to "Il file di stato locale è corrotto""></a></h3><p><code>etl run</code> fallisce con «Stato di pipeline corrotto» o «con una forma inattesa», e nomina il file. Non riparte da <code>initial</code> da sola: sarebbe un full reload non richiesto.</p><ol><li>Ripristinare il file da una copia, se c'è.</li><li>Altrimenti rimuoverlo: è un full reload voluto. Lo storico locale degli eventi si perde con lui.</li></ol><h2 id="escalation" tabindex="-1">Escalation <a class="header-anchor" href="#escalation" aria-label="Permalink to "Escalation""></a></h2><ul><li>Primo livello: chi ha in carico la pipeline.</li><li>Secondo livello: team BI/ETL. Un sospetto di record saltati (reset in avanti, <code>commitOn: "partial"</code> senza dead-letter durevole) va trattato come un incidente sui dati.</li></ul></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>task SQL, truncate e scambio di tabelle</span><!--]--></a></div><div class="pager" data-v-64d0b887><!----></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
32
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"
|
|
32
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"DUHajB0u\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"ChyXSf73\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"D8Si7E2S\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"D13C7Zwu\",\"guide_claude-code_index.md\":\"CxVSru8e\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"V_vlNfOz\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"f3LAxif4\",\"runbooks_deployment.md\":\"DvIOOsoG\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"BOXZqdXC\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DQP0pWc8\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori di posta\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
33
33
|
|
|
34
34
|
</body>
|
|
35
35
|
</html>
|