GetMmsJob - MaxCompute: Central de Documentação do Alibaba Cloud

Obtém os detalhes de um único plano de migração MMA.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

odps:GetMmsJob

get

*projeto.

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

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
sourceId	integer	Sim	O ID da fonte de dados.	2000015
jobId	integer	Sim	O ID do trabalho.	10

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	ApiRes
requestId	string	O ID da solicitação.	D9F872FD-5DDE-30A6-8C8A-1B8C6A81059F
data	object	O objeto do trabalho de migração.
id	integer	O ID do trabalho de migração.	10
name	string	O nome do trabalho de migração.	migrate_db_1
sourceId	integer	O ID da fonte de dados.	2
dbId	integer	O ID do banco de dados de origem.	23
sourceName	string	O nome da fonte de dados.	demo
srcDbName	string	O nome do banco de dados de origem.	mms_test
srcSchemaName	string	O nome do schema de origem em um namespace de três níveis.	default
dstDbName	string	O projeto MaxCompute de destino.	mms_target
dstSchemaName	string	O schema MaxCompute de destino.	default
status	string	O status da tarefa de migração. Valores válidos: INIT : Não está em execução. DONE : Bem-sucedido. DOING : Em execução. FAILED : Com falha.	DOING
type	string	O escopo da migração. Valores válidos: Database, Tables, Partitions. Valores válidos: Partitions : Múltiplas partições. Database : Banco de dados único. Tables : Múltiplas tabelas.	Tables
taskNum	integer	O número de tarefas de migração incluídas.	100
stopped	boolean	Indica se o trabalho está parado.	false
createTime	string	A hora de criação no formato AAAA-MM-DD HH:mm:ss.	2024-12-17 15:44:17
taskDone	integer	O número de tarefas de migração concluídas.	100
config	object	A configuração do trabalho de migração.
partitions	array	A lista de IDs de partição das tabelas a serem migradas. Este parâmetro entra em vigor quando type é definido como Partitions.
	integer	O ID da partição da tabela a ser migrada.	[123, 132]
tables	array	A lista de nomes de tabelas a serem migradas. Este parâmetro entra em vigor quando type é definido como Tables.
	string	O nome da tabela a ser migrada.	["student", "scores"]
taskType	string	[Deprecated] Valores válidos: MOCK, HIVE (tarefa udtf do hive), HIVE_DATAX (tarefa datax do hive), COPY_TASK (tarefa de cópia do ODPS), ODPS_INSERT_OVERWRITE (tarefa simples de insert overwrite do ODPS), MC2MC_VERIFY, OSS, HIVE_OSS, HIVE_SPARK, BIGQUERY.	BIGQUERY
tableBlackList	array	A lista de tabelas a serem excluídas da migração. Este parâmetro entra em vigor quando type é definido como Database.
	string	A tabela a ser excluída da migração. Este parâmetro entra em vigor quando type é definido como Database.	["student", "scores"]
tableWhiteList	array	A lista de tabelas a serem migradas. Este parâmetro entra em vigor quando type é definido como Database. Se tableWhiteList não for especificado, todas as tabelas no banco de dados correspondente serão migradas.
	string	A tabela a ser migrada. Este parâmetro entra em vigor quando type é definido como Database.	["student", "scores"]
partitionFilters	object	As expressões de filtro de partição. Especifica a expressão de filtro de partição para uma determinada tabela.
	string	A expressão de filtro de partição. Exemplo: p1 >= '2022-03-04' and (p2 = 10 or p3 > 20) and p4 in ('abc', 'cde'). Descrição:\n\np1, p2 e p3 são nomes de partições.\n\nOs valores de partição podem ser apenas strings ou números. As strings devem ser colocadas entre aspas duplas ou simples.\n\nExceto para colunas de partição dos tipos INT e BIGINT, os valores de partição de outros tipos podem ser apenas strings.\n\nOs operadores de comparação incluem: >, >=, =, <, <= e <>.\n\nA expressão de filtro de partição oferece suporte ao operador IN.\n\nOs operadores lógicos incluem: AND e OR.\n\nHá suporte para parênteses.	{ "student": "p1 >= '2022-03-04' and (p2 = 10 or p3 > 20) and p4 in ('abc', 'cde')" }
schemaOnly	boolean	Descontinuado.	false
tableMapping	object	O mapeamento de nomes de tabelas de origem para nomes de tabelas de destino.
	string	O mapeamento de nomes de tabelas de origem para nomes de tabelas de destino.	{'a': 'a1'}
increment	boolean	Especifica se a migração incremental deve ser ativada. Apenas partições novas ou modificadas são migradas. As partições modificadas são migradas novamente.	true
enableVerification	boolean	Especifica se a verificação deve ser ativada. O método de verificação atual executa SELECT COUNT na origem e no destino para comparar a contagem de linhas.	true
tunnelQuota	string	Descontinuado.	Deprecated
columnMapping	object	O mapeamento de nomes de colunas no formato {nome da coluna de origem: nome da coluna de destino}.
	string	O mapeamento de nomes de colunas no formato {nome da coluna de origem: nome da coluna de destino}.	{"c-1": "c_1"}
others	object	As informações de configuração adicionais.	{"spark.executor.mem": "2g"}
eta	string	O tempo esperado de conclusão da migração. Um valor de eta menor indica uma prioridade maior para a tarefa de migração.	2025-05-06

Exemplos

Resposta de sucesso

JSON formato

{
  "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"
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.