database - Appengine 的 NDB 中的 context.map_query 和 qry.map_async 有什么区别？

Question

该文档似乎表明它们可以类似地使用。有什么区别，什么时候应该使用？应该使用哪个以获得最佳性能（因为两者都表明它们是“最快的”）。

context.map_query 的文档：https ://docs.google.com/document/d/1rPyB2RmRERAZDPpqy2cxzXeDGyfLhX-s-3dFVpnwFXw/edit?hl=en_US#heading=h.wniiq5a4ja4o

qry_obj.map_async 的文档：https ://docs.google.com/document/d/1rPyB2RmRERAZDPpqy2cxzXeDGyfLhX-s-3dFVpnwFXw/edit?hl=en_US#heading=h.t1t6424hbp7y

Answer 1

绝对使用 qry_obj.map_async()。Context().map_query() 是您不需要的较低级别的 API。请注意，该文件已过时；我有一个 TODO 来更新它，但其他事情一直优先。幸运的是，Google App Engine 文档团队现在正在帮助编写文档。

Answer 2

查看它出现的实现Query.map_async只是调用的快捷方式Context.map_query：

def map_async(self, callback, merge_future=None, **q_options):
   """Map a callback function or tasklet over the query results.

   This is the asynchronous version of Query.map().
   """
   return tasklets.get_context().map_query(self, callback,
                                           options=_make_options(q_options),
                                           merge_future=merge_future)