diff --git a/documentation/faq.asciidoc b/documentation/faq.asciidoc index 8bab1be6572..2319bec7768 100644 --- a/documentation/faq.asciidoc +++ b/documentation/faq.asciidoc @@ -383,15 +383,5 @@ The database timezone must be specified explicitly in this situation, using the This may be the case when Debezium (or rather the MongoDB change stream cursor) encounters a change event document with total size exceeding the https://www.mongodb.com/docs/manual/reference/limits/#mongodb-limit-BSON-Document-Size[BSON document size limit of 16 megabytes]. 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. - -Starting with Debezium version 2.3.4 you can use the `cursor.pipeline` and `cursor.pipeline.order` properties to circumvent this error - -First set the `cursor.pipeline.order` to `user_first`, then set `cursor.pipeline` to add the following aggregation stage. - - -``` -[{ "$match": { "$and": [{"$expr": { "$lte": [{"$bsonSize": "$fullDocument"}, 8000]}}, {"$expr": { "$lte": [{"$bsonSize": "$fullDocumentBeforeChange"}, 8000]}}]} }] -``` - -In the example above all events for documents with original or updated size exceeeding 8000 bytes will be safely filtered out. - +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