Riferimento alle proprietà delle entità

Questa API è supportata per i runtime di prima generazione e può essere utilizzata durante l'upgrade ai runtime di seconda generazione corrispondenti. Se esegui l'aggiornamento al runtime di App Engine Go 1.12 o versioni successive, consulta la guida alla migrazione per conoscere le opzioni di migrazione per i servizi in bundle legacy.

Firestore in modalità Datastore (Datastore) supporta diversi tipi di dati per i valori delle proprietà. tra cui:

• Numeri interi
• Numeri con virgola mobile
• Corde
• Date
• Dati binari

Per un elenco completo dei tipi, consulta Proprietà e tipi di valori.

Proprietà e tipi di valori

I valori dei dati associati a un'entità sono costituiti da una o più proprietà. Ogni proprietà ha un nome e uno o più valori. Una proprietà può avere valori di più di un tipo e due entità possono avere valori di tipo diverso per la stessa proprietà. Le proprietà possono essere indicizzate o non indicizzate (le query che ordinano o filtrano su una proprietà P ignorano le entità in cui P non è indicizzata). Un'entità può avere al massimo 20.000 proprietà indicizzate.

Nota: le proprietà con più valori possono essere utili, ad esempio, quando si eseguono query con filtri di uguaglianza: un'entità soddisfa la query se uno qualsiasi dei suoi valori per una proprietà corrisponde al valore specificato nel filtro. Per ulteriori dettagli sulle proprietà con più valori, inclusi i problemi di cui dovresti essere a conoscenza, consulta la pagina Query sul datastore.

Sono supportati i seguenti tipi di valori:

Tipo di valore	Tipi Go	Ordinamento	Note
Numero intero	int int8 int16 int32 int64	Numerico	Numero intero a 64 bit, firmato
Numero con virgola mobile	float32 float64	Numerico	Doppia precisione a 64 bit, IEEE 754
Booleano	bool	false<true
Stringa (breve)	string	Unicode	Fino a 1500 byte
Stringa (lunga)	string (con noindex)	Nessuna esperienza	Fino a 1 megabyte Non indicizzato
Sezione byte (breve)	datastore.ByteString	Ordine byte	Fino a 1500 byte
Sezione byte (lunga)	[]byte	Nessuna esperienza	Fino a 1 megabyte Non indicizzato
Data e ora	time.Time	Cronologica
Punto geografico	appengine.GeoPoint	Per latitudine, poi per longitudine
Chiave Datastore	*datastore.Key	In base agli elementi del percorso (kind, identifier, kind, identifier...)
Chiave archivio BLOB	appengine.BlobKey	Ordine byte

Puoi anche utilizzare un struct o un slice per aggregare le proprietà. Consulta Riferimento Datastore per ulteriori dettagli.

Quando una query riguarda una proprietà con valori di tipi misti, Datastore utilizza un ordinamento deterministico basato sulle rappresentazioni interne:

1. Valori null
2. Numeri a virgola fissa
   • Numeri interi
   • Date e ore
3. Valori booleani
4. Sequenze di byte
   • Sezioni di byte (breve)
   • Stringa Unicode
   • Chiavi dell'archivio BLOB
5. Numeri con virgola mobile
6. Punti geografici
7. Chiavi Datastore

Poiché le sezioni di byte lunghi e le stringhe lunghe non sono indicizzate, non hanno un ordine definito.

Nota: i numeri interi e in virgola mobile sono considerati tipi separati in Datastore. Se un'entità utilizza una combinazione di numeri interi e numeri in virgola mobile per la stessa proprietà, tutti i numeri interi verranno ordinati prima di tutti i numeri in virgola mobile,ad esempio:

7 < 3.2