user130076
user130076

Reputation:

Google App Engine - Datastore get_or_insert key_name confusion

I am confused by get_or_insert(..). What should I pass as the key_name? Consider the following example:

class Person(db.model)
    name = db.StringProperty(required=True)

Assume that no two people can have the same name. Say I want to get or insert a new Person with name Peter, what would my get_or_insert statement look like?

Cheers,

Pete

Upvotes: 5

Views: 3905

Answers (2)

Robert Kluin
Robert Kluin

Reputation: 8292

You can think of key_name like a primary key. Look at the docs for get_or_insert(...), there is an example of what the back-end code looks like.

If name is a unique field, you might want to use that as the key name too. Although I would suggest stripping white-space and normalizing case.

Upvotes: 1

bgporter
bgporter

Reputation: 36474

The possibly confusing thing here is that the key doesn't show up directly in your model declaration, so that name = db.StringProperty bit in your example isn't needed. get_or_insert takes the keyname as its first (required) argument, so you're looking for code like:

person = Person.get_or_insert('Peter')
# other interesting & useful code here...
# later, maybe we need to retrieve that key name from the object:
name = person.key().name()
assert(name == "Peter")

Upvotes: 5

Related Questions