CreateMmsJob - 创建数据迁移任务_云原生大数据计算服务 MaxCompute(MaxCompute)-阿里云帮助中心

创建数据迁移任务

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作

操作	访问级别	资源类型	条件关键字	关联操作
odps:CreateMmsJob	create	*project `acs:odps:{#regionId}:{#accountId}:mmsdatasource/{#sourceId}`	无	无

请求语法

        
POST /api/v1/mms/datasources/{sourceId}/jobs HTTP/1.1

请求参数

名称	类型	必填	描述	示例值

名称	类型	必填	描述	示例值
sourceId	long	是	数据源 ID	2000014
body	object	否	请求体参数
sourceId	long	否	数据源 ID	2000014
name	string	否	迁移作业名字	migrate_db_1
sourceName	string	否	数据源名	demo
srcDbName	string	否	源库名	src_db
srcSchemaName	string	否	源 schema name-三层命名空间中的 schema	default
dstDbName	string	否	目标 MaxCompute 项目	mms_test
dstSchemaName	string	否	目标 MaxCompute Schema	default
taskType	string	否	迁移任务类型枚举值： HIVE：HIVE UDTF方式。 BIGQUERY：BIGQUERY read api方式。	BIGQUERY
partitions	array	否	分区 ID 列表
partition	long	否	分区 ID 值	1232
tables	array	否	table 名字列表
table	string	否	table 名字	t1
tableBlackList	array	否	table 黑名单
tableBlackList	string	否	table 名	t1
tableWhiteList	array	否	table 白名单, 注意：同时有白名单和黑名单时，只有黑名单有效
tableWhiteList	string	否	table 名	t1
partitionFilters	object	否	{table 名：分区过滤表达式}
	string	否	分区过滤表达式	例子：p1 >= '2022-03-04' and (p2 = 10 or p3 > 20) and p4 in ('abc', 'cde') 例子说明： 1. p1, p2, p3为分区名 2. 分区值只有字符串和数字两种，字符串被双引号或单引号包裹。除int/bigint类型的分区列值外，其他所有类型的分区值都只能取字符串值。 3. 比较操作符包括: >, >=, = , <, <=, <> 4. 支持"in"操作符 5. 逻辑操作符包括: and, or 6. 支持括号
schemaOnly	boolean	否	是否只迁元数据	false
tableMapping	object	否	{源表: 目标表}
	string	否	table 名	t1_1
increment	boolean	否	增量迁移：只迁移新分区或有变动的分区，注意有变动的分区会被重迁	true
enableVerification	boolean	否	开启校验，目前校验方式是在源和目标端执行 select count，对比行数	true
columnMapping	object	否	{源列名：目标列名}
	string	否	列名	null
others	object	否	其他配置信息
	any	否	配置值	null

返回参数

名称	类型	描述	示例值

名称	类型	描述	示例值
	object	ApiRes
requestId	string	请求 ID。	73207140-0FD5-588A-B11A-3CE093924196
data	object	返回数据
asyncTaskId	long	创建迁移作业的异步任务 ID	100

示例

正常返回示例

JSON格式

        
{
  "requestId": "73207140-0FD5-588A-B11A-3CE093924196",
  "data": {
    "asyncTaskId": 100
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作

变更时间	变更内容概要	操作
2025-01-09	API 内部配置变更，不影响调用	查看变更详情