调用DescribeDBInstanceDataBloat获取实例的数据膨胀情况-云原生数据仓库AnalyticDB-阿里云-云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

获取AnalyticDB PostgreSQL版实例的数据膨胀情况。

接口说明

本接口用于查看存储弹性模式的 AnalyticDB PostgreSQL 版实例的数据膨胀状态，实例内核小版本需为 V6.3.10.1 及以上，如何查看和升级内核小版本，请参见查看内核小版本和版本升级。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

gpdb:DescribeDBInstanceDataBloat

get

*DBInstance

acs:gpdb:*:{#accountId}:dbinstance/{#DBInstanceId}

无

请求参数

名称	类型	必填	描述	示例值
DBInstanceId	string	是	实例 ID。说明您可以调用 DescribeDBInstances 接口查看目标地域下所有的 AnalyticDB PostgreSQL 实例的详情，包括实例 ID。	gp-bp12ga6v69h86****
PageSize	integer	否	每页记录数，取值说明： 30 50 100 默认值：30。	30
PageNumber	integer	否	页码，大于 0 且不超过 Integer 的最大值，默认值：1。	1
Database	string	否	数据库名称	test
OrderBy	string	否	排序条件	{Field: TableName, Type: Desc}

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	B4CAF581-2AC7-41AD-8940-D56DF7AADF5B
TotalCount	integer	表数量，该数值除以分页大小等于总页数。	1
PageNumber	integer	当前页码。	1
Items	array<object>	数据膨胀详情列表。
	object
Sequence	integer	序号。	1
DatabaseName	string	数据库名称。	adbtest
SchemaName	string	Schema 名称。	schema1
TableName	string	表名称。	tab1
StorageType	string	表存储类型，取值说明： Heap Table: 堆表。 Append-Only Heap Table：Append-Only 堆表。 Append-Only Columnar Table：列存表。	Heap Table
ExpectTableSize	string	期望表大小。期望表大小为系统判断没有膨胀情况下的表大小。	1MB
RealTableSize	string	实际表大小。	1.2MB
BloatSize	string	膨胀表的大小，为可释放的空间量。	0.2MB
BloatCeoff	string	数据膨胀的系数，膨胀系数计算公式如下：系统统计的死行数/系统统计的活跃行数。	1.03
SuggestedAction	string	暂不返回该参数。	null
TimeLastVacuumed	string	上次 VACUUM 表的时间（UTC 时间）。	2022-08-08T16:00:00Z
TimeLastUpdated	string	上次更新（DELETE、INSERT 或 UPDATE 操作）表的时间。	2022-08-08T20:00:00Z

示例

正常返回示例

JSON格式

{
  "RequestId": "B4CAF581-2AC7-41AD-8940-D56DF7AADF5B",
  "TotalCount": 1,
  "PageNumber": 1,
  "Items": [
    {
      "Sequence": 1,
      "DatabaseName": "adbtest",
      "SchemaName": "schema1",
      "TableName": "tab1",
      "StorageType": "Heap Table",
      "ExpectTableSize": "1MB",
      "RealTableSize": "1.2MB",
      "BloatSize": "0.2MB",
      "BloatCeoff": "1.03",
      "SuggestedAction": "null",
      "TimeLastVacuumed": "2022-08-08T16:00:00Z",
      "TimeLastUpdated": "2022-08-08T20:00:00Z"
    }
  ]
}

错误码

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

变更历史

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