[ 
https://issues.apache.org/jira/browse/KAFKA-1674?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Stevo Slavic updated KAFKA-1674:
--------------------------------
    Description: 
{{auto.create.topics.enable}} is currently 
[documented|http://kafka.apache.org/08/configuration.html] with
{quote}
Enable auto creation of topic on the server. If this is set to true then 
attempts to produce, consume, or fetch metadata for a non-existent topic will 
automatically create it with the default replication factor and number of 
partitions.
{quote}

In Kafka 0.8.1.1 reality, topics are only created when trying to publish a 
message on non-existing topic.

After 
[discussion|http://mail-archives.apache.org/mod_mbox/kafka-users/201410.mbox/%3CCAFbh0Q1WXLUDO-im1fQ1yEvrMduxmXbj5HXVc3Cq8B%3DfeMso9g%40mail.gmail.com%3E]
 with [~junrao] conclusion was that it's documentation issue which needs to be 
fixed.

Please check once more if this is just non-working functionality. If it is docs 
only issue, and implicit topic creation functionality should work only for 
producer, consider moving {{auto.create.topics.enable}} and maybe also 
{{num.partitions}}, {{default.replication.factor}} and any other topic auto 
creation related configuration properties (docs only, but maybe code also?) 
from broker configuration options to producer configuration options.

  was:
{{auto.create.topics.enable}} is currently 
[documented|http://kafka.apache.org/08/configuration.html] with
{quote}
Enable auto creation of topic on the server. If this is set to true then 
attempts to produce, consume, or fetch metadata for a non-existent topic will 
automatically create it with the default replication factor and number of 
partitions.
{quote}

In Kafka 0.8.1.1 reality, topics are only created when trying to publish a 
message on non-existing topic.

After 
[discussion|http://mail-archives.apache.org/mod_mbox/kafka-users/201410.mbox/%3CCAFbh0Q1WXLUDO-im1fQ1yEvrMduxmXbj5HXVc3Cq8B%3DfeMso9g%40mail.gmail.com%3E]
 with [~junrao] conclusion was that it's documentation issue which needs to be 
fixed.

Please check once more if this is just non-working functionality. If it is docs 
only issue, and implicit topic creation functionality should work only for 
producer, consider moving {{auto.create.topics.enable}} and other topic auto 
creation related configuration properties (docs only, but maybe code also?) 
from broker configuration options to producer configuration options.


> auto.create.topics.enable docs are misleading
> ---------------------------------------------
>
>                 Key: KAFKA-1674
>                 URL: https://issues.apache.org/jira/browse/KAFKA-1674
>             Project: Kafka
>          Issue Type: Bug
>    Affects Versions: 0.8.1.1
>            Reporter: Stevo Slavic
>            Priority: Minor
>
> {{auto.create.topics.enable}} is currently 
> [documented|http://kafka.apache.org/08/configuration.html] with
> {quote}
> Enable auto creation of topic on the server. If this is set to true then 
> attempts to produce, consume, or fetch metadata for a non-existent topic will 
> automatically create it with the default replication factor and number of 
> partitions.
> {quote}
> In Kafka 0.8.1.1 reality, topics are only created when trying to publish a 
> message on non-existing topic.
> After 
> [discussion|http://mail-archives.apache.org/mod_mbox/kafka-users/201410.mbox/%3CCAFbh0Q1WXLUDO-im1fQ1yEvrMduxmXbj5HXVc3Cq8B%3DfeMso9g%40mail.gmail.com%3E]
>  with [~junrao] conclusion was that it's documentation issue which needs to 
> be fixed.
> Please check once more if this is just non-working functionality. If it is 
> docs only issue, and implicit topic creation functionality should work only 
> for producer, consider moving {{auto.create.topics.enable}} and maybe also 
> {{num.partitions}}, {{default.replication.factor}} and any other topic auto 
> creation related configuration properties (docs only, but maybe code also?) 
> from broker configuration options to producer configuration options.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to