文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 实例管理/ 查询SQL统计列表信息(PostgreSQL)
更新时间:2025-10-16 GMT+08:00
分享

查询SQL统计列表信息(PostgreSQL)

功能介绍

查询SQL统计列表信息。

调试

您可以在API Explorer中调试该接口。

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/sql-statistics

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    参数解释

    租户在某一Region下的项目ID。

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

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    instance_id

    参数解释

    实例ID。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

offset

Integer

参数解释:

索引位置,偏移量。从第一条数据偏移offset条数据后开始查询。

约束限制:

必须为数字,不能为负数。

取值范围:

大于等于0的整数。

默认取值:

0

limit

Integer

参数解释:

查询记录数。

约束限制:

不涉及。

取值范围:

默认为1000,不能为负数,最小值为1,最大值为1000。

默认取值:

1000

请求示例

查询SQL统计列表信息。

GET https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/794c38e5309344818f4b33b86ebce9b4in03/sql-statistics

响应消息

  • 正常响应要素说明
    表3 要素说明

    名称

    参数类型

    说明

    reset_view_last_time

    Long

    参数解释

    最新重置时间。

    取值范围

    不涉及。

    total_count

    Integer

    参数解释

    总的个数。

    取值范围

    不涉及。

    schemas

    Array of objects

    参数解释

    调用结果。详情请参见表4

    表4 schemas字段说明

    名称

    参数类型

    说明

    user_name

    String

    参数解释

    用户名称。

    取值范围

    不涉及。

    database

    String

    参数解释

    数据库名称。

    取值范围

    不涉及。

    query_id

    String

    参数解释

    由SQL的语法解析树计算出的内部哈希码。

    取值范围

    不涉及。

    calls

    Long

    参数解释

    调用次数。

    取值范围

    不涉及。

    query

    String

    参数解释

    SQL语句的文本形式。

    取值范围

    不涉及。

    rows

    Long

    参数解释

    扫描行数。

    取值范围

    不涉及。

    can_use

    double

    参数解释

    是否可以执行SQL限流。

    取值范围

    不涉及。

  • 正常响应样例
    {
      "reset_view_last_time": 1561561651651,
      "total_count": 1,
      "list": [
        {
          "user_name": "root",
          "database": "data_test",
          "query_id": "4454541510",
          "calls": 1111,
          "query": "select pg_sleep(222);",
          "rows": 111,
          "can_use": true
        }
      ]
    }

状态码

错误码

请参见错误码

相关文档