Table of Contents |
---|
Status
Current state: Under Discussion Adopted
Discussion thread: here
JIRA: KAFKA-4291
...
KIP Authors: Edoardo Comar and Mickael Maison
Motivation
When using TopicCommand --describe
, it does not show if a topic is marked for deletion. Such information is only displayed when using --list
. It would be helpful to have the --describe
command command include all details instead of having to go back and forth between multiple commands.
Moreover when using TopicCommand --describe
with with --under-replicated-partitions
or or --unavailable-partitions
, topics marked for deletion are listed without being marked appropriately which can be confusing!
...
The change would only be in the output of TopicCommand when using the --describe
flag flag. This is the class called by the kafka-topics.sh
script script.
Proposed Changes
If a topic is marked for deletion, --describe
will will return the following:
Topic:testtopic PartitionCount:1 ReplicationFactor:1 Configs:cleanup.policy=compact,flush.ms=1000 MarkedForDeletion:true
...
Topic: testtopic Partition: 0 Leader: none Replicas: 0 Isr:
When running with --unavailable-partitions or --under-replicated-partitions, the topic header is not displayed. In this case, the marker will be added on each partition:
Topic: testtopic Partition: 0 Leader: none Replicas: 0 Isr: MarkedForDeletion:true
Compatibility, Deprecation, and Migration Plan
...
There is a concern that people may be parsing the raw output as there is no structured output from this command. In that case, people will need to adjust their parsing logic.
Rejected Alternatives
...
We tried reusing the same string used by --list
("- marked for deletion") but we found the output inconsistent compared to the other fields in --describe
.
Topic:testtopic PartitionCount:1 ReplicationFactor:1 Configs:cleanup.policy=compact,flush.ms=1000 - marked for deletion
Topic: testtopic Partition: 0 Leader: none Replicas: 0 Isr: