Cloud NDB基于Key查询实体触发TypeError报错的正确实现问询

报错原因 #

ndb.Query 方法仅支持接收 ndb 过滤表达式节点作为参数，你直接传入 ndb.Key 对象不符合参数要求，因此抛出类型错误。

最优解决方案 #

你要实现的是按主键查询实体，这本身就是 Datastore 中效率最高的读取操作，完全不需要走查询接口，直接调用 Key 的 get() 方法即可：

with client.context():
    ans = ndb.Key("Word", "love").get()

这种方式是 O(1) 复杂度的直读操作，不需要扫描任何索引，延迟远低于查询方式，完全满足你对最高效查询的要求。

（不推荐）查询写法适配 #

如果你确实需要通过 query 接口实现相同逻辑，可以调整过滤条件的写法：

with client.context():
    ans = Word.query(Word.key == ndb.Key("Word", "love")).get()

这种写法需要走索引查询，性能弱于直接按键读取，仅做兼容参考。

内容的提问来源于stack exchange，提问作者salyela