Todos os produtos
Search
Central de documentação

DataWorks:CreateImportMigration

Última atualização: Oct 09, 2026

Cria uma tarefa de importação para importar um pacote de importação e exportação do DataWorks que contém objetos como fontes de dados, tarefas e tabelas.

Descrição da operação

Nota: Esta operação envolve uploads de arquivos. O exemplo a seguir mostra como chamar esta operação:

    Config config = new Config();
    config.setAccessKeyId(accessId);
    config.setAccessKeySecret(accessKey);
    config.setEndpoint(popEndpoint);
    config.setRegionId(regionId);
    
    Client client = new Client(config);

    CreateImportMigrationAdvanceRequest request = new CreateImportMigrationAdvanceRequest();
    request.setName("test_migration_api_" + System.currentTimeMillis());
    request.setProjectId(123456L); 
    request.setPackageType("DATAWORKS_MODEL");
    request.setPackageFileObject(new FileInputStream("/home/admin/Downloads/test.zip"));

    RuntimeOptions runtime = new RuntimeOptions();
    CreateImportMigrationResponse response = client.createImportMigrationAdvance(request, runtime);
    ...

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

dataworks:*

update

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ProjectId

integer

Sim

O ID do workspace do DataWorks. Você pode fazer login no console do DataWorks e acessar a página Configuração do Workspace para obter o ID do workspace.

123456

Name

string

Sim

O nome da tarefa de importação a ser criada. O nome deve ser exclusivo no workspace.

test_import_001

PackageType

string

Sim

O tipo do pacote de importação e exportação. Valores válidos:

  • DATAWORKS_MODEL: formato padrão

  • DATAWORKS_V2: Apsara Stack (V3.6.1 a V3.11)

  • DATAWORKS_V3: Apsara Stack (V3.12 e posterior)

DATAWORKS_MODEL

PackageFile

string

Sim

O caminho do arquivo do pacote de importação. Nota: Esta operação envolve uploads de arquivos. O exemplo a seguir mostra como chamar esta operação:

        Config config = new Config();
        config.setAccessKeyId(accessId);
        config.setAccessKeySecret(accessKey);
        config.setEndpoint(popEndpoint);
        config.setRegionId(regionId);

        Client client = new Client(config);

        CreateImportMigrationAdvanceRequest request = new CreateImportMigrationAdvanceRequest();
        request.setName("test_migration_api_" + System.currentTimeMillis());
        request.setProjectId(123456L); 
        request.setPackageType("DATAWORKS_MODEL");
        request.setPackageFileObject(new FileInputStream("/home/admin/Downloads/test.zip"));

        RuntimeOptions runtime = new RuntimeOptions();
        CreateImportMigrationResponse response = client.createImportMigrationAdvance(request, runtime);

Se você passar diretamente o caminho do arquivo, o valor do parâmetro deve ser uma URL válida de um objeto do OSS na conta do chamador, como https://{bucket}.oss-{region}.aliyuncs.com/{object_key}. URLs do OSS entre contas são rejeitadas. Se você usar o método Advance do SDK, poderá fazer o upload do arquivo usando um fluxo de arquivo local.

/home/admin/xxx/import.zip

ResourceGroupMap

string

Não

O mapeamento entre grupos de recursos de agendamento e grupos de recursos de integração de dados. Tanto as chaves quanto os valores no mapeamento são identificadores de grupos de recursos. O formato é o seguinte:

{
    "SCHEDULER_RESOURCE_GROUP": {
        "xxx": "yyy"
    },
    "DI_RESOURCE_GROUP": {
        "ccc": "dfdd"
    }
}

{"SCHEDULER_RESOURCE_GROUP": {"xxx":"yyy"},"DI_RESOURCE_GROUP":{"ccc":"ddd"}}

WorkspaceMap

string

Não

O mapeamento usado para alterar os nomes dos workspaces de entrada e saída no pacote de importação e exportação para os nomes dos workspaces mapeados durante as operações de importação e exportação. Por exemplo, durante uma importação, os prefixos dos nomes dos workspaces de entrada e saída são substituídos com base no mapeamento.

{"test_workspace_src": "test_workspace_target"}

CalculateEngineMap

string

Não

O mapeamento entre os mecanismos de computação de origem e as instâncias do mecanismo de computação de destino na tarefa de importação. Os tipos de mecanismo de computação incluem ODPS, EMR, HADOOP_CDH e HOLOGRES.

{ "ODPS": { "zxy_8221431_engine": "wzp_kaifazheban_engine" }, "EMR": { "aaaa": "bbb" } }

CommitRule

string

Não

As regras para envio e publicação automáticos de tarefas durante a operação de importação. Os parâmetros são os seguintes:

  • resourceAutoCommit: Especifica se os recursos devem ser enviados automaticamente. true: sim. false: não.

  • resourceAutoDeploy: Especifica se os recursos devem ser publicados automaticamente. true: sim. false: não.

  • functionAutoCommit: Especifica se as funções devem ser enviadas automaticamente. true: sim. false: não.

  • functionAutoDeploy: Especifica se as funções devem ser publicadas automaticamente. true: sim. false: não.

  • tableAutoCommitToDev: Especifica se as tabelas devem ser enviadas automaticamente para o ambiente de desenvolvimento. true: sim. false: não.

  • tableAutoCommitToProd: Especifica se as tabelas devem ser enviadas automaticamente para o ambiente de produção. true: sim. false: não.

  • ignoreLock: Especifica se os bloqueios devem ser ignorados automaticamente. true: sim. false: não. Se uma tarefa estiver bloqueada por outro usuário para edição, você poderá forçar a atualização da tarefa atual escolhendo ignorar o bloqueio.

  • fileAutoCommit: Especifica se os arquivos devem ser enviados automaticamente. true: sim. false: não.

  • fileAutoDeploy: Especifica se os arquivos devem ser publicados automaticamente. true: sim. false: não.

{ "resourceAutoCommit": false, "resourceAutoDeploy": false, "functionAutoCommit": false, "functionAutoDeploy": false, "tableAutoCommitToDev": false, "tableAutoCommitToProd": false, "ignoreLock": false, "fileAutoCommit": false, "fileAutoDeploy": false }

Description

string

Não

A descrição do pacote de importação e exportação.

test description

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados da resposta.

HttpStatusCode

integer

O código de status HTTP.

200

Data

integer

O ID do pacote de importação e exportação. Você pode usar este ID como parâmetro de entrada para executar a tarefa de importação ou consultar o progresso de execução da tarefa de importação.

123456

ErrorMessage

string

A mensagem de erro.

test error message

RequestId

string

O ID da solicitação. Você pode usar o ID para localizar logs e solucionar problemas.

ADFASDFASDFA-ADFASDF-ASDFADSDF-AFFADS

ErrorCode

string

O código de erro.

110001123456

Success

boolean

Indica se a chamada foi bem-sucedida.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "Data": 123456,
  "ErrorMessage": "test error message",
  "RequestId": "ADFASDFASDFA-ADFASDF-ASDFADSDF-AFFADS",
  "ErrorCode": "110001123456",
  "Success": true
}

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.