Datastore 查詢中的資料一致性

這個 API 支援第一代執行階段，可在升級至對應的第二代執行階段時使用。如果您要更新至 App Engine Go 1.12 以上版本的執行階段，請參閱遷移指南，瞭解舊版套裝組合服務的遷移選項。

資料一致性等級

Datastore 查詢能夠提供的結果分為兩種一致性等級：

• 「同步一致性」查詢可保證獲得最新的結果，但可能需要較長的時間才能完成。
• 最終一致性查詢的執行速度通常較快，但偶爾可能會傳回過時的結果。

在最終一致性查詢中，用於收集結果的索引也是透過最終一致性的方式來存取。因此，這類查詢有時候會傳回不再符合原始查詢條件的實體，而具有同步一致性的查詢則一律具有交易一致性。

Datastore 查詢資料一致性

根據查詢的性質，查詢會傳回一致性保證等級不同的結果：

• 根據預設，祖系查詢 (在實體群組內) 會維持同步一致性，但可以藉由設定 Datastore 讀取政策 (請見下文) 改為維持最終一致性。
• 非祖系查詢始終會維持最終一致性。

按金鑰擷取實體 (也稱為「按金鑰查詢」) 會維持同步一致性。

相關資源

• 瞭解如何指定查詢傳回的內容，以及如何進一步控制查詢結果。
• 瞭解進行 Datastore 查詢時的常見限制。
• 瞭解查詢游標，應用程式可運用這項功能分批擷取查詢結果，十分方便。
• 瞭解 Datastore 查詢的基本語法與結構。