Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NameDescriptionTypeDefaultValid ValuesImportance
allowproducer.auto.create.topicsConfigures how topic auto-creation will occur. 'False' does allow auto-topic creation. 'Server-side' allows the server to create the topic if the broker's 'auto.create.topics.enable' is true. 'Client-side' creates the topic client-side. Client-side auto-creation is only supported by brokers with version greater than 0.10.1.1.Stringallow-server-side[false, allow-server-side, client-side]medium

...

In order to automatically create topics with the producer, the producer's allow.auto.create.topics config topics config must be set to 'client-side.'  If the broker does not support KIP 464, auto.create.num.partitions and auto.create.replication.factor must be specified. 

...

    • By default, 'allow-server-side' auto-creation is used. The broker's 'auto.create.topics.enable' must be configured as true.
      • Although the broker config and server-side auto-creation is deprecated, this is the default to ensure compatibility.
      • If the broker config is set to false, the topic will not be created automatically.
    • Systems that rely on auto-creation would be encouraged to set the producer config producer.auto.create.topics .enable to 'client-side.'
      • This will effectively override the deprecated broker config, so even if it is configured to true, the server will not auto-create topics.
      • Systems with older broker versions that do not support KIP-464 would not be compatible with this option.
    • Systems that want to turn off auto-creation completely should set the producer config to false. This will override the broker config for this producer.
      • This will fulfill the same role as 'allow.auto.create.topics' on the consumer, but for the producer.
    • Systems that utilize auto-creation on the consumer will no longer be able to do so with only the producer config enabled.
      • Enabling the broker config or making further changes to the code is required.

...