查询 SQL 调优建议
更新时间：2026-01-30
查询 SQL 调优建议
接口描述
该接口用于查询 SQL 调优建议。
请求结构
Plain Text
1GET /v{version}/ddc/ob/instance/{instanceId}/tenant/{tenantId}/sql/{sqlId}/tuningAdvices HTTP/1.1
2Host: ddc.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| instanceId | String | 是 | URL参数 | 集群ID |
| tenantId | String | 是 | URL参数 | 租户ID |
| sqlId | String | 是 | URL参数 | SQL ID。 |
| dbName | String | 是 | Query参数 | 数据库名称。 |
| startTime | String | 是 | Query参数 | 开始时间。 |
| endTime | String | 是 | Query参数 | 结束时间。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| dataList | List<DataItem> | 数据列表。 |
| total | Integer | 总数量。 |
DataItem
| 参数名称 | 类型 | 描述 |
|---|---|---|
| columnNames | String | 索引列顺序。 |
| columns | List<Column> | 索引列信息。 |
| database | String | 数据库名称。 |
| dbName | String | 数据库名称。 |
| sqlId | String | SQL ID。 |
| table | String | 表名。 |
| tenantId | String | 租户 ID。 |
| type | String | 优化类型。 |
Column
| 参数名称 | 类型 | 描述 |
|---|---|---|
| columnName | String | 列名。 |
| maxValue | String | 最大值。 |
| minValue | String | 最小值。 |
| ndv | Float | NDV。 |
请求示例
Plain Text
1GET http://ddc.bj.baidubce.com/v1/ddc/ob/instance/ob7g5m8khp0vs0/tenant/t7g5pystgmzs0/sql/3F5F7A0083116D221E0B1DDEDE388ABC/tuningAdvices?startTime=2026-01-28T06%3A00%3A00Z&endTime=2026-01-28T12%3A00%3A00Z&dbName=clltestdb
2Host: ddc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "dataList": [
8 {
9 "columnNames": "CREATE_TIME",
10 "columns": [
11 {
12 "columnName": "CREATE_TIME",
13 "maxValue": "'2026-01-28 14:44:45'",
14 "minValue": "'2025-01-29 14:44:37'",
15 "ndv": 3257.0
16 }
17 ],
18 "database": "clltestdb",
19 "dbName": "CLLTESTDB",
20 "localityType": "LOCAL",
21 "sqlId": "3F5F7A0083116D221E0B1DDEDE388ABC",
22 "table": "USERS",
23 "tenantId": "t7g5pystgmzs0",
24 "type": "INDEX_CREATION"
25 },
26 {
27 "columnNames": "GENDER;AGE",
28 "columns": [
29 {
30 "columnName": "GENDER",
31 "maxValue": "'男'",
32 "minValue": "'女'",
33 "ndv": 3.0
34 },
35 {
36 "columnName": "AGE",
37 "maxValue": "68",
38 "minValue": "18",
39 "ndv": 52.0
40 }
41 ],
42 "database": "clltestdb",
43 "dbName": "CLLTESTDB",
44 "localityType": "LOCAL",
45 "sqlId": "3F5F7A0083116D221E0B1DDEDE388ABC",
46 "table": "USERS",
47 "tenantId": "t7g5pystgmzs0",
48 "type": "INDEX_CREATION"
49 },
50 {
51 "columnNames": "AGE;USERNAME",
52 "columns": [
53 {
54 "columnName": "AGE",
55 "maxValue": "68",
56 "minValue": "18",
57 "ndv": 52.0
58 },
59 {
60 "columnName": "USERNAME",
61 "maxValue": "'zhaoliu'",
62 "minValue": "'lisi'",
63 "ndv": 50416.0
64 }
65 ],
66 "database": "clltestdb",
67 "dbName": "CLLTESTDB",
68 "localityType": "LOCAL",
69 "sqlId": "3F5F7A0083116D221E0B1DDEDE388ABC",
70 "table": "USERS",
71 "tenantId": "t7g5pystgmzs0",
72 "type": "INDEX_CREATION"
73 }
74 ],
75 "total": 3
76}评价此篇文章