Versions Compared

Key

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

...

NameDescriptionTypeDefaultValid ValuesImportance
allow.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
auto.create.num.partitionsThe default number of log partitions per topic for auto-created topics. This value is only used if the broker's auto-creation configuration has been disabled and the producer's config has been enabled.int-1
medium
auto.create.replication.factor

The default replication factor for automatically created topics. This value is only used if the broker's auto-creation configuration has been disabled and the producer's config has been enabled.

int-1
medium

...

    • By default, '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 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 would need to set auto.create.num.partitions and auto.create.replication.factor upon allowing 'client-side' auto-creation.
    • 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.
    • 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.

...