Riferimento ai metadati di NDB

In questa pagina viene descritto come utilizzare le API e i servizi legacy raggruppati. Questa API può essere eseguita solo nei runtime di prima generazione nell'ambiente standard di App Engine. Se esegui l'aggiornamento al runtime App Engine Python 3, consulta la guida alla migrazione per scoprire di più sulle opzioni di migrazione per i servizi in bundle legacy.

Questa API si trova nel modulo google.appengine.ext.ndb.metadata, solitamente utilizzato tramite from google.appengine.ext.ndb import metadata.

Funzioni

get_entity_group_version(key)

Restituisce la versione del gruppo di entità contenente la chiave. Questa versione è garantita per aumentare a ogni modifica del gruppo di entità. La versione può essere incrementata anche in assenza di modifiche visibili all'utente al gruppo di entità. Può restituire None se non è mai stata eseguita una scrittura nel gruppo di entità.

Avviso: il comportamento dei metadati del gruppo di entità ora è diverso. La versione del gruppo di entità può aumentare indipendentemente dagli aggiornamenti degli utenti. In precedenza, la versione del gruppo di entità aumentava solo in caso di aggiornamento dell'utente. Per mantenere il comportamento precedente, utilizza la soluzione alternativa per la versione del gruppo di entità.

Argomenti

chiave

per un gruppo di entità.

get_namespaces(start=None, end=None)

Restituisce un elenco di nomi di spazi dei nomi.

Argomenti

start

Non restituire i nomi dello spazio dei nomi precedenti in ordine alfabetico.

end

Non restituire i nomi dello spazio dei nomi dopo questo in ordine alfabetico.

get_kinds(start=None, end=None):

Restituisce un elenco di nomi di tipo nello spazio dei nomi corrente.

Argomenti

start

Non restituire i nomi di tipo precedenti in ordine alfabetico.

end

Non restituire i nomi di tipo dopo questo in ordine alfabetico.

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

Restituisce un elenco di nomi di proprietà per il nome kind specificato nello spazio dei nomi corrente.

Argomenti

kind

Quali proprietà elencare.

start

Non restituire i nomi delle proprietà precedenti in ordine alfabetico.

end

Non restituire i nomi delle proprietà dopo questo in ordine alfabetico.

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

Restituisce un dict che mappa i nomi delle proprietà per il nome del tipo specificato ad elenchi di nomi di rappresentazioni come "STRING", "BOOLEAN" o "INT64". Cerca solo nello spazio dei nomi corrente. Per un elenco completo di questi tipi, consulta Tipi di rappresentazione

Restituisce un elenco di nomi di proprietà per il nome kind specificato.

Argomenti

kind

Quali proprietà elencare.

start

Non restituire i nomi delle proprietà precedenti in ordine alfabetico.

end

Non restituire i nomi delle proprietà dopo questo in ordine alfabetico.

Tipi di rappresentazione

Classe di proprietà	Rappresentazione
StringProperty	STRING
BooleanProperty	BOOLEANO
IntegerProperty	INT64
FloatProperty	DOPPIO
DateTimeProperty DateProperty TimeProperty	INT64
UserProperty	UTENTE
BlobProperty	STRING
BlobKeyProperty	STRING
TextProperty	STRING
GeoPtProperty	POINT
GenericProperty	(dipende dal valore memorizzato).
ComputedProperty	(dipende dal valore memorizzato).
JsonProperty	STRING
PickleProperty	STRING
StructuredProperty	Quando ricevi i tipi di rappresentazione, le proprietà StructuredProperty non vengono restituite. ma mostra i valori per le proprietà secondarie corrispondenti ai loro tipi di proprietà.
LocalStructuredProperty	STRING
KeyProperty	RIFERIMENTO