全部產品
Search
文件中心

MaxCompute:GetMmsJob - 擷取單個遷移作業詳情

更新時間:Feb 04, 2026

擷取單個MMA遷移計劃詳情

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

odps:GetMmsJob

get

*project

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

請求文法

GET /api/v1/mms/datasources/{sourceId}/jobs/{jobId} HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

sourceId

integer

資料來源 ID

2000015

jobId

integer

作業 ID

10

請求參數

名稱

類型

必填

描述

樣本值

當前API無需請求參數

返回參數

名稱

類型

描述

樣本值

object

ApiRes

requestId

string

請求 ID

D9F872FD-5DDE-30A6-8C8A-1B8C6A81059F

data

object

遷移工作物件

id

integer

遷移作業 ID

10

name

string

遷移作業名字

migrate_db_1

sourceId

integer

資料來源 ID

2

dbId

integer

源庫 ID

23

sourceName

string

資料來源名

demo

srcDbName

string

源庫名

mms_test

srcSchemaName

string

源 schema name-三層命名空間中的 schema

default

dstDbName

string

目標 MaxCompute 專案

mms_target

dstSchemaName

string

目標 MaxCompute Schema

default

status

string

遷移任務狀態

枚舉值:

  • INIT :

    未運行

  • DONE :

    成功

  • DOING :

    運行中

  • FAILED :

    運行失敗

DOING

type

string

遷移範圍:Database, Tables, Partitions

枚舉值:

  • Partitions :

    多分區

  • Database :

    單庫

  • Tables :

    多表

Tables

taskNum

integer

包含的遷移任務數量

100

stopped

boolean

被停止

false

createTime

string

建立時間。

2024-12-17 15:44:17

taskDone

integer

完成的遷移任務數量

100

config

object

遷移作業的配置

partitions

array

當 type=Partitions 時, 通過該參數指定要遷移表的分區 ID 列表

integer

要遷移表的分區 ID

[123, 132]

tables

array

當 type=Tables 時, 通過該參數指定要遷移的表的名稱列表

string

要遷移的表的名稱

["student", "scores"]

taskType

string

Depcreated; 可以指定的值有 MOCK, HIVE: hive udtf task, HIVE_DATAX: hive datax task, COPY_TASK: odps Copy Task, ODPS_INSERT_OVERWRITE: odps simple insert overwrite task, MC2MC_VERIFY, OSS, HIVE_OSS, HIVE_SPARK, BIGQUERY

BIGQUERY

tableBlackList

array

當 type=Database 時, 通過 tableBlackList 指定排除哪些表不遷移

string

當 type=Database 時, 要排查的表

["student", "scores"]

tableWhiteList

array

當 type=Database 時, 指定的要遷移的表列表。如果沒有指定 tableWhiteList,則遷移對應 Database 下的所有表

string

當 type=Database 時, 指定的要遷移的表。

["student", "scores"]

partitionFilters

object

分區過濾運算式。 配置指定"表"對應的"分區過濾運算式"

string

分區過濾運算式。例如:p1 >= '2022-03-04' and (p2 = 10 or p3 > 20) and p4 in ('abc', 'cde'),介紹如下:

p1、p2 和 p3 均為分區名。

分區值僅包含字串和數字,字串被雙引號或單引號包裹。

除 INT 和 BIGINT 類型的分區列值外,其他類型的分區值都只能取字串值。

比較操作符包括:>、>=、= 、<、<=、<>。

分區過濾運算式支援 IN 操作符。

邏輯操作符包括:AND 和 OR。

支援使用括弧。

{ "student": "p1 >= '2022-03-04' and (p2 = 10 or p3 > 20) and p4 in ('abc', 'cde')" }

schemaOnly

boolean

Depcreated

false

tableMapping

object

源表名->目標名 映射

string

源表名->目標名 映射

{'a': 'a1'}

increment

boolean

增量遷移:只遷移新分區或有變動的分區,注意有變動的分區會被重遷

true

enableVerification

boolean

開啟校正,目前校正方式是在源和目標端執行 select count,對比行數

true

tunnelQuota

string

Depcreated

Depcreated

columnMapping

object

{源列名:目標列名}

string

{源列名:目標列名}

{"c-1": "c_1"}

others

object

其他配置資訊

{"spark.executor.mem": "2g"}

eta

string

期望的遷移完成時間. 注意:eta 值越小,遷移任務的優先順序會越高

2025-05-06

樣本

正常返回樣本

JSON格式

{
  "requestId": "D9F872FD-5DDE-30A6-8C8A-1B8C6A81059F",
  "data": {
    "id": 10,
    "name": "migrate_db_1",
    "sourceId": 2,
    "dbId": 23,
    "sourceName": "demo",
    "srcDbName": "mms_test",
    "srcSchemaName": "default",
    "dstDbName": "mms_target",
    "dstSchemaName": "default",
    "status": "DOING",
    "type": "Tables",
    "taskNum": 100,
    "stopped": true,
    "createTime": "2024-12-17 15:44:17",
    "taskDone": 100,
    "config": {
      "partitions": [
        0
      ],
      "tables": [
        "[\"student\", \"scores\"]"
      ],
      "taskType": "BIGQUERY",
      "tableBlackList": [
        "[\"student\", \"scores\"]"
      ],
      "tableWhiteList": [
        "[\"student\", \"scores\"]"
      ],
      "partitionFilters": {
        "key": "{\n\"student\": \"p1 >= '2022-03-04' and (p2 = 10 or p3 > 20) and p4 in ('abc', 'cde')\" \n}\n"
      },
      "schemaOnly": false,
      "tableMapping": {
        "key": "{'a': 'a1'}"
      },
      "increment": true,
      "enableVerification": true,
      "tunnelQuota": "Depcreated",
      "columnMapping": {
        "key": "{\"c-1\": \"c_1\"}"
      },
      "others": {
        "spark.executor.mem": "2g"
      }
    },
    "eta": "2025-05-06"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情