(flink) branch master updated: [hotfix][docs] Fix typo and heading level in state backends documentation (#28173)

[da...@apache.org]

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

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


The following commit(s) were added to refs/heads/master by this push:
     new 4e98dce2878 [hotfix][docs] Fix typo and heading level in state backends documentation (#28173)
4e98dce2878 is described below

commit 4e98dce287836fb88d863e4d0abce60784ce7397
Author: Dennis-Mircea Ciupitu <de...@gmail.com>
AuthorDate: Thu Jun 4 12:31:43 2026 +0300

    [hotfix][docs] Fix typo and heading level in state backends documentation (#28173)
    
    * [hotfix][docs] Fix typo and heading level in state backends documentation
    
    * [hotfix][docs] Update the Available State Backends general description
    
    * [hotfix][docs] Address review comment
---
 docs/content.zh/docs/ops/state/state_backends.md | 39 ++++++++++++++++++++++++
 docs/content/docs/ops/state/state_backends.md    |  5 +--
 2 files changed, 42 insertions(+), 2 deletions(-)

diff --git a/docs/content.zh/docs/ops/state/state_backends.md b/docs/content.zh/docs/ops/state/state_backends.md
index 3bd98b20920..7b8a50f896a 100644
--- a/docs/content.zh/docs/ops/state/state_backends.md
+++ b/docs/content.zh/docs/ops/state/state_backends.md
@@ -46,6 +46,7 @@ Flink 内置了以下这些开箱即用的 state backends ：
 
  - *HashMapStateBackend*
  - *EmbeddedRocksDBStateBackend*
+ - *ForStStateBackend*
 
 如果不设置，默认使用 HashMapStateBackend。
 
@@ -102,6 +103,44 @@ EmbeddedRocksDBStateBackend 是目前唯一支持增量 CheckPoint 的 State Bac
 
 每个 slot 中的 RocksDB instance 的内存大小是有限制的，详情请见 [这里]({{< ref "docs/ops/state/large_state_tuning" >}})。
 
+<a name="the-forststatebackend"></a>
+
+### The ForStStateBackend
+
+The *ForStStateBackend* is a state backend that is based on [ForSt project](https://github.com/ververica/ForSt),
+which is also a LSM-tree structured key-value store and built on top of the RocksDB.
+It is designed for disaggregated state management, for more details, see [here]({{< ref "docs/ops/state/disaggregated_state" >}}).
+Most importantly, it can hold its sst files on remote file systems that Flink supports, such as HDFS, S3, etc.
+This allows Flink to scale the state size beyond the local disk capacity of the TaskManager.
+Moreover, by putting the sst files on remote file systems, it can also provide a more lightweight
+way to perform checkpoint and recovery.
+
+The ForStStateBackend is still in the experimental stage and is not fully available for production.
+It always performs asynchronous incremental snapshots.
+
+The ForStStateBackend is encouraged for:
+
+- Jobs with very large state, long windows, large key/value states. Local disk may not be enough to 
+store the state.
+- All high-availability setups.
+- Asynchronous state access is preferred. Since the ForStStateBackend is the only one supporting 
+asynchronous state access.
+- Jobs that require lightweight checkpoint and recovery, such as cloud-native applications.
+
+Limitations of the ForStStateBackend (for now):
+
+- Same as EmbeddedRocksDBStateBackend, the maximum supported size per key and per value is 2^31 bytes each.
+- Does not support canonical savepoint, full snapshot, changelog and file-merging checkpoints.
+Always perform incremental snapshots.
+
+Compared with EmbeddedRocksDBStateBackend, ForStStateBackend stores data on remote file system, thus
+the amount of state that you can keep is unlimited. The local disk of TaskManager is only used to
+store cache of file, to provide better performance. Note that when most of the active state is on
+remote file system, the performance of state access may be affected by the network latency. Flink
+introduces asynchronous state access to mitigate this issue. If you are using the asynchronous state
+methods in State API V2, you can benefit from the asynchronous state access. To get familiar with the
+State API V2, please refer to the [State API V2 documentation]({{< ref "docs/dev/datastream/fault-tolerance/state_v2" >}}).
+
 <a name="choose-the-right-state-backend"></a>
 
 ## 选择合适的 State Backend
diff --git a/docs/content/docs/ops/state/state_backends.md b/docs/content/docs/ops/state/state_backends.md
index 52b6d2d0a54..813f4416e35 100644
--- a/docs/content/docs/ops/state/state_backends.md
+++ b/docs/content/docs/ops/state/state_backends.md
@@ -45,6 +45,7 @@ Out of the box, Flink bundles these state backends:
 
  - *HashMapStateBackend*
  - *EmbeddedRocksDBStateBackend*
+ - *ForStStateBackend*
 
 If nothing else is configured, the system will use the HashMapStateBackend.
 
@@ -100,7 +101,7 @@ Certain RocksDB native metrics are available but disabled by default, you can fi
 
 The total memory amount of RocksDB instance(s) per slot can also be bounded, please refer to documentation [here]({{< ref "docs/ops/state/large_state_tuning" >}}#bounding-rocksdb-memory-usage) for details.
 
-## The ForStStateBackend
+### The ForStStateBackend
 
 The *ForStStateBackend* is a state backend that is based on [ForSt project](https://github.com/ververica/ForSt),
 which is also a LSM-tree structured key-value store and built on top of the RocksDB.
@@ -304,7 +305,7 @@ See [configuration docs]({{< ref "docs/deployment/config" >}}#rocksdb-native-met
 Enabling RocksDB's native metrics may have a negative performance impact on your application.
 {{< /hint >}}
 
-### Advanced RocksDB Memory Turning
+### Advanced RocksDB Memory Tuning
 
 {{< hint info >}}
 Flink offers sophisticated default [memory management for RocksDB](#memory-management) that should work for most use-cases. The below mechanisms should mainly be used for *expert tuning* or *trouble shooting*.