(paimon) branch master updated: [core] Explain tag.num-retained-max (#3555)

[lzljs3620320]

This is an automated email from the ASF dual-hosted git repository.

lzljs3620320 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/paimon.git


The following commit(s) were added to refs/heads/master by this push:
     new 9e98cda5b [core] Explain tag.num-retained-max (#3555)
9e98cda5b is described below

commit 9e98cda5bfac2ad8b9d9374e0d1e7f23c244cba8
Author: yuzelin <33053040+yuze...@users.noreply.github.com>
AuthorDate: Thu Jun 20 17:58:06 2024 +0800

    [core] Explain tag.num-retained-max (#3555)
---
 docs/layouts/shortcodes/generated/core_configuration.html      | 4 ++--
 paimon-common/src/main/java/org/apache/paimon/CoreOptions.java | 7 +++++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/docs/layouts/shortcodes/generated/core_configuration.html 
b/docs/layouts/shortcodes/generated/core_configuration.html
index 862f614ee..e57becbab 100644
--- a/docs/layouts/shortcodes/generated/core_configuration.html
+++ b/docs/layouts/shortcodes/generated/core_configuration.html
@@ -754,13 +754,13 @@ If the data size allocated for the sorting task is 
uneven,which may lead to perf
             <td><h5>tag.default-time-retained</h5></td>
             <td style="word-wrap: break-word;">(none)</td>
             <td>Duration</td>
-            <td>The default maximum time retained for newly created tags.</td>
+            <td>The default maximum time retained for newly created tags. It 
affects both auto-created tags and manually created (by procedure) tags.</td>
         </tr>
         <tr>
             <td><h5>tag.num-retained-max</h5></td>
             <td style="word-wrap: break-word;">(none)</td>
             <td>Integer</td>
-            <td>The maximum number of tags to retain.</td>
+            <td>The maximum number of tags to retain. It only affects 
auto-created tags.</td>
         </tr>
         <tr>
             <td><h5>tag.period-formatter</h5></td>
diff --git a/paimon-common/src/main/java/org/apache/paimon/CoreOptions.java 
b/paimon-common/src/main/java/org/apache/paimon/CoreOptions.java
index 5e8ebb264..36a2a2af2 100644
--- a/paimon-common/src/main/java/org/apache/paimon/CoreOptions.java
+++ b/paimon-common/src/main/java/org/apache/paimon/CoreOptions.java
@@ -1057,13 +1057,16 @@ public class CoreOptions implements Serializable {
             key("tag.num-retained-max")
                     .intType()
                     .noDefaultValue()
-                    .withDescription("The maximum number of tags to retain.");
+                    .withDescription(
+                            "The maximum number of tags to retain. It only 
affects auto-created tags.");
 
     public static final ConfigOption<Duration> TAG_DEFAULT_TIME_RETAINED =
             key("tag.default-time-retained")
                     .durationType()
                     .noDefaultValue()
-                    .withDescription("The default maximum time retained for 
newly created tags.");
+                    .withDescription(
+                            "The default maximum time retained for newly 
created tags. "
+                                    + "It affects both auto-created tags and 
manually created (by procedure) tags.");
 
     public static final ConfigOption<Duration> SNAPSHOT_WATERMARK_IDLE_TIMEOUT 
=
             key("snapshot.watermark-idle-timeout")