文档中心

AI 原生 BaaS 平台 Supabase 版

数据库管理

CreateDatabase

调用 CreateDatabase 接口为分支创建数据库。

请求类型

同步请求。

注意事项

该接口仅能用于操作使用 PostgreSQL 引擎和 veDB MySQL 引擎的 Workspace（工作区）。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
WorkspaceId	String	是	noble-heath-3a48****	Workspace 的 ID。
BranchId	String	是	br-merry-scup-42d3****	分支 ID。
DatabaseName	String	是	test-db	数据库的名称。数据库名称应满足以下规则：在分支内唯一。只能以字母开头，以字母或数字结尾。只能包含字母、数字、中划线（-）和下划线（_），长度需要在 2~63 个字符之间。不能使用某些预留字。关于预留字的详细信息，请参见预留字列表。
DatabaseOwner	String	否	test-user	数据库所属的账号。说明请求参数 WorkspaceId 所指定的 Workspace 使用的引擎不同时，请求参数 DatabaseOwner 的可选性不同： Workspace 使用的引擎为 PostgreSQL 时，DatabaseOwner 为必选。 Workspace 使用的引擎为 veDB_MySQL时，DatabaseOwner 为可选。
DatabaseDesc	String	否	This is a description of a database.	数据库的描述信息，长度不超过 256 个字符。

返回参数

参数	类型	示例值	描述
Database	Object of Database	请参见返回示例。	数据库的详细信息。

Database

参数	类型	示例值	描述
BranchId	String	br-merry-scup-42d3****	分支 ID。
CreateTime	String	2025-10-21T08:06:52Z	数据库的创建时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ssZ。
DatabaseDesc	String	This is a description of a database.	数据库的描述信息。
DatabaseName	String	test-db	数据库的名称。
DatabaseOwner	String	test-user	数据库的所属的账号。
UpdateTime	String	2025-10-21T08:06:52Z	数据库的更新时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ssZ。
WorkspaceId	String	noble-heath-3a48****	Workspace 的 ID。

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.06.24 10:58:46

这个页面对您有帮助吗？

有用

无用