修改DDM实例参数
功能介绍
修改DDM实例参数。
接口约束
修改的参数必须在控制台“参数管理”页面内,具体可配置范围请参见《分布式数据库中间件DDM 用户指南》中“修改DDM实例参数”的内容。
URI
PUT /v3/{project_id}/instances/{instance_id}/configurations
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户在某一region下的project ID。 获取方法请参见获取项目ID。 |
instance_id |
是 |
String |
DDM实例ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Language |
否 |
String |
语种,默认中文。中文:zh-cn,英文:en-us。 |
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务的“获取用户Token”接口来获取。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
values |
是 |
values object Map<String,String> |
参数值对象,用户基于默认参数模板自定义的参数值。
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
bind_table |
否 |
String |
用于描述多个拆分表的内在数据关联性,用于告知优化器在处理join时,把join下推到MySQL层执行。格式为:[{tb.col1,tb2.col2},{tb.col2,tb3.col1},...]。 |
character_set_server |
否 |
String |
DDM服务端字符集,如果需要存储emoji表情符号,请选择utf8mb4,并设置RDS字符集也为utf8mb4。修改DDM服务端字符集时,DDM服务端字符序必须同步修改为对应类型的值。 枚举值:
|
collation_server |
否 |
String |
DDM服务端字符序。修改DDM服务端字符序时,DDM服务端字符集必须同步修改为对应类型的值。 枚举值:
|
concurrent_execution_level |
否 |
String |
逻辑表扫描时的分片并发执行级别。
枚举值:
|
connection_idle_timeout |
否 |
String |
服务器关闭连接之前等待连接活动的秒数,以秒为单位,取值范围为60-28800,默认值28800,表示服务器关闭连接之前等待28800秒后,关闭连接。 |
enable_table_recycle |
否 |
String |
是否开启表回收站。 枚举值:
|
insert_to_load_data |
否 |
String |
insert常量值是否使用load data执行。 枚举值:
|
live_transaction_timeout_on_shutdown |
否 |
String |
在途事务等待时间窗口,以秒为单位,取值范围为0-100,默认值为1,表示服务器关闭前端连接之前等待1秒后关闭连接。 |
long_query_time |
否 |
String |
记录慢查询的最小秒数,以秒为单位,取值范围为0.01-10,默认值为1,表示如果SQL执行大于等于1秒就定义为慢SQL。 |
max_allowed_packet |
否 |
String |
服务端和客户端在一次传送数据包的过程中最大允许的数据包大小。该值必须设置为1024的倍数。取值范围为1024~1073741824,默认值为1073741824。 |
max_backend_connections |
否 |
String |
允许每个DDM节点同时连接RDS的最大客户端总数。0为默认值标识符,实际值等于(RDS的最大连接数-20)/DDM节点数。取值范围为0-10000000。 |
max_connections |
否 |
String |
允许同时连接的客户端总数。与后端RDS规格及数量有关。以个数为单位,取值范围为10-40000,默认值为20000,表示允许同时连接的客户端总数不能超过40000。 |
min_backend_connections |
否 |
String |
允许每个DDM节点同时连接RDS的最小客户端总数。默认值为10。取值范围为0-10000000。 |
not_from_pushdown |
否 |
String |
是否强制下推查询语句中不含FROM的语句。 枚举值:
|
seconds_behind_master |
否 |
String |
主从RDS节点延迟时间阈值,以秒为单位,取值范围为0-7200,默认值为30,表示主RDS与从RDS之间的数据同步时间值不能超过30秒,如果超过30秒,读数据指令就不走当前读节点。 |
sql_audit |
否 |
String |
开启或关闭SQL审计。 枚举值:
|
sql_execute_timeout |
否 |
String |
SQL执行超时秒数,以秒为单位,取值范围为100-28800,默认值28800,表示SQL执行大于等于28800秒超时。 |
support_ddl_binlog_hint |
否 |
String |
DDL语句添加binlog hint。 枚举值:
|
transaction_policy |
否 |
String |
枚举值:
|
ultimate_optimize |
否 |
String |
开启或关闭优化器中的极致下推优化功能。 枚举值:
|
请求示例
修改慢查询的参数值为2,表示如果SQL执行大于等于2秒就定义为慢SQL。
PUT https://{endpoint}/v3/{project_id}/instances/{instance_id}/configurations { "values" : { "long_query_time" : 2 } }
响应参数
- 正常响应参数说明
表5 响应Body参数 参数
参数类型
描述
nodeList
String
节点列表。
needRestart
Boolean
是否需要重启实例。
jobId
String
任务ID。
configId
String
参数组ID。
configName
String
参数组名称。
- 正常响应示例
{ "nodeList" : null, "needRestart" : "false", "jobId" : "9fe84a77-6a6b-4b03-9a3e-db910a548657", "configId" : null, "configName" : null }
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。