本頁說明 Cloud Firestore 支援的資料類型。
資料類型
下表列出 Cloud Firestore 支援的資料類型。並說明比較相同類型值時使用的排序順序:
資料類型 | 排序順序 | 附註 |
---|---|---|
陣列 | 依元素值 |
陣列不能包含其他陣列值做為其中一個元素。 在陣列中,元素會保留指派給該元素的位置。排序兩個以上的陣列時,系統會根據元素值排序陣列。
比較兩個陣列時,系統會比較每個陣列的第一個元素。如果第一個元素相等,則會比較第二個元素,以此類推,直到找到差異為止。如果陣列的元素用盡,但在該點之前的元素相等,則較短的陣列會排在較長的陣列之前。 例如 |
布林值 | false < true |
— |
位元組 | 位元組順序 | 最多 1,048,487 個位元組 (1 MiB - 89 個位元組)。查詢只會考量前 1,500 個位元組。 |
日期與時間 | 依時間順序 | 儲存在 Cloud Firestore 中時,精確度只計算到微秒;無條件捨去任何其他精準度。 |
浮點數 | 數字 | 64 位元雙精度,IEEE 754。 |
地理點 | 依照緯度再依經度 | 由於查詢功能有限制,我們目前不建議使用這類資料類型。一般來說,建議您將經緯度儲存為個別的數值欄位。如果您的應用程式需要簡單的以距離為依據的地理查詢,請參閱「地理查詢」 |
整數 | 數字 | 64 位元,帶正負號 |
地圖 | 依鍵排序,然後依值排序 | 代表文件中嵌入的物件。如有建立索引,您可以查詢子欄位。若在建立索引時排除此值,也會一併排除所有子欄位。
鍵的排序一律會排序。舉例來說,如果您寫入 地圖欄位會依鍵排序,並以鍵/值組合進行比較,先比較鍵,再比較值。如果第一個鍵/值組合相等,系統會比較下一個鍵/值組合,以此類推。如果兩個對應表的所有鍵/值組合都相同,系統會考量對應表長度。舉例來說,以下地圖是按遞增順序排列:
|
NaN | 無 | — |
空值 | 無 | — |
參考資料 | 依路徑元素 (集合、文件 ID、集合、文件 ID...) | 例如 projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH] 。 |
文字字串 | UTF-8 編碼位元組順序 | 最多 1,048,487 個位元組 (1 MiB - 89 個位元組)。查詢只會考量 UTF-8 表示法的前 1,500 個位元組。 |
向量 | 依維度和個別元素值排序 | 支援的嵌入維度上限為 2048。如要儲存維度較大的向量,請使用降維。 |
值類型排序
查詢含混合類型值的欄位時,Cloud Firestore 會根據內部表示法使用確定性排序。以下是排序清單:
- 空值
- 布林值
- NaN 值
- 整數和浮點值,以數字順序排序
- 日期值
- 文字字串值
- 位元組值
- Cloud Firestore 參照
- 地理點值
- 陣列值
- 向量嵌入
- 對應值