Nota: Python 2.7 ha raggiunto fine del supporto il 31 gennaio 2024. Le applicazioni Python 2.7 esistenti continueranno a esistere per eseguire e ricevere traffico. Tuttavia, App Engine potrebbe bloccare il rideployment delle applicazioni che utilizzano i runtime al termine del periodo di assistenza. Ti consigliamo di eseguire la migrazione alla versione più recente supportata di Python.

Questa pagina è stata tradotta dall'API Cloud Translation.

Riferimento Python alle entità di metadati

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 API. Se al momento utilizzi la libreria client DB precedente, leggi il Guida alla migrazione da database 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 ricevere:

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ò restituire None 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.

Classe EntityGroup

Modello per i metadati __entity_group__ (disponibile solo nel datastore RU).

Questi metadati contengono un valore __version__ numerico una proprietà 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à

versione: Il numero di versione

Metodo del corso

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 per get() 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.

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à:

namespace_name: Restituisce il nome dello spazio dei nomi specificato dalla chiave di questa entità.

Metodi della classe

La classe Namespace prevede i seguenti metodi:

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(chiave)

Restituisce lo spazio dei nomi specificato da una chiave __namespace__ specificata.

Argomento

chiave: La chiave di cui è richiesto il nome.

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à:

kind_name: Restituisce il nome del tipo specificato dalla chiave di questa entità.

Metodi della classe

La classe Kind prevede i seguenti metodi:

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 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:

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.

Proprietà

Le istanze della classe Property hanno le seguenti proprietà:

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à.

Metodi della classe

La classe Property prevede i seguenti metodi:

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__ o None se la chiave specificava solo un tipo.

Argomento

chiave: La chiave di cui è richiesto il nome della proprietà.