Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Paginazione dei risultati in Amazon CloudSearch
Come impostazione predefinita, Amazon CloudSearch restituisce le prime dieci occorrenze in base al tipo di ordinamento specificato. Per controllare il numero di occorrenze restituite in un set di risultati, utilizza il parametro size.
Per ottenere il set successivo di occorrenze a partire da un determinato offset, è possibile utilizzare il parametro start. Il set di risultati è a base zero, il primo risultato è a indice 0. È possibile ottenere le prime 10.000 occorrenze utilizzando i parametri size e start. Per scorrere più di 10.000 occorrenze, si utilizza il parametro cursor. Per ulteriori informazioni, consulta Paginazione profonda oltre 10.000 occorrenze .
Ad esempio, search?q=wolverine restituisce le prime 10 occorrenze che contengono wolverine, a partire dall'indice 0. L'esempio seguente imposta il parametro start su 10 per ottenere il set di dieci occorrenze successivo.
search?q=wolverine&start=10
Per recuperare 25 occorrenze alla volta, imposta il parametro size su 25. Per ottenere il primo set di occorrenze non è necessario impostare il parametro start.
search?q=wolverine&size=25
Per le richieste successive, utilizza il parametro start per recuperare il set di occorrenze desiderato. Ad esempio, per ottenere il terzo batch di 25 occorrenze, specificare:
search?q=wolverine&size=25&start=50
Paginazione profonda oltre 10.000 occorrenze in Amazon CloudSearch
L'utilizzo di size e start per spostarsi tra le pagine dei risultati risulta efficace per accedere solo alle prime pagine dei risultati. Se invece si devono scorrere migliaia di occorrenze, è preferibile utilizzare un cursore. Per scorrere più di 10.000 occorrenze è necessario utilizzare un parametro cursor. Utilizzando i parametri start e size è possibile accedere solo alle prime 10.000 occorrenze.
Per scorrere i risultati utilizzando un cursore, è necessario specificarecursor=initialnella tua richiesta di ricerca iniziale e includi ilsizeper specificare quanti risultati si desidera ottenere. Amazon CloudSearch restituisce un valore del cursore nella risposta che puoi utilizzare per ottenere il set di occorrenze successivo. I cursori restituiscono set sequenziali di occorrenze, tuttavia, è possibile utilizzarle per simulare l'accesso casuale di una pagina profonda, se necessario. I cursori sono stati concepiti per permettere di scorrere un set di risultati entro un periodo di tempo ragionevole dalla richiesta iniziale. L'utilizzo di un cursore obsoleto può restituire risultati non aggiornati nel caso in cui nel frattempo nell'indice siano stati pubblicati aggiornamenti.
Importante
È possibile che, utilizzando un cursore per scorrere un set di risultati ordinato in base al punteggio dei documenti (_score), si ottengano risultati non coerenti se tra una richiesta e l'altra l'indice è stato aggiornato. Questo può accadere anche se il conteggio delle repliche del dominio è maggiore di uno, in quanto gli aggiornamenti vengono applicati in modo consistente finale tra le istanze del dominio. Se questo è un problema, evita di ordinare i risultati in base al punteggio. Puoi utilizzare l'opzione sort per ordinare i risultati in base a un campo specifico oppure puoi utilizzare fq anziché q per specificare criteri di ricerca personalizzati. (I punteggi dei documenti non vengono calcolati per filtrare le query).
Ad esempio, i set di richieste seguenti impostano il valore cursor su initial e il parametro size su 100 per ottenere il primo set di occorrenze.
search?q=-star&cursor=initial&size=100
Il cursore per il set di occorrenze successivo è incluso nella risposta.
{ "status": { "rid": "z67+3L0oHgo6swY=", "time-ms": 7 }, "hits": { "found": 1649, "start": 0, "cursor": "Vb-HSS4YQW9JSVFKeFpvQ2wwZERBek16SXpOems9Aw", "hit": [ { "id": "tt0397892" }, . . . { "id": "tt0332379" } ] } }
Nella richiesta successiva il parametro cursor specifica il valore di cursore restituito.
search?q=-star&cursor=Vb-HSS4YQW9JSVFKeFpvQ2wwZERBek16SXpOems9Aw&size=100
