You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@fluss.apache.org by "qiuyunbuyu (via GitHub)" <gi...@apache.org> on 2025/11/12 13:12:46 UTC

[PR] [docs] add an explanation for setting the configuration of kv.snapsho… [fluss]

qiuyunbuyu opened a new pull request, #1971:
URL: https://github.com/apache/fluss/pull/1971

   While conducting tests following the [official Docker deployment guide](https://fluss.apache.org/docs/install-deploy/deploying-with-docker/), I noticed that all kv.snapshot.interval parameters are set to 0S. I found this configuration quite confusing, as the behavior it implies wasn't immediately clear.
   
   I checked the [configuration documentation](https://fluss.apache.org/docs/maintenance/configuration/#kv), but it didn't provide a clear explanation for a value of 0S. To understand its meaning, I looked through the code commit history and found the relevant context in [PR #30](https://github.com/apache/fluss/pull/30).
   
   Now that I understand its purpose, I would like to propose that we add specific documentation to clarify the special meaning and intended use-case when this parameter is set to 0S. This would prevent confusion for future users.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] [docs] add an explanation for setting the configuration of kv.snapshot.interval to 0s [fluss]

Posted by "rionmonster (via GitHub)" <gi...@apache.org>.
rionmonster commented on code in PR #1971:
URL: https://github.com/apache/fluss/pull/1971#discussion_r2519250772


##########
website/docs/maintenance/configuration.md:
##########
@@ -132,7 +132,7 @@ during the Fluss cluster working.
 
 | Option                                            | Type       | Default                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 |---------------------------------------------------|------------|-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kv.snapshot.interval                              | Duration   | 10min                         | The interval to perform periodic snapshot for kv data. The default setting is 10 minutes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| kv.snapshot.interval                              | Duration   | 10min                         | The interval to perform periodic snapshot for kv data. The default setting is 10 minutes. If the value is set to 0s, it means not to do kv snapshot.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

Review Comment:
   I'm wondering if this would read slightly more clearly as:
   
   ```
   The interval to perform periodic snapshots for kv data. The default setting is 10 minutes. When set to 0s, snapshotting will be disabled.     
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] [docs] add an explanation for setting the configuration of kv.snapshot.interval to 0s [fluss]

Posted by "rionmonster (via GitHub)" <gi...@apache.org>.
rionmonster commented on code in PR #1971:
URL: https://github.com/apache/fluss/pull/1971#discussion_r2519250772


##########
website/docs/maintenance/configuration.md:
##########
@@ -132,7 +132,7 @@ during the Fluss cluster working.
 
 | Option                                            | Type       | Default                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 |---------------------------------------------------|------------|-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kv.snapshot.interval                              | Duration   | 10min                         | The interval to perform periodic snapshot for kv data. The default setting is 10 minutes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| kv.snapshot.interval                              | Duration   | 10min                         | The interval to perform periodic snapshot for kv data. The default setting is 10 minutes. If the value is set to 0s, it means not to do kv snapshot.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

Review Comment:
   I'm wondering if this would read slightly more clearly as:
   
   > The interval to perform periodic snapshots for kv data. The default setting is 10 minutes. When set to 0s, snapshotting will be disabled.     
   



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] [docs] add an explanation for setting the configuration of kv.snapshot.interval to 0s [fluss]

Posted by "qiuyunbuyu (via GitHub)" <gi...@apache.org>.
qiuyunbuyu commented on PR #1971:
URL: https://github.com/apache/fluss/pull/1971#issuecomment-3525323054

   > Left a single comment/wording nit; otherwise LGTM!
   
   @rionmonster Thank you for the review. I agree with your suggestion. Using "disable" does make the behavior more explicit and aligns with the existing comment in [apache/fluss#30](https://github.com/apache/fluss/pull/30/files). I've applied the change.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@fluss.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org