Principle:Apache Kafka Topic Configuration Alteration
| Knowledge Sources | |
|---|---|
| Domains | Administration, Configuration |
| Last Updated | 2026-02-09 12:00 GMT |
Overview
An incremental configuration operation that modifies specific topic settings without affecting other existing configurations.
Description
Topic Configuration Alteration uses the incremental alter configs protocol to modify individual topic settings. Unlike the deprecated full-replacement alter, incremental alteration supports SET, DELETE, APPEND, and SUBTRACT operations on individual config keys. This prevents accidental removal of other configurations and supports list-valued configurations.
Usage
Use this principle when modifying topic settings like retention, cleanup policy, or compression. Incremental alteration is the recommended approach for all configuration changes in modern Kafka.
Theoretical Basis
- Operation Types: SET (add/overwrite), DELETE (remove override), APPEND (add to list), SUBTRACT (remove from list).
- Incremental Application: Only specified keys are affected; all other configurations remain unchanged.
- Validation: The broker validates config values before applying them.
- Propagation: Changes are persisted and propagated to all brokers managing the topic.
Related Pages
Implemented By
Page Connections
Double-click a node to navigate. Hold to expand connections.
Principle
Implementation
Heuristic
Environment