Status
Current state: Under Discussion
Discussion thread: here
JIRA: KAFKA-4291
Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).
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 include all details instead of having to go back and forth between multiple commands.
Moreover when using TopicCommand --describe with --under-replicated-partitions or --unavailable-partitions, topics marked for deletion are listed without being marked appropriately which can be confusing !
Public Interfaces
The change would only be in the output of TopicCommand when using the --describe flag. This is the class called by the kafka-topics.sh script.
Proposed Changes
If a topic is marked for deletion, --describe 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:
Compatibility, Deprecation, and Migration Plan
- What impact (if any) will there be on existing users?
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
If there are alternative ways of accomplishing the same thing, what were they? The purpose of this section is to motivate why the design is the way it is and not some other way.