DBZ-7143 Add document for event.converting.failure.handling.mode

This commit is contained in:
nicholas-fwang 2023-12-01 14:34:32 +09:00 committed by Jiri Pechanec
parent a36caea1de
commit 2bdeec099a
2 changed files with 13 additions and 3 deletions

View File

@ -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.");

View File

@ -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]]<<mysql-property-event-converting-failure-handling-mode, `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"]