---
title: "Ripristinare una sincronizzazione bloccata o fallita | Centro Assistenza | Tajo"
description: "Che cosa fa Tajo da solo quando un worker si ferma o un'esecuzione di sincronizzazione fallisce, che cosa mostra la pagina della sincronizzazione e quando tocca a te: nuovo tentativo, riconnessione, correzione della mappatura o nuova pubblicazione."
url: https://tajo.io/it/resources/help/troubleshooting/recover-a-stuck-or-failed-sync/
markdown: https://tajo.io/it/resources/help/troubleshooting/recover-a-stuck-or-failed-sync.md
lang: it-IT
robots: noindex
---

Richiedi l’accesso anticipato

Inserisci il tuo nome e il tuo indirizzo email. Ti invieremo un link per confermare la richiesta di accesso a Tajo.

[Set Noa](https://tajo.io/it/set-noa/) Principiante 6 min 6 nov 2026

# Ripristinare una sincronizzazione bloccata o fallita

Che cosa fa Tajo da solo quando un worker si ferma o un'esecuzione di sincronizzazione fallisce, che cosa mostra la pagina della sincronizzazione e quando tocca a te: nuovo tentativo, riconnessione, correzione della mappatura o nuova pubblicazione.

**Un’esecuzione di sincronizzazione può fermarsi a metà perché un worker si riavvia, l’altro sistema non risponde o un record viene rifiutato. Dopo un worker fermo o un disservizio passeggero, Tajo riprende la sincronizzazione da solo. Non invia di nuovo i record che ha scritto negli ultimi sette giorni. Questa pagina spiega che cosa fa, che cosa vedi nella pagina della sincronizzazione e i pochi casi in cui devi intervenire.**

> **Controllo rapido** Apri la sincronizzazione da **Syncs and mappings** sotto Connections e leggi l’esecuzione più recente in **Run history**. Un’esecuzione fallita dice che cosa è successo e che cosa fare dopo.

## Che cosa fa Tajo da solo

**Il cursore.** Un’esecuzione legge la sorgente a batch, a partire dal cursore salvato della sincronizzazione. Il cursore avanza alla fine di un batch solo se ogni record di quel batch è arrivato. Se l’esecuzione fallisce, resta l’ultima posizione raggiunta senza errori. L’esecuzione successiva parte da lì, quindi un batch interrotto viene riletto invece che saltato.

**Il registro delle consegne.** Prima che un record venga scritto, riceve una chiave di consegna. La chiave è un hash della sincronizzazione, della sorgente, del cursore di pagina, della posizione del record nella pagina e del record stesso, quindi non contiene dati personali. Prima di chiamare la destinazione, la chiave viene prenotata. Quando la scrittura riesce, la chiave viene segnata come completata e conservata per sette giorni. La chiave non dipende dall’esecuzione che la chiede, quindi un nuovo tentativo o un’esecuzione pianificata successiva ricava la stessa chiave per lo stesso record. Entro quei sette giorni viene usato il risultato memorizzato e la destinazione non viene chiamata di nuovo. Per questo un batch ripetuto non arriva due volte.

**Una sola esecuzione alla volta.** Ogni sincronizzazione ha una sola concessione temporanea, detenuta dall’esecuzione in corso per tutta la sua durata. La concessione ha un proprio token e una durata di 15 minuti, rinnovata ogni 5 minuti mentre l’esecuzione lavora. Un’esecuzione che perde la concessione si ferma prima della scrittura o del checkpoint successivo, per evitare di scrivere due volte. Quando un worker si ferma, la sua concessione non viene più rinnovata e scade entro 15 minuti.

**Nuovi tentativi automatici.** Un’esecuzione in coda che fallisce ha fino a cinque tentativi. Tajo aspetta 60 secondi prima del secondo tentativo, poi 120, 240 e 480 secondi. Un nuovo tentativo o un’esecuzione di test che avvii tu viene eseguito una sola volta. Un’esecuzione che si è scontrata con un’altra già in corso non viene ritentata, e nemmeno un’esecuzione la cui versione pubblicata o le cui connessioni non sono più valide.

**Esecuzioni bloccate.** Per una sincronizzazione che Tajo esegue secondo una pianificazione, un’esecuzione viene chiusa e ne viene messa in coda una nuova quando è partita da più di un’ora e non detiene più la sua concessione. L’esecuzione chiusa mostra “The run stopped reporting progress and was closed.” (l’esecuzione ha smesso di segnalare i progressi ed è stata chiusa). Quindi la concessione di un’esecuzione ferma dura al massimo 15 minuti, e l’esecuzione bloccata di una sincronizzazione pianificata viene sostituita dopo un’ora. [Capire la sincronizzazione dei dati](https://tajo.io/it/resources/help/getting-started/understanding-data-sync/) indica quali sincronizzazioni vengono eseguite secondo una pianificazione.

**Pausa dopo errori ripetuti.** Se le ultime cinque esecuzioni concluse dall’ultima modifica della sincronizzazione sono tutte fallite, Tajo mette in pausa la sincronizzazione. La sua pagina mostra “Paused automatically by the failure circuit breaker” con l’ultimo errore. Una sola esecuzione riuscita azzera il conteggio. Niente riavvia da solo una sincronizzazione in pausa: resta in pausa finché non correggi la causa e non la pubblichi di nuovo.

**Il controllo orario.** Ogni ora, al minuto 13, Tajo avvisa il proprio team di ogni workspace che ha una sincronizzazione attiva e nessuna esecuzione riuscita nelle ultime 24 ore. Questo include un workspace in cui non è stata registrata alcuna esecuzione. L’avviso parte una volta, e riparte solo dopo che un’esecuzione è riuscita. Un workspace la cui sincronizzazione attiva più vecchia è stata abilitata o modificata meno di 24 ore fa non viene ancora controllato. Questo avviso arriva a Tajo, non a te, e non modifica la tua sincronizzazione.

## Che cosa vedi

Apri la sincronizzazione da **Syncs and mappings**. **Run history** elenca ogni esecuzione con i record scritti sui record letti, il numero di errori, la durata e l’ora di avvio. Il suo stato è Queued, Running, Succeeded, Partial (alcuni record sono falliti) o Failed.

- Un’esecuzione in corso che non segnala progressi da 2 minuti mostra “Waiting for a fresh progress update” (in attesa di un nuovo aggiornamento sui progressi).
- Un’esecuzione fallita mostra una frase su che cosa è successo, una su che cosa fare dopo, il nome dell’errore e l’id dell’esecuzione.
- **View DLQ** nella pagina **Syncs** elenca le esecuzioni fallite e parziali di tutte le sincronizzazioni, ognuna con un pulsante **Retry**.

## Che cosa fare

1. **Leggi l’esecuzione fallita più recente.** La sua riga “che cosa fare” è il passo successivo. La tabella qui sotto elenca gli errori che incontrerai più spesso.
2. **Se dice “Nothing”, aspetta.** La prossima esecuzione pianificata si ripristina da sola.
3. **Se dice di eseguire di nuovo la sincronizzazione,** premi **Retry** sull’esecuzione fallita in **View DLQ**. Il nuovo tentativo parte dal cursore salvato, quindi i batch già scritti non vengono scritti di nuovo. Un nuovo tentativo riuscito toglie l’esecuzione fallita dall’elenco.
4. **Se la sincronizzazione è stata messa in pausa,** correggi la causa indicata dal banner, poi pubblica di nuovo la sincronizzazione con **Publish sync** o **Request publish approval**.
5. **Se lo stesso errore si ripresenta,** inviaci l’id dell’esecuzione mostrato sotto l’esecuzione fallita.

Ogni nome di errore corrisponde a una frase su che cosa è successo, una su che cosa fare dopo e a chi lo corregge: tu o Tajo.

| Nome dell’errore | Che cosa è successo | Che cosa fare | Chi lo corregge |
| --- | --- | --- | --- |
| `lease_conflict` | Un’altra esecuzione di questa sincronizzazione era già in corso. | Niente. L’esecuzione in corso terminerà; la prossima esecuzione pianificata parte normalmente. | Tajo |
| `lease_lost` | L’esecuzione ha perso il suo slot a metà ed è stata fermata per evitare di scrivere due volte. | Esegui di nuovo la sincronizzazione. | Tajo |
| `lease_unavailable` | La sincronizzazione non è riuscita a riservare il suo slot di esecuzione. | Esegui di nuovo la sincronizzazione. Se fallisce allo stesso modo, inviaci l’id dell’esecuzione. | Tajo |
| `stale_job_swept` | L’esecuzione ha smesso di segnalare i progressi ed è stata chiusa. | Esegui di nuovo la sincronizzazione. | Tajo |
| `provider_rate_limited` | L’altro sistema ci ha chiesto di rallentare. | Niente. Aspetta la prossima esecuzione pianificata. | Tajo |
| `provider_unavailable` | L’altro sistema non era disponibile o non ha risposto in tempo. | Niente. Aspetta la prossima esecuzione pianificata. Se fallisce allo stesso modo per un giorno, inviaci l’id dell’esecuzione. | Tajo |
| `connection_missing` | Uno strumento usato dalla sincronizzazione non è connesso in questo workspace; l’esecuzione lo indica. | Connettilo, poi esegui di nuovo la sincronizzazione. | Tu |
| `connection_unauthorized` | L’altro sistema ha rifiutato il nostro accesso. | Riconnetti la connessione perché riceva una nuova autorizzazione, poi esegui di nuovo la sincronizzazione. | Tu |
| `destination_rejected` | La destinazione ha rifiutato tutti i record di questa esecuzione. | Confronta la mappatura dei campi con i campi obbligatori e i formati della destinazione, poi esegui di nuovo la sincronizzazione. | Tu |
| `node_failed` | Un passaggio della sincronizzazione è fallito durante la lettura, la trasformazione o la scrittura dei record. | Apri l’esecuzione per vedere quale passaggio è fallito e perché, correggilo, poi esegui di nuovo la sincronizzazione. | Tu |
| `attestation_rule_not_active` | Questa sincronizzazione è in pausa. | Riattiva la sincronizzazione per eseguirla. | Tu |
| `attestation_publication_not_attested` | Questa versione della sincronizzazione non è stata pubblicata. | Pubblica la sincronizzazione. Le modifiche a una sincronizzazione non vengono eseguite finché non sono pubblicate. | Tu |
| `unclassified_exception` | La sincronizzazione è fallita per un motivo che non abbiamo ancora classificato. | Esegui di nuovo la sincronizzazione. Se fallisce allo stesso modo, inviaci l’id dell’esecuzione. | Tajo |

## Che cosa può andare storto

- **Retry risponde “This sync rule is already running.”** (questa regola di sincronizzazione è già in esecuzione). Un nuovo tentativo o un’esecuzione di test che avvii tu viene rifiutato finché un’esecuzione della sincronizzazione risulta Queued o Running, anche un’esecuzione il cui worker si è fermato. Per una sincronizzazione che Tajo esegue secondo una pianificazione, quell’esecuzione viene chiusa e sostituita quando è partita da più di un’ora. Per qualsiasi altra sincronizzazione, inviaci l’id dell’esecuzione.
- **Una sincronizzazione fallisce da più di sette giorni.** Dopo sette giorni il registro dimentica una scrittura completata. Un batch ripetuto dopo quel momento può scrivere di nuovo dei record, quindi controlla nella destinazione se ci sono [contatti duplicati](https://tajo.io/it/resources/help/troubleshooting/duplicate-contacts/).
- **Una sincronizzazione tace mentre un’altra funziona.** Il controllo orario sorveglia il workspace, non ogni sincronizzazione. Una sincronizzazione sana nasconde una sincronizzazione silenziosa nello stesso workspace, quindi leggi la Run history di ogni sincronizzazione.
- **Vuoi limiti diversi.** La pausa dopo cinque errori e il controllo delle 24 ore sono impostati per l’intera installazione di Tajo, non per singola sincronizzazione.

## Articoli correlati

- [Capire la sincronizzazione dei dati](https://tajo.io/it/resources/help/getting-started/understanding-data-sync/)
- [I dati non si sincronizzano](https://tajo.io/it/resources/help/troubleshooting/data-not-syncing/)
- [Disconnetti o riconnetti](https://tajo.io/it/resources/help/integrations/disconnect-or-reconnect/)

## Articoli Popolari

[Centro Assistenza](https://tajo.io/it/resources/help)

### Vedi tutto

Tutte le Risorse

## Questa pagina in Markdown: [recover-a-stuck-or-failed-sync.md](https://tajo.io/it/resources/help/troubleshooting/recover-a-stuck-or-failed-sync.md)

Caricamento del Markdown…

[Apri in Claude](https://claude.ai/new) [Apri in ChatGPT](https://chatgpt.com/)