调用DescribeTableAccessCount接口查看指定日期内AnalyticDB MySQL版集群下目标表或所有表的被访问次数。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeTableAccessCount

系统规定参数。取值:DescribeTableAccessCount

DBClusterId String am-****************

集群ID。

说明 您可以调用DescribeDBClusters接口查看目标地域下所有AnalyticDB MySQL集群的详情,包括集群ID。
TableName String CUSTOMER

目标表名。

说明 若该参数留空,则会返回当前日期内目标集群下所有表的使用频次数据。
StartTime String 2021-08-30

需要查询的日期,格式为yyyy-MM-dd(UTC时间)。

说明 仅支持查看30天内的数据。
Order String [{"Field":"TableSchema","Type":"Asc"}]

将查询结果按指定字段进行排序。格式为JOSN字符串,例如[{"Field":"TableSchema","Type":"Asc"}]。其中:

  • Field表示排序字段。支持如下取值:
    • TableSchema:表所属的数据库名。
    • TableName:表名。
    • AccessCount:表被访问的次数。
  • Type表示排序方式。支持如下取值:
    • Asc:升序排序。
    • Desc: 降序排序。
说明 若不设置参数,默认按照目标表所属的数据库升序排列。
PageNumber Integer 1

页码,取值为大于0且不超过Integer数据类型的最大值。默认值为1

PageSize Integer 30

每页记录数,取值为任意正整数。默认为30

RegionId String cn-hangzhou

地域ID。

说明 您可以调用DescribeRegions接口查看AnalyticDB MySQL版支持的地域和可用区信息,包括地域ID。

返回数据

名称 类型 示例值 描述
RequestId String C242707A-01D1-54DA-A5F6-671557******

请求ID。

PageNumber Integer 1

页数。

PageSize Integer 30

本页记录数。

TotalCount Integer 1

总记录数。

Items Array of Items

表使用详情。

ReportDate String 2021-08-30

表使用日期。

TableSchema String tpch

表所属的数据库。

AccessCount String 6

表被访问的次数。

TableName String CUSTOMER

表名。

InstanceName String am-****************

表所属集群的集群ID。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeTableAccessCount
&DBClusterId=am-****************
&StartTime=2021-08-30
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeTableAccessCountResponse>
    <TotalCount>1</TotalCount>
    <RequestId>C242707A-01D1-54DA-A5F6-671557******</RequestId>
    <PageSize>30</PageSize>
    <PageNumber>1</PageNumber>
    <Items>
        <InstanceName>am-****************</InstanceName>
        <TableName>CUSTOMER</TableName>
        <TableSchema>tpch</TableSchema>
        <ReportDate>2021-08-30</ReportDate>
        <AccessCount>6</AccessCount>
    </Items>
</DescribeTableAccessCountResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "C242707A-01D1-54DA-A5F6-671557******",
  "PageSize" : 30,
  "PageNumber" : 1,
  "Items" : [ {
    "InstanceName" : "am-****************",
    "TableName" : "CUSTOMER",
    "TableSchema" : "tpch",
    "ReportDate" : "2021-08-30",
    "AccessCount" : 6
  } ]
}

错误码

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