调用CreateDatabase接口为PolarDB集群创建一个新的数据库。

集群必须满足以下条件，否则将创建失败：

  • 当前集群状态：运行中。
  • 当前集群锁定模式：正常。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateDatabase

系统规定参数。取值：CreateDatabase。
DBClusterId String 是 pc-**************

集群ID。
DBName String 是 testDB

数据库名称，名称需满足如下要求：

  • 由小写字母、数字、中划线（-）、下划线（_）组成。
  • 以字母开头，以字母或数字结尾，最长64个字符。
说明 请勿使用保留关键字作为数据库名称，如test、mysql等。
CharacterSetName String 是 utf8

字符集。关于字符集的取值范围，请参见字符集表。
DBDescription String 否 testdesc

数据库备注信息，备注信息需满足如下要求：

  • 不能以http://或https://开头。
  • 长度为2~256个字符。
说明 当集群为PolarDB PostgreSQL版（兼容Oracle）或PolarDB PostgreSQL版时，该参数必填；当集群为PolarDB MySQL版时，该参数非必填。
AccountName String 否 testacc

授权访问该数据库的账号名。可通过接口DescribeAccounts查询账号信息。

说明
  • 只支持输入普通账号，高权限账号默认拥有数据库全部权限无需授权。
  • 当集群为PolarDB PostgreSQL版（兼容Oracle）或PolarDB PostgreSQL版时，该参数必填；当集群为PolarDB MySQL版时，该参数非必填。
AccountPrivilege String 否 ReadWrite

账号权限，取值范围如下：

  • ReadWrite：读写。
  • ReadOnly：只读。
  • DMLOnly：只允许DML。
  • DDLOnly：只允许DDL。
  • ReadIndex：只读+索引。

若该参数不填，则默认为ReadWrite。

说明
  • 该参数仅当AccountName为非空值时生效。
  • 当集群为PolarDB PostgreSQL版（兼容Oracle）或PolarDB PostgreSQL版时，该参数必填；
  • 当集群为PolarDB MySQL版时，该参数非必填。
Collate String 否 C

语言环境设置，用于指定新建数据库的排序规则。

说明
  • 语言环境必须与CharacterSetName参数设置的字符集兼容。

  • 当集群为PolarDB PostgreSQL版（兼容Oracle）或PolarDB PostgreSQL版时，该参数必填；当集群为PolarDB MySQL版时，不支持该参数。

    关于该参数的取值范围，请登录PolarDB控制台，在配置与管理 > 数据库管理页签，单击创建数据库进行查看。
Ctype String 否 C

语言环境设置，用于指定数据库的字符分类。

说明
  • 语言环境必须与CharacterSetName参数设置的字符集兼容。
  • 与Collate传入信息一致。

  • 当集群为PolarDB PostgreSQL版（兼容Oracle）或PolarDB PostgreSQL版时，该参数必填；当集群为PolarDB MySQL版时，该参数非必填。

    关于该参数的取值范围，请登录PolarDB控制台，在配置与管理 > 数据库管理页签，单击创建数据库进行查看。

返回数据

名称 类型 示例值 描述
RequestId String 93E98F25-BE02-40DA-83E3-F77F8D******

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=CreateDatabase
&DBClusterId=pc-**************
&DBName=testDB
&CharacterSetName=utf8
&DBDescription=testdesc
&AccountName=testacc
&AccountPrivilege=ReadWrite
&Ctype=C
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDatabaseResponse>
    <RequestId>93E98F25-BE02-40DA-83E3-F77F8D******</RequestId>
</CreateDatabaseResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "93E98F25-BE02-40DA-83E3-F77F8D******"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDBName.Malformed The specified parameter DBName is not valid. 操作失败，指定的数据库名称格式无效。
400 Database.AddError Instance %s add database minidoc error 实例%s添加数据库minidoc错误
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的DBClusterId。

访问错误中心查看更多错误码。