Auf dieser Seite werden die Datentypen beschrieben, die Cloud Firestore unterstützt.
Datentypen
In der folgenden Tabelle sind die von Cloud Firestore unterstützten Datentypen aufgeführt. Außerdem wird darin die Sortierreihenfolge beschrieben, nach der beim Vergleichen von Werten desselben Typs vorgegangen wird:
Datentyp | Sortierfolge | Hinweise |
---|---|---|
Array | Nach Elementwerten |
Ein Array darf keinen anderen Arraywert als eines seiner Elemente enthalten. Innerhalb eines Arrays behalten Elemente die ihnen zugewiesene Position bei. Beim Sortieren von zwei oder mehr Arrays geben deren Elementwerte die Reihenfolge vor.
Beim Vergleich von zwei Arrays werden die jeweils ersten Elemente verglichen. Wenn die ersten Elemente gleich sind, werden die zweiten Elemente verglichen und so weiter, bis eine Differenz gefunden wird. Wenn ein Array keine weiteren zu vergleichenden Elemente aufweist, aber bis zu diesem Punkt identisch ist, wird das kürzere vor dem längeren Array angeordnet. Beispiel: |
Boolesch | false < true |
– |
Byte | Bytereihenfolge | Bis zu 1.048.487 Byte (1 MiB – 89 Byte) Nur die ersten 1.500 Byte werden bei Abfragen berücksichtigt. |
Datum und Uhrzeit | Chronologisch | Bei der Speicherung in Cloud Firestore nur auf Mikrosekunden genau, kleinere Zeiteinheiten werden abgerundet. |
Gleitkommazahl | Numerisch | 64-Bit mit doppelter Genauigkeit, IEEE 754. |
Geografischer Punkt | Nach Längengrad, dann nach Breitengrad | Derzeit wird die Verwendung dieses Datentyps aufgrund von Abfragebeschränkungen nicht empfohlen. Im Allgemeinen ist es besser, den Breiten- und Längengrad als separate numerische Felder zu speichern. Wenn Ihre Anwendung einfache geobasierte Geoabfragen benötigt, finden Sie weitere Informationen unter Geoabfragen. |
Integer | Numerisch | 64 Bit, signiert |
Map | Nach Schlüsseln, danach nach Wert | Stellt ein in ein Dokument eingebettetes Objekt dar. Kann, sofern indexiert, auf untergeordnete Felder abgefragt werden. Wenn Sie diesen Wert von der Indexierung ausschließen, werden auch alle untergeordneten Felder von der Indexierung ausgeschlossen.
Schlüssel werden immer sortiert. Wenn Sie beispielsweise Map-Felder werden nach Schlüsseln sortiert und nach Schlüssel/Wert-Paaren verglichen, wobei zuerst die Schlüssel und dann die Werte verglichen werden. Wenn die ersten Schlüssel/Wert-Paare gleich sind, werden die nächsten verglichen und so weiter. Wenn zwei Maps dieselben Schlüssel/Wert-Paare haben, wird ihre Länge berücksichtigt. Die folgenden Maps sind beispielsweise in aufsteigender Reihenfolge angeordnet:
|
NaN | Keine | – |
Null | – | – |
Referenz | Nach Pfadelementen (Sammlung, Dokument-ID, Sammlung, Dokument-ID...) | Beispiel: projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH] |
Textstring | UTF-8-codierte Byte-Reihenfolge | Bis zu 1.048.487 Byte (1 MiB – 89 Byte) Nur die ersten 1.500 Byte der UTF-8-Darstellung werden von Abfragen berücksichtigt. |
Vektor | Nach Dimension und dann nach einzelnen Elementwerten | Die maximale unterstützte Einbettungsdimension ist 2.048. Wenn Sie Vektoren mit größeren Dimensionen speichern möchten, verwenden Sie die Dimensionseinschränkung. |
Werttypsortierung
Wenn eine Abfrage ein Feld mit Werten gemischter Typen umfasst, verwendet Cloud Firestore eine deterministische Sortierung anhand der internen Darstellungen. Die folgende Liste zeigt diese Reihenfolge:
- Nullwerte
- Boolesche Werte
- NaN-Werte
- Ganzzahl- und Gleitkommawerte, sortiert in numerischer Reihenfolge
- Datumswerte
- Textstring-Werte
- Byte-Werte
- Cloud Firestore Referenzen
- Geografische Punktwerte
- Arraywerte
- Vektoreinbettungen
- Map-Werte