Skip to content

Commit

Permalink
Fix manual commit documentation page is misleading (#1071)
Browse files Browse the repository at this point in the history
* Fix manual commit documentation page is misleading

* Update docs/examples/manual_commit.rst

Co-authored-by: Denis Otkidach <denis.otkidach@gmail.com>

---------

Co-authored-by: Denis Otkidach <denis.otkidach@gmail.com>
  • Loading branch information
memew1se and ods authored Dec 4, 2024
1 parent 49a5573 commit 29b58db
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions docs/examples/manual_commit.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
Manual commit
=============

When processing more sensitive data ``enable_auto_commit=False`` mode of
Consumer can lead to data loss in cases of critical failure. To avoid it we
can commit offsets manually after they were processed. Note, that this is a
tradeoff from *at most once* to *at least once* delivery, to achieve
*exactly once* you will need to save offsets in the destination database and
validate those yourself.
When processing sensitive data, using ``enable_auto_commit=True`` (default) for the
Consumer can lead to data loss in the event of a critical failure. To avoid
this, set ``enable_auto_commit=False`` and commit offsets manually only after
messages have been processed. Note, that this is a tradeoff from *at most once*
to *at least once* delivery, to achieve *exactly once* you will need to save
offsets in the destination database and validate those yourself.

More on message delivery: https://kafka.apache.org/documentation.html#semantics

Expand Down

0 comments on commit 29b58db

Please sign in to comment.