python - 了解 ndb 键类与 KeyProperty

Question

我已经查看了文档、文档和 SO 问题和答案，但仍在努力理解其中的一小部分。您应该选择哪个以及何时选择？

这是我到目前为止读过的内容(只是示例):

• ndb documentation
• movie database structure on SO
• Parent Key issues

关键类对我来说似乎很简单。当您创建一个 ndb 实体时，数据存储会自动为您创建一个 key ，通常采用 key(Kind, id) 的形式，其中为您创建了 id。

假设您有这两个模型:

class Blah(ndb.Model):
     last_name = ndb.StringProperty()

class Blah2(ndb.Model):
     first_name = ndb.StringProperty()
     blahkey = ndb.KeyProperty()

因此，只需使用 key 类型，您就可以让 Blah1 成为 parent (或有多个姓氏相同的家庭成员)

lname = Blah(last_name = "Bonaparte")
l_key = lname.put() **OR**
l_key = lname.key.id() # spits out some long id 

fname_key = l_key **OR**
fname_key = ndb.Key('Blah', lname.last_name) # which is more readable.. 

然后:

lname = Blah2( parent=fname_key, first_name = "Napoleon")
lname.put()

lname2 = Blah2( parent=fname_key, first_name = "Lucien")
lname2.put()

到目前为止一切顺利(我认为)。现在介绍 Blah2 的 KeyProperty。假设 Blah1 仍然相同。

lname3 = Blah2( first_name = "Louis", blahkey = fname_key)
lname3.put()

这是正确的吗？

如何查询各种事物

查询姓氏:

Blah.query() # all last names
Blah.query(last_name='Bonaparte') # That specific entity.

名字:

Blah2.query()
napol =   Blah2.query(first_name = "Napoleon")
bonakey = napol.key.parent().get() # returns Bonaparte's key ??

bona = bonakey.get() # I think this might be redundant

这就是我迷路的地方。如何使用键或键属性从名字中查找 Bonaparte。我没有在这里添加它，也许应该添加它，这是 parent 、祖 parent 、曾祖 parent 的讨论，因为 Keys 跟踪祖先/ parent 。

与固有 key 类相比，您将如何以及为何使用 KeyProperty。还假设您有 3 个传感器 s1、s2、s3。每个传感器都有数以千计的读数，但您希望将读数与 s1 相关联，以便您可以用图表表示今天 s1 的所有读数。你会用哪个？ KeyProperty 还是关键类？如果这个问题在其他地方得到了回答，我深表歉意，但我没有看到关于选择哪个以及为什么/如何选择的明确示例/指南。

Answer 1

我认为混淆来自使用 key 。 Key 不与实体内部的任何属性相关联，它只是定位单个实体的唯一标识符。它可以是数字或字符串。

幸运的是，除了这一行之外，您的所有代码看起来都不错:

fname_key = ndb.Key('Blah', lname.last_name) # which is more readable.. 

构造一个 Key 需要一个唯一的 ID，这与属性不同。也就是说，它不会将变量 lname.last_name 与属性 last_name 相关联。相反，您可以像这样创建记录:

lname = Blah(id = "Bonaparte")
lname.put()
lname_key = ndb.Key('Blah', "Bonaparte")

您保证只有一个 Blah 实体具有该 ID。事实上，如果您使用像 last_name 这样的字符串作为 ID，则无需将其存储为单独的属性。将实体 ID 视为唯一的额外字符串属性。

接下来，注意不要假设 Blah.last_name 和 Blah2.first_name 在您的查询中是唯一的:

lname = Blah2( parent=fname_key, first_name = "Napoleon")
lname.put()

如果您多次执行此操作，将会有多个实体的 first_name 为 Napoleon(所有实体都具有相同的父键)。

继续上面的代码:

napol =   Blah2.query(first_name = "Napoleon")
bonakey = napol.key.parent().get() # returns Bonaparte's key ??
bona = bonakey.get() # I think this might be redundant

napol 包含查询，而不是结果。您需要调用 napol.fetch() 以获取所有带有“Napolean”的实体(如果您确定只有一个实体，则调用 napol.get())。bonakey 恰恰相反，它持有父实体是因为 get() 而不是 Bonaparte 的 key 。如果您关闭 .get()，那么 bona 将正确地拥有父级。

最后，关于传感器的问题。您可能不需要 KeyProperty 或“固有” key 。如果您有这样的阅读课:

class Readings(ndb.Model):
    sensor = ndb.StringProperty()
    reading = ndb.IntegerProperty()

然后您可以将它们全部存储在一个没有键的表中。 (您可能希望包括时间戳或其他属性。)稍后，您可以使用此查询检索 then:

s1_readings = Readings.query(Readings.sensor == 'S1').fetch()