Cursor Pagination
Paginação por cursor
A paginação por cursor continua após um marcador oculto em uma ordem fixa de classificação. Ela não conta nem pula nenhum registro anterior.
Outro exemplo
Uma fila de revisão classifica casos por `created_at DESC, id DESC` e retorna um `endCursor` que oculta ambos os valores. Casos novos acima não repetem linhas já revisadas. Se o registro do cursor for excluído, a próxima página ainda começa na fronteira de ordenação, e cursores alterados falham na validação.
Partes principais
- 01Ordem única determinística
- 02Cursor de continuação opaco
- 03página de borda limitada
Use-o quando
Use-o para dados grandes ou rapidamente mutáveis quando páginas seguintes e anteriores estáveis são mais importantes do que os números das páginas.
Não o use quando
Não esconda um deslocamento de banco de dados em mudança e chame-o de cursor. Não prometa saltos para qualquer página sem um plano de índice separado.
Nome usado no código
opaque cursor over a unique deterministic sort key + first/after or last/before Antes de lançar
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Complete the task with Paginação por cursor (Cursor Pagination). User context: Uma fila de revisão classifica casos por `created_at DESC, id DESC` e retorna um `endCursor` que oculta ambos os valores. Casos novos acima não repetem linhas já revisadas. Se o registro do cursor for excluído, a próxima página ainda começa na fronteira de ordenação, e cursores alterados falham na validação. Technical concept or control: Paginação por cursor (Cursor Pagination). Why it fits: Use-o para dados grandes ou rapidamente mutáveis quando páginas seguintes e anteriores estáveis são mais importantes do que os números das páginas. Do not use it when: Não esconda um deslocamento de banco de dados em mudança e chame-o de cursor. Não prometa saltos para qualquer página sem um plano de índice separado. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): Nenhum padrão oficial único controla todo o termo. Seu significado pode mudar entre equipes, plataformas ou frameworks. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Conferir este pedido
Review how Paginação por cursor (Cursor Pagination) is used now. Definition: A paginação por cursor continua após um marcador oculto em uma ordem fixa de classificação. Ela não conta nem pula nenhum registro anterior. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.