全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云数据库 RDS 版

修改数据库参数列表

更新时间:2017-09-19 17:24:08

描述

用户可以修改实例参数,提交请求后,RDS将下达任务,新修改的参数应用到实例。如果所提交的参数中,有需要重启数据库的,RDS将重启数据库。必须满足以下条件,否则调用失败:

  • 当前实例状态:使用中。

  • 当前实例锁定模式:正常。

参数值有如下3类:

  • [1-65535],表示数字范围,通过正则识别,从而提取出最小值,最大值。然后根据最小值和最大值对输入参数进行验证,另外,还须是整除因子的倍数。

  • [utf8|gbk|latin1],表示固定的取值规则,通过正则识别,从而提取出固定的取值。然后根据这些固定的取值对输入参数进行验证。

  • 其它,这种情况符合正则表达式。

下达任务之前,RDS将会进行参数检查,步骤如下:

  • 参数是否存在。

  • 参数是否可修改。

  • 参数是否合法。

若参数非法,RDS返回400错误,并返回非法的参数信息。类似:

  1. {"HttpStatusCode":400,"Code":"InvalidParameter.Format",
  2. "Message":"Specified parameter is not valid.[auto_increment_increment:a,character_set_client:41]"}

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:ModifyParameter。
DBInstanceId String 实例名。
Parameters String 参数及其值的JSON串,参数的值都是字符串类型,
{“auto_increment_increment”:”1”,
“character_set_client”:”utf8”}。
Forcerestart String true:强制重启(若修改的参数当中,有需要重启的参数,则必须传入true,否则修改将不生效);false:不强制重启。默认不强制重启。

返回参数

名称 类型 描述
<公共返回参数> 详见公共参数

示例

  • 请求示例

    1. https://rds.aliyuncs.com/?Action=ModifyeParameter
    2. &DBInstanceId=riauvjz6zajfiq6ba1370329449201L
    3. &Parameters={"key_buffer_size":"456","character_set_client":"gbk"}
    4. &<公共请求参数>
  • 返回示例

    XML格式:

    1. <ModifyeParameterResponse>
    2. <RequestId>542BB8D6-4268-45CC-A557-B03EFD7AB30A</RequestId>
    3. </ModifyeParameterResponse>

    JSON格式:

    1. {
    2. "RequestId":"542BB8D6-4268-45CC-A557-B03EFD7AB30A",
    3. }
本文导读目录