diff --git a/documentation/faq.asciidoc b/documentation/faq.asciidoc index 2319bec7768..9fe87ffac94 100644 --- a/documentation/faq.asciidoc +++ b/documentation/faq.asciidoc @@ -384,4 +384,32 @@ This may be the case when Debezium (or rather the MongoDB change stream cursor) Note that depending on the used `capture.mode` this issue can still manifest even when the actual value of the *stored* documents is significantly lower. To mitigate this issue, refer to the documentation of link:/documentation/reference/stable/connectors/mongodb.html#mongodb-property-cursor-oversize-handling-mode[cursor.oversize.handling.mode] and -link:/documentation/reference/stable/connectors/mongodb.html#mongodb-property-cursor-oversize-skip-threshold[cursor.oversize.skip.threshold] properties. \ No newline at end of file +link:/documentation/reference/stable/connectors/mongodb.html#mongodb-property-cursor-oversize-skip-threshold[cursor.oversize.skip.threshold] properties. + +== Debezium engine applications fails with "Unable to find minimal snapshot lock mode. Please check your configuration" error + +Debezium uses uses the SPI via the ServiceLoader to load the implementation. +The implementation can be based on the connector type, or it can be a custom implementation. + +Some interfaces have multiple implementations. +For example, `io.debezium.snapshot.spi.SnapshotLock` has a default implementation in the core, and specific implementations for each connector. +To ensure that Debezium can locate the required implementation, you must explicitly configure your build tools to merge the `META-INF/services files`. + + +For example, if you are using the https://maven.apache.org/plugins/maven-shade-plugin[Maven shade plugin], +add the https://maven.apache.org/plugins/maven-shade-plugin/examples/resource-transformers.html#ServicesResourceTransformer[`ServicesResourceTransformer`] transformer, as shown in the following example: + +[source,xml] +---- +... + + + ... + + ... + +... + +---- + +Alternatively, if you use the https://maven.apache.org/plugins/maven-assembly-plugin/index.html[Maven Assembly plug-in], you can use the https://maven.apache.org/plugins/maven-assembly-plugin/examples/single/using-container-descriptor-handlers.html[metaInf-services container descriptor handlers]. \ No newline at end of file