Nota: Gli sviluppatori che creano nuove applicazioni sono vivamente incoraggiati a utilizzare il Libreria client NDB, che offre numerosi vantaggi rispetto a questa libreria client, come la memorizzazione automatica nella cache delle entità tramite tramite Google Cloud CLI o tramite l'API Compute Engine. Se al momento utilizzi la libreria client DB precedente, leggi il Guida alla migrazione da DB a NDB
Le classi del modello
EntityGroup
,
Namespace
,
Kind
,
e
Property
che rappresentano i risultati del recupero o dell'esecuzione di query su tipi di metadati.
Queste classi sono tutte definite nel pacchetto
google.appengine.ext.db.metadata
. Visualizza la pagina
Metadati
per ulteriori informazioni ed esempi sul loro utilizzo.
Funzioni helper
Le seguenti funzioni helper sono disponibili per ottenere metadati informazioni senza inviare una query esplicita o ottenere:
- get_entity_group_version(entity_or_key)
-
Restituisce la versione del gruppo di entità contenente
entity_or_key
. Questo la versione aumenterà a ogni modifica all'entità gruppo. La versione può aumentare anche in assenza di dati visibili all'utente modifiche al gruppo di entità. Può restituireNone
se il gruppo di entità era mai scritto.Avviso: il comportamento dei metadati del gruppo di entità ora è diverso. L'entità la versione del gruppo può aumentare indipendentemente dagli aggiornamenti dell'utente. In precedenza, l'entità gruppo di utenti è stato aumentato solo all'aggiornamento dell'utente. Per mantenere il comportamento precedente, utilizza soluzione alternativa versione gruppo di entità.
Argomenti:
- entity_or_key
- Una chiave o un'entità di cui vuoi la versione.
- get_namespaces(start=Nessuno, end=Nessuno)
-
Restituisce un elenco di nomi degli spazi dei nomi.
Argomenti
- avvia
-
Se non
None
, restituisce solo i nomi dello spazio dei nomi maggiori o uguali al valore specificato. - fine
-
Se non
None
, restituisce solo i nomi dello spazio dei nomi inferiori al valore specificato.
- get_kinds(start=None, end=None)
-
Restituisce un elenco di nomi di tipi di entità.
Argomenti
- avvia
-
Se non
None
, restituisce solo i nomi dei tipi maggiori o uguali al valore specificato. - fine
-
Se non
None
, restituisce solo i nomi dei tipi inferiori al valore specificato.
- get_properties_of_kind(kind, start=None, end=None)
-
Restituisce un elenco di nomi di proprietà indicizzati per un tipo specificato. Le proprietà non indicizzate non sono incluse.
Argomenti
- gentile
-
Il tipo di cui sono richiesti i nomi delle proprietà.
- avvia
-
Se non
None
, restituisce solo i nomi delle proprietà maggiori o uguali al valore specificato. - fine
-
Se non
None
, restituisce solo i nomi delle proprietà inferiori al valore specificato.
- get_representations_of_kind(kind, start=None, end=None)
-
Restituisce un dizionario che mappa il nome di ogni proprietà indicizzata per un tipo specificato a un elenco delle sue rappresentazioni. Le proprietà non indicizzate non sono incluse.
Argomenti
- gentile
-
Il tipo di cui vengono richieste le rappresentazioni della proprietà.
- avvia
-
Se non
None
, vengono restituite solo rappresentazioni per le proprietà i cui nomi sono maggiori o uguali al valore specificato. - fine
-
Se non
None
, vengono restituite solo rappresentazioni per le proprietà i cui nomi sono inferiori al valore specificato.
- versione
- Il numero di versione
- key_for_entity(entity_or_key)
- Restituisci la chiave dei metadati per il gruppo di entità contenente
entity_or_key
. Usa questa chiave come argomento perget()
il__entity_group__
l'entità metadati gruppo di entità contenente entity_or_key.Argomenti:
- entity_or_key
- Una chiave o un'entità il cui
__entity_group__
chiave desiderata.
- namespace_name
-
Restituisce il nome dello spazio dei nomi specificato dalla chiave di questa entità.
- key_for_namespace(spazio dei nomi)
-
Restituisce la chiave
__namespace__
per lo spazio dei nomi specificato.Argomento
- spazio dei nomi
-
Lo spazio dei nomi di cui è richiesta la chiave.
- key_to_namespace(key)
-
Restituisce lo spazio dei nomi specificato da una chiave
__namespace__
specificata.Argomento
- chiave
-
La chiave di cui è richiesto il nome.
- kind_name
-
Restituisce il nome del tipo specificato dalla chiave di questa entità.
- key_for_kind(kind)
-
Restituisce la chiave
__kind__
per il tipo specificato.Argomento
- gentile
-
Il tipo di cui viene richiesta la chiave.
- key_to_kind(chiave)
-
Restituisce il tipo specificato da una determinata chiave
__kind__
.Argomento
- chiave
-
La chiave di cui è richiesto il tipo.
- La chiave dell'entità ha il tipo
__property__
e il nome della chiave P. - La chiave dell'entità padre ha il tipo
__kind__
e il nome della chiave K. - kind_name
-
Restituisce il nome del tipo specificato dalla chiave di questa entità.
- property_name
-
Restituisce il nome della proprietà specificato dalla chiave di questa entità.
- key_for_kind(kind)
-
Restituisce la chiave padre per le chiavi
__property__
del tipo specificato.Argomento
- gentile
-
Il tipo di cui è richiesta la chiave padre.
- key_for_property(kind, property)
-
Restituisce la chiave
__property__
per la proprietà e il tipo specificati.Argomenti
- gentile
-
Il tipo di cui viene richiesta la chiave.
- proprietà
-
La proprietà di cui è stata richiesta la chiave.
- key_to_kind(chiave)
-
Restituisce il tipo specificato da una determinata chiave
__property__
.Argomento
- chiave
-
La chiave di cui è richiesto il nome del tipo.
- key_to_property(chiave)
-
Restituisce la proprietà specificata da una determinata chiave
__property__
oNone
se la chiave specificava solo un tipo.Argomento
- chiave
-
La chiave di cui è richiesto il nome della proprietà.
La classe EntityGroup
Modello per i metadati __entity_group__
(disponibile solo nel datastore RU).
Questi metadati contengono un valore __version__
numerico
una proprietà che viene garantita
aumentare a ogni modifica al gruppo di entità. La versione può aumentare
anche in assenza di modifiche visibili all'utente per il gruppo di entità. La
L'entità __entity_group__
potrebbe non esistere
in cui non è mai stato scritto.
Proprietà
Metodo della classe
La classe dello spazio dei nomi
La classe Namespace
rappresenta un'entità di metadati di tipo speciale __namespace__
, restituita come risultato di un
.
nello spazio dei nomi.
La chiave dell'entità è il nome dello spazio dei nomi. Un'eccezione è lo spazio dei nomi predefinito designato dalla stringa vuota ""
: poiché non si tratta di un nome di chiave valido, lo spazio dei nomi predefinito è rappresentato da una chiave con ID numerico 1
.
Proprietà
Le istanze della classe Namespace
hanno la seguente proprietà:
Metodi della classe
La classe Namespace
prevede i seguenti metodi:
La classe Kind
La classe Kind
rappresenta un'entità di metadati di tipo speciale __kind__
, restituita come risultato di un
.
di tipo query.
La chiave dell'entità è il nome del tipo di entità.
Proprietà
Le istanze della classe Kind
hanno la seguente proprietà:
Metodi della classe
La classe Kind
prevede i seguenti metodi:
La classe della proprietà
La classe Property
rappresenta un'entità di metadati di tipo speciale __property__
, restituita come risultato di un
.
query sulla proprietà.
L'entità che rappresenta la proprietà P di tipo K viene creata come segue:
Proprietà
Le istanze della classe Property
hanno le seguenti proprietà:
Metodi della classe
La classe Property
prevede i seguenti metodi: