GenerateDISyncTaskConfigForUpdating - : Central de Documentação do Alibaba Cloud

Gera um ID para um thread assíncrono usado na atualização de um nó de sincronização em tempo real ou de uma solução de sincronização no Data Integration. Esse ID é necessário ao chamar a operação QueryDISyncTaskConfigProcessResult para obter os parâmetros gerados assincronamente e atualizar o nó ou a solução no Data Integration.

O DataWorks permite usar apenas a operação UpdateDISyncTask para atualizar um nó de sincronização em lote no Data Integration. Para atualizar um nó de sincronização em tempo real ou uma solução de sincronização, chame primeiro a operação GenerateDISyncTaskConfigForUpdating para gerar o ID de um thread assíncrono. Em seguida, chame a operação QueryDISyncTaskConfigProcessResult para obter os parâmetros gerados assincronamente com base nesse ID. Por fim, chame a operação UpdateDISyncTask e utilize esses parâmetros na solicitação para atualizar o nó de sincronização em tempo real ou a solução de sincronização no Data Integration. O DataWorks suporta a atualização de nós de sincronização em tempo real e soluções de sincronização no Data Integration exclusivamente no modo assíncrono.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GenerateDISyncTaskConfigForUpdating	A operação a ser executada.
ProjectId	Long	Sim	10000	ID do workspace do DataWorks. Faça login no console do DataWorks e acesse a página Workspace Management para obter esse ID. Este parâmetro especifica o workspace do DataWorks ao qual a operação se aplica.
TaskType	String	Sim	DI_REALTIME	Tipo de objeto a ser atualizado no Data Integration no modo assíncrono. Valores válidos: DI_REALTIME: nó de sincronização em tempo real DI_SOLUTION: solução de sincronização O DataWorks permite atualizar nós de sincronização em tempo real e soluções de sincronização no Data Integration apenas no modo assíncrono.
RegionId	String	Sim	cn-zhangjiakou	ID da região. Por exemplo, o ID da região China (Shanghai) é cn-shanghai, e o da região China (Zhangjiakou) é cn-zhangjiakou. O sistema determina o valor deste parâmetro com base no endpoint usado para chamar a operação.
TaskParam	String	Sim	{ "steps": [ { "parameter": { "connection": [ { "table": [ "xyx" ] } ] }, "name": "Reader", "category": "reader" } ] }	Script para atualizar o nó de sincronização em tempo real ou a solução de sincronização no Data Integration. O DataWorks permite adicionar ou remover tabelas de um nó de sincronização em tempo real ou de uma solução de sincronização no Data Integration apenas no modo assíncrono. Os seguintes tipos são suportados: Nó ou solução de sincronização em tempo real do MySQL para o MaxCompute Nó ou solução de sincronização em tempo real do MySQL para o Kafka Nó ou solução de sincronização em tempo real do MySQL para o Hologres Use o parâmetro SelectedTables para especificar tabelas a serem sincronizadas de vários bancos de dados. Use o parâmetro Tables para especificar tabelas a serem sincronizadas de um único banco de dados. Se o script contiver o parâmetro SelectedTables, o sistema sincronizará as tabelas especificadas nesse parâmetro. Se o script contiver o parâmetro Tables, o sistema sincronizará as tabelas especificadas nesse parâmetro.
ClientToken	String	Não	ABFUOEUOTRTRJKE	Token do cliente usado para garantir a idempotência da solicitação. Este parâmetro evita operações repetidas causadas por múltiplas chamadas.
TaskId	Long	Sim	100	ID do nó de sincronização em tempo real ou da solução de sincronização. Se definir TaskType como DI_REALTIME, defina TaskId com o valor do parâmetro FileId do nó de sincronização em tempo real. Se definir TaskType como DI_SOLUTION, defina TaskId com o valor do parâmetro FileId da solução de sincronização.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Success	Boolean	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.
RequestId	String	0bc1411515937635973****	ID da solicitação. Use este ID para localizar logs e solucionar problemas.
Data	Object		Informações retornadas sobre o ID do thread assíncrono.
Status	String	true	Indica se o ID do thread assíncrono foi gerado. Valores válidos: success: indica que o ID do thread assíncrono foi gerado. fail: indica falha na geração do ID do thread assíncrono. Verifique o motivo da falha para solucionar o problema.
ProcessId	Long	10	ID do thread assíncrono. Chame a operação QueryDISyncTaskConfigProcessResult para obter os parâmetros gerados assincronamente com base neste ID. Esses parâmetros servem para atualizar um nó de sincronização em tempo real ou uma solução de sincronização no Data Integration.
Message	String	XXX is invalid.	Motivo da falha na geração do ID do thread assíncrono. Se o ID for gerado com sucesso, o valor null será retornado.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=GenerateDISyncTaskConfigForUpdating
&ProjectId=10000
&TaskType=DI_REALTIME
&TaskParam={"steps":[{"parameter":{"connection":[{"table":["xyx"]}]},"name":"Reader","category":"reader"}]}
&ClientToken=ABFUOEUOTRTRJKE
&TaskId=100
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<GenerateDISyncTaskConfigForUpdatingResponse>
    <Success>true</Success>
    <RequestId>0bc1411515937635973****</RequestId>
    <Data>
        <Status>true</Status>
        <ProcessId>10</ProcessId>
        <Message>XXX is invalid.</Message>
    </Data>
</GenerateDISyncTaskConfigForUpdatingResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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.	Um ou mais parâmetros são inválidos.
400	Invalid.DI.Parameter.File.Existed	The file name already exists.	O nome de arquivo especificado já existe.
403	Forbidden.DI.NoPrivilege	No access.	Permissões insuficientes para realizar a operação.
500	InternalError.DI.Parameter	A DI internal error occurred.	Ocorreu um erro interno no Data Integration.

Para obter uma lista de códigos de erro, visite o API Error Center.