调用DescribeSlowLogTrend接口查询集群慢日志趋势统计-云数据库 ClickHouse-阿里云

查看集群慢日志趋势统计情况。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

clickhouse:DescribeSlowLogTrend

get

*DBCluster

acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否	地域 ID。您可以通过调用 DescribeRegions 接口查询地域 ID。	cn-hangzhou
DBClusterId	string	是	集群 ID。您可以通过调用 DescribeDBClusters 接口查询目标地域下所有的集群信息，包括集群 ID。	cc-bp11xxl475ui8****
StartTime	string	是	查询开始时间。格式：yyyy-MM-dd hh:mm:ss（UTC 时间）。	2022-05-20 16:00:00
EndTime	string	是	查询结束时间，格式：yyyy-MM-dd hh:mm:ss（UTC 时间）。说明查询结束时间需晚于查询开始时间，且与查询开始时间间隔小于 7 天。	2022-05-27 16:00:00
QueryDurationMs	integer	否	慢 SQL 的执行耗时。最小值为 1000，默认值为 1000。单位：毫秒。返回参数将返回超过该耗时的慢 SQL。	1000

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF
SlowLogTrend	object	慢 SQL 的结果集合。
TableSchema	object
ResultSet	array<object>	表结构。
	object	结果表结构
Type	string	列类型。	UInt64
Name	string	列名。	query_start_time
Data	object
ResultSet	array<object>	慢 SQL 列表。
	object	慢 SQL 列表。
QueryStartTime	string	查询开始的时间。格式：yyyy-MM-dd hh:mm:ss（UTC 时间）。	2022-05-22 20:00:01
MaxQueryDurationMs	string	最长执行耗时。单位：毫秒。	3000
MinQueryDurationMs	string	最短执行耗时。单位：毫秒。	1000
Count	string	慢 SQL 执行耗时的总和。单位：毫秒。	4000
AvgQueryDurationMs	string	平均执行耗时。单位：毫秒。	2000
Rows	string	返回结果集的行数。	1
RowsBeforeLimitAtLeast	string	分页大小。	1
Statistics	object	查询结果的统计信息。
RowsRead	integer	读取的行数。	14721
ElapsedTime	number	读取 SQL 的耗时。单位：毫秒。	0.001703578
BytesRead	integer	读取的数据量大小。单位：Byte。	697899

示例

正常返回示例

JSON格式

{
  "RequestId": "7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF",
  "SlowLogTrend": {
    "TableSchema": {
      "ResultSet": [
        {
          "Type": "UInt64",
          "Name": "query_start_time"
        }
      ]
    },
    "Data": {
      "ResultSet": [
        {
          "QueryStartTime": "2022-05-22 20:00:01",
          "MaxQueryDurationMs": "3000",
          "MinQueryDurationMs": "1000",
          "Count": "4000",
          "AvgQueryDurationMs": "2000"
        }
      ]
    },
    "Rows": "1",
    "RowsBeforeLimitAtLeast": "1",
    "Statistics": {
      "RowsRead": 14721,
      "ElapsedTime": 0.001703578,
      "BytesRead": 697899
    }
  }
}

错误码

HTTP status code	错误码	错误信息	描述
500	InternalError	An error occurred while processing your request.	系统内部错误，请稍后重试
503	ServiceUnavailable	An error occurred while processing your request.	系统暂时不可用，请稍后重试

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。