Skip to main content

Query Configuration

Interface Overview

Query the kv configuration list according to the task id

Interface Address

/cloudcanal/console/api/v1/openapi/datajob/listkvconfigsbyjobid

Request Manner

POST

Request Parameters

ParameterNameParameter DescriptionRequestTypeWhether RequiredDataType
dataJobIdTask IDBodyTrueLong

Public Response Results

ParameterNameParameter DescriptionType(Java)NotNull
code1:Success, 0:FailureStringTrue
dataResponse dataObjectFalse
msgError message (if any)StringFalse
requestIdRequest IDStringTrue

Data Parameter Description

data is an array where each item is information for a kv configuration item. The field parameters are as follows. Note that:

ParameterNameParameter DescriptionNotNullType(Java)
dataJobIdDataJob IDTrueLong
configNameConfiguration nameTrueString
configValueCurrent configuration valueFalseString
defaultValueSystem default valueFalseString
valueRangeSystem recommended valueFalseString
descriptionParameter descriptionTrueString
taskTypeTask type to which the parameter applies

BUILD_STRUCT (Schema Migration)
FULL (Full Data)
INCREMENT (Incremental Sync)
CHECK (Verification)
REVISE (Correction)
FalseString
endPointTypeEndpoint type to which the parameter applies

SOURCE (Source)
TARGET (Target)
INDEPENDENT (Global)
TrueString
dynamicWhether the parameter can be changed dynamically (without restarting the task); currently false for all parametersTrueBoolean
readOnlyWhether the parameter is read-onlyTrueBoolean
configTypeEntity type to which the configuration belongs

SERVER_CORE (Task)
DATASOURCE (Data Source)
MAPPING (Metadata Mapping)
TrueString
configTagTypeConfiguration type

NORMAL (General)
PERFORMANCE (Performance)
TrueString
isSecretWhether the configuration is a secret; if true, then the configValue is emptyTrueBoolean
needCreateWhether the configuration has not appeared in this task (new version configuration), and needs to be inserted as a new configuration when submitting a configuration updateTrueBoolean

Response Example

{
"requestId": "50bcb593-6673-11ed-b716-e934b5005e9f",
"taskId": 0,
"workerIdentity": null,
"sendBackToTask": false,
"code": "1",
"msg": "request success",
"data": [
{
"dataJobId": 956,
"configName": "dataTaskDsType",
"configValue": "MYSQL_TUNNEL",
"defaultValue": "",
"valueRange": "",
"description": "Combination of task source and target data source types",
"taskType": null,
"endPointType": "INDEPENDENT",
"dynamic": false,
"readOnly": true,
"configType": "SERVER_CORE",
"configTagType": "NORMAL",
"needCreate": false,
"secret": false
},
{
"dataJobId": 956,
"configName": "specId",
"configValue": "16",
"defaultValue": "",
"valueRange": "15/16/17/18/19/20/21/22/23/24/25/26. 15=1GB mem,16=2GB mem,17=3GB mem,18=4GB mem,19=512MB mem,20=5GB mem,21=6GB mem,22=7GB mem,23=8GB mem,24=12GB mem,25=16GB mem,26=20GB mem.",
"description": "Task specification ID. The value must be the recommended value",
"taskType": null,
"endPointType": "INDEPENDENT",
"dynamic": false,
"readOnly": false,
"configType": "SERVER_CORE",
"configTagType": "NORMAL",
"needCreate": false,
"secret": false
},
{
"dataJobId": 956,
"configName": "exceptionSkipMode",
"configValue": "NONE",
"defaultValue": "NONE",
"valueRange": "NONE / ApplierHandlerException / ALL",
"description": "Task Exception ignore mode, NONE: exceptions are not ignored. Applier Handler Exception: write exceptions are ignored on the peer end",
"taskType": null,
"endPointType": "INDEPENDENT",
"dynamic": false,
"readOnly": false,
"configType": "SERVER_CORE",
"configTagType": "NORMAL",
"needCreate": false,
"secret": false
},
{
"dataJobId": 956,
"configName": "ddlExceptionSkip",
"configValue": "false",
"defaultValue": "false",
"valueRange": "true / false",
"description": "Whether to ignore the DDL execution exception on the peer end: true: ignore the DDL execution exception, false: not ignore the DDL execution exception ",
"taskType": null,
"endPointType": "INDEPENDENT",
"dynamic": false,
"readOnly": false,
"configType": "SERVER_CORE",
"configTagType": "NORMAL",
"needCreate": false,
"secret": false
},
{
"dataJobId": 956,
"configName": "fullRingBufferSize",
"configValue": "64",
"defaultValue": "16",
"valueRange": "16-256",
"description": "Full task internal queue size",
"taskType": null,
"endPointType": "INDEPENDENT",
"dynamic": false,
"readOnly": false,
"configType": "SERVER_CORE",
"configTagType": "PERFORMANCE",
"needCreate": false,
"secret": false
},
{
"dataJobId": 956,
"configName": "mappingDef",
"configValue": "[{\"method\":\"DB_SCHEMA\",\"serializeMapping\":{\"{\\\"value\\\":\\\"dingtax\\\"}\":\"{\\\"parent\\\":{\\\"value\\\":\\\"cc_virtual_db\\\"},\\\"value\\\":\\\"cc_virtual_schema\\\"}\"},\"serializeAutoGenRules\":{},\"commonGenRule\":\"MIRROR\"},{\"serializeMapping\":{},\"method\":\"TABLE_TABLE\",\"serializeAutoGenRules\":{},\"commonGenRule\":\"MIRROR\"},{\"method\":\"COLUMN_COLUMN\",\"serializeMapping\":{},\"serializeAutoGenRules\":{},\"commonGenRule\":\"MIRROR\"}]",
"defaultValue": "",
"valueRange": "",
"description": "Table structure mapping information",
"taskType": null,
"endPointType": "INDEPENDENT",
"dynamic": false,
"readOnly": true,
"configType": "MAPPING",
"configTagType": "NORMAL",
"needCreate": false,
"secret": false
},
{
...
}
],
"fail": false,
"success": true,
"rsocketDirectionType": null
}