儲存空間大小計算

本頁面說明 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 個位元組

欄位值大小

下表依類型顯示欄位值的大小。

舉例來說，如果布林值欄位名為 done，則會使用 6 個位元組：

• done 欄位名稱佔 5 個位元組
• 布林值佔 1 個位元組

文件大小

文件的大小是以下幾項的總和：

• 文件名稱大小
• 每個欄位名稱的字串大小總和
• 每個欄位值大小的總和
• 額外 32 個位元組

以下範例適用於子集合 users/jeff/tasks 中字串文件 ID 為 my_task_id 的文件：

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

欄位的總大小為 71 個位元組：

因此，文件大小為 44 + 71 + 32 = 147 個位元組：

• 文件名稱佔 44 個位元組
• 欄位佔 71 個位元組
• 額外 32 個位元組

索引項目大小

以下列舉單一欄位和複合式索引的索引項目大小計算方式。

單一欄位索引項目大小

單一欄位索引項目的大小取決於索引的範圍是集合還是集合群組。

集合範圍

設有集合範圍的單一欄位索引項目大小是以下幾項的總和：

• 索引文件的文件名稱大小
• 已建立索引文件父項文件的文件名稱大小。
• 已建立索引欄位名稱的字串大小
• 索引欄位值的大小
• 額外 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 個位元組

集合群組範圍

設有集合群組範圍的單一欄位索引項目大小是以下幾項的總和：

• 索引文件的文件名稱大小
• 已建立索引的欄位名稱字串大小
• 已建立索引的欄位值大小
• 額外 48 個位元組

請考慮子集合 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 個位元組

複合式索引項目大小

複合式索引中的項目大小取決於索引的範圍是集合還是集合群組。

集合範圍

在含有集合範圍的複合式索引中，索引項目的大小是以下幾項的總和：

• 索引文件的文件名稱大小
• 已建立索引文件父項文件的文件名稱大小。
• 索引欄位值的總和
• 額外 32 個位元組

假設子集合 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 個位元組

集合群組範圍

在集合群組範圍的複合式索引中，索引項目的大小是以下幾項的總和：

• 已建立索引文件的文件名稱大小
• 索引欄位值的總和
• 額外 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 個位元組

後續步驟