diff --git a/debezium-core/src/main/java/io/debezium/config/CommonConnectorConfig.java b/debezium-core/src/main/java/io/debezium/config/CommonConnectorConfig.java index 053fdb07c..25d713c4f 100644 --- a/debezium-core/src/main/java/io/debezium/config/CommonConnectorConfig.java +++ b/debezium-core/src/main/java/io/debezium/config/CommonConnectorConfig.java @@ -844,13 +844,13 @@ public static EventConvertingFailureHandlingMode parse(String value) { + "'insert_delete' only open signal is written on signal data collection, the close will delete the relative open signal;"); public static final Field EVENT_CONVERTING_FAILURE_HANDLING_MODE = Field.create("event.converting.failure.handling.mode") - .withDisplayName("Event converting failure handling") + .withDisplayName("Event converting failure handling mode") .withGroup(Field.createGroupEntry(Field.Group.CONNECTOR_ADVANCED, 26)) .withEnum(EventConvertingFailureHandlingMode.class, EventConvertingFailureHandlingMode.WARN) - .withWidth(Width.SHORT) + .withWidth(Width.MEDIUM) .withImportance(Importance.MEDIUM) .withDescription("Specify how failures during converting of event should be handled, including: " - + "'fail' throw an exception that the column of event conversion is failed with unmatched schema type, causing the connector to be stopped. it needs schema recovery to covert successfully; " + + "'fail' throw an exception that the column of event conversion is failed with unmatched schema type, causing the connector to be stopped. it could need schema recovery to covert successfully; " + "'warn' (the default) the value of column of event that conversion failed will be null and be logged with warn level; " + "'skip' the value of column of event that conversion failed will be null and be logged with debug level."); diff --git a/documentation/modules/ROOT/pages/connectors/mysql.adoc b/documentation/modules/ROOT/pages/connectors/mysql.adoc index 4fe30dcd2..ae90a7fd1 100644 --- a/documentation/modules/ROOT/pages/connectors/mysql.adoc +++ b/documentation/modules/ROOT/pages/connectors/mysql.adoc @@ -3490,6 +3490,16 @@ Specify one of the following options: |`-1` |The maximum number of retries on retriable errors (e.g. connection errors) before failing (-1 = no limit, 0 = disabled, > 0 = num of retries). +|[[mysql-property-event-converting-failure-handling-mode]]<> +|`warn` +|Specifies how the connector should react to exceptions during converting of a column of a row by converter using debezium internal schema. + + + +`fail` throw an exception that the column of event conversion is failed with unmatched schema type, causing the connector to be stopped. it could need schema recovery to covert successfully. + + + +`warn` the value of column of event that conversion failed will be null and be logged with warn level. + + + +`skip` the value of column of event that conversion failed will be null and be logged with debug level. + |=== [id="debezium-mysql-connector-database-history-configuration-properties"]