配額與限制

本頁面說明 Cloud Spanner 的實際工作環境限制。

下列數值隨時可能變動。

查看配額

如要查看專案目前的資源配額,請使用 Google Cloud Console:

查看配額

提高配額

隨著 Cloud Spanner 使用量增加,您也可以要求更多配額。如果您預期用量將大幅攀升,請提前幾天申請,確保系統可以妥善調整您的配額。

  1. 前往 Cloud Console 的「配額」頁面

    前往「配額」頁面

  2. 在「服務」下拉式清單中,選取 [Cloud Spanner API]

    如果系統未顯示 [Cloud Spanner API],表示 Cloud Spanner API 尚未啟用。

  3. 選取您要變更的配額。

  4. 按一下 [編輯配額]

  5. 填寫您的姓名、電子郵件地址和電話號碼,然後按一下 [下一步]

  6. 輸入您的配額要求,然後按一下 [提交要求]

您會在 48 小時內收到 Cloud Spanner 小組的回覆。

執行個體限制

限制
執行個體 ID 長度 2 至 64 個字元

資料庫限制

限制
每個執行個體的資料庫數 100
資料庫 ID 長度 2 至 30 個字元
每個節點的儲存空間大小 2 TB1

備份與還原限制

限制
每個資料庫正在建立備份的作業數量 1
每個執行個體正在還原資料庫的作業數量 (此處所指執行個體為位於還原資料庫者,並非位於備份中) 1
備份保留時間上限 1 年 (包含閏年中的額外天數)

結構定義限制

DDL 陳述式

限制
單一結構定義變更的 DDL 陳述式大小 10 MB
GetDatabaseDdl 傳回,資料庫整個結構定義的 DDL 陳述式大小 10 MB

資料表

限制
每個資料庫的資料表數 2,048
資料表名稱長度 1 至 128 個字元
每個資料表的欄數 1,024
欄名稱長度 1 至 128 個字元
每個欄的資料大小 10 MB
資料表索引鍵中的欄數

16

包含與任何上層資料表共用的索引鍵欄

資料表交錯深度

6

如果頂層資料表含有子資料表,則深度為 1。

如果頂層資料表的子資料表下還有一層子資料表,則深度為 2,以此類推。

資料表或索引鍵的總大小

8 KB

組成索引鍵之所有資料欄的加總大小。

每列資料大小

4 GB

包含頂層資料列及其所有的交錯插入子資料列和索引資料列

索引

限制
每個資料庫的索引數 4,096
每個資料表的索引數 32
索引名稱長度 1 至 128 個字元
索引鍵中的欄數

16

已建立索引的欄數 (STORING 欄除外) 加上主資料表中的主鍵欄數

查詢限制

限制
GROUP BY 子句中的欄數 1000
函式呼叫數 1000
彙整次數 15
巢狀函式呼叫數 75
巢狀 GROUP BY 子句數 35
巢狀子查詢運算式數 25
巢狀 Subselect 陳述式數 60
參數總數 950
查詢陳述式長度 100 萬個字元
STRUCT 欄位數 1000
子查詢運算式子項數 40
查詢中的聯集數 200

建立、讀取、更新和刪除資料的限制

限制
修訂版本大小 (含索引) 100 MB
每個工作階段的並行讀取數 100
每個修訂版本 (含索引) 的異動數2 20,000
每個資料庫的並行分區 DML 陳述式 20,000

管理作業限制

限制
管理動作要求大小3 1 MB
管理動作頻率限制4

每位使用者每個專案每秒 5 次

(平均超過 100 秒)

要求限制

限制
修訂版本以外的要求大小5 10 MB

注意事項

1. 為確保存取資料庫時能兼顧高可用性及低延遲優勢,Cloud Spanner 要求在資料庫中每 2 TB 的資料就必須要有 1 個節點。舉例來說,如果執行個體有 1 個資料庫,而該資料庫中儲存了 3.5 TB 的資料,您就必須佈建至少 2 個節點。這些節點會防止執行個體超過限制,直到資料庫成長到 4 TB 為止。當資料庫達到這個大小時,您就必須再新增一個節點,好讓資料庫能繼續成長。否則,資料庫的寫入作業就會失敗。為確保資料庫能順利成長,請在資料庫達到此大小上限前新增節點。

2. 計算異動數時,應將插入和更新作業數乘以受到這兩項作業影響的欄數。例如,插入一筆新記錄時,如果值是插入到五個資料欄中,便可能會計為五次異動。不過若是刪除作業和刪除範圍作業,不論有多少資料欄受到影響,都計為一次異動。

3. 管理動作要求限制不適用於修訂版本、注意事項 5 中所列的要求,以及結構定義變更。

4. 此頻率限制適用所有對 Admin API 的呼叫,包括對執行個體、資料庫或備份的長時間執行作業輪詢呼叫。

5. 此限制適用的要求包括建立資料庫、更新資料庫、讀取、串流讀取、執行 SQL 查詢,以及執行串流 SQL 查詢。