Versions Compared

Key

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

...

We propose a protocol upgrade to CreateTopicsRequest and CreatePartitionsRequest to specify a minimum number of replicas to be available at creation to satisfy the request. 
A new error code will be added to indicate a topic/partition creation was completed without the full replication factor.

A
broker configuration will be added to select the desired behavior handling a create request that accepts under-replication: Administrators can disallow, or allow creations of topics/partitions without the full replication factor. When allowed a su-option is to always prefer using all known brokers and their racks and have some under replication, rather than using currently available online brokers.
Topic policies could be used to add more complex validations, for exampleto allow creation with min-isr factor but not less.

...

NAME

DESCRIPTION

TYPE

DEFAULT

VALID VALUES

IMPORTANCE

DYNAMIC UPDATE MODE

under.replicated.creation.enablepolicy

Allow Behavior on Topic or Partition creation without the full set of replicas being active.

BOOLEANSTRING

False

disabled

True/Falsedisabled, enabled, enabled_prefer_observed

Medium

cluster-wide

Administrators can disable (disabled), or enable (enabled) creations of topics/partitions without the full replication factor. When enabled a sub-option is to always prefer using all known brokers and their racks and have some under replication, rather than using currently available online brokers (enabled_prefer_observed)

Command line tools and arguments

...