ListMmsPartitions - 列出数据源内的分区 - 云原生大数据计算服务 MaxCompute

列出MMA数据源内的分区

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

odps:ListMmsPartitions

list

*project

acs:odps:{#regionId}:{#accountId}:mmsdatasource/{#sourceId}

无

请求语法

GET /api/v1/mms/datasources/{sourceId}/partitions HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
sourceId	integer	是	数据源 ID	200018

请求参数

名称	类型	必填	描述	示例值
dbId	integer	否	库 ID	2
dbName	string	否	库名	d1
updated	boolean	否	过滤出元数据有更新的分区	false
tableName	string	否	表名	t1
tableId	integer	否	分区所在表的 ID	20323
value	string	否	分区值	p1=1/p2=abc
status	array	否	迁移状态
	string	否	迁移状态枚举值： INIT : 未迁移 DONE : 迁移成功 DOING : 正在迁移 FAILED : 迁移失败	["DONE", "FAILED"]
lastDdlTimeStart	string	否	lastDdlTime 最小值	2024-12-17 15:44:42
lastDdlTimeEnd	string	否	lastDdlTime 最大值	2024-12-17 19:44:42
pageNum	integer	否	页码	1
pageSize	integer	否	分页大小	100
sorter.numRows	string	否	按行数排序枚举值： asc : 升序 desc : 降序	desc
sorter.size	string	否	按数据量排序枚举值： asc : 升序 desc : 降序	asc
sorter.lastDdlTime	string	否	按 lastDdlTime 排序枚举值： asc : 升序 desc : 降序	desc

返回参数

名称	类型	描述	示例值
	object	返回值
requestId	string	请求 ID	D9F872FD-5DDE-30A6-8C8A-1B8C6A81059F
data	object	数据
total	integer	分区总数	1000
objectList	array<object>	返回分区列表
	object	分区对象
id	integer	分区 ID	2323
dbId	integer	分区所在“库”的 id， “库”在不同数据源中对应的元数据层级名称不同。如，在 BigQuery，对应 Dataset; 在 Hive 中对应 Databse; 在 Databricks 中对应"Schema"; 在 MaxCompute 中对应"Schema"。	196
tableId	integer	表 ID	23
dbName	string	库名。 “库”在不同数据源中对应的元数据层级名称不同。如，在 BigQuery，对应 Dataset; 在 Hive 中对应 Databse; 在 Databricks 中对应"Schema"; 在 MaxCompute 中对应"Schema"。	d1
tableName	string	表名	t1
value	string	分区值	p1=1/p2=abc
dstProjectName	string	目标 MaxCompute 项目名	mms_test
dstSchemaName	string	目标 MaxCompute schema 名，对于没有开启 schema 的 MaxCompute 项目，该值为空	default
dstTableName	string	目标 MaxCompute 表名	default
dstValue	string	目标 MaxCompute 分区值，默认与源分区值一致	p1=1/p2=abc
sourceId	integer	数据源 ID	200018
sourceName	string	数据源名称	demo
size	integer	数据量大小-单位 Bytes	23223
numRows	integer	行数	2323
updated	boolean	元数据是否有更新	false
lastDdlTime	string	lastDdlTime	2024-12-17 15:44:42
status	string	迁移状态枚举值： INIT : 未迁移 DONE : 迁移成功 DOING : 正在迁移 FAILED : 迁移失败	DONE
pageNum	integer	页码	1
pageSize	integer	分页大小	10

示例

正常返回示例

JSON格式

{
  "requestId": "D9F872FD-5DDE-30A6-8C8A-1B8C6A81059F",
  "data": {
    "total": 1000,
    "objectList": [
      {
        "id": 2323,
        "dbId": 196,
        "tableId": 23,
        "dbName": "d1",
        "tableName": "t1",
        "value": "p1=1/p2=abc\n",
        "dstProjectName": "mms_test",
        "dstSchemaName": "default",
        "dstTableName": "default",
        "dstValue": "p1=1/p2=abc",
        "sourceId": 200018,
        "sourceName": "demo",
        "size": 23223,
        "numRows": 2323,
        "updated": false,
        "lastDdlTime": "2024-12-17 15:44:42\n",
        "status": "DONE"
      }
    ],
    "pageNum": 1,
    "pageSize": 10
  }
}

错误码

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

变更历史

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