更新时间:2025-09-18 GMT+08:00

下发重分布

功能介绍

该接口用于集群扩容后将老节点数据均匀分布到新扩节点的数据重分布操作,数据“重分布”后将大大提升业务响应速率。

重分布功能DWS 2.0 8.1.1.200及以上集群版本支持。

离线调度重分布模式在8.2.0及以上版本将不再支持。

只有在扩容之后,集群任务信息为“待重分布”状态时才能手动使用“重分布”功能,其他时段该功能不可使用。

在扩容阶段也可以选择重分布模式等高级配置,详情参见设置高级配置。

重分布队列的排序依据表的relpage大小进行,为确保relpage大小正确,建议在重分布之前对需要重分布的表执行analyze操作。

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/clusters/{cluster_id}/redistribution

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

集群ID。获取方法请参见获取集群ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

redis_mode

String

参数解释

重分布模式

约束限制

不涉及。

取值范围

online:在线重分布;

offline:离线重分布;

默认取值

offline

parallel_jobs

Integer

参数解释

重分布并发数。

约束限制

不涉及。

取值范围

4~200

默认取值

4

响应参数

状态码:200

重分布下发成功。

请求示例

下发集群离线重分布任务,设置并发数为100。

POST https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/clusters/e59d6b86-9072-46eb-a996-13f8b44994c1/redistribution

{
  "redis_mode" : "offline",
  "parallel_jobs" : 100
}

响应示例

状态码:200

重分布下发成功。

{ }

状态码

状态码

描述

200

重分布下发成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。