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

查询表倾斜或脏页率信息

功能介绍

该接口用于查询表倾斜或脏页率信息。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/clusters/{cluster_id}/dms/tables/statistic

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

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

约束限制

必须是有效的dws集群ID。

取值范围

36位UUID。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

rate_type

String

参数解释

查询类型,固定取值。

约束限制

不涉及。

取值范围

skew:表倾斜率。

dirtyPage:表脏页率。

默认取值

不涉及。

offset

Integer

参数解释

分页偏移量,从0开始,页数减1。

约束限制

不涉及。

取值范围

大于等于0。

默认取值

0

limit

Integer

参数解释

分页单页大小。

约束限制

不涉及。

取值范围

大于0。

默认取值

不限制。

order_by

String

参数解释

排序字段,固定取值。

约束限制

不涉及。

取值范围

table_size:表大小。

rate:表倾斜率或脏页率。

默认取值

不涉及。

sort_by

String

参数解释

正序还是倒序排序,固定取值。

约束限制

不涉及。

取值范围

ASC:正序。

DESC:倒序。

默认取值

不涉及。

filter

String

参数解释

查询条件,固定取值。

约束限制

不涉及。

取值范围

db_name:数据库名称。

schema_name:schema名称。

table_name:表名。

table_owner:所属用户。

默认取值

不涉及。

value

String

参数解释

过滤条件的值。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

collect_time

Long

参数解释

数据采集时间毫秒级时间戳。

取值范围

不涉及。

data

Array of ListTablesStatisticDto objects

参数解释

表倾斜率或脏页率列表。

取值范围

不涉及。

count

Integer

参数解释

总列表大小。

取值范围

不涉及。

表4 ListTablesStatisticDto

参数

参数类型

描述

db_name

String

参数解释

数据库名称。

取值范围

不涉及。

schema_name

String

参数解释

模式名称。

取值范围

不涉及。

table_name

String

参数解释

表名。

取值范围

不涉及。

table_owner

String

参数解释

所属用户。

取值范围

不涉及。

table_size

String

参数解释

表大小。

取值范围

不涉及。

skew_rate

Double

参数解释

表倾斜率。

取值范围

不涉及。

dirty_page_rate

Double

参数解释

脏页率。

取值范围

不涉及。

请求示例

https://{Endpoint}/v1/{project_id}/clusters/{cluster_id}/dms/tables/statistic?rate_type=dirtyPage&filter=&value=&offset=0&limit=1&order_by=&sort_by=ASC

响应示例

状态码:200

查询成功。

{
  "collect_time" : 0,
  "data" : [ {
    "db_name" : "postgres",
    "schema_name" : "pmk",
    "table_name" : "pmk_snapshot_coordinator_stat",
    "table_owner" : "Ruby",
    "table_size" : "224 KB",
    "skew_rate" : null,
    "dirty_page_rate" : 0.77
  } ],
  "count" : 3
}

状态码

状态码

描述

200

查询成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。