This is an automated email from the ASF dual-hosted git repository.
cegerton pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/kafka-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 77ecf44c KAFKA-14876: Add stopped state to Kafka Connect
Administration docs section (#539)
77ecf44c is described below
commit 77ecf44cc39788f14700547fc182b63aa7b8aa9b
Author: Yash Mayya <yash.ma...@gmail.com>
AuthorDate: Thu Sep 7 17:39:01 2023 +0100
KAFKA-14876: Add stopped state to Kafka Connect Administration docs section
(#539)
Reviewers: Chris Egerton <chr...@aiven.io>
---
35/connect.html | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/35/connect.html b/35/connect.html
index 20872b13..976fda0b 100644
--- a/35/connect.html
+++ b/35/connect.html
@@ -934,6 +934,7 @@ Struct struct = new Struct(schema)
<li><b>UNASSIGNED:</b> The connector/task has not yet been assigned to a
worker.</li>
<li><b>RUNNING:</b> The connector/task is running.</li>
<li><b>PAUSED:</b> The connector/task has been administratively
paused.</li>
+ <li><b>STOPPED:</b> The connector has been stopped. Note that this state
is not applicable to tasks because the tasks for a stopped connector are shut
down and won't be visible in the status API.</li>
<li><b>FAILED:</b> The connector/task has failed (usually by raising an
exception, which is reported in the status output).</li>
<li><b>RESTARTING:</b> The connector/task is either actively restarting or
is expected to restart soon</li>
</ul>
@@ -949,6 +950,10 @@ Struct struct = new Struct(schema)
<p>
It's sometimes useful to temporarily stop the message processing of a
connector. For example, if the remote system is undergoing maintenance, it
would be preferable for source connectors to stop polling it for new data
instead of filling logs with exception spam. For this use case, Connect offers
a pause/resume API. While a source connector is paused, Connect will stop
polling it for additional records. While a sink connector is paused, Connect
will stop pushing new messages to it. T [...]
</p>
+
+ <p>
+ In 3.5.0, Connect introduced a stop API that completely shuts down the
tasks for a connector and deallocates any resources claimed by them. This is
different from pausing a connector where tasks are left idling and any
resources claimed by them are left allocated (which allows the connector to
begin processing data quickly once it is resumed). Stopping a connector is more
efficient from a resource usage standpoint than pausing it, but can cause it to
take longer to begin processing d [...]
+ </p>
</script>
<div class="p-connect"></div>
