ListPartitionNames - 获取元数据表分区名称列表

获取数据湖元数据表分区名称列表,通常用于多级分区

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Bodyobject

HTTP请求体

CatalogIdstring

数据库分类命名空间,默认填写主账号Uid

1344371
DatabaseNamestring

元数据库名称

database_test
NextPageTokenstring

翻页token,从返回结果返回,无则传空字符串或''

2cb472ec1bf84f8d92f9c4baa0d21c19aa
PageSizeinteger

分页大小

10
PartialPartValuesListString

分区值列表,可以只传入部分分区的值,会查询出所有下级分区的分区名

TableNamestring

元数据表名称

test_table_20200715162543389

返回参数

名称类型描述示例值
object

返回结果体

Codestring

状态码描述

OK
Messagestring

提示相关错误信息

.
NextPageTokenstring

翻页token

2cb472ec1bf84f8d92f9c4baa0d21c19aa
PartitionNamesarray

分区名称列表

string

分区名称

ds=20201124/hour=10
RequestIdstring

请求ID

B7F4B621-E41E-4C84-B97F-42B5380A32BB
Successboolean

是否成功

true

Code错误码说明
NoSuchObject:对应的元数据库/表等不存在
InternalError:其他类型错误,请参考Message提示

示例

请求示例

POST /api/metastore/catalogs/databases/tables/partitions/names HTTP/1.1 
 {
  "TableName": "test_table_20201225",
  "PageSize": 10,
  "NextPageToken": "''",
  "DatabaseName": "database_test",
  "CatalogId": "1344371",
  "PartialPartValues": [
    "20201124"
  ]
}

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "",
  "NextPageToken": "",
  "PartitionNames": [
    "ds=20201124/hour=10",
    "ds=20201124/hour=12",
    "ds=20201124/hour=14"
  ],
  "RequestId": "F3D5B471-EE5D-45AF-A25A-976FFF2D9AAA",
  "Success": true
}

错误码

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

阿里云首页 数据湖构建 相关技术圈