Dopo aver creato una query, puoi specificare una serie di opzioni di recupero per controllare ulteriormente i risultati che restituisce. Consulta le query sul datastore per ulteriori informazioni sulla strutturazione delle query per la tua app.
Recupero di una singola entità
Per recuperare solo una singola entità che corrisponde alla query, utilizza il metodo PreparedQuery.asSingleEntity()
:
Questo restituisce il primo risultato trovato nell'indice che corrisponde alla query.
Se è presente più di un risultato corrispondente, viene visualizzato un valore TooManyResultsException
.
Ripetizione dei risultati delle query
Durante l'iterazione dei risultati di una query utilizzando i metodi PreparedQuery.asIterable()
e PreparedQuery.asIterator()
, Cloud Datastore recupera i risultati in batch. Per impostazione predefinita, ogni batch contiene 20 risultati, ma puoi modificare questo valore utilizzando FetchOptions.chunkSize()
. Puoi continuare a eseguire l'iterazione dei risultati della query fino a quando non vengono restituiti tutti i risultati o fino al timeout della richiesta.
Recupero delle proprietà selezionate da un'entità
Per recuperare solo le proprietà selezionate di un'entità anziché l'intera entità, utilizza una query di proiezione. Questo tipo di query viene eseguito più velocemente e costa meno di una query che restituisce entità complete.
Analogamente, una query solo con chiavi consente di risparmiare tempo e risorse restituendo solo le chiavi alle entità corrispondenti, anziché alle entità complete. Per creare questo tipo di query, utilizza il metodo Query.setKeysOnly()
:
Impostazione di un limite per la query
Puoi specificare un limite per la query per controllare il numero massimo di risultati restituiti in un batch. L'esempio seguente recupera le cinque persone più alte da Cloud Datastore:
Che cosa succede dopo?
- Scopri le limitazioni comuni per le query su Cloud Datastore.
- Scopri di più sui cursori di query, che consentono a un'applicazione di recuperare i risultati di una query in pratici batch.
- Comprendi la coerenza dei dati e come funziona la coerenza dei dati con diversi tipi di query su Cloud Datastore.
- Scopri la sintassi e la struttura di base delle query per Cloud Datastore.