开发者社区 问答 正文

如何查询分库列表



功能描述


查询 DRDS 库的所有分库。

请求参数

[backcolor=transparent]参数名[backcolor=transparent]类型[backcolor=transparent]是否必须[backcolor=transparent]说明
ActionString系统规定参数,取值:DescribeShardDBs
DrdsInstanceIdStringDRDS 实例 ID
DbNameString数据库名


返回值

[backcolor=transparent]参数名[backcolor=transparent]类型[backcolor=transparent]描述
公共返回值
DataList<DbIntancePair>由 RdsInstance 组成的数组


RdsInstance组成

[backcolor=transparent]参数名[backcolor=transparent]类型[backcolor=transparent]描述
SubDbNameString分库名
InstanceNameStringRDS 实例名


错误码

[backcolor=transparent]错误[backcolor=transparent]错误代码[backcolor=transparent]描述[backcolor=transparent]HTTP 状态码
通用错误码
实例不存在InvalidDrdsInstanceId.NotFoundThe DrdsInstanceId provided does not exist in our records.404
数据库不存在InvalidDbName.NotFoundThe Drds DbName provided does not exist in our records.404
参数错误InvalidParameter.MismatchThe specified parameter does not match.400

展开
收起
猫饭先生 2017-10-30 14:13:46 1474 分享 版权
阿里云 AI 助理回答

根据您提供的信息,这是关于阿里云分布式关系型数据库服务(DRDS)中查询所有分库的操作描述。下面是对这一功能请求、返回值以及可能遇到的错误码的详细解析:

功能描述

此功能允许用户查询指定DRDS实例下的某个数据库的所有分库信息。DRDS通过将单个数据库横向拆分为多个分库来实现数据的水平扩展,提高处理能力和存储容量。

请求参数

  1. Action: 必须参数,固定值为DescribeShardDBs,表示请求的操作类型是查询分库。
  2. DrdsInstanceId: 必须参数,类型为String,表示目标DRDS实例的ID。这个ID用于唯一标识一个DRDS实例。
  3. DbName: 必须参数,类型为String,表示要查询分库信息的数据库名。

返回值

成功响应时,返回的数据结构包含一个名为DataList的数组,该数组由多个RdsInstance对象组成,每个对象代表一个分库的信息: - SubDbName: 分库名称。 - InstanceName: 与该分库关联的RDS实例名称。

错误码

在调用接口过程中,可能会遇到以下错误: 1. InvalidDrdsInstanceId.NotFound: 错误代码,表示提供的DrdsInstanceId不存在,即请求的DRDS实例ID在系统中未找到。HTTP状态码为404。 2. InvalidDbName.NotFound: 错误代码,意味着提供的数据库名DbName在DRDS记录中不存在。同样返回404状态码。 3. InvalidParameter.Mismatch: 参数不匹配错误,当指定的某个参数不符合要求时触发。例如,参数格式错误等。HTTP状态码为400。

使用提示

  • 在发起请求前,请确保你拥有正确的DRDS实例ID和数据库名。
  • 通过API调用时,注意检查请求参数是否符合API文档的要求,避免因参数错误导致请求失败。
  • 如果遇到错误,可以根据错误码快速定位问题,并参考阿里云官方文档或直接联系客服获取帮助。

希望这些信息能帮助您顺利使用阿里云DRDS的查询分库功能。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答