Tipi di dati supportati

Questa pagina descrive i tipi di dati supportati da Cloud Firestore.

Tipi di dati

La tabella seguente elenca i tipi di dati supportati da Cloud Firestore. Descrive anche l'ordinamento utilizzato quando si confrontano valori dello stesso tipo:

Tipo di dati	Ordinamento	Appunti
Vettore	Per valori di elemento	Un array non può contenere un altro valore di array come uno dei suoi elementi. All'interno di un array, gli elementi mantengono la posizione loro assegnata. Quando si ordinano due o più array, gli array vengono ordinati in base ai valori degli elementi. Quando si confrontano due array, vengono confrontati i primi elementi di ogni array. Se i primi elementi sono uguali, vengono confrontati i secondi elementi e così via finché non viene trovata una differenza. Se un array esaurisce gli elementi da confrontare ma è uguale fino a quel punto, l'array più corto viene ordinato prima dell'array più lungo. Ad esempio, [1, 2, 3] < [1, 2, 3, 1] < [2] . L'array [2] ha il valore del primo elemento più grande. L'array [1, 2, 3] ha elementi uguali ai primi tre elementi di [1, 2, 3, 1] ma ha una lunghezza inferiore.
Booleano	false < true	—
Byte	Ordine dei byte	Fino a 1.048.487 byte (1 MiB - 89 byte). Solo i primi 1.500 byte vengono considerati dalle query.
Data e ora	Cronologico	Se archiviato in Cloud Firestore, preciso solo al microsecondo; qualsiasi ulteriore precisione viene arrotondata per difetto.
Numero in virgola mobile	Numerico	Doppia precisione a 64 bit, IEEE 754.
Punto geografico	Per latitudine, quindi longitudine	Al momento non è consigliabile utilizzare questo tipo di dati a causa delle limitazioni delle query. In genere è preferibile memorizzare la latitudine e la longitudine come campi numerici separati. Se la tua app necessita di geoquery semplici basate sulla distanza, vedi Query geografiche
Numero intero	Numerico	64 bit, firmato
Carta geografica	Per chiavi, quindi per valore	Rappresenta un oggetto incorporato in un documento. Una volta indicizzato, puoi interrogare i sottocampi. Se si esclude questo valore dall'indicizzazione, anche tutti i sottocampi vengono esclusi dall'indicizzazione. L'ordinamento delle chiavi è sempre ordinato. Ad esempio, se scrivi {c: "foo", a: "bar", b: "qux"} la mappa viene ordinata per chiave e salvata come {a: "bar", b: "qux", c: "foo"} . I campi della mappa vengono ordinati per chiave e confrontati per coppie chiave-valore, confrontando prima le chiavi e poi i valori. Se le prime coppie chiave-valore sono uguali, vengono confrontate le successive coppie chiave-valore e così via. Se due mappe iniziano con le stesse coppie chiave-valore, viene considerata la lunghezza della mappa. Ad esempio, le seguenti mappe sono in ordine crescente: {a: "aaa", b: "baz"} {a: "foo", b: "bar"} {a: "foo", b: "bar", c: "qux"} {a: "foo", b: "baz"} {b: "aaa", c: "baz"} {c: "aaa"}
Nullo	Nessuno	—
Riferimento	Per elementi di percorso (raccolta, ID documento, raccolta, ID documento...)	Ad esempio, projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH] .
Stringa di testo	Ordine dei byte con codifica UTF-8	Fino a 1.048.487 byte (1 MiB - 89 byte). Solo i primi 1.500 byte della rappresentazione UTF-8 vengono considerati dalle query.

Ordinamento del tipo di valore

Quando una query coinvolge un campo con valori di tipi misti, Cloud Firestore utilizza un ordinamento deterministico basato sulle rappresentazioni interne. L'elenco seguente mostra l'ordine:

1. Valori nulli
2. Valori booleani
3. Valori interi e in virgola mobile, ordinati in ordine numerico
4. Valori data
5. Valori stringa di testo
6. Valori in byte
7. Riferimenti a Cloud Firestore
8. Valori dei punti geografici
9. Valori di matrice
10. Valori della mappa