查询重分布详情
功能介绍
该接口用于查看当前集群的重分布模式、重分布进度、数据表重分布详情等监控信息。
查看重分布详情功能DWS 2.0 8.1.1.200及以上集群版本支持,其中数据表重分布进度详情仅DWS 2.0 8.2.1及以上集群版本支持。
调用方法
请参见如何调用API。
URI
GET /v2/{project_id}/clusters/{cluster_id}/redistribution
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
cluster_id |
是 |
String |
参数解释: 集群ID。获取方法请参见获取集群ID。 约束限制: 必须是有效的dws集群ID。 取值范围: 36位UUID。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
参数解释: 分页查询,每页大小。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 10 |
|
offset |
否 |
Integer |
参数解释: 分页偏移量,从0开始,页数减1。 约束限制: 不涉及。 取值范围: 大于等于0 默认取值: 0 |
|
db_name |
否 |
String |
参数解释: 数据库名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: null |
|
table_name |
否 |
String |
参数解释: 表名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: null |
|
type |
否 |
String |
参数解释: 类型,取值来自public.pgxc_redistb表的redistributed字段。多个可用逗号分割。 约束限制: 不涉及。 取值范围: i:重分布中; y:已完成; n:未开始; 默认取值: null,即不过滤。 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
redis_info |
RdsRedisInfo object |
参数解释: 重分布信息。 取值范围: 不涉及。 |
|
schedule_mode |
Boolean |
参数解释: 调度模式。 取值范围: false:非调度模式;true:调度模式。 |
|
pause_enable |
Boolean |
参数解释: 是否允许暂停。 取值范围: false:不允许暂停;true:允许暂停。 |
|
recover_enable |
Boolean |
参数解释: 是否允许恢复。 取值范围: false:不允许恢复;true:允许恢复。 |
|
retry_enable |
Boolean |
参数解释: 是否允许重试。 取值范围: false:不允许重试;true:允许重试。 |
|
update_enable |
Boolean |
参数解释: 是否允许更新。 取值范围: false:不允许更新;true:允许更新,该参数仅仅适用于调度模式。 |
|
control_enable |
Boolean |
参数解释: 是否允许控制。 取值范围: false:不允许控制;true:允许控制,该参数仅仅适用于调度模式。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 重分布信息ID。 取值范围: 不涉及。 |
|
cluster_id |
String |
参数解释: 集群ID。 取值范围: 不涉及。 |
|
start_time |
String |
参数解释: 开始时间。 取值范围: 不涉及。 |
|
end_time |
String |
参数解释: 结束时间。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 状态。 取值范围: PREPARE|RUNNING|WAITING|PAUSE|PAUSING|SUCCESS|FAIL。 |
|
redis_conf |
RedisConf object |
参数解释: 重分布配置。 取值范围: 不涉及。 |
|
redis_progress |
RedisProgress object |
参数解释: 重分布进度信息。 取值范围: 不涉及。 |
|
redis_table_detail |
RedisTableDetail object |
参数解释: 重分布表信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
redis_mode |
String |
参数解释: 重分布模式。 取值范围: online|offline。 |
|
schedule_conf |
ScheduleConf object |
参数解释: 调度配置信息。 取值范围: 不涉及。 |
|
parallel_jobs |
Integer |
参数解释: 重分布并发数。 取值范围: 1~200。 |
|
parallel_job |
Integer |
参数解释: 重分布并发数,已经废弃。 取值范围: 1~200。 |
|
priority_policy |
String |
参数解释: 优先级策略。 取值范围: large:优先对大表进行重分布。 small:优先对小表进行重分布 default:默认顺序进行重分布。 |
|
bucket_split_info |
BucketSplitInfo object |
参数解释: 桶分裂信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
schedule_start |
String |
参数解释: 调度开始时间。 取值范围: 不涉及。 |
|
schedule_end |
String |
参数解释: 调度结束时间。 取值范围: 不涉及。 |
|
schedule_type |
String |
参数解释: 调度类型。 取值范围: 不涉及。 |
|
schedule_date |
Array of integers |
参数解释: 调度日期。 取值范围: 不涉及。 |
|
schedule_time |
Array of strings |
参数解释: 调度时间列表。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
current_dn_num |
Integer |
参数解释: 当前DN数。 取值范围: 不涉及。 |
|
after_scale_out_dn_num |
Integer |
参数解释: 扩容后DN数。 取值范围: 不涉及。 |
|
current_bucket_num |
Integer |
参数解释: 当前bucket数。 取值范围: 不涉及。 |
|
after_scale_out_bucket_num |
Integer |
参数解释: 扩容后bucket数。 取值范围: 不涉及。 |
|
is_bucket_split |
Boolean |
参数解释: 扩容是否涉及bucket分裂。 取值范围: 不涉及。 |
|
bucket_tilt_rate |
String |
参数解释: bucket DN倾斜率,用于衡量bucket在DN节点上不均衡程度。 取值范围: 不涉及。 |
|
after_scale_out_bucket_tilt_rate |
String |
参数解释: 扩容后 bucket DN倾斜率,用于衡量扩容后bucket在DN节点上不均衡程度。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
bytes_done |
Long |
参数解释: 已完成字节数。 取值范围: 不涉及。 |
|
byte_left |
Long |
参数解释: 剩余字节数。 取值范围: 不涉及。 |
|
tables_done |
Integer |
参数解释: 完成表数量。 取值范围: 不涉及。 |
|
tables_left |
Integer |
参数解释: 剩余表数量。 取值范围: 不涉及。 |
|
table_progress |
Integer |
参数解释: 表重分布进度。 取值范围: 1~100。 |
|
total_progress |
Integer |
参数解释: 总进度。 取值范围: 1~100。 |
|
redis_rate |
String |
参数解释: 重分布速度。 取值范围: 不涉及。 |
|
estimated_time |
String |
参数解释: 预估时间。 取值范围: 不涉及。 |
|
completed |
Boolean |
参数解释: 是否已完成。 取值范围: 不涉及。 |
|
initialed |
Boolean |
参数解释: 是否完成初始化。 取值范围: 不涉及。 |
|
fail_count |
Integer |
参数解释: 失败次数。 取值范围: 不涉及。 |
|
redistributing |
Boolean |
参数解释: cm_ctl查询的重分布结果。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 状态。 取值范围: 不涉及。 |
|
pause_by_user |
Boolean |
参数解释: 是否用户暂停。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
Array of RedisTable objects |
参数解释: 重分布具体数据。 取值范围: 不涉及。 |
|
total |
Integer |
参数解释: 重分布表张数。 取值范围: 不涉及。 |
请求示例
查询重分布详情。
GET https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/clusters/e59d6b86-9072-46eb-a996-13f8b44994c1/redistribution
{
"redis_mode" : "online",
"parallel_jobs" : 3
}
响应示例
状态码:200
查询重分布详情成功。
{
"error_msg" : null,
"redis_info" : {
"id" : "1e1006ae-5243-4989-9452-c0217ad08776",
"cluster_id" : "37e6956b-17dd-4aef-980d-8ebd9c29f887",
"start_time" : "2025-05-15 14:04",
"end_time" : "",
"status" : "PAUSE",
"redis_conf" : {
"redis_mode" : "online",
"schedule_conf" : null,
"parallel_jobs" : 4,
"priority_policy" : "default",
"bucket_split_info" : {
"current_dn_num" : 3,
"after_scale_out_dn_num" : 6,
"current_bucket_num" : 32,
"after_scale_out_bucket_num" : 32,
"is_bucket_split" : false,
"bucket_tilt_rate" : "9.09%",
"after_scale_out_bucket_tilt_rate" : "16.67%"
}
},
"redis_progress" : {
"bytes_done" : 7219200,
"byte_left" : 0,
"tables_done" : 95,
"tables_left" : 230,
"table_progress" : 29,
"total_progress" : 31,
"redis_rate" : "21 MB/s",
"estimated_time" : "00:12:06",
"completed" : false,
"initialed" : true,
"fail_count" : 0,
"redistributing" : true,
"status" : "FAIL",
"pause_by_user" : false
},
"redis_table_detail" : {
"data" : [ {
"table_name" : "test_69",
"id" : 2147492808,
"schema_name" : "public",
"logical_cluster_name" : "v3_logical",
"size" : 77815808,
"status" : "i"
}, {
"table_name" : "test_171",
"id" : 2147493123,
"schema_name" : "public",
"logical_cluster_name" : "v3_logical",
"size" : 77815808,
"status" : "i"
}, {
"table_name" : "test_236",
"id" : 2147493327,
"schema_name" : "public",
"logical_cluster_name" : "v3_logical",
"size" : 77815808,
"status" : "i"
} ],
"total" : 3
}
},
"schedule_mode" : false,
"pause_enable" : false,
"recover_enable" : true,
"retry_enable" : false,
"update_enable" : false,
"control_enable" : false
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询重分布详情成功。 |
|
400 |
请求错误。 |
|
401 |
鉴权失败。 |
|
403 |
没有操作权限。 |
|
404 |
找不到资源。 |
|
500 |
服务内部错误。 |
|
503 |
服务不可用。 |