Todos os produtos
Search
Central de documentação

DataWorks:GenerateDISyncTaskConfigForCreating

Última atualização: Oct 09, 2026

Gera assincronamente a configuração JSON para uma tarefa de sincronização.

Descrição da operação

Atualmente, o DataWorks suporta a chamada direta da operação CreateDISyncTask para criar apenas tarefas de sincronização offline no Data Integration. Para criar tarefas de sincronização em tempo real e outros tipos de tarefas de sincronização, você deve primeiro chamar as operações GenerateDISyncTaskConfigForCreating e QueryDISyncTaskConfigProcessResult para obter os parâmetros necessários para gerar a configuração de forma assíncrona. Em seguida, passe esses parâmetros como entrada para a operação CreateDISyncTask para criar as tarefas de sincronização em tempo real ou de outros tipos correspondentes. Apenas o método assíncrono é suportado para a criação de tarefas de sincronização em tempo real e outros tipos de tarefas de sincronização no Data Integration.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ProjectId

integer

Sim

O ID do espaço de trabalho do DataWorks. Você pode fazer logon no console do DataWorks e acessar a página Configuração do Espaço de Trabalho para obter o ID do espaço de trabalho.

Este parâmetro especifica o espaço de trabalho do DataWorks para a chamada de API atual.

10000

TaskType

string

Sim

O tipo da tarefa de sincronização do Data Integration criada usando o método assíncrono. Valores válidos:

  • DI_REALTIME: tarefa de sincronização em tempo real

  • DI_SOLUTION: outros tipos de tarefas de sincronização

Apenas o método assíncrono é suportado para gerar tarefas de sincronização em tempo real e outros tipos de tarefas de sincronização no Data Integration.

DI_REALTIME

TaskParam

string

Sim

O script da tarefa de sincronização do Data Integration. Os seguintes tipos de tarefas de sincronização podem ser criados:

  • Sincronizar dados do MySQL para o MaxCompute.

  • Sincronizar dados do MySQL para o Kafka.

  • Sincronizar dados do MySQL para o Hologres.

SelectedTables é usado para selecionar tabelas de sincronização no modo de múltiplos bancos de dados, e Tables é usado para selecionar tabelas de sincronização no modo de banco de dados único.

  • Se o script contiver a instrução SelectedTables, o sistema usará as informações da tabela na instrução SelectedTables para a sincronização.

  • Se o script contiver a instrução Tables, o sistema usará as informações de campo de Tables para a sincronização.

O exemplo a seguir mostra o script para sincronizar dados do MySQL para o MaxCompute:

{
  "type": "realtime",
  "version": "1.0",
  "setting": {
    "resourceGroup": "S_res_group_280749521950784_1623033752022",
    "taskType": "oneclick_to_odps"
  },
  "steps": [
    {
      "stepType": "mysql",
      "parameter": {
        "connection": [
          {
            "datasourceType": "mysql",
            "datasource": "mysql_pub1",
            "selectedTables": [
              {
                "dbName": "mysql_db",
                "schema": [
                  {
                    "tableInfos": [
                      {
                        "table": "molin_di_test_in_pk_v4"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      },
      "name": "Reader",
      "category": "reader"
    },
    {
      "stepType": "odps",
      "parameter": {
        "datasource": "odps_source"
      },
      "name": "Writer",
      "category": "writer"
    }
  ]
}

O exemplo a seguir mostra o script para sincronizar dados do MySQL para o Kafka:

{
  "type": "realtime",
  "version": "1.0",
  "setting": {
    "resourceGroup": "S_res_group_280749521950784_1623033752022",
    "taskType": "oneclick_to_kafka"
  },
  "steps": [
    {
      "stepType": "mysql",
      "parameter": {
        "connection": [
          {
            "datasourceType": "mysql",
            "datasource": "pkset_test",
            "selectedTables": [
              {
                "dbName": "mysql_db",
                "schema": [
                  {
                    "tableInfos": [
                      {
                        "table": "molin_di_test_in_pk_v4"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      },
      "name": "Reader",
      "category": "reader"
    },
    {
      "stepType": "kafka",
      "parameter": {
        "datasource": "azn_kafka"
      },
      "name": "Writer",
      "category": "writer"
    }
  ]
}

O exemplo a seguir mostra o script para sincronizar dados do MySQL para o Hologres:

{
  "type": "realtime",
  "version": "1.0",
  "setting": {
    "resourceGroup": "S_res_group_280749521950784_1623033752022",
    "taskType": "oneclick_to_holo"
  },
  "steps": [
    {
      "stepType": "mysql",
      "parameter": {
        "connection": [
          {
            "datasourceType": "mysql",
            "datasource": "mysql_pub",
            "selectedTables": [
              {
                "dbName": "mysql_db",
                "schema": [
                  {
                    "tableInfos": [
                      {
                        "table": "molin_di_test_in2_pk_v3"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      },
      "name": "Reader",
      "category": "reader"
    },
    {
      "stepType": "holo",
      "parameter": {
        "datasource": "holo"
      },
      "name": "Writer",
      "category": "writer"
    }
  ]
}

{ "type": "realtime", "version": "1.0", "setting": { "resourceGroup": "S_res_group_280749521950784_1623033752022", "taskType": "oneclick_to_odps" }, "steps": [{ "stepType": "mysql", "parameter": { "connection": [ { "datasourceType": "mysql", "datasource": "mysql_pub1", "selectedTables": [ { "dbName": "mysql_db", "schema": [ { "tableInfos": [ { "table": "molin_di_test_in_pk_v4" }] } ] } ] } ] }, "name": "Reader", "category": "reader" }, { "stepType": "odps", "parameter": { "datasource": "odps_source" }, "name": "Writer", "category": "writer" } ] }

ClientToken

string

Não

O token de idempotência. Este parâmetro evita operações duplicadas causadas por chamadas repetidas.

ABFUOEUOTRTRJKE

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A estrutura da resposta.

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true: A solicitação foi bem-sucedida.

  • false: A solicitação falhou.

true

RequestId

string

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

0bc1411515937635973****

Data

object

O resultado da geração do ID do thread assíncrono.

Status

string

O status da geração do ID do thread assíncrono. Valores válidos:

  • success: O ID do thread assíncrono foi gerado.

  • fail: Falha ao gerar o ID do thread assíncrono. Você pode visualizar a causa da falha e solucionar o problema.

true

ProcessId

integer

O ID do thread assíncrono. Você deve usar este ID para chamar a operação QueryDISyncTaskConfigProcessResult a fim de obter os parâmetros necessários para gerar assincronamente a configuração da tarefa de sincronização do Data Integration e, em seguida, usar os parâmetros para criar a tarefa.

10

Message

string

A descrição da causa da falha ao gerar o ID do thread assíncrono. Se o ID do thread assíncrono for gerado, este parâmetro ficará vazio.

XXX is invalid.

Exemplos

Resposta de sucesso

JSON formato

{
  "Success": true,
  "RequestId": "0bc1411515937635973****",
  "Data": {
    "Status": "true",
    "ProcessId": 10,
    "Message": "XXX is invalid."
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Invalid.DI.Parameter The parameter is invalid. Ocorreu um erro de parâmetro.
400 Invalid.DI.Parameter.File.Existed The file name already exists. O parâmetro é inválido porque o nome do arquivo já existe.
500 InternalError.DI.Parameter A DI internal error occurred. Ocorreu um erro interno de negócio no Data Integration.
403 Forbidden.DI.NoPrivilege No access. Você não tem as permissões de acesso.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.