本頁面說明 Cloud Firestore 中的文件、文件名稱、欄位和索引項目的儲存空間大小。
您可以在 Cloud Firestore 定價頁面查詢這類儲存空間的費用。字串大小
字串大小按 UTF-8 編碼位元組的數目 + 1 計算。
以下均以字串形式儲存:
- 集合 ID
- 字串文件 ID
- 文件名稱
- 欄位名稱
- 字串欄位值
例如:
- 集合 ID
tasks
使用 5 個位元組 + 1 個位元組,共 6 個位元組。 - 欄位名稱
description
使用 11 個位元組 + 1 個位元組,共 12 個位元組。
文件 ID 大小
文件 ID 的大小為字串 ID 的字串大小,或整數 ID 的 8 個位元組。
文件名稱大小
文件名稱的大小是下列項目的總和:
- 文件路徑中每個集合 ID 和文件 ID 的大小
- 額外 16 個位元組
如果子集合 users/jeff/tasks
中的文件具有字串文件 ID my_task_id
,則文件名稱大小為 6 + 5 + 6 + 11 + 16 = 44 個位元組:
users
集合 ID 佔 6 個位元組jeff
文件 ID 佔 5 個位元組tasks
集合 ID 佔 6 個位元組my_task_id
文件 ID 佔 11 個位元組- 額外 16 個位元組
欄位值大小
下表依類型顯示欄位值的大小。
類型 | 大小 |
---|---|
陣列 | 其值的大小總和 |
布林值 | 1 個位元組 |
位元組 | 位元組長度 |
日期與時間 | 8 個位元組 |
浮點數 | 8 個位元組 |
地理點 | 16 個位元組 |
整數 | 8 個位元組 |
地圖 | 地圖的大小,計算方式與文件大小相同 |
空值 | 1 個位元組 |
參考資料 | 文件名稱大小 |
文字字串 | UTF-8 編碼位元組數目 + 1 |
舉例來說,名為 done
的布林值欄位會使用 6 個位元組:
done
欄位名稱佔 5 個位元組- 布林值佔 1 個位元組
文件大小
文件的大小是以下幾項的總和:
以下範例是針對子集合 users/jeff/tasks
中的文件,其字串文件 ID 為 my_task_id
:
- "type": "Personal" - "done": false - "priority": 1 - "description": "Learn Cloud Firestore"
欄位的總大小為 71 個位元組:
欄位名稱和值 | 欄位大小 (以位元組為單位) |
---|---|
"type": "Personal" |
14 5 個欄位名稱 + 9 個欄位字串值 |
"done": false |
6 欄位名稱佔 5 個 + 欄位布林值佔 1 個 |
"priority": 1 |
17 欄位名稱佔 9 個 + 欄位整數值佔 8 個 |
"description": "Learn Cloud Firestore" |
34 欄位名稱佔 12 個 + 欄位字串值佔 22 個 |
因此,文件大小為 44 + 71 + 32 = 147 個位元組:
- 文件名稱佔 44 個位元組
- 欄位佔 71 個位元組
- 額外 32 個位元組
索引項目大小
以下列舉單一欄位和複合式索引的索引項目大小計算方式。
單一欄位索引項目大小
單一欄位索引項目的大小取決於索引的範圍是集合還是集合群組。
集合範圍
設有集合範圍的單一欄位索引項目大小是以下幾項的總和:
請考慮子集合 users/jeff/tasks
中的文件,其字串文件 ID 為 my_task_id
:
- "type": "Personal" - "done": false - "priority": 1 - "description": "Learn Cloud Firestore"
如果單一欄位索引的集合範圍是編入 done
欄位的索引,則這個索引中的項目總大小為 109 個位元組:
- 文件名稱
users/jeff/tasks/my_task_id
佔 44 個位元組 - 父項文件的文件名稱
users/jeff
佔 27 個位元組 done
欄位名稱佔 5 個位元組- 布林欄位值佔 1 個位元組
- 額外 32 個位元組
集合群組範圍
設有集合群組範圍的單一欄位索引項目大小是以下幾項的總和:
請考慮子集合 users/jeff/tasks
中的文件,其字串文件 ID 為 my_task_id
:
- "type": "Personal" - "done": false - "priority": 1 - "description": "Learn Cloud Firestore"
如果單一欄位索引的集合群組範圍是編入 done
欄位的索引,則這個索引中的項目總大小為 98 個位元組:
- 文件名稱
users/jeff/tasks/my_task_id
佔 44 個位元組 done
欄位名稱佔 5 個位元組- 布林欄位值佔 1 個位元組
- 額外 48 個位元組
複合式索引項目大小
複合式索引中的項目大小取決於索引的範圍是集合還是集合群組。
集合範圍
在含有集合範圍的複合式索引中,索引項目的大小是以下幾項的總和:
請考慮子集合 users/jeff/tasks
中的文件,其字串文件 ID 為 my_task_id
:
- "type": "Personal" - "done": false - "priority": 1 - "description": "Learn Cloud Firestore"
如果複合式索引的集合範圍是將 done
和 priority
欄位編入索引 (兩者皆以遞增順序排列),則這個索引中的項目總大小為 112 個位元組:
- 文件名稱
users/jeff/tasks/my_task_id
佔 44 個位元組 - 父項文件的文件名稱
users/jeff
佔 27 個位元組 - 布林欄位值佔 1 個位元組
- 整數欄位值佔 8 個位元組
- 額外 32 個位元組
集合群組範圍
在集合群組範圍的複合式索引中,索引項目的大小是以下幾項的總和:
請考慮子集合 users/jeff/tasks
中的文件,其字串文件 ID 為 my_task_id
:
- "type": "Personal" - "done": false - "priority": 1 - "description": "Learn Cloud Firestore"
如果複合式索引的集合群組範圍是將 done
和 priority
欄位編入索引 (兩者皆以遞增順序排列),則這個索引中的索引項目總大小為 85 個位元組:
- 文件名稱
users/jeff/tasks/my_task_id
佔 44 個位元組 - 布林欄位值佔 1 個位元組
- 整數欄位值佔 8 個位元組
- 額外 32 個位元組