Risorse · 86
Esportazioni API: paginazione, ripresa e riconciliazione
Controllare cosa viene letto, quando continuare e come dimostrare la copertura.
Aggiornato · 3 min
Obiettivi di questa guida
- Definire la collezione
- Trattare il cursore come continuazione
- Riconoscere la fine prevista
- Riprendere dopo una scrittura durevole
- Riconciliare la copertura
Verifica rapida
- Una pagina vuota conclude l’esportazione?
- Possedere un cursore concede accesso?
- La deduplicazione evita tutte le perdite?
Metodo passo passo
- 1
Definire la collezione
Fissare filtri, ordinamento e criterio di spareggio. Due record possono avere lo stesso timestamp. Distinguere una collezione aggiornata durante la lettura da una fotografia realmente garantita dal servizio.
Risultato: perimetro e ordine documentati.
- 2
Trattare il cursore come continuazione
Un token opaco non autorizza la lettura. Verificare identità e permessi a ogni richiesta, associare la continuazione ai parametri e specificare scadenza e condizioni di riuso.
Risultato: contratto del token e controlli di accesso.
- 3
Riconoscere la fine prevista
Una pagina corta o vuota non dimostra sempre la fine. Nel contratto AIP-158 la fine è indicata dall’assenza di next_page_token. Individuare token ripetuti e interruzioni senza avanzamento.
Risultato: condizioni di fine e allarme di ciclo.
- 4
Riprendere dopo una scrittura durevole
Salvare il checkpoint dopo aver registrato il lotto. Deduplicare con identificatori stabili. Se la fotografia scade, scegliere esplicitamente fra nuova lettura e riconciliazione; non promettere continuità impossibile.
Risultato: procedura di ripresa testata.
- 5
Riconciliare la copertura
Confrontare identificatori unici, stati, esclusioni e data di riferimento. Due conteggi uguali possono coprire oggetti diversi. Provare inserimenti, modifiche e cancellazioni durante la lettura.
Risultato: evidenze del perimetro effettivamente esportato.
Continuare o riprendere?
Leggere il contratto prima di interpretare la pagina.
Fine dichiarata?
Terminare solo sul segnale previsto dal servizio.
Token valido e progressivo?
Rilevare scadenza, ripetizioni e parametri incoerenti.
Lotto registrato?
Aggiornare il checkpoint dopo la scrittura durevole.
Copertura riconciliata?
Confrontare identificatori e perimetro di riferimento.
Una pagina vuota con un token valido può richiedere una richiesta successiva.
Foglio di lavoro riutilizzabile
Completare con le proprie osservazioni autorizzate. Questi campi costituiscono un modello di lavoro, non risultati osservati.
| Campo | Informazioni da registrare |
|---|---|
| Collezione | Filtri, ordine, spareggio e riferimento |
| Continuazione | Token, scadenza e fine |
| Ripresa | Checkpoint e scrittura durevole |
| Risultato | Identificatori, esclusioni e riconciliazione |
Esempio pratico fittizio
Situazione illustrativa
Esempio fittizio: durante un’esportazione a offset vengono aggiunti prodotti all’inizio della lista.
Decisione e prove attese
Il collaudo rileva ripetizioni e assenze. Si usa una fotografia disponibile oppure si dichiara la lettura dinamica e si riconciliano gli identificatori.
Distinguere i meccanismi
| Meccanismo | Scopo | Verifica o limitazione |
|---|---|---|
| Offset | Semplice accesso per posizione | Gli inserimenti possono spostare i record |
| Cursore | Continua secondo un contratto | Non garantisce da solo una fotografia |
| Fotografia | Stabilizza un perimetro se supportata | Validità, costo e scadenza da conoscere |
Indicatori di gestione
| Indicatore | Cosa misura | Prima azione |
|---|---|---|
| Identificatori unici | Oggetti esportati senza ripetizioni | Indagare sovrapposizioni |
| Avanzamento | Token e pagine che progrediscono | Fermare i cicli |
| Copertura verificata | Confronto con un riferimento definito | Spiegare mancanti e variazioni |
Errori comuni
- Gli inserimenti possono spostare i record
- Non garantisce da solo una fotografia
- Validità, costo e scadenza da conoscere
Domande frequenti
Una pagina vuota conclude l’esportazione?
Dipende dal contratto. Leggere il segnale di continuazione, non dedurre la fine dalla sola lunghezza.
Possedere un cursore concede accesso?
No. Ogni richiesta deve applicare i controlli di autorizzazione.
La deduplicazione evita tutte le perdite?
No. Elimina ripetizioni riconosciute, ma non recupera automaticamente record mai letti.
Riferimenti ufficiali
I riferimenti supportano il metodo. Adattare i controlli al proprio contesto; non costituiscono una certificazione. I titoli dei riferimenti originali e i documenti di origine potrebbero essere in un'altra lingua.
Riferimenti consultati il .
