diff --git a/modules/develop/pages/config-topics.adoc b/modules/develop/pages/config-topics.adoc index c9843152b4..347217b5cc 100644 --- a/modules/develop/pages/config-topics.adoc +++ b/modules/develop/pages/config-topics.adoc @@ -99,6 +99,8 @@ The cleanup policy determines how to clean up the partition log files when they Unlike compacted topics, which keep only the most recent message for a given key, topics configured with a `delete` cleanup policy provide a running history of all changes for those topics. +include::develop:partial$topic-properties-warning.adoc[] + For example, to change a topic's policy to `compact`, run: [,bash] diff --git a/modules/develop/partials/topic-properties-warning.adoc b/modules/develop/partials/topic-properties-warning.adoc new file mode 100644 index 0000000000..62fef970c7 --- /dev/null +++ b/modules/develop/partials/topic-properties-warning.adoc @@ -0,0 +1 @@ +WARNING: Modifying the properties of topics that are created and managed by Redpanda applications can cause unexpected errors. This may lead to connector and cluster failures. \ No newline at end of file diff --git a/modules/manage/pages/cluster-maintenance/compaction-settings.adoc b/modules/manage/pages/cluster-maintenance/compaction-settings.adoc index 0dfb0bc8ff..33226b4069 100644 --- a/modules/manage/pages/cluster-maintenance/compaction-settings.adoc +++ b/modules/manage/pages/cluster-maintenance/compaction-settings.adoc @@ -26,6 +26,8 @@ Compaction policy may be applied to a cluster or to an individual topic. If both * `compact`: This triggers only cleanup of records with multiple versions. A record that represents the only version for a given key is not deleted. * `compact,delete`: This combines both policies, deleting records exceeding the retention period while compacting multiple versions of records. +include::develop:partial$topic-properties-warning.adoc[] + == Tombstone record removal Compaction also enables deletion of existing records through tombstones. For example, as data is deleted from a source system, clients produce a tombstone record to the log. A tombstone contains a key and the value `null`. Tombstones signal to brokers and consumers that records with the same key prior to it in the log should be deleted. diff --git a/modules/manage/pages/kubernetes/k-manage-topics.adoc b/modules/manage/pages/kubernetes/k-manage-topics.adoc index 4804ebea2f..91f6d914bb 100644 --- a/modules/manage/pages/kubernetes/k-manage-topics.adoc +++ b/modules/manage/pages/kubernetes/k-manage-topics.adoc @@ -126,6 +126,8 @@ The cleanup policy determines how to manage the partition log files when they re If the cleanup policy is `delete` or `compact,delete` you can <>. +include::develop:partial$topic-properties-warning.adoc[] + === Configure Iceberg topics Iceberg topics allow you to create a seamless integration with Apache Iceberg by writing records in Redpanda topics to object storage in Iceberg format. diff --git a/modules/reference/pages/properties/topic-properties.adoc b/modules/reference/pages/properties/topic-properties.adoc index dadf9abd59..cf83eb25da 100644 --- a/modules/reference/pages/properties/topic-properties.adoc +++ b/modules/reference/pages/properties/topic-properties.adoc @@ -171,6 +171,8 @@ The cleanup policy to apply for log segments of a topic. When `cleanup.policy` is set, it overrides the cluster property xref:cluster-properties.adoc#log_cleanup_policy[`log_cleanup_policy`] for the topic. +include::develop:partial$topic-properties-warning.adoc[] + **Default**: `[delete]` **Values**: @@ -179,6 +181,8 @@ When `cleanup.policy` is set, it overrides the cluster property xref:cluster-pro - `[compact]` - Deletes data according to a key-based retention policy, discarding all but the latest value for each key. - `[compact,delete]` - The latest values are kept for each key, while the remaining data is deleted according to retention limits. + + **Related topics**: - xref:manage:cluster-maintenance/disk-utilization.adoc#configure-segment-size[Configure segment size]