如何创建数据库
功能描述
创建 DRDS 数据库。该接口只是向控制台提交了一个创建分布式数据库的任务，接入方需要依据 DescribeDrdsDB 接口（查询数据库信息的接口）的返回结果来判断分布式数据库是否创建成功。
调用 CreateDrdsDB(创建数据库接口)完成并返回成功后，尝试去调用 DescribeDrdsDB 接口查询建库结果时，如果 CreateDrdsDB 的返回值里的 Status 属性为1，则表示库建成功；否则，表示建库不成功。要连接上这个数据库需要 IP（DRDS 实例的 IP），port（DRDS 实例的端口），dbname（建库时提供的库名），username（目前默认创建了和 dbname 同名的帐号，暂不支持自主建帐号），password（建库时提供的密码）。
请求参数
| [backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]是否必须 | [backcolor=transparent]描述 |
| Action | String | 是 | 系统规定参数，取值：CreateDrdsDB |
| DrdsInstanceId | String | 是 | DRDS 实例 ID |
| DbName | String | 是 | 分布式数据库的名称（小写字母、数字、下划线组成，字母开头，不超过24字符） |
| Encode | String | 是 | 数据库编码（取值可以为utf8，gbk，latin1，utf8mb4） |
| Password | String | 是 | 分布式数据库密码（8-30个字符。） |
| RdsInstances | String | 是 | RDS 实例名列表（RDS 实例名就是 RDS 的 DBInstanceId），字符串形式的 JSON 数组 |
返回值
| [backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]描述 |
| 公共返回值 |
错误码
| [backcolor=transparent]错误 | [backcolor=transparent]错误代码 | [backcolor=transparent]描述 | [backcolor=transparent]HTTP 状态码 |
| 通用错误码 | |||
| 指定的 RDS 实例和 DRDS 实例不属于同一个用户 | InvalidParameter.Mismatch | RDS instance and drds instance must belong to owner | 400 |
| 用户的 DRDS 数据库个数已经达到上限 | QuotaExceeded.DrdsDB | The quota of create DrdsDB exceeds. | 400 |
| Dbname 不合法 | InvalidDbname.MalFormed | The specified parameter Dbname is not valid. | 400 |
| Encode 不支持 | InvalidEncode. ValueNotSupported | The specified parameter encode is not valid. | 400 |
| RDS 数据库上的库已经存在 | OperationDenied.RdsDbNameExists | The operation is not permitted due to RDS DbName exist. | 400 |
| RDS 上帐号已存在 | OperationDenied.RdsAccoutExists | The operation is not permitted due to RDS accout exist. | 400 |
| 密码不合法 | InvalidPassword.MalFormed | The specified parameter password is not valid. | 400 |
| 数据库名不能以下划线(_)结尾 | InvalidParameter_DbprefixCannotEndWithUnderline | DB prefix can not end up with underline. | 400 |
| DRDS 实例的版本不支持建库 | DrdsVersionIsOld | This drds instance version too old.not allow create drds db | 400 |
| 数据库名重复 | InvalidDbprefixDuplicated | db name in this drds instance duplicate | 400 |
| RDS 的区域与 DRDS 实例不匹配 | InvalidRds.RegionNotMatch | The rds region does not match Drds region | 400 |
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
根据您提供的信息，这是关于阿里云分布式关系型数据库服务（DRDS）中创建数据库的接口描述及请求参数、返回值和错误码的详细说明。下面我将为您简要解析这些内容：
功能描述
- 创建 DRDS 数据库：通过调用
CreateDrdsDB接口，您可以向阿里云控制台提交创建一个分布式数据库的任务。请注意，这个操作只是提交任务，并不意味着立即创建完成。 - 查询建库结果：创建任务提交后，需要使用
DescribeDrdsDB接口来查询数据库是否创建成功。关键在于检查返回结果中的Status属性，如果为1，则表示创建成功；否则，创建失败。 - 连接数据库：一旦数据库创建成功，您需要以下信息来连接它：DRDS实例的IP地址、端口、数据库名（dbname）、用户名（默认与dbname相同）以及建库时设置的密码。
请求参数
- Action: 必须参数，固定值
CreateDrdsDB。 - DrdsInstanceId: DRDS实例ID，用于指定在哪个DRDS实例上创建数据库。
- DbName: 分布式数据库名称，要求由小写字母、数字、下划线组成，以字母开头，长度不超过24个字符。
- Encode: 数据库编码，可选值包括utf8, gbk, latin1, utf8mb4。
- Password: 数据库密码，需满足8-30个字符的限制。
- RdsInstances: 以JSON数组形式列出的RDS实例名列表，这些RDS实例将与DRDS关联。
返回值
通常会包含操作状态和其他可能的响应信息，但具体细节未提供，一般会确认操作是否成功及相关的任务状态。
错误码
列举了一系列可能出现的错误情况及其对应的错误代码和HTTP状态码，例如： - InvalidParameter.MismatchRDS instance and drds instance must belong to owner: 表示RDS实例和DRDS实例不属于同一个阿里云账号。 - QuotaExceeded.DrdsDB: 创建的DRDS数据库数量已达到上限。 - InvalidDbname.MalFormed: 数据库名格式不合法等。
这些错误码有助于定位问题并采取相应的解决措施。当遇到错误时，可以根据错误代码快速识别问题所在，并参考阿里云官方文档或联系客服获取进一步的帮助。
