任务参数说明 表1 任务参数说明 参数名 描述 取值范围 默认值 参数类型 是否需要重启 applier_thread_num 全量阶段写数据到目标数据库的线程数 与规格大小有关。 极小规格：1-4 小规格：1-4 中规格：1-8 大规格：1-18 超大规格：1-24 与规格大小有关。 极小规格：2 小规格：2 中规格：4 大规格：6 超大规格：12 int 是 read_task_num 全量阶段从源数据库读取数据的线程数 与规格大小有关。 极小规格：1-2 小规格：1-2 中规格：1-4 大规格：1-8 超大规格：1-12 与规格大小有关。 极小规格：1 小规格：1 中规格：2 大规格：4 超大规格：6 int 是 shard_task_num 全量阶段从源数据库分片线程数 与规格大小有关。 极小规格：1-2 小规格：1-2 中规格：1-4 大规格：1-8 超大规格：1-8 与规格大小有关。 极小规格：1 小规格：1 中规格：2 大规格：4 超大规格：4 int 是 increment_writer_num 增量阶段写目标库线程数 与规格大小有关。 极小规格：1-8 小规格：1-16 中规格：1-32 大规格：1-128 超大规格：1-128 与规格大小有关。 极小规格：4 小规格：8 中规格：16 大规格：64 超大规格：64 int 是 relay_socket_timeout 增量阶段从源数据库拉取日志的超时时间 30000-2147483647毫秒 30000毫秒 int 是 datamove_source_socket_timeout 全量阶段从源数据库拉取数据的超时时间 120000-2147483647毫秒 120000毫秒 int 是

操作步骤 在“实时同步管理”界面，选择指定的同步任务。 单击任务名称，页面跳转至“基本信息”页面。 单击左侧“参数管理”，在“参数”页签可对当前同步任务的参数信息进行修改。 图1 查看参数信息 修改完成后，可选择“保存”或者“取消”设置。 单击“保存”，在弹出框中单击“是”，保存修改。 单击“取消”，在弹出框中单击“是”，放弃本次设置。 部分参数完成修改后，需要重启任务后才生效，可单击右上角“重启”按钮使之生效，也可参考重启同步任务内容进行重启。 除此以外，重置、续传、任务重建、主备倒换、全量阶段修改限速操作也会重启任务进程使设置生效。

操作场景 您可以复制您创建的自定义数据库参数模板。当您已创建一个数据库参数模板，并且想在新的数据库参数模板中包含该组中的大部分自定义参数和值时，复制参数模板是一个方便的解决方案。您还可以导出某数据库实例应用的参数列表，生成一个新的参数模板，供您后期使用。 复制数据库参数模板之后，新参数模板可能不会立即显示，建议您等待5分钟再使用。 您无法复制默认参数模板。不过，您可以创建基于默认参数模板的新参数模板。

常见参数的修改 表1 常见参数的修改 参数名 描述 文档链接 time_zone 时区。当实例类型为只读实例时，请务必保证该参数的值与主实例上该参数的值保持一致。 如何修改时区 default_password_lifetime 定义了全局自动密码过期策略，单位为天。 RDS for MySQL密码过期策略 tx_isolation 指定默认的事务隔离等级。 如何修改云数据库RDS的事务隔离等级 character_set_server 服务器字符集。 使用utf8mb4字符集存储emoji表情到RDS for MySQ L实例 lower_case_table_names 如果设为0，表格名称被存储成固定并且表名称将是大小写敏感的。如果设为1，表格名称被存储成小写并且表名称将是大小写不敏感的。 RDS for MySQL如何设置表名是否区分大小写 group_concat_max_len 函数GROUP_CONCAT()结果的最大长度。 GROUP_CONCAT结果不符合预期 max_connections 允许同时连接的客户端总数。如果设定值为default，表示该参数随内存规格变化。 RDS数据库实例支持的最大数据连接数是多少

修改单个参数 在实例列表，选择指定的实例，单击实例名称。 选择“参数设置”。 在参数列表的“操作”列，单击“修改”，修改参数值。 根据参数列表中“是否需要重启”提示，进行相应操作： 是：在实例列表中，查看“运行状态”，如果显示“参数变更，等待重启”，则需重启实例使之生效。 修改主实例的某些参数（如果是主备实例，备实例的参数也会被同步修改），需重启主实例使之生效。 否：无需重启，立即生效。 图1 参数修改 单击“确认”，在弹框中单击“是”，保存修改。 单击“取消”，放弃本次设置。 参数修改完成后，您可以单击“参数修改历史”，查看参数的修改详情。当前仅显示7天之内的参数修改历史。

批量修改参数 在实例列表，选择指定的实例，单击实例名称。 选择“参数设置”。 打开批量修改开关，一次最多可以修改30个参数。 根据参数列表中“是否需要重启”提示，进行相应操作： 是：在实例列表中，查看“运行状态”，如果显示“参数变更，等待重启”，则需重启实例使之生效。 修改主实例的某些参数（如果是主备实例，备实例的参数也会被同步修改），需重启主实例使之生效。 否：无需重启，立即生效。 图2 设置参数 单击“保存”，在弹框中单击“是”，保存修改。 单击“取消”，在弹框中单击“是”，放弃本次设置。 参数修改完成后，您可以单击“参数修改历史”，查看参数的修改详情。当前仅显示7天之内的参数修改历史。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 configurations Array of objects 参数模板列表。 详情请参见表3。 表3 configurations字段数据结构说明 名称 参数类型 说明 id String 参数模板ID。 name String 参数模板名称。 description String 参数模板描述。 datastore_version_name String 数据库版本名称。 datastore_name String 数据库名称。 created String 创建时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 updated String 更新时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 user_defined Boolean 是否是用户自定义参数模板： false，表示为系统默认参数模板。 true，表示为用户自定义参数模板。 正常响应样例 { "configurations": [{ "id": "887ea0d1bb0843c49e8d8e5a09a95652pr01", "name": "configuration_test", "description": "configuration_test", "datastore_version_name": "8.0", "datastore_name": "mysql", "created": "2019-05-15T11:53:34+0000", "updated": "2019-05-15T11:53:34+0000", "user_defined": true }, { "id": "3bc1e9cc0d34404b9225ed7a58fb284epr01", "name": "Default-MySQL-5.7", "description": "Default parameter group for MySQL 5.7", "datastore_version_name": "5.7", "datastore_name": "mysql", "created": "2019-05-27T03:38:51+0000", "updated": "2019-05-27T03:38:51+0000", "user_defined": false } ] } 异常响应 请参见异常请求结果。

修改自定义参数模板并应用到实例 您也可以通过修改自定义参数模板中的参数值后，将该自定义参数模板应用到实例来实现实例参数的修改。 在“参数管理”页面的“自定义模板”页签，选择目标参数模板，单击参数模板名称。 默认在“参数”页签下，根据需要修改相关参数值。 图3 修改自定义参数模板值 根据参数列表中“是否需要重启”提示，进行相应操作： 是：参数修改完成后，需要重启实例使之生效。 修改主实例的某些参数，需重启主实例使之生效。如果是高可用实例，备节点的参数也会被同步修改 修改只读实例的某些参数，需要重启该只读实例使之生效。 否：无需重启，立即生效。 单击“保存”，在弹出框中单击“是”，保存修改。 单击“取消”，放弃本次设置。 单击“预览”，可对比参数修改前和修改后的值。 参数修改完成后，您可以单击“参数修改历史”查看参数的修改详情。 自定义参数模板中参数修改后，不会立即应用到当前使用的实例，您需要手动进行应用操作才可生效，具体操作请参见应用 GaussDB (for MySQL)标准版参数模板。

请求示例 更新任务全量阶段写数据到目标数据库的线程数和全量阶段从源教据库读取数据的线程数。 https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs/c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r/modify-configuration { "values" : [ { "parameter_name" : "applier_thread_num", "parameter_value" : "20" }, { "parameter_name" : "read_task_num", "parameter_value" : "3" } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json X-Auth-Token 是 String 从 IAM 服务获取的用户Token。用户Token也就是调用IAM获取用户Token接口的响应值，请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。 缺省值：en-us 枚举值： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 values 是 Array of objects 参数值对象，基于默认参数模板初始化的参数值。 详情请参见表4。 表4 values字段数据结构说明 参数 是否必选 参数类型 描述 parameter_name 是 String 参数名称，如：“applier_thread_num”，“read_task_num”等。为空时表示不修改参数值。 parameter_value 是 String 参数名称对应的参数值，如：“20”，“false”。parameter_name不为空时，parameter_value也不可为空。

参数管理的页面权限？ 权限设计 访问参数列表页：需要list权限: coc:parameter:list 获取参数详情：需要get权限：coc:parameter:get 删除参数：需要操作类权限：coc:parameter:delete 创建参数：需要操作类权限：coc:parameter:create 更新参数：需要操作类权限：coc:parameter:update 资源类权限（具体到某一个region下 && 某一个租户的一个参数）：coc:*:*:parameter:name（第一个*代表所有regionID，第二个*所有租户，name代表参数名称） 资源类权限决定你可以访问哪些数据，操作类权限是对你有的资源类权限进行操作，常见问题： 如果你可以访问某个参数，但是你访问不了列表页，代表你缺少coc:parameter:list权限 如果你找不到指定的参数，需要确认是否有该参数的权限 coc:service-name:region:account-id:resource-type:resource-path这个是资源类权限的结构，*代表该层级所有权限，添加资源类权限需要按照这个格式填写 父主题： 参数管理常见问题

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 job_id String 参数解释： 任务ID。 取值范围： 不涉及。 restart_required Boolean 参数解释： 实例是否需要重启。 取值范围： “true”需要重启。 “false”不需要重启。 ignored_params List 参数解释： 请求参数“values”中被忽略掉，没有生效的参数名称列表。 当参数不存在时，参数修改不会下发，并通过此参数返回所有被忽略的参数名称。 取值范围： 不涉及。 正常响应样例 { "job_id" : "e7a7535b-eb9b-45ac-a83a-020dc5016d94", "restart_required" : "false", "ignored_params": [] } 异常响应 请参见异常请求结果。

URI URI格式 PUT /v3/{project_id}/instances/{instance_id}/configurations 参数说明 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求示例 修改指定实例的参数。 https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/configurations { "values" : { "max_connections" : "10", "autocommit" : "OFF", "binlog_checksum" : "CRC32", "innodb_purge_threads" : "4" } }

响应消息 响应参数 参数说明见表2。 表2 参数说明 参数 类型 说明 status String 实例运行状态。 instance_id String 实例ID。 redis_config Array 实例配置项数组。具体请参考表3。 config_status String 实例修改状态。 UPDATING FAILURE SUC CES S config_time String 实例操作时间。格式为：2017-03-31T12:24:46.297Z 表3 redis_config参数说明 参数 类型 说明 description String 配置项的描述。 param_id Integer 配置参数ID。取值见表4“参数ID”列。 param_name String 配置参数名称。取值见表4“参数名称”列。 param_value String 配置参数值。 default_value String 配置参数的默认值。取值见表4“默认值”列。 value_type String 配置参数的值类型。取值见表4“参数类型”列。 value_range String 配置参数的取值范围。取值见表4“取值范围”列。 缓存实例配置参数的说明见表4。 表4 缓存实例配置参数说明 参数ID 参数名称 适用引擎 参数类型 参数解释 取值范围 默认值 1 timeout Redis、Memcached Interger 客户端与服务端连接空闲超时断开时间，参数设为0表示连接永不断开。 0~7200，单位：秒 0 2 maxmemory-policy Redis、Memcached Enum 内存使用达到上限时对缓存数据管理策略。 参数说明见逐出策略。 volatile-lru allkeys-lru volatile-random allkeys-random volatile-ttl noeviction volatile-lfu allkeys-lfu volatile-lru 说明： 如果是2020年7月之前创建的Redis实例，且没有修改过该参数，则默认值为noeviction。如果是2020年7月之后创建的实例，默认值都为volatile-lru。 3 hash-max-ziplist-entries Redis Interger 当hash表中记录数少于参数值，使用ziplist编码格式，节约内存。 1~10000 512 4 hash-max-ziplist-value Redis Interger 当hash表中各字段长度的最大值小于参数值时，使用ziplist编码格式，节约内存。 1~10000 64 5 list-max-ziplist-entries Redis Interger 当列表中记录数少于参数值，使用ziplist编码格式，节约内存。 1~10000 512 6 list-max-ziplist-value Redis Interger 当列表中各字段长度的最大值小于参数值时，使用ziplist编码格式，节约内存。 1~10000 64 7 set-max-intset-entries Redis Interger 当一个集合仅包含字符串且整型元素数量少于参数值时，使用intset编码格式，节约内存。 1~10000 512 8 zset-max-ziplist-entries Redis Interger 当有序集合中记录数少于参数值，使用ziplist编码格式，节约内存。 1~10000 128 9 zset-max-ziplist-value Redis Interger 当有序集合中各字段长度的最大值小于参数值时，使用ziplist编码格式，节约内存。 1~10000 64 10 latency-monitor-threshold Redis Interger 延时监控的采样时间阈值（最小值）。 当阈值设置为0时，不做监控，也不采样；当阈值设置为大于0时，将监控并记录执行耗时大于阈值的操作。 用户可以通过LATENCY等命令获取统计数据和配置、执行采样监控。详情参考Redis官网说明：https://redis.io/docs/reference/optimization/latency-monitor/。 0~86400000，单位：毫秒。 0 12 reserved-memory Redis Interger 预留内存，只有单机、主备实例有此配置。 预留内存将被分配给实例VM，保证D CS 实例后台进程在做持久化和主从同步等任务时拥有足够的内存。 预留内存大小可以调高或者调低，但不能超过实例当前剩余的可用内存，以及最大可用内存的80%。其中实例最大可用内存可参考《分布式缓存服务产品介绍》文档。 实例最大可用内存数的0-80%，同时不能超过实例当前剩余的可用内存，单位：MB。 0 13 notify-keyspace-events Redis String 键空间通知，配置该参数后客户端可以通过Redis的订阅与发布功能，来接收那些以某种方式改动了Redis数据集的事件。 当配置为空字符串""或null时，配置会使用默认值Ex。 您可配置为以下字符的任意组合，指定了服务器该发送哪些类型的通知： K：键空间通知，所有通知以__keyspace@__为前缀。 E：键事件通知，所有通知以__keyevent@__为前缀。 g：DEL、EXPIRE、RENAME等类型无关的通用命令的通知。 $：字符串命令的通知。 l：列表命令的通知。 s：集合命令的通知。 h：哈希命令的通知。 z：有序集合命令的通知。 x：过期事件：每当有过期键被删除时发送。 e：驱逐(evict)事件：每当有键因为maxmemory政策而被删除时发送。 其他描述，请参考表格下方的说明。 Ex notify-keyspace-events参数的说明如下： 有效值为[K|E|KE][A|g|l|s|h|z|x|e|$]，即输入的参数中至少要有一个K或者E。 A为“g$lshzxe”所有参数的集合别名。A与“g$lshzxe”中任意一个不能同时出现。 例如，如果只想订阅键空间中和列表相关的通知，那么参数就应该设为Kl。若将参数设为字符串"AKE"表示发送所有类型的通知。 响应样例 { "status": "RUNNING", "instance_id": "c08fdc6e-5c25-4185-ab57-c0a5529b727f", "redis_config": [ { "description": "How Redis will select what to remove when maxmemory is reached, You can select among five behaviors: volatile-lru : remove the key with an expire set using an LRU algorithm allkeys-lru : remove any key according to the LRU algorithm volatile-random: remove a random key with an expire set allkeys-random: remove a random key, any key volatile-ttl : remove the key with the nearest expire time (minor TTL) noeviction : don't expire at all, just return an error on write operations", "param_id": 2, "param_name": "maxmemory-policy", "param_value": "noeviction", "default_value": "noeviction", "value_type": "Enum", "value_range": "volatile-lru,allkeys-lru,volatile-random,allkeys-random,volatile-ttl,noeviction" }, { "description": "Hashes are encoded using a memory efficient data structure when they have a small number of entries", "param_id": 3, "param_name": "hash-max-ziplist-entries", "param_value": "512", "default_value": "512", "value_type": "Interger", "value_range": "1-10000" }, { "description": "Hashes are encoded using a memory efficient data structure when the biggest entry does not exceed a given threshold", "param_id": 4, "param_name": "hash-max-ziplist-value", "param_value": "64", "default_value": "64", "value_type": "Interger", "value_range": "1-10000" }, { "description": "Lists are encoded using a memory efficient data structure when they have a small number of entries", "param_id": 5, "param_name": "list-max-ziplist-entries", "param_value": "512", "default_value": "512", "value_type": "Interger", "value_range": "1-10000" }, { "description": "Lists are encoded using a memory efficient data structure when the biggest entry does not exceed a given threshold", "param_id": 6, "param_name": "list-max-ziplist-value", "param_value": "64", "default_value": "64", "value_type": "Interger", "value_range": "1-10000" }, { "description": "When a set is composed of just strings that happen to be integers in radix 10 in the range of 64 bit signed integers.", "param_id": 7, "param_name": "set-max-intset-entries", "param_value": "512", "default_value": "512", "value_type": "Interger", "value_range": "1-10000" }, { "description": "Sorted sets are encoded using a memory efficient data structure when they have a small number of entries", "param_id": 8, "param_name": "zset-max-ziplist-entries", "param_value": "128", "default_value": "128", "value_type": "Interger", "value_range": "1-10000" }, { "description": "Sorted sets are encoded using a memory efficient data structure when the biggest entry does not exceed a given threshold", "param_id": 9, "param_name": "zset-max-ziplist-value", "param_value": "64", "default_value": "64", "value_type": "Interger", "value_range": "1-10000" }, { "description": "Close the connection after a client is idle for N seconds (0 to disable)", "param_id": 1, "param_name": "timeout", "param_value": "0", "default_value": "0", "value_type": "Interger", "value_range": "0-7200" }, { "description": "Only events that run in more time than the configured latency-monitor-threshold will be logged as latency spikes. If latency-monitor-threshold is set to 0, latency monitoring is disabled. If latency-monitor-threshold is set to a value greater than 0, all events blocking the server for a time equal to or greater than the configured latency-monitor-threshold will be logged.", "param_id": 10, "param_name": "latency-monitor-threshold", "param_value": "0", "default_value": "0", "value_type": "Interger", "value_range": "0-86400000" }, { "description": "The total memory, in bytes, reserved for non-data usage.", "param_id": 12, "param_name": "reserved-memory", "param_value": "0", "default_value": "0", "value_type": "Interger", "value_range": "0-6553" }, { "description": "Redis can notify Pub or Sub clients about events happening in the key space", "param_id": 13, "param_name": "notify-keyspace-events", "param_value": null, "default_value": null, "value_type": "regular", "value_range": "([KE]+([A]|[g$lshzxe]+)){0,11}" } ], "config_status": "SUCCESS", "config_time": "" }