Todos os produtos
Search
Central de documentação

DataWorks:UpdateDIJob

Última atualização: Sep 29, 2026

Atualiza uma tarefa de sincronização da nova versão. O seguinte tipo de tarefa é compatível: sincronização em tempo real de todos os dados de um banco de dados MySQL para o Hologres.

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

DIJobId

integer

Não

O ID da tarefa de sincronização.

11588

Description

string

Não

A descrição da tarefa de sincronização.

Synchronize MySQL to Hologres

ResourceSettings

object

Não

As configurações de recursos.

OfflineResourceSettings

object

Não

O recurso usado para sincronização em lote.

ResourceGroupIdentifier

string

Não

O identificador do grupo de recursos do Data Integration usado para sincronização em lote.

S_res_group_111_222

RealtimeResourceSettings

object

Não

O recurso usado para sincronização em tempo real.

ResourceGroupIdentifier

string

Não

O identificador do grupo de recursos do Data Integration usado para sincronização em tempo real.

S_res_group_111_222

RequestedCu

number

Não

O número de unidades de computação (CUs) no grupo de recursos que são usadas para sincronização completa e incremental.

2.0

TransformationRules

array<object>

Não

A lista de regras de transformação que você deseja aplicar aos objetos de sincronização selecionados da origem. Cada entrada na lista define uma regra de transformação.

object

Não

A regra de transformação que você deseja aplicar aos objetos de sincronização selecionados da origem.

RuleName

string

Não

O nome da regra. Se os valores do parâmetro RuleActionType e do parâmetro RuleTargetType forem iguais para várias regras de transformação, você deve garantir que os nomes das regras de transformação sejam exclusivos.

rename_rule_1

RuleActionType

string

Não

O tipo da ação. Valores válidos:

  • DefinePrimaryKey: define chaves primárias

  • Rename: renomeia

  • AddColumn: adiciona colunas

  • HandleDml: processa DML

  • DefineIncrementalCondition: define condições incrementais

  • DefineCycleScheduleSettings: define configurações de agendamento periódico

  • DefineRuntimeSettings: define parâmetros de configuração avançados

  • DefinePartitionKey: define colunas de partição

Rename

RuleTargetType

string

Não

O tipo do objeto no qual você deseja executar a ação. Valores válidos:

  • Table: tabela

  • Schema: schema

Table

RuleExpression

string

Não

A expressão da regra. A expressão deve ser uma string JSON.

Exemplo de uma regra de renomeação: {"expression":"${srcDatasourceName}_${srcDatabaseName}_0922","variables":[{"variableName":"srcDatabaseName","variableRules":[{"from":"fromdb","to":"todb"}]}]}.

expression: a expressão da regra de renomeação. A expressão pode conter as seguintes variáveis: ${srcDatasourceName}, ${srcDatabaseName} e ${srcTableName}. ${srcDatasourceName} especifica o nome da origem. ${srcDatabaseName} especifica o nome de um banco de dados de origem. ${srcTableName} especifica o nome de uma tabela de origem. variables: a regra de geração para uma variável usada na expressão da regra de renomeação. O valor padrão da variável especificada é o valor original do objeto indicado pela variável. Você pode definir um grupo de regras de substituição de string para alterar os valores originais com base nos seus requisitos de negócios. variableName: o nome da variável. Não coloque o nome da variável entre ${}. variableRules: as regras de substituição de string para variáveis. O sistema executa as regras de substituição de string em sequência. from especifica a string original. to especifica a nova string. Exemplo de uma regra usada para adicionar um campo específico ao destino e atribuir um valor ao campo: {"columns":[{"columnName":"my_add_column","columnValueType":"Constant","columnValue":"123"}]}.

Se você não configurar essa regra, nenhum campo será adicionado ao destino e nenhum valor será atribuído por padrão. columnName: o nome do campo que você deseja adicionar. columnValueType: o tipo de valor do campo. Valores válidos: Constant e Variable. columnValue: o valor do campo que você deseja adicionar. Se você definir o parâmetro valueType como Constant, defina o parâmetro columnValue como uma constante personalizada do tipo STRING. Se você definir o parâmetro valueType como Variable, defina o columnValue como uma variável integrada. As seguintes variáveis integradas são suportadas: EXECUTE_TIME (tipo de dados LONG), DB_NAME_SRC (tipo de dados STRING), DATASOURCE_NAME_SRC (tipo de dados STRING), TABLE_NAME_SRC (tipo de dados STRING), DB_NAME_DEST (tipo de dados STRING), DATASOURCE_NAME_DEST (tipo de dados STRING), TABLE_NAME_DEST (tipo de dados STRING) e DB_NAME_SRC_TRANSED (tipo de dados STRING). EXECUTE_TIME especifica o tempo de execução. DB_NAME_SRC indica o nome de um banco de dados de origem. DATASOURCE_NAME_SRC especifica o nome da origem. TABLE_NAME_SRC especifica o nome de uma tabela de origem. DB_NAME_DEST especifica o nome de um banco de dados de destino. DATASOURCE_NAME_DEST especifica o nome do destino. TABLE_NAME_DEST especifica o nome de uma tabela de destino. DB_NAME_SRC_TRANSED especifica o nome do banco de dados obtido após uma transformação. Exemplo de uma regra usada para especificar campos de chave primária para uma tabela de destino: {"columns":["ukcolumn1","ukcolumn2"]}.

Se você não configurar essa regra, os campos de chave primária na tabela de origem mapeada serão usados para a tabela de destino por padrão. Se a tabela de destino for uma tabela existente, o Data Integration não modificará o schema da tabela de destino. Se os campos de chave primária especificados não existirem na tabela de destino, um erro será relatado quando a tarefa de sincronização começar a ser executada. Se a tabela de destino for criada automaticamente pelo sistema, o Data Integration criará automaticamente o schema da tabela de destino. O schema contém os campos de chave primária que você especificar. Se os campos de chave primária especificados não existirem na tabela de destino, um erro será relatado quando a tarefa de sincronização começar a ser executada. Exemplo de uma regra usada para processar mensagens DML: {"dmlPolicies":[{"dmlType":"Delete","dmlAction":"Filter","filterCondition":"id > 1"}]}.

Se você não configurar essa regra, a política de processamento padrão para mensagens geradas para operações de inserção, atualização e exclusão será Normal. dmlType: a operação DML. Valores válidos: Insert, Update e Delete. dmlAction: a política de processamento para mensagens DML. Valores válidos: Normal, Ignore, Filter e LogicalDelete. Filter indica processamento condicional. Você pode definir o parâmetro dmlAction como Filter apenas quando o parâmetro dmlType estiver definido como Update ou Delete. filterCondition: a condição usada para filtrar mensagens DML. Este parâmetro é necessário apenas quando o parâmetro dmlAction está definido como Filter.

{"expression":"${srcDatasoureName}_${srcDatabaseName}"}

TableMappings

array<object>

Não

A lista de mapeamentos entre as regras usadas para selecionar objetos de sincronização na origem e as regras de transformação aplicadas aos objetos de sincronização selecionados. Cada entrada descreve uma lista de regras de seleção de objetos de origem e uma lista de regras de transformação aplicadas a esse grupo de objetos.

array<object>

Não

O mapeamento entre uma regra usada para selecionar objetos de sincronização na origem e uma regra de transformação aplicada aos objetos de sincronização selecionados.

SourceObjectSelectionRules

array<object>

Não

A lista de regras que você deseja usar para selecionar objetos de sincronização na origem.

object

Não

A regra que você deseja usar para selecionar objetos de sincronização na origem. Os objetos podem ser bancos de dados ou tabelas.

ObjectType

string

Não

O tipo do objeto. Valores válidos:

  • Table: tabela

  • Database: banco de dados

Table

Expression

string

Não

A expressão.

mysql_table_1

TransformationRules

array<object>

Não

A lista de regras de transformação que você deseja aplicar aos objetos de sincronização selecionados da origem.

object

Não

A regra de transformação que você deseja aplicar aos objetos de sincronização selecionados da origem.

RuleName

string

Não

O nome da regra. Se os valores do parâmetro RuleActionType e do parâmetro RuleTargetType forem iguais para várias regras de transformação, você deve garantir que os nomes das regras de transformação sejam exclusivos.

rename_rule_1

RuleActionType

string

Não

O tipo da ação. Valores válidos:

  • DefinePrimaryKey: define chaves primárias

  • Rename: renomeia

  • AddColumn: adiciona colunas

  • HandleDml: processa DML

  • DefineIncrementalCondition: define condições incrementais

  • DefineCycleScheduleSettings: define configurações de agendamento periódico

  • DefineRuntimeSettings: define parâmetros de configuração avançados

  • DefinePartitionKey: define colunas de partição

Rename

RuleTargetType

string

Não

O tipo do objeto no qual você deseja executar a ação. Valores válidos:

  • Table: tabela

  • Schema: schema

Table

JobSettings

object

Não

As configurações no nível da tarefa de sincronização. As configurações incluem políticas de processamento para mensagens DDL, políticas para mapeamentos de tipo de dados entre campos de origem e campos de destino, e parâmetros de tempo de execução da tarefa de sincronização.

DdlHandlingSettings

array<object>

Não

As configurações para processamento de mensagens DDL. O valor deste parâmetro deve ser uma matriz.

object

Não

A configuração de processamento para um tipo específico de mensagem DDL.

Type

string

Não

O tipo da operação DDL. Valores válidos:

  • RenameColumn: renomeia uma coluna

  • ModifyColumn: atualiza uma coluna

  • CreateTable: cria uma tabela

  • TruncateTable: esvazia uma tabela

  • DropTable: exclui uma tabela

  • DropColumn: exclui uma coluna

  • AddColumn: adiciona uma coluna

AddColumn

Action

string

Não

A política de processamento para mensagens DDL. Valores válidos:

  • Ignore: ignora uma mensagem DDL.

  • Critical: relata um erro para uma mensagem DDL.

  • Normal: processa normalmente uma mensagem DDL.

Critical

ColumnDataTypeSettings

array<object>

Não

As configurações para mapeamentos de tipo de dados entre campos de origem e campos de destino. O valor deste parâmetro deve ser uma matriz.

object

Não

O mapeamento de tipo de dados entre um campo de origem e um campo de destino.

SourceDataType

string

Não

O tipo de dados de um campo de origem.

bigint

DestinationDataType

string

Não

O tipo de dados de um campo de destino.

text

RuntimeSettings

array<object>

Não

As configurações de tempo de execução. O valor deste parâmetro deve ser uma matriz.

object

Não

As configurações de tempo de execução.

Name

string

Não

O nome do item de configuração. Valores válidos:

  • runtime.offline.speed.limit.mb: especifica a taxa máxima de transmissão permitida para uma tarefa de sincronização em lote. Este item de configuração entra em vigor apenas quando runtime.offline.speed.limit.enable está definido como true.

  • runtime.offline.speed.limit.enable: especifica se o limitador de taxa está ativado para uma tarefa de sincronização em lote.

  • dst.offline.connection.max: especifica o número máximo de conexões permitidas para gravar dados no destino de uma tarefa de sincronização em lote.

  • runtime.offline.concurrent: especifica o número máximo de threads paralelas permitidas para uma tarefa de sincronização em lote.

  • dst.realtime.connection.max: especifica o número máximo de conexões permitidas para gravar dados no destino de uma tarefa de sincronização em tempo real.

  • runtime.enable.auto.create.schema: especifica se os schemas são criados automaticamente no destino de uma tarefa de sincronização.

  • src.offline.datasource.max.connection: especifica o número máximo de conexões permitidas para ler dados da origem de uma tarefa de sincronização em lote.

  • runtime.realtime.concurrent: especifica o número máximo de threads paralelas permitidas para uma tarefa de sincronização em tempo real.

runtime.offline.concurrent

Value

string

Não

O valor do item de configuração.

1

CycleScheduleSettings

object

Não

As configurações para agendamento periódico.

ScheduleParameters

string

Não

Os parâmetros de agendamento.

bizdate=$bizdate

ChannelSettings

string

Não

As configurações de controle de canal para a tarefa de sincronização. O valor deste parâmetro deve ser uma string JSON.

{"structInfo":"MANAGED","storageType":"TEXTFILE","writeMode":"APPEND","partitionColumns":[{"columnName":"pt","columnType":"STRING","comment":""}],"fieldDelimiter":""}

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O resultado retornado.

RequestId

string

O ID da solicitação.

AAC30B35-820D-5F3E-A42C-E96BB6379325

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "AAC30B35-820D-5F3E-A42C-E96BB6379325"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.