获取MySQL实例表空间
更新时间：2025-05-07
接口描述
获取MySQL实例下各个表的空间使用情况。
权限说明
鉴权认证机制的详细内容请参见鉴权认证。
请求结构
Plain
1GET /api/v{version}/diagnosis/mysql/space/table?appId=appId
2&nodeId=nodeId
3&database=database
4&table=table
5&orderBy=orderBy
6&order=order
7&page=page
8&pageSize=pageSize HTTP/1.1
9Host: dbsc.bj.baidubce.com
10Authorization: authorization string除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| appId | string | 是 | Query参数 | 实例ID |
| nodeId | string | 否 | Query参数 | 节点ID |
| database | string | 否 | Query参数 | 数据库名，以模糊匹配方式进行搜索 |
| table | string | 否 | Query参数 | 表名，以模糊匹配方式进行搜索 |
| orderBy | string | 否 | Query参数 | 排序字段，参考返回结果中MysqlTableSpaceModel结构字段 |
| order | string | 否 | Query参数 | 排序方式正序：asc倒序：desc |
| page | integer | 否 | Query参数 | 分页，默认是1 |
| pageSize | integer | 否 | Query参数 | 每页展示条数，默认是20 |
响应头域
无。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| items | List |
全量日志列表 |
| totalCount | integer |
日志总数 |
MysqlTableSpaceModel 结构
| 字段名 | 类型 | 说明 |
|---|---|---|
| databaseName | string | 数据库名 |
| tableName | string | 表名 |
| engine | string | 存储引擎 |
| totalSpace | integer |
表总空间 |
| dataSpace | integer |
表数据空间 |
| indexSpace | integer |
表索引空间 |
| freeSpace | integer |
表可用空间 |
| freeRate | fioat64 | 表可用空间占比 |
| usageRate | fioat64 | 表已用空间占比 |
| rows | integer |
数据空间（字节） |
| avgRowLength | integer |
平均行长度 |
| physicalSpace | integer |
表物理空间 |
请求示例
Plain
1GET /api/v1/diagnosis/mysql/space/database?appId=***&nodeId=***&page=1&pageSize=10&order=desc&orderBy=totalSpace' HTTP/1.1
2Host: dbsc.bj.baidu.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2023-07-11T11:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
JSON
1{
2 "items": [
3 {
4 "databaseName": "testtable",
5 "tableName": "testdb",
6 "engine": "InnoDB",
7 "totalSpace": 45424197632,
8 "dataSpace": 18436063232,
9 "indexSpace": 26971357184,
10 "freeSpace": 16777216,
11 "freeRate": "0.0004",
12 "usageRate": "0.9996",
13 "rows": 113272668,
14 "avgRowLength": 162,
15 "physicalSpace": 47001444352
16 }
17 ],
18 "totalCount": 1
19}