文档中心

云数据库 MySQL 版

数据库管理

CreateDatabase - 创建数据库

CreateDatabase - 创建数据库

调用 CreateDatabase 接口创建数据库。

请求类型

同步请求。

调试

API Explorer

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

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-r3xq0zdl****	实例 ID。
DBName	String	是	testdb1	数据库名称。命名规则如下：名称唯一。长度为 2~64 个字符。以字母开头，以字母或数字结尾。由字母、数字、下划线（_）或中划线（-）组成。不能使用某些预留字，包括 root、admin 等。被禁用的预留字请参见禁用词列表。
CharacterSetName	String	否	utf8	数据库字符集。目前支持的字符集包含：utf8、utf8mb4（默认）、latin1、ascii。
DatabasePrivileges	Array of DatabasePrivilegeObject	否	[ { "AccountName": "user1", "Host":"%", "AccountPrivilege":"ReadWrite" } ]	授权数据库权限信息。
DBDesc	String	否	这是一段数据库的描述信息。	数据库的描述信息，长度不超过 256 个字符。该字段可选，若不设置该字段，或设置了该字段但描述信息长度为 0 ，则描述信息为空。

DatabasePrivilegeObject

参数	类型	是否必选	示例值	描述
AccountName	String	是	testdb1	需授权的账号名称。
Host	String	否	%	指定的数据库账号可以访问数据库的 IP 地址。默认值为 %。若指定 Host 为 %，允许该账号从任意 IP 地址访问数据库。若指定 Host 为 192.10.10.%，则表示该账号可从 192.10.10.0~192.10.10.255 之间的 IP 地址访问数据库。指定的 Host 需要添加在实例所绑定的白名单中，
AccountPrivilege	String	是	ReadWrite	授予的账号权限类型，取值： ReadWrite：读写权限。 ReadOnly：只读权限。 DDLOnly：仅 DDL 权限。 DMLOnly：仅 DML 权限。 Custom：自定义权限。说明权限类型单选，传多个权限时报错。
AccountPrivilegeDetail	String	否	SELECT,INSERT,UPDATE	数据库权限字符串。作为请求参数时，当 AccountPrivilege 取值为 Custom 时必填，取值： SELECT INSERT UPDATE DELETE CREATE DROP REFERENCES INDEX ALTER CREATE TEMPORARY TABLES LOCK TABLES EXECUTE CREATE VIEW SHOW VIEW CREATE ROUTINE ALTER ROUTINE EVENT TRIGGER 作为返回结果时，不管 AccountPrivilege 的值是否为 Custom，都会展示 AccountPrivilege 的详细权限。说明多个字符串使用英文逗号（,）分隔。

返回参数

null

示例

请求示例

返回示例

错误码

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

最近更新时间：2026.06.10 10:58:16

这个页面对您有帮助吗？

有用

有用

无用

无用