PolarDBPostgreSQL引擎有哪些使用限制 - PolarDB

為保障雲上資料庫服務的整體穩定性與效能，PolarDB PostgreSQL版在資源使用和功能操作上設定了特定限制。本文檔旨在協助您瞭解並遵循這些限制，以便在應用設計和資料庫營運中進行合理規劃，從而避免因超出限制而引發的運行異常。

本產品的限制主要包括PolarDB在雲上環境中特有的限制，以及其繼承自PostgreSQL核心的通用限制。

PolarDB限制

以下限制為PolarDB PostgreSQL版版為保障多租戶環境下的穩定性、安全性與資源隔離而設定的特有規則。

PolarDB PostgreSQL版對單個叢集可建立的檔案總數設有上限，此上限與叢集的節點規格直接相關。當檔案數量達到上限時，您將無法建立新的資料表或索引，並會收到could not create file錯誤提示。

檔案構成：檔案總數包括使用者表檔案、資料庫系統資料表檔案、索引檔案以及記錄檔等。通常，一個普通的資料表（非分區表）會佔用3個檔案（資料檔案、FSM檔案、VM檔案）。若該表包含索引，則每個索引會額外佔用1個檔案。
解決方案：若達到檔案數量上限，您可以通過刪除不再使用的表或索引來釋放資源，或通過升級配置升級配置來提升上限。

各規格上限詳情：

操作項	使用約束	說明
資料庫許可權	不提供`superuser`許可權	作為替代，系統提供了`polar_superuser`角色，即高許可權帳號。該角色是`superuser`許可權的子集，能夠滿足絕大多數日常管理需求。

作為基於PostgreSQL的雲資料庫，PolarDB同樣遵循PostgreSQL核心關於資料庫物件的內在限制。下表整合了PostgreSQL 14至17版本中穩定存在的通用核心限制，在進行資料庫設計時需要重點關注。

限制對象	限制值	說明
資料庫大小	500 TB/無限制	根據您的PolarDB叢集形態而定：集中式叢集：預設最高500 TB儲存空間，實際容量受限制與您的叢集規格。分布式叢集：儲存空間理論上無限制。
單表最大尺寸	32 TB	此為基於預設8KB資料區塊（`BLCKSZ`）大小的有效上限。
單表最大列數	1,600	理論上限為1600，但實際可用列數取決於所有列的資料類型總和。由於一行資料（不含TOAST值）不能超過一個資料頁（約8KB），因此使用`bigint`等寬資料類型會顯著減少列數上限。建議將列數控制在250以內以保證最佳效能。
單欄位最大尺寸	1 GB	適用於`text`、`jsonb`、`bytea`等可變長度類型。其儲存依賴TOAST機制，將超大值儲存在行外。
標識符長度	63 位元組	資料庫物件（如表、列名）的名稱上限。超過部分將被靜默截斷，可能導致非預期行為。
單表最大索引數	無限制	理論上沒有上限，實際可建立的索引數量受限於儲存空間、檔案數量上限和系統資源。
索引列數	32	單個索引中可以包含的列數上限。
分區鍵列數	32	建立分區表時，分區鍵可以包含的列數上限。
函數參數個數	100	自訂函數的參數數量上限。
查詢參數個數	65,535	在單個查詢中可以使用的參數標記（如 `$1`, `$2`）的數量上限。