支持的數據類型

本頁面介紹 Cloud Firestore 支援的資料類型。

資料類型

下表列出了 Cloud Firestore 支援的資料類型。它還描述了比較相同類型的值時所使用的排序順序：

資料類型排序筆記
大批按元素值

數組不能包含另一個數組值作為其元素之一。

在陣列中，元素保持分配給它們的位置。對兩個或多個陣列進行排序時，陣列會根據其元素值進行排序。

比較兩個陣列時，將比較每個陣列的第一個元素。如果第一個元素相等，則比較第二個元素，依此類推，直到發現差異。如果陣列用完了要比較的元素，但到該點為止都相等，則較短的陣列將排在較長的陣列之前。

例如， [1, 2, 3] < [1, 2, 3, 1] < [2] 。數組[2]具有最大的第一個元素值。數組[1, 2, 3]的元素等於[1, 2, 3, 1]的前三個元素，但長度較短。

布林值false < true —
位元組位元組順序最多 1,048,487 位元組（1 MiB - 89 位元組）。查詢僅考慮前 1,500 個位元組。
日期和時間時間順序儲存在 Cloud Firestore 中時，僅精確到微秒；任何額外的精度都會向下舍入。
浮點數數位64 位元雙精確度， IEEE 754 。
地理點先按緯度，再按經度由於查詢限制，目前我們不建議使用此資料類型。通常最好將緯度和經度儲存為單獨的數字欄位。如果您的應用程式需要簡單的基於距離的地理查詢，請參閱地理查詢
整數數位64 位，有符號
地圖按鍵，然後按數值

表示嵌入文件中的物件。建立索引後，您可以查詢子欄位。如果從索引中排除該值，則所有子欄位也會從索引中排除。

鍵的順序始終是排序的。例如，如果您編寫{c: "foo", a: "bar", b: "qux"}映射將按鍵排序並儲存為{a: "bar", b: "qux", c: "foo"} .

Map欄位按鍵排序，並按鍵值對進行比較，先比較鍵，然後比較數值。如果第一個鍵值對相等，則比較下一個鍵值對，依此類推。如果兩個映射以相同的鍵值對開頭，則考慮映射長度。例如，以下地圖按升序排列：

{a: "aaa", b: "baz"}
{a: "foo", b: "bar"}
{a: "foo", b: "bar", c: "qux"}
{a: "foo", b: "baz"}
{b: "aaa", c: "baz"}
{c: "aaa"}

南沒有任何—
無效的沒有任何—
參考按路徑元素（集合、文件 ID、集合、文件 ID...）例如， projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH] 。
文字字串UTF-8編碼的位元組順序最多 1,048,487 位元組（1 MiB - 89 位元組）。查詢僅考慮 UTF-8 表示形式的前 1,500 個位元組。

值類型排序

當查詢涉及具有混合類型值的欄位時，Cloud Firestore 使用基於內部表示的確定性排序。以下列表顯示了順序：

  1. 空值
  2. 布林值
  3. NaN 值
  4. 整數和浮點數值，依數字順序排序
  5. 日期值
  6. 文字字串值
  7. 位元組值
  8. Cloud Firestore 參考
  9. 地理點數值
  10. 數組值
  11. 地圖值