文档中心

AI 原生 BaaS 平台 Supabase 版

产品简介

约束与限制

AI 原生 BaaS 平台 Supabase 版依托于 AI 原生数据库管理平台（AI Native Database Platform，简称 AIDAP），通过四种数据库引擎 Supabase、PostgreSQL、Lakebase 和 veDB MySQL 提供服务。本文介绍 AI 原生数据库管理平台的 PostgreSQL 引擎和 Supabase 引擎在使用上的约束与限制。

PostgreSQL 引擎使用建议

针对使用 PostgreSQL 引擎的 Workspace，为了获得稳定的性能和资源使用体验，建议在业务规划和使用过程中参考以下推荐值。当业务规模显著超过推荐值时，可能会带来性能波动或资源紧张，请提前进行容量评估。

约束项	约束内容
每秒事务数（Transactions Per Second，TPS）	建议每个分支的 TPS 不超过 10。
每秒查询数（Queries Per Second，QPS）	建议每个分支的 QPS 不超过 20。
活跃连接数	建议每个分支的活跃连接数不超过 10。
数据量	建议将每个分支的数据量控制在 10 GB 以下。
角色数量	建议每个分支的角色数量不超过 50 个。
数据库数量	建议每个分支的数据库数量不超过 50 个。
SCHEMA 数量	建议每个分支的 SCHEMA 数量不超过 100 个。
数据库的表数量	建议每个数据库的表数量不超过 1000 个。
分支个数	建议每个 Workspace 的分支数量不超过 10 个。

Supabase 引擎的使用限制与使用建议

使用限制

Supabase 版在 Workspace 分支、认证、数据库、对象存储、边缘函数、日志以及网络等方面的关键限制项，您在创建和使用资源时请关注相应的约束。

约束项	约束内容
Workspace 的分支数量	建议单个 Workspace 的分支数量不超过 10 个。详见创建分支的注意事项。
Auth Third-Party Provider	Supabase Auth 支持基于 Sign In / Providers 的 Third-Party Auth 接入，使用前请关注相关注意事项，包括第三方身份服务的兼容性、JWT 校验配置等。
Auth Hooks	Supabase Auth Hooks 支持传递 JWT Token 以及多种 Hook 类型，使用前请关注其注意事项，避免因配置不当导致登录、回调流程异常。
Database	PostgreSQL 引擎相关使用建议详见上文 PostgreSQL 引擎使用建议。通过 Table Editor 创建数据库表时，单个分支的数据库表数量上限为 10000 个。
Storage Object	单个文件大小默认上限为 50 MB，最高可调整至 51200 MB（即 50 GB）。
Edge Function	单个 Supabase 分支的 Edge Function 数量默认上限为 500 个。
Logs 保留天数	日志默认保留 30 天。
单个分支的共享公网带宽	共享公网地址的带宽上限为 100 Mbps。
分支记忆	普通新建分支不会继承父分支的记忆。
记忆迁移	首期不支持导入、导出和跨分支复制记忆。
记忆保留	记忆默认不过期且无个数限制。如不再需要，需主动删除。
业务用户删除	删除业务用户不会自动清理该用户的记忆，需另行主动删除。

使用建议

除上述硬性或推荐限制之外，您在日常使用 Supabase 版时还可以参考以下使用建议，以提升服务的安全性和可扩展性。

妥善保管相关密码或密钥

请妥善保管 Supabase 相关的密码、密钥等，避免对外暴露、造成安全风险。包括但不限于：

Supabase 的 service_role_key。

Supabase PostgreSQL 中 postgres 账号的密码。

Supabase Edge Function Secrets 中的密码或密钥。

Supabase Dashboard 的登录账号和密码。

Supabase Auth Third-Party 中自定义 JWKS（Custom JWKS）的私钥。

安全提示：上述密钥一旦对外泄露，可能导致数据库被未授权访问、敏感数据被读取或篡改。建议结合企业内部的密钥管理服务（KMS）或 Vault 类工具进行集中托管，并定期轮换。

提升私网虚拟网卡（ENI）的配额、增大 Subnet 网段

在通常情况下，Supabase 的分支如果开启了私网地址，每个分支会绑定一个独立的私网虚拟网卡（ENI），并占用所选 Subnet 下 1 个 IP。

对于 Vibe Coding 等需要批量创建实例和分支的应用场景，可能会遇到弹性网卡配额不足或 Subnet 下 IP 数量不够的情况。建议参考以下措施提前规划：

提前提升虚拟网卡配额。具体操作参见创建配额申请并查看申请历史，配额项路径为：“网络”→“私有网络”→“eni”。同时建议创建配额告警，及时关注剩余配额。

合理规划 VPC 和 Subnet 的网段大小。在创建 VPC 和 Subnet 时，请根据业务规模选择合适的网段（掩码越小，网段越大）。建议 Subnet 的掩码不超过 16，以便容纳大批量分支所需的私网 IP。

容量规划建议

若预计单个 VPC 内将运行成百上千个 Supabase 分支，建议在项目初期就完成 ENI 配额申请与 Subnet 网段规划，避免业务上线后再调整带来的迁移成本。

Lakebase 引擎的使用限制与使用建议

使用限制

针对使用 Lakebase 引擎的 Workspace，为了获得稳定的性能和资源使用体验，建议在业务规划和使用过程中参考以下推荐值。当业务规模显著超过推荐值时，可能会带来性能波动或资源紧张，请提前进行容量评估。

分类	约束项	约束内容
数据量	业务表数据容量上限	与核数（Max cu）相关，详情如下： Max cu ≤ 2c：存储容量上限 120 GB Max cu ≤ 16c：存储容量上限 240 GB Max cu ≤ 32c：存储容量上限 480 GB 修改 Max cu 后，存储容量上限也会级联调整。
性能	每秒事务数（TPS）	建议每个分支的 TPS 不超过 10。
		每秒查询数（QPS）	建议每个分支的 QPS 不超过 20。
		活跃连接数	建议每个分支的活跃连接数不超过 10。
Workspace 与分支	Workspace 个数	每个火山引擎主账号可创建 30 个使用 Lakebase 引擎的 Workspace。如需调整限额，请提交工单联系技术支持。
		分支个数	当前版本暂不支持创建新分支。
		角色数量	建议每个分支的角色数量不超过 50 个。
数据库与表	业务库数量	建议每个分支的业务库数量不超过 50 个。通过 Table Editor 创建业务表时，单个分支的业务表数量上限为 10000 个。
		Schema 数量	建议每个分支的 Schema 数量不超过 100 个。
		业务库的表数量	建议每个业务库的表数量不超过 1000 个。
		外表创建	当前版本不支持直接创建可写外表。
分析表	分析表数量	每个分支的分析表数量不超过 10 个。如需创建新的分析表，请先关闭存量分析表同步链路，详情请参见关闭分析表同步链路。
		数据类型	分析表支持 smallint、integer、bigint、real、double precision、numeric/decimal、boolean、date、time without time zone、timestamp without time zone、char、varchar、text、bytea、uuid 数据类型。若源表包含任一不支持的数据类型，分析表将生成失败。
		源表限制	为表生成分析表时，源表必须有主键，且主键第一列为字符串类型时，必须使用默认的字符集和 collation。
		操作限制	对于已存在分析表任务的业务表，暂不支持任何 DDL 操作。分析表名称不能与源表名称相同。
账号权限	账号权限	通过 SQL 语句创建的数据库账号不具备 rolcreatedb、rolcreaterole 权限，无法使用该账号创建数据库和账号。如果需要创建数据库和账号，请前往控制台创建，详情请参见创建数据库和创建账号。 Lakebase PostgreSQL 普通账号权限包括 rolcanlogin。
网络	共享公网带宽	单个分支的共享公网带宽上限为 100 Mbps。

使用建议

除上述硬性或推荐限制之外，您在日常使用 Lakebase 版时还可以参考以下使用建议，以提升服务的安全性和可扩展性。

建议项	建议内容
分析表	建议先完成业务表的更新，再启动生成分析表任务。建议在分析表生成完成后，再对对应的业务表发起写入负载。若数据库上有长事务，建议在启动生成分析表任务前，等待长事务执行完成或终止长事务。长事务可能会阻塞生成分析表任务。
相关密码或密钥	请妥善保管 Lakebase 相关的密码、密钥等，避免对外暴露、造成安全风险。密钥一旦对外泄露，可能导致数据库被未授权访问、敏感数据被读取或篡改。建议结合企业内部的密钥管理服务（KMS）或 Vault 类工具进行集中托管，并定期轮换。

最近更新时间：2026.10.26 11:19:13

这个页面对您有帮助吗？

有用

无用