阿里云RDS文档概述——参数设置

时间:2022-02-28 06:11:57

该系列博客的目录:

    概述与请求方式: http://blog.csdn.net/hyzhou33550336/article/details/41620595 (请先看这篇了解公共请求参数)

    实例管理:   http://blog.csdn.net/hyzhou33550336/article/details/41620749

    数据库管理: http://blog.csdn.net/hyzhou33550336/article/details/41620833

    数据迁入:   http://blog.csdn.net/hyzhou33550336/article/details/41620863

    账号管理:   http://blog.csdn.net/hyzhou33550336/article/details/41620879

    备份恢复:   http://blog.csdn.net/hyzhou33550336/article/details/41620899

    监控查询:   http://blog.csdn.net/hyzhou33550336/article/details/41620907

    日志查询:   http://blog.csdn.net/hyzhou33550336/article/details/41620917

    性能优化:   http://blog.csdn.net/hyzhou33550336/article/details/41620931

    参数设置:   http://blog.csdn.net/hyzhou33550336/article/details/41620595


参数设置
  • 查看数据库参数模板
  • 查看当前实例数据库参数运行列表
  • 修改数据库参数列表

 

查看数据库参数模板:

描述:

该接口返回参数模板列表,包含内容:参数名,参数默认值,是否可修改,是否需要重启才能生效,参数校验规则(正则表达式)。

请求参数:

名称

类型

是否必须

描述

Action

String

系统规定参数,取值:DescribeParameterTemplates

Engine

String

数据库类型,取值为MySQLSQLServer

EngineVersion

String

数据库版本号,MySQL:5.15.55.6;SQLServer:2008r2

返回参数:

名称

类型

描述

Engine

String

数据库类型

EngineVersion

String

数据库版本号

ParameterCount

Integer

参数个数

Parameters

List<TemplateRecord>

参数列表,格式:{parameter1, parameter2, parameter3, …}

TemplateRecord:

名称

类型

描述

ParameterName

String

参数名

ParameterValue

String

参数默认值

ForceModify

String

是否可修改, Flase:不可修改; Ture:可修改

ForceRestart

String

是否立即生效,取值: True:需要重启数据库才能生效;False:立即生效

CheckingCode

String

校验代码,参数的可选范围,是一个正则表达式

ParameterDescription

String

参数描述

示例:

请求示例:

https://rds.aliyuncs.com/?Action=DescribeParameterTemplates

&Engine=SQLServer

&EngineVersion=2008r2

&<公共请求参数>

返回示例:

XML格式:

<DescribeParameterTemplatesResponse>

<Engine>mssql</Engine>

<EngineVersion>2008r2</EngineVersion>

<ParameterCount>1</ParameterCount>

<Parameters>

<TemplateRecord>

<CheckingCode>[0-100]</CheckingCode>

<ForceRestart>True</ForceRestart>

<Factor>1</Factor>

<ParameterDescription>

此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能。

</ParameterDescription>

<ParameterName>fill factor</ParameterName>

<ParameterValue>0</ParameterValue>

<ForceModify>True</ForceModify>

<Unit>INT</Unit>

</TemplateRecord>

</Parameters>

<RequestId>7B96585A-0FF2-4979-8FE5-7D147A29FDC0</RequestId>

</DescribeParameterTemplatesResponse>

JSON格式:

{

"Engine":"mssql",

"EngineVersion":"2008r2",

"ParameterCount":1

"Parameters":{

"TemplateRecord":[

{

"ParameterDescription":

"此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能。",

"ForceRestart":"True",

"CheckingCode":"[0-100]"

"Factor":"1"

"ParameterName":"fillfactor"

"ParameterValue":"0"

"ForceModify":"True"

"Unit":"INT"

}

]

},

"RequestId":"7B96585A-0FF2-4979-8FE5-7D147A29FDC0"

}

 

查看当前实例数据库参数运行列表:

描述:

该接口返回用户某个实例当前的参数配置。

请求参数:

名称

类型

是否必须

描述

Action

String

系统规定参数,取值:DescribeParameters

DBInstanceId

String

实例名

返回参数:

名称

类型

描述

Engine

String

数据库类型

EngineVersion

String

数据库版本号

RunningParameters

List<DBInstanceParameter>

当前运行的参数列表,格式:

ConfigParameters

List<DBInstanceParameter>

正在同步的参数列表,格式:

DBInstanceParameter参数:

名称

类型

描述

ParameterName

String

参数名

ParameterValue

String

参数值

ParameterDescription

String

参数描述

示例:

请求示例:

https://rds.aliyuncs.com/?Action=DescribeParameters

&DBInstanceId=riauvjz6zajfiq6ba1370329449201

&<公共请求参数>

返回示例:

XML格式:

<DescribeParametersResponse>

<RequestId>2A748162-8040-4D6B-813E-6910C8C033F1</RequestId>

<Engine>mssql</ Engine >

<EngineVersion>2008r2</ EngineVersion >

<RunningParameters>

<DBInstanceParameter>

<ParameterDescription>

此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能

</ParameterDescription>

<ParameterName>fill factor</ParameterName>

<ParameterValue>0</ParameterValue>

</DBInstanceParameter>

</RunningParameters>

<ConfigParameters>

<DBInstanceParameter>

<ParameterDescription>

此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能

</ParameterDescription>

<ParameterName>fillfactor</ParameterName>

<ParameterValue>50</ParameterValue>

</DBInstanceParameter>

</ConfigParameters>

</DescribeParametersResponse>

JSON格式:

{

"ConfigParameters":{

"DBInstanceParameter":[

{

"ParameterDescription":

"此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能。",

"ParameterName":"fill factor",

"ParameterValue":"50"

}

]

},

"Engine":"mssql",

"EngineVersion":"2008r2",

"RunningParameters":{

"DBInstanceParameter":[

{

"ParameterDescription":

"此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能。",

"ParameterName":"fill factor",

"ParameterValue":"0"

}

]

},

"RequestId":"2A748162-8040-4D6B-813E-6910C8C033F1"

}

 

 

修改数据库参数列表:

描述:

用户可以修改实例参数,提交请求后,RDS将下达任务,新修改的参数应用到实例。如果所提交的参数中,有需要重启数据库的,RDS将重启数据库。

必须满足以下条件,否则调用失败:

当前实例状态:使用中

当前实例锁定模式:正常

参数值有如下3:

  1. [1-65535],表示数字范围,通过正则识别,从而提取出最小值,最大值。

然后根据最小值和最大值对输入参数进行验证,另外,还须是整除因子的倍数

  1. [utf8|gbk|latin1],表示固定的取值规则,通过正则识别,从而提取出固定的取值。

然后根据这些固定的取值对输入参数进行验证

  1. 其它,这种情况符合正则表达式

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

参数是否存在;

参数是否可修改;

参数是否合法。

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

{"HttpStatusCode":400,"Code":"InvalidParameter.Format",

"Message":"Specifiedparameter is notvalid.[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

Bool

true:强制重启;false:不强制重启,默认不强制重启

示例:

请求示例:

https://rds.aliyuncs.com/?Action=ModifyeParameter

&DBInstanceId=riauvjz6zajfiq6ba1370329449201L

&Parameters={"key_buffer_size":"456","character_set_client":"gbk"}

&<公共请求参数>

返回示例:

XML格式:

<ModifyeParameterResponse>

<RequestId>542BB8D6-4268-45CC-A557-B03EFD7AB30A</RequestId>

</ModifyeParameterResponse>

JSON格式:

{

"RequestId":"542BB8D6-4268-45CC-A557-B03EFD7AB30A",

}