Catatan: Python 2.7 telah mencapai akhir dukungan pada 31 Januari 2024. Aplikasi Python 2.7 Anda yang sudah ada akan terus berjalan dan menerima traffic. Namun, App Engine mungkin memblokir deployment ulang aplikasi yang menggunakan runtime setelah akhir tanggal dukungannya. Sebaiknya migrasikan ke Python versi terbaru yang didukung.

Referensi Python Entity Metadata

Catatan: Developer yang membuat aplikasi baru sangat dianjurkan untuk menggunakan Library Klien NDB, yang memiliki beberapa manfaat dibandingkan dengan library klien ini, seperti menyimpan entity dalam cache otomatis melalui Memcache API. Jika saat ini Anda menggunakan Library Klien DB versi lama, baca Panduan Migrasi DB ke NDB

Class model EntityGroup, Namespace, Kind, dan Property mewakili hasil untuk mendapatkan atau membuat kueri jenis metadata. Class ini semuanya ditentukan dalam paket google.appengine.ext.db.metadata. Lihat halaman Metadata untuk mengetahui informasi selengkapnya dan contoh penggunaannya.

Fungsi Bantuan

Fungsi bantuan berikut tersedia untuk memperoleh informasi metadata tanpa mengeluarkan kueri eksplisit atau mendapatkan:

get_entity_group_version(entity_or_key)

Menampilkan versi grup entity yang berisi entity_or_key. Versi ini dijamin akan meningkat pada setiap perubahan pada entity group. Versi ini dapat meningkat meskipun tidak ada perubahan yang terlihat oleh pengguna pada entity group. Dapat menampilkan None jika entity group tidak pernah dituliskan.

Peringatan: Perilaku metadata entity group kini berbeda. Versi entity group dapat meningkat secara terpisah dari update pengguna. Sebelumnya, versi entity group hanya meningkat saat update pengguna. Untuk mempertahankan perilaku lama, gunakan solusi versi entity group.

Argumen:

entity_or_key: kunci atau entity yang versinya Anda inginkan.

get_namespaces(start=None, end=None)

Menampilkan daftar nama namespace.

Argumen

start: Jika bukan None, hanya tampilkan nama namespace yang lebih besar dari atau sama dengan nilai yang ditentukan.
end: Jika bukan None, hanya tampilkan nama namespace yang lebih kecil dari nilai yang ditentukan.

get_kinds(start=None, end=None)

Menampilkan daftar nama jenis entity.

Argumen

start: Jika bukan None, hanya tampilkan nama jenis yang lebih besar dari atau sama dengan nilai yang ditentukan.
end: Jika bukan None, hanya tampilkan nama jenis yang lebih kecil dari nilai yang ditentukan.

get_properties_of_kind(kind, start=None, end=None)

Menampilkan daftar nama properti yang diindeks untuk jenis tertentu. Properti yang tidak diindeks tidak disertakan.

Argumen

kind: Jenis yang nama propertinya diminta.
start: Jika bukan None, hanya tampilkan nama properti yang lebih besar dari atau sama dengan nilai yang ditentukan.
end: Jika bukan None, hanya tampilkan nama properti yang kurang dari nilai yang ditentukan.

get_representations_of_kind(kind, start=None, end=None)

Menampilkan kamus yang memetakan setiap nama properti yang diindeks untuk jenis tertentu ke daftar representasinya. Properti yang tidak diindeks tidak disertakan.

Argumen

kind: Jenis yang representasi propertinya diminta.
start: Jika bukan None, hanya tampilkan representasi untuk properti yang namanya lebih besar dari atau sama dengan nilai yang ditentukan.
end: Jika bukan None, hanya tampilkan representasi untuk properti yang namanya kurang dari nilai yang ditentukan.

Class EntityGroup

Model untuk metadata __entity_group__ (hanya tersedia di datastore HR).

Metadata ini berisi properti __version__ numerik yang dijamin akan meningkat pada setiap perubahan pada entity group. Versi ini dapat meningkat meskipun tidak ada perubahan yang terlihat oleh pengguna pada entity group. Entity __entity_group__ mungkin tidak ada jika grup entity tidak pernah ditulis.

Properti

versi: Nomor versi

Metode Class

key_for_entity(entity_or_key)

Menampilkan kunci metadata untuk grup entity yang berisi entity_or_key. Gunakan kunci ini sebagai argumen untuk menjalankan get() pada entity metadata __entity_group__ untuk grup entity yang berisi entity_or_key.

Argumen:

entity_or_key: kunci atau entity yang kunci __entity_group__-nya Anda inginkan.

Class Namespace

Class Namespace mewakili entity metadata dari jenis __namespace__ khusus, yang ditampilkan sebagai hasil dari kueri namespace. Kunci entity adalah nama namespace. (Pengecualian adalah namespace default yang ditetapkan oleh string kosong "": karena ini bukan nama kunci yang valid, namespace default diwakili oleh kunci dengan ID numerik 1.)

Properti

Instance class Namespace memiliki properti berikut:

namespace_name: Menampilkan nama namespace yang ditentukan oleh kunci entity ini.

Metode Class

Class Namespace memiliki metode class berikut:

key_for_namespace(namespace)

Menampilkan kunci __namespace__ untuk namespace yang ditentukan.

Argumen

namespace: Namespace yang kuncinya diminta.

key_to_namespace(key)

Menampilkan namespace yang ditentukan oleh kunci __namespace__ yang disediakan.

Argumen

key: Kunci yang namanya diminta.

Class Jenis

Class Kind mewakili entity metadata dari jenis __kind__ khusus, yang ditampilkan sebagai hasil dari kueri jenis. Kunci entity adalah nama dari jenis entity.

Properti

Instance class Kind memiliki properti berikut:

kind_name: Menampilkan nama jenis yang ditentukan oleh kunci entity ini.

Metode Class

Class Kind memiliki metode class berikut:

key_for_kind(kind)

Menampilkan kunci __kind__ untuk jenis yang ditentukan.

Argumen

kind: Jenis yang kuncinya diminta.

key_to_kind(key)

Menampilkan jenis yang ditentukan oleh kunci __kind__ yang diberikan.

Argumen

key: Kunci yang jenisnya diminta.

Class Properti

Class Property mewakili entity metadata dari jenis khusus __property__, yang ditampilkan sebagai hasil dari kueri properti. Entity yang mewakili properti P jenis K dibuat sebagai berikut:

Kunci entity memiliki jenis __property__ dan nama kunci P.
Kunci parent entity memiliki jenis __kind__ dan nama kunci K.

Properti

Instance class Property memiliki properti berikut:

kind_name: Menampilkan nama jenis yang ditentukan oleh kunci entity ini.
property_name: Menampilkan nama properti yang ditentukan oleh kunci entity ini.

Metode Class

Class Property memiliki metode class berikut:

key_for_kind(kind)

Menampilkan kunci induk untuk kunci __property__ dari jenis yang ditentukan.

Argumen

kind: Jenis yang kunci induknya diminta.

key_for_property(kind, property)

Menampilkan kunci __property__ untuk properti dan jenis yang ditentukan.

Argumen

kind: Jenis yang kuncinya diminta.
property: Properti yang kuncinya diminta.

key_to_kind(key)

Menampilkan jenis yang ditentukan oleh kunci __property__ yang diberikan.

Argumen

key: Kunci yang nama jenisnya diminta.

key_to_property(key)

Menampilkan properti yang ditentukan oleh kunci __property__ tertentu, atau None jika kunci hanya menentukan sebuah jenis.

Argumen

key: Kunci yang nama propertinya diminta.