该系列博客的目录:
概述与请求方式: 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 |
是 |
数据库类型,取值为MySQL和SQLServer |
EngineVersion |
String |
是 |
数据库版本号,MySQL:5.1或5.5或5.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-65535],表示数字范围,通过正则识别,从而提取出最小值,最大值。
然后根据最小值和最大值对输入参数进行验证,另外,还须是整除因子的倍数
- [utf8|gbk|latin1],表示固定的取值规则,通过正则识别,从而提取出固定的取值。
然后根据这些固定的取值对输入参数进行验证
- 其它,这种情况符合正则表达式
下达任务之前,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",
}