Firestore in modalità Datastore (Datastore) supporta diversi tipi di dati per i valori delle proprietà. tra cui:
- Numeri interi
- Numeri con virgola mobile
- Stringhe
- 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 tipi diversi per la stessa proprietà. Le proprietà possono essere indicizzate o non indicizzate (le query che ordinano o filtrano su una proprietà P ignoreranno le entità in cui P non è indicizzato). Un'entità può avere al massimo 20.000 proprietà indicizzate.
Sono supportati i seguenti tipi di valori:
Tipo di valore | Tipi di Java | Ordinamento | Note |
---|---|---|---|
Numero intero | short int long java.lang.Short java.lang.Integer java.lang.Long |
Numerico | Archiviato come numero intero lungo, poi convertito nel tipo di campo overflow dei valori fuori intervallo |
Numero con virgola mobile | float double java.lang.Float java.lang.Double |
Numerico | Precisione doppia a 64 bit, IEEE 754 |
Booleano | boolean java.lang.Boolean |
false <true |
|
Stringa di testo (breve) | java.lang.String |
Unicode | Fino a 1500 byte Valori superiori a 1500 byte vengono generati IllegalArgumentException |
Stringa di testo (lunga) | com.google.appengine.api.datastore.Text |
Nessuna | Fino a 1 megabyte Non indicizzato |
Stringa byte (breve) | com.google.appengine.api.datastore.ShortBlob |
Ordine byte | Fino a 1500 byte I valori più lunghi di 1500 byte vengono generati IllegalArgumentException |
Stringa byte (lunga) | com.google.appengine.api.datastore.Blob |
Nessuna | Fino a 1 megabyte Non indicizzato |
Data e ora | java.util.Date |
Cronologica | |
Punto geografico | com.google.appengine.api.datastore.GeoPt |
Per latitudine, poi per longitudine |
|
Indirizzo postale | com.google.appengine.api.datastore.PostalAddress |
Unicode | |
Numero di telefono | com.google.appengine.api.datastore.PhoneNumber |
Unicode | |
Indirizzo email | com.google.appengine.api.datastore.Email |
Unicode | |
Utente Account Google | com.google.appengine.api.users.User |
Indirizzo email nell'ordine Unicode |
|
Handle della messaggistica immediata | com.google.appengine.api.datastore.IMHandle |
Unicode | |
Link | com.google.appengine.api.datastore.Link |
Unicode | |
Categoria | com.google.appengine.api.datastore.Category |
Unicode | |
Valutazione | com.google.appengine.api.datastore.Rating |
Numerico | |
Chiave Datastore | com.google.appengine.api.datastore.Key o l'oggetto a cui viene fatto riferimento (come elemento secondario) |
Per elementi del percorso (kind, identifier, kind, identifier...) |
Fino a 1500 byte I valori più lunghi di 1500 byte vengono generati IllegalArgumentException |
Chiave Blobstore | com.google.appengine.api.blobstore.BlobKey |
Ordine byte | |
Entità incorporata | com.google.appengine.api.datastore.EmbeddedEntity |
Nessuna | Non indicizzato |
Null | null |
Nessuna |
Importante:ti consigliamo vivamente di evitare di archiviare users.User
come valore di proprietà, perché include l'indirizzo email e l'ID univoco. Se un utente cambia il proprio indirizzo email e confronti il precedente valore user.User
archiviato con il nuovo valore di user.User
, non corrisponderanno. Utilizza invece il valore ID utente User
come identificatore univoco stabile dell'utente.
Per le stringhe di testo e i dati binari non codificati (stringhe di byte), Datastore supporta due tipi di valori:
- Le stringhe brevi (fino a 1500 byte) vengono indicizzate e possono essere utilizzate nelle condizioni di filtro delle query e negli ordini di ordinamento.
- Le stringhe lunghe (fino a 1 megabyte) non vengono indicizzate e non possono essere utilizzate nei filtri delle query e negli ordini di ordinamento.
Blob
nell'API Datastore. Questo tipo non è correlato ai BLOB utilizzati nell'API Blobstore.
Quando una query riguarda una proprietà con valori di tipi misti, Datastore utilizza un ordinamento deterministico basato sulle rappresentazioni interne:
- Valori null
- Numeri a virgola fissa
- Numeri interi
- Date e ore
- Valutazioni
- Valori booleani
- Sequenze di byte
- Stringa byte
- Stringa Unicode
- Chiavi dell'archivio BLOB
- Numeri con virgola mobile
- Punti geografici
- Utenti con account Google
- Chiavi Datastore
Poiché le stringhe di testo lunghe, le stringhe di byte lunghi e le entità incorporate non sono indicizzate, non hanno un ordine definito.
Proprietà ripetute
Puoi archiviare più valori all'interno di una singola proprietà.
Entità incorporate
A volte potrebbe essere pratico incorporare un'entità come proprietà di un'altra entità. Questo può essere utile, ad esempio, per creare una struttura gerarchica dei valori delle proprietà all'interno di un'entità. La classe Java EmbeddedEntity
consente di eseguire queste operazioni:
Le proprietà di un'entità incorporata non sono indicizzate e non possono essere utilizzate nelle query. Facoltativamente, puoi associare una chiave a un'entità incorporata, ma (a differenza di un'entità completa) la chiave non è obbligatoria e, anche se presente, non può essere utilizzata per recuperare l'entità.
Anziché compilare manualmente le proprietà dell'entità incorporata, puoi utilizzare il metodo setPropertiesFrom()
per copiarle da un'entità esistente:
In seguito, puoi utilizzare lo stesso metodo per recuperare l'entità originale dall'entità incorporata:
Utilizzo di un elenco vuoto
Storicamente Datastore non aveva una rappresentazione per una proprietà che rappresenta un elenco vuoto. L'SDK Java ha risolto questo problema memorizzando le raccolte vuote come valori nulli, quindi non è possibile distinguere tra valori nulli ed elenchi vuoti. Per mantenere la compatibilità con le versioni precedenti, questo rimane il comportamento predefinito, sintetizzato come segue:
- Le proprietà null sono scritte come null in Datastore
- Le raccolte vuote vengono scritte come null in Datastore
- Un valore null viene letto come null in Datastore
- Una raccolta vuota viene letta come nulla.
Tuttavia, se modifichi il comportamento predefinito, l'SDK Java di Appengine Datastore supporterà l'archiviazione di elenchi vuoti. Ti consigliamo di valutare le implicazioni della modifica del comportamento predefinito dell'applicazione e di attivare il supporto per gli elenchi vuoti.
Per modificare il comportamento predefinito in modo da utilizzare elenchi vuoti, imposta la proprietà DATASTORE_EMPTY_LIST_SUPPORT durante l'inizializzazione dell'app come segue:
System.setProperty(DatastoreServiceConfig.DATASTORE_EMPTY_LIST_SUPPORT, Boolean.TRUE.toString());
Con questa proprietà impostata su true
come mostrato sopra:
- Le proprietà null sono scritte come null in Datastore
- Le raccolte vuote vengono scritte come un elenco vuoto in Datastore.
- Un valore null viene letto come null in Datastore
- Durante la lettura da Datastore, viene restituito un elenco vuoto come raccolta vuota.