调用DescribeTableStatistics接口查询目标AnalyticDB MySQL版集群中的表信息统计详情。

说明 更多关于表信息统计的详情,请参见监控信息

调试

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

请求参数

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

系统规定参数。取值:DescribeTableStatistics

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

集群ID。

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

每页记录数,取值为30(默认值)、50100

PageNumber Integer 1

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

Order String [ { "Field":"TableName", "Type":"Asc" } ]

根据指定字段进行排序,格式为JSON,是一个有序JSON数组,按输入数组的顺序进行复合排序,包含FieldType两个字段,例如[{ "Field":"TableName", "Type":"Asc" }]。其中:

  • Field表示需要排序的字段名,当前仅支持对TableName字段进行排序。
  • Type表示排序类型,支持如下取值(取值均不区分大小写):
    • Desc:降序。
    • Asc:升序。

返回数据

名称 类型 示例值 描述
TotalCount String 1

总记录数。

PageSize String 30

本页记录数。

RequestId String 4C4433FF-5D3A-4C3E-A19C-6D93B2******

请求ID。

PageNumber String 1

页数。

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

集群ID。

Items Array of TableStatisticRecords

表统计信息列表。

TableStatisticRecords
SchemaName String test_schema

数据库名称。

TableName String test_table

表名称。

RowCount Long 3

表行数。

DataSize Long 15592

表数据量,单位:Byte。

IndexSize Long 3076

索引数据量,单位:Byte。

PrimaryKeyIndexSize Long 16340

主键索引数据量,单位:Byte。

PartitionCount Long 1

分区数。

ColdDataSize Long 0

冷数据总量,单位:Byte。

说明 仅内核版本为3.1.3.4或以上集群才会返回该参数。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeTableStatistics
&DBClusterId=am-****************
&公共请求参数

正常返回示例

XML格式

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

<DescribeTableStatisticsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>4C4433FF-5D3A-4C3E-A19C-6D93B2******</RequestId>
    <PageSize>30</PageSize>
    <PageNumber>1</PageNumber>
    <DBClusterId>am-****************</DBClusterId>
    <Items>
        <TableStatisticRecords>
            <TableName>test_table</TableName>
            <ColdDataSize>0</ColdDataSize>
            <DataSize>15592</DataSize>
            <PrimaryKeyIndexSize>16340</PrimaryKeyIndexSize>
            <IndexSize>3076</IndexSize>
            <RowCount>3</RowCount>
            <PartitionCount>1</PartitionCount>
            <SchemaName>test_schema</SchemaName>
        </TableStatisticRecords>
    </Items>
</DescribeTableStatisticsResponse>

JSON格式

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

{
  "TotalCount" : 1,
  "RequestId" : "4C4433FF-5D3A-4C3E-A19C-6D93B2******",
  "PageSize" : 30,
  "PageNumber" : 1,
  "DBClusterId" : "am-****************",
  "Items" : {
    "TableStatisticRecords" : [ {
      "TableName" : "test_table",
      "ColdDataSize" : 0,
      "DataSize" : 15592,
      "PrimaryKeyIndexSize" : 16340,
      "IndexSize" : 3076,
      "RowCount" : 3,
      "PartitionCount" : 1,
      "SchemaName" : "test_schema"
    } ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 您指定的 DBClusterId 不存在,请确认 DBClusterId 值是否正确。

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