Coerenza dei dati nelle query Datastore

Livelli di coerenza dei dati

Le query del datastore possono restituire i risultati a due livelli di coerenza:

  • Le query molto coerenti garantiscono i risultati più recenti, ma potrebbero richiedere più tempo per essere completate.
  • Le query coerenti in modo asintotico in genere vengono eseguite più rapidamente, ma a volte possono restituire risultati non aggiornati.

In una query con coerenza finale, anche gli indici utilizzati per raccogliere i risultati sono accessibili con coerenza finale. Di conseguenza, a volte queste query possono restituire entità che non corrispondono più ai criteri della query originale, mentre le query fortemente coerenti sono sempre coerenti a livello di transazioni.

Coerenza dei dati delle query di Datastore

Le query restituiscono i risultati con diversi livelli di garanzia di coerenza, a seconda della loro natura:

  • Le query sugli antenati (quelle all'interno di un gruppo di entità) sono fortemente coerenti per impostazione predefinita, ma possono essere rese coerenti in modo definitivo impostando il criterio di lettura di Datastore (vedi di seguito).
  • Le query non relative agli antenati sono sempre coerenti in modo definitivo.

Il recupero di un'entità tramite chiave, chiamato anche "ricerca tramite chiave", è fortemente coerente.

Impostazione del criterio di lettura di Datastore

Per migliorare le prestazioni, puoi impostare il criterio di lettura di Datastore in modo che tutte le letture e le query siano eventualmente coerenti. L'API consente anche di impostare esplicitamente un criterio di coerenza forte, ma questa impostazione non avrà alcun effetto pratico, poiché le query non antecedenti sono sempre eventualmente coerenti indipendentemente dal criterio.

Puoi anche impostare la scadenza della chiamata di Datastore, ovvero il tempo massimo, in secondi, che l'applicazione attenderà che Datastore restituisca un risultato prima di abortire con un errore. Il termine per impostazione predefinita è di 60 secondi. Al momento non è possibile impostarlo su un valore superiore, ma puoi modificarlo verso il basso per assicurarti che una determinata operazione non vada a buon fine rapidamente (ad esempio, per restituire una risposta più rapida all'utente).

Per impostare il criterio di lettura e la scadenza della chiamata di Datastore in Python, li passi come argomenti ai metodi run(), get(), fetch() e count() della classe Query o GqlQuery. Ad esempio:

for result in Employee.all().run(limit=5,
                                 read_policy=db.EVENTUAL_CONSISTENCY,
                                 deadline=5):
  # Body of iterative loop

Passaggi successivi