Consulta as informações sobre uma tarefa de sincronização de nova versão criada no Data Integration. Os seguintes tipos de tarefas de sincronização são suportados: sincronização em tempo real de todos os dados em um banco de dados MySQL para o Hologres.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
dataworks:* |
get |
*全部资源
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| DIJobId |
integer |
Sim |
O ID da tarefa de sincronização. |
11588 |
| WithDetails |
boolean |
Não |
Especifica se devem ser retornadas informações detalhadas de configuração, incluindo TransformationRules, TableMappings e JobSettings. Valores válidos: true e false. Valor padrão: true. |
true |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
O resultado retornado. |
||
| Data |
object |
As informações sobre a tarefa de sincronização. |
|
| ProjectId |
integer |
O ID do workspace. |
22 |
| DIJobId |
integer |
O ID da tarefa de sincronização. |
11588 |
| JobName |
string |
O nome da tarefa de sincronização. |
mysql_to_holo_sync_445 |
| Description |
string |
A descrição da tarefa de sincronização. |
Synchronize mysql to hologres |
| MigrationType |
string |
O tipo de sincronização. Valores válidos:
|
FullAndRealtimeIncremental |
| SourceDataSourceType |
string |
O tipo de origem. O valor MySQL é retornado. |
MySQL |
| DestinationDataSourceType |
string |
O tipo de destino. Valores válidos: Hologres e Hive. |
Hologres |
| SourceDataSourceSettings |
array<object> |
As configurações da origem. Apenas uma única origem é suportada. |
|
|
array<object> |
As configurações da fonte de dados de origem. |
||
| DataSourceName |
string |
O nome da fonte de dados. |
mysql_datasource_1 |
| DataSourceProperties |
object |
As propriedades da fonte de dados. |
|
|
string |
As propriedades da origem. As propriedades de uma fonte de dados MySQL incluem TimeZone e Encoding. |
TimeZone |
|
| DestinationDataSourceSettings |
array<object> |
As configurações do destino. Apenas um único destino é suportado. |
|
|
array<object> |
As configurações da fonte de dados de destino. |
||
| DataSourceName |
string |
O nome da fonte de dados. |
holo_datasource_1 |
| DataSourceProperties |
object |
As propriedades da fonte de dados. |
|
|
string |
As propriedades do destino. Nenhuma propriedade é retornada porque o DataWorks não permite configurar propriedades para uma fonte de dados Hologres. |
TimeZone |
|
| ResourceSettings |
object |
As configurações de recursos. |
|
| OfflineResourceSettings |
object |
O recurso usado para sincronização em lote. |
|
| ResourceGroupIdentifier |
string |
O identificador do grupo de recursos do Data Integration usado para sincronização em lote. |
S_res_group_111_222 |
| RealtimeResourceSettings |
object |
O recurso usado para sincronização em tempo real. |
|
| ResourceGroupIdentifier |
string |
O identificador do grupo de recursos do Data Integration usado para sincronização em tempo real. |
S_res_group_111_222 |
| RequestedCu |
number |
O número de unidades de computação (CUs) no grupo de recursos que são usadas para sincronização incremental e completa. |
2.0 |
| TransformationRules |
array<object> |
A lista de regras de transformação que são aplicadas aos objetos de sincronização selecionados da origem. Cada entrada na lista define uma regra de transformação. |
|
|
object |
A regra de transformação que é aplicada aos objetos de sincronização selecionados da origem. |
||
| RuleActionType |
string |
O tipo de ação. Valores válidos:
|
Rename |
| RuleExpression |
string |
A expressão da regra. A expressão é uma string JSON.
|
{"expression":"${srcDatasoureName}_${srcDatabaseName}"} |
| RuleName |
string |
O nome da regra. Se os valores do parâmetro RuleActionType e do parâmetro RuleTargetType forem os mesmos para várias regras de transformação, você deve garantir que os nomes das regras de transformação sejam exclusivos. |
rename_rule_1 |
| RuleTargetType |
string |
O tipo do objeto no qual a ação é executada. Valores válidos:
|
Table |
| TableMappings |
array<object> |
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> |
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> |
A lista de regras usadas para selecionar objetos de sincronização na origem. |
|
|
object |
A regra usada para selecionar objetos de sincronização na origem. Os objetos podem ser bancos de dados ou tabelas. |
||
| Expression |
string |
A expressão. |
mysql_table_1 |
| ObjectType |
string |
O tipo de objeto. Valores válidos:
|
Table |
| TransformationRules |
array<object> |
A lista de regras de transformação que são aplicadas aos objetos de sincronização selecionados da origem. |
|
|
object |
A regra de transformação que é aplicada aos objetos de sincronização selecionados da origem. |
||
| RuleActionType |
string |
O tipo de ação. Valores válidos:
|
Rename |
| RuleName |
string |
O nome da regra. Se os valores do parâmetro RuleActionType e do parâmetro RuleTargetType forem os mesmos para várias regras de transformação, você deve garantir que os nomes das regras de transformação sejam exclusivos. |
rename_rule_1 |
| RuleTargetType |
string |
O tipo do objeto no qual a ação é executada. Valores válidos:
|
Table |
| JobSettings |
object |
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 tipos de dados entre campos de origem e campos de destino, e parâmetros de tempo de execução da tarefa de sincronização. |
|
| ColumnDataTypeSettings |
array<object> |
As configurações para mapeamentos de tipos de dados entre campos de origem e campos de destino. O valor deste parâmetro é um array. |
|
|
object |
O mapeamento de tipo de coluna. |
||
| SourceDataType |
string |
O tipo de dados de um campo de origem. |
bigint |
| DestinationDataType |
string |
O tipo de dados de um campo de destino. |
text |
| DdlHandlingSettings |
array<object> |
As configurações para processamento de mensagens DDL. O valor deste parâmetro é um array. |
|
|
object |
A configuração de processamento para um tipo específico de mensagem DDL. |
||
| Action |
string |
A política de processamento. Valores válidos:
|
Critical |
| Type |
string |
O tipo da operação DDL. Valores válidos:
|
AddColumn |
| RuntimeSettings |
array<object> |
As configurações de tempo de execução. O valor deste parâmetro é um array. |
|
|
object |
A configuração de tempo de execução. |
||
| Name |
string |
O nome do item de configuração. Valores válidos:
|
runtime.offline.concurrent |
| Value |
string |
O valor do item de configuração. |
1 |
| CycleScheduleSettings |
object |
As configurações para agendamento periódico. |
|
| CycleMigrationType |
string |
O tipo de sincronização que requer agendamento periódico. Valores válidos:
|
Full |
| ScheduleParameters |
string |
Os parâmetros de agendamento. |
bizdate=$bizdate |
| ChannelSettings |
string |
As configurações de controle de canal para a tarefa de sincronização. O valor deste parâmetro é uma string JSON. |
{"structInfo":"MANAGED","storageType":"TEXTFILE","writeMode":"APPEND","partitionColumns":[{"columnName":"pt","columnType":"STRING","comment":""}],"fieldDelimiter":""} |
| CreatedTime |
integer |
O carimbo de data/hora de quando a tarefa de sincronização foi criada. Unidade: segundos. |
1671516776 |
| CreatedUid |
string |
O ID do usuário que cria a tarefa de sincronização. |
100000001 |
| UpdatedTime |
integer |
O carimbo de data/hora de quando a tarefa de sincronização foi modificada pela última vez. Unidade: segundos. |
1673859985 |
| UpdatedUid |
string |
O ID do usuário que modificou a tarefa de sincronização pela última vez. |
100000001 |
| StartedTime |
integer |
O carimbo de data/hora de quando a tarefa de sincronização foi iniciada pela última vez. Unidade: segundos. |
1673859999 |
| StartedUid |
string |
O ID do usuário que iniciou a tarefa de sincronização pela última vez. |
100000001 |
| JobStatus |
string |
O status da tarefa de sincronização. Valores válidos:
|
Finished |
| ErrorMessage |
string |
A mensagem de erro retornada se o valor do parâmetro JobStatus for Failed. |
error details xxx |
| RunStats |
object |
As informações sobre a execução da tarefa de sincronização. |
|
|
string |
As estatísticas detalhadas sobre a execução da tarefa de sincronização.
|
StructureMigrationTotalTables |
|
| RequestId |
string |
O ID da solicitação. |
0000-ABCD-EFG**** |
Exemplos
Resposta de sucesso
JSON formato
{
"Data": {
"ProjectId": 22,
"DIJobId": 11588,
"JobName": "mysql_to_holo_sync_445",
"Description": "Synchronize mysql to hologres\n",
"MigrationType": "FullAndRealtimeIncremental",
"SourceDataSourceType": "MySQL",
"DestinationDataSourceType": "Hologres",
"SourceDataSourceSettings": [
{
"DataSourceName": "mysql_datasource_1",
"DataSourceProperties": {
"key": "TimeZone"
}
}
],
"DestinationDataSourceSettings": [
{
"DataSourceName": "holo_datasource_1",
"DataSourceProperties": {
"key": "TimeZone"
}
}
],
"ResourceSettings": {
"OfflineResourceSettings": {
"ResourceGroupIdentifier": "S_res_group_111_222"
},
"RealtimeResourceSettings": {
"ResourceGroupIdentifier": "S_res_group_111_222"
},
"RequestedCu": 2
},
"TransformationRules": [
{
"RuleActionType": "Rename",
"RuleExpression": "{\"expression\":\"${srcDatasoureName}_${srcDatabaseName}\"}",
"RuleName": "rename_rule_1",
"RuleTargetType": "Table"
}
],
"TableMappings": [
{
"SourceObjectSelectionRules": [
{
"Expression": "mysql_table_1",
"ObjectType": "Table"
}
],
"TransformationRules": [
{
"RuleActionType": "Rename",
"RuleName": "rename_rule_1",
"RuleTargetType": "Table"
}
]
}
],
"JobSettings": {
"ColumnDataTypeSettings": [
{
"SourceDataType": "bigint",
"DestinationDataType": "text"
}
],
"DdlHandlingSettings": [
{
"Action": "Critical",
"Type": "AddColumn"
}
],
"RuntimeSettings": [
{
"Name": "runtime.offline.concurrent",
"Value": "1"
}
],
"CycleScheduleSettings": {
"CycleMigrationType": "Full",
"ScheduleParameters": "bizdate=$bizdate"
},
"ChannelSettings": "{\"structInfo\":\"MANAGED\",\"storageType\":\"TEXTFILE\",\"writeMode\":\"APPEND\",\"partitionColumns\":[{\"columnName\":\"pt\",\"columnType\":\"STRING\",\"comment\":\"\"}],\"fieldDelimiter\":\"\"}\n"
},
"CreatedTime": 1671516776,
"CreatedUid": "100000001",
"UpdatedTime": 1673859985,
"UpdatedUid": "100000001",
"StartedTime": 1673859999,
"StartedUid": "100000001",
"JobStatus": "Finished",
"ErrorMessage": "error details xxx",
"RunStats": {
"key": "StructureMigrationTotalTables"
}
},
"RequestId": "0000-ABCD-EFG****"
}
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.