获取数据湖元数据表分区列表,按Filter条件查询
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Body | object | 否 | HTTP请求体 | |
CatalogId | string | 否 | 数据库分类命名空间,默认填写主账号Uid | 1344371 |
DatabaseName | string | 否 | 元数据库名称 | database_test |
Filter | string | 否 | 查询条件表达式,如ds>20201201 | ds>20201201 |
NextPageToken | string | 否 | 翻页token,从返回结果返回,无则传空字符串或'' | '' |
PageSize | integer | 否 | 每页大小 | 10 |
TableName | string | 否 | 元数据表名 | test_table_20200715162543389 |
IsShareSd | boolean | 否 | 是否共享partition的SD中column信息 |
isShareSd:是否开启共享SD中的columns信息,listpartitions返回的partitions列表中,不同的partition中sd中的column相同的可能性比较高,因此开启共享,可以降低网络传输的数据量,有助于提升性能
返回参数
Code错误码说明
NoSuchObject:对应的元数据库/表等不存在
InternalError:其他类型错误,请参考Message提示
示例
请求示例
POST /api/metastore/catalogs/databases/tables/partitions/listbyfilter HTTP/1.1
{
"TableName": "test_table_20201225",
"PageSize": 10,
"NextPageToken": "''",
"DatabaseName": "database_test",
"CatalogId": "1344371",
"Filter": "ds>20201201"
}
正常返回示例
JSON
格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "",
"NextPageToken": "",
"Partitions": [
{
"CatName": "1344371",
"CreateTime": 1608814496,
"DatabaseName": "database_test",
"LastAccessTime": 0,
"LastAnalyzedTime": 0,
"Parameters": {
"transient_lastDdlTime": "1608814496"
},
"PartitionId": "b388c318579d417ab5b3d64c823aab5b",
"PartitionName": "ds=20201224/hour=14",
"Privileges": {
"GroupPrivileges": {},
"RolePrivileges": {},
"UserPrivileges": {}
},
"Sd": {
"BucketCols": [],
"Cols": [
{
"Comment": "user_name",
"Id": "name",
"Name": "name",
"Type": "string"
}
],
"Compressed": false,
"InputFormat": "input",
"NumBuckets": 5,
"OutputFormat": "output",
"Parameters": {},
"SerDeInfo": {
"Parameters": {}
},
"SkewedInfo": {
"SkewedColNames": [],
"SkewedColValueLocationMaps": {},
"SkewedColValues": []
},
"SortCols": [],
"StoredAsSubDirectories": false
},
"TableId": "f34ff9818d8f4e02a0f965fa940d8e37",
"TableName": "test_table_20201225",
"Values": [
"20201224",
"14"
]
}
],
"RequestId": "9A3BC9C1-60A1-4E12-AF2D-D4E9F86013F6",
"Success": true
}
错误码
访问错误中心查看更多错误码。