GAE 翻译(4)Keys and Entity Groups

最新推荐文章于 2021-01-30 07:58:24 发布

翻译最新推荐文章于 2021-01-30 07:58:24 发布 · 893 阅读

文章标签：

#gae #存储 #query #table #class #api

本文介绍了Datastore中实体的概念，包括实体的键、种类、名称和ID等关键概念。详细解释了实体如何通过键来唯一标识，以及实体组、祖先和路径之间的关系。此外还讨论了实体的创建和事务处理等问题。

Keys and EntityGroups

每个entity 都有一个key，是entity 提供唯一的标识给应用程序。一个key 有几个组成部分：一个路径描述它和其它entity 之间的父子关系;Entity 的表类;程序给entity 的一个名字或者datastore给entity 的一个数字ID。

· Kinds, Names and IDs

· Entity Groups, Ancestors and Paths

· Paths and Key Uniqueness

Kinds, Names and IDs

每个entity 属于一个特定表类。查询可以返回一组entity。不象table 中的行，尽管应用程序能够在数据模型中建立约束，2个同表类的entity不一定具有完全一样的属性。datastore API 用 Model或者 Expando 的子类的名字作为表类的名字。

例如，这个类定义了一个模型给一个”Story”种类

class Story(db.Model):
title = db.StringProperty()
author = db.StringProperty()

每个 entity 有一个标识。一个应用程序可以赋值这个标识，在建立实例的时候用key_name参数就可以了

s = Story(key_name="xzy123")

如果没有指定 key_name ，datastore 缺省会给它一个数字id

s2 = Story() # s2 does not have a name or an ID.
s2.put() # s2 is given an ID by the datastore.

一旦建立，entity 的ID 或者名字不能改变

提示：在查询语句中key值不能象属性一样使用。但是你可以用一个命名了的key，并把名称作为属性存储。如果是数字ID 的话，可以通过 obj.key().id() 获取ID 的值，然后赋给一个属性，然后对这个属性来排序就等于对id 排序了

Entity Groups, Ancestors and Paths

每个entity 属于一个entity组。单个事务可以操作一组entity。Entity组的关系告诉appengine 在分布式网络同一部分储存几个entity。一个事务为一个entity组建立起datastore的操作，要么全部成功要么全部失败。

当应用程序创建一个entity，它能够把另外一个entity赋值为它的父亲。这个操作把新的entity并到父亲的同一组。

没有父亲的entity 是根entity。父子关系可以多级。从根节点开始的链称为entity的路径。这个路径上的entity都是它的祖先。Entity创建的时候，父亲就指定了并且不能被改变。

每个entity 和它的父亲entity都属于同一组。所有同组的entity 都储存于datastore 的同一个节点。同一个事务可以修改同组的多个entity，或者为新增的entity 指定现存的entity作为父亲。

如果一个entity 是一个已经删除的entity 的祖先，它的后代将不会被删除，后代仍然保留这继承路径。

通过指定继承路径，你可以先于创建父亲来创建一个 entdity 。为了实现，你使用 keyname 创建一个 key 给祖先，然后用它作为新 entity 的父亲。所有具备相同的根祖先的 entity 都属于同一组。无论这个 root 祖先是否一个真正的 entity 。

提示

· 只有需要事务的时候才使用entity组。其它的一些数据关系请使用ReferenceProperty和key值，他们可以在query 里面使用。

· 你的程序用entity组用的越多，就是说，越多的根entity，datastore就能够越有效率的使用节点存储这些entity。更好的分布可以提高创建和更新的性能。并且多用户在试图同时更新同组的entity的时候会导致一些事务的重新执行，可能导致失败。不要把所有的entity 放在同一个root.