获取分区信息列表（废弃）

功能介绍

该API用于用于获取分区信息的列表。

当前接口已废弃，不推荐使用。

调试

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

URI

URI格式：
GET /v1.0/{project_id}/databases/{database_name}/tables/{table_name}/partitions

参数说明

表1 URI 参数
参数名称	是否必选	参数类型	说明
project_id	是	String	项目编号，用于资源隔离。获取方式请参考获取项目ID。
database_name	是	String	数据库名称。
table_name	是	String	表名称。

表2 query参数
参数名称	是否必选	参数类型	说明
limit	否	Integer	每页显示的返回信息的个数，默认值为100。
offset	否	Integer	偏移量。
filter	否	String	筛选条件，目前只支持“=”条件筛选，例如：name=name1，表示筛选出分区中name=name1的数据，name为分区列名称，name1为分区列的值。key和value不区分大小写。例如：GET /v1.0/{project_id}/databases/{database_name}/tables/{table_name}/partitions?part=part2

请求消息

无请求参数。

响应消息

表3 响应参数
参数名称	是否必选	参数类型	说明
is_success	否	Boolean	执行请求是否成功。“true”表示请求执行成功。
message	否	String	系统提示信息，执行成功时，信息可能为空。
partitions	否	Object	分区信息。请参考表4。

表4 partitions参数说明
参数名称	是否必选	参数类型	说明
total_count	是	Long	总个数。
partition_infos	是	Array of Objects	分区信息列表。请参考表5。

表5 partition_infos参数说明
参数名称	是否必选	参数类型	说明
partition_name	是	String	分区名。
create_time	是	Long	创建时间。
last_access_time	是	Long	最后改动时间。
locations	否	Array of Strings	路径，非DLI表显示，DLI表不显示。
last_ddl_time	否	Long	最后一个ddl语句执行时间，（单位：秒（s））。
num_rows	否	Long	该分区数据总行数。
num_files	否	Long	分区文件数。
total_size	否	Long	该分区总的数据大小（单位：字节）。

请求示例

无

响应示例

{
    "is_success": true,
    "message": "list partitions succeed",
    "partitions": {
        "total_count": 5,
        "partition_infos": [
            {
                "partition_name": "name=test",
                "create_time": 1579520179000,
                "last_access_time": 1579520179000,
                "locations": [
                    "obs://test/partition"
                ]
            },
            {
                "partition_name": "name=test1",
                "create_time": 1579521406000,
                "last_access_time": 1579521406000,
                "locations": [
                    "obs://test/partition"
                ]
            },
            {
                "partition_name": "name=test2",
                "create_time": 1579521884000,
                "last_access_time": 1579521884000,
                "locations": [
                    "obs://test/partition"
                ]
            },
            {
                "partition_name": "name=test3",
                "create_time": 1579522085000,
                "last_access_time": 1579522085000,
                "locations": [
                    "obs://test/partition"
                ]
            },
            {
                "partition_name": "name=name1/age=age1",
                "create_time": 1581409182000,
                "last_access_time": 1581409182000,
                "locations": [
                    "obs://test/0117"
                ],
                "last_ddl_time": 1581409182,
                "total_size": 2130,
                "num_rows": -1,
                "num_files": 2
            }
        ]
    }
}