Repository: StarRocks/starrocks
Pull request #57021: [Doc] Doc for Automated Cluster Snapshot
Author: login: EsoragotoSpirit
Labels: name: documentation
description: Improvements or additions to documentation
name: 3.4-merged
Created: 2025-03-18T03:21:21Z | Merged: 2025-03-21T08:47:02Z

Signed-off-by: EsoragotoSpirit <wanglichen@starrocks.com>

## Why I'm doing:

## What I'm doing:

Fixes #issue

## What type of PR is this:

- [ ] BugFix
- [ ] Feature
- [ ] Enhancement
- [ ] Refactor
- [ ] UT
- [x] Doc
- [ ] Tool

Does this PR entail a change in behavior?

- [ ] Yes, this PR will result in a change in behavior.
- [x] No, this PR will not result in a change in behavior.

If yes, please specify the type of change:

- [ ] Interface/UI changes: syntax, type conversion, expression evaluation, display information
- [ ] Parameter changes: default values, similar parameters but with different default values
- [ ] Policy changes: use new policy to replace old one, functionality automatically enabled
- [ ] Feature removed
- [ ] Miscellaneous: upgrade & downgrade compatibility, etc.

## Checklist:

- [ ] I have added test cases for my bug fix or my new feature
- [ ] This pr needs user documentation (for new or modified features or behaviors)
  - [ ] I have added documentation for my new feature or new function
- [ ] This is a backport pr

## Bugfix cherry-pick branch check:
- [x] I have checked the version labels which the pr will be auto-backported to the target branch
  - [x] 3.4
  - [ ] 3.3
  - [ ] 3.2
  - [ ] 3.1
  - [ ] 3.0


Diff:
diff --git a/docs/en/administration/cluster_snapshot.md b/docs/en/administration/cluster_snapshot.md
new file mode 100644
index 00000000000000..3afefa10209319
--- /dev/null
+++ b/docs/en/administration/cluster_snapshot.md
@@ -0,0 +1,201 @@
+---
+displayed_sidebar: docs
+sidebar_label: "Cluster Snapshot"
+---
+
+# Automated Cluster Snapshot
+
+This topic describes how to automate the cluster snapshot for disaster recovery on shared-data clusters.
+
+This feature is supported from v3.4.2 onwards and only available on shared-data clusters.
+
+## Overview
+
+The fundamental idea of disaster recovery for shared-data clusters is to ensure that the full cluster state (including data and metadata) is stored in object storage. This way, if the cluster encounters a failure, it can be restored from the object storage as long as the data and metadata remain intact. Additionally, features like backups and cross-region replication offered by cloud providers can be used to achieve remote recovery and cross-region disaster recovery.
+
+In shared-data clusters, the CN state (data) is stored in object storage, but the FE state (metadata) remains local. To ensure that object storage has all the cluster state for restoration, StarRocks now supports the Automated Cluster Snapshot for both data and metadata in object storage.
+
+### Terms
+
+- **Cluster snapshot**
+
+  A cluster snapshot refers to a snapshot of the cluster state at a certain moment. It contains all the objects in the cluster, such as catalogs, databases, tables, users & privileges, loading tasks, and more. It does not include all external dependent objects, such as configuration files of external catalogs, and local UDF JAR packages.
+
+- **Automating cluster snapshot**
+
+  The system automatically maintains a snapshot closely following the latest cluster state. Historical snapshots will be dropped right after the latest one is created, keeping only one snapshot available all the time. Currently, tasks for automating the cluster snapshot are triggered only by the system. Manually creating a snapshot is not supported.
+
+- **Cluster Restore**
+
+  Restore the cluster from a snapshot.
+
+
+## Usage
+
+### Enable Automated Cluster Snapshot
+
+Automated Cluster Snapshot is disabled by default.
+
+Use the following statement to enable this feature:
+
+Syntax:
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+Parameter:
+
+`storage_volume_name`: Specifies the storage volume used to store the snapshot. If this parameter is not specified, the default storage volume will be used.
+
+Each time FE creates a new metadata image after completing a metadata checkpoint, it automatically creates a snapshot. The name of the snapshot is generated by the system, following the format `automated_cluster_snapshot_{timestamp}`.
+
+Metadata snapshots are stored under `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp`. Data snapshots are stored in the same location as the original data.
+
+FE configuration item `automated_cluster_snapshot_interval_seconds` controls the snapshot automation cycle. The default value is 1800 seconds (30 minutes).
+
+### Disable Automated Cluster Snapshot
+
+Use the following statement to disable Automated Cluster Snapshot:
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+Once Automated Cluster Snapshot is disabled, the system will automatically purge the historical snapshot.
+
+### View cluster snapshots
+
+You can query the view `information_schema.cluster_snapshots` to view the latest cluster snapshot and the snapshots yet to be dropped.
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+Return:
+
+| Field              | Description                                                  |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | The name of the snapshot.                                    |
+| snapshot_type      | The type of the snapshot. Currently, only `automated` is available. |
+| created_time       | The time at which the snapshot was created.                  |
+| fe_journal_id      | The ID of the FE journal.                                    |
+| starmgr_journal_id | The ID of the StarManager journal.                           |
+| properties         | Applies to a feature not yet available.                      |
+| storage_volume     | The storage volume where the snapshot is stored.             |
+| storage_path       | The storage path under which the snapshot is stored.         |
+
+### View cluster snapshot jobs
+
+You can query the view `information_schema.cluster_snapshot_jobs` to view the job information of cluster snapshots.
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+Return:
+
+| Field              | Description                                                  |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | The name of the snapshot.                                    |
+| job_id             | The ID of the job.                                           |
+| created_time       | The time at which the job was created.                       |
+| finished_time      | The time at which the job was finished.                      |
+| state              | The state of the job. Valid values: `INITIALIZING`, `SNAPSHOTING`, `FINISHED`, `EXPIRED`, `DELETED`, and `ERROR`. |
+| detail_info        | The specific progress information of the current execution stage. |
+| error_message      | The error message (if any) of the job.                       |
+
+### Restore the cluster
+
+Follow these steps to restore the cluster with the cluster snapshot.
+
+1. **(Optional)** If the storage location (storage volume) that stores the cluster snapshot have changed, all files under the original storage path must be copied to the new path. To achieve this, you must modify the configuration file **cluster_snapshot.yaml** under the directory `fe/conf` of the Leader FE nodes. For the template of **cluster_snapshot.yaml**, see [Appendix](#appendix).
+
+2. Start the Leader FE node.
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. Start other FE nodes **after cleaning the `meta` directories**.
+
+   ```Bash
+   ./fe/bin/start_fe.sh --helper <leader_ip>:<leader_edit_log_port> --daemon
+   ```
+
+4. Start CN nodes **after cleaning the `storage_root_path` directories**.
+
+   ```Bash
+   ./be/bin/start_cn.sh --daemon
+   ```
+
+If you have modified **cluster_snapshot.yaml** in the step 1, the node and storage volumes will be re-configured in the new cluster according to the information in the file.
+
+## Appendix
+
+Template of **cluster_snapshot.yaml**:
+
+```Yaml
+# Information of the cluster snapshot to be downloaded for restoration.
+cluster_snapshot:
+    # The URI of the snapshot.
+    # Example 1: s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta/image/automated_cluster_snapshot_1704038400000
+    # Example 2: s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta
+    cluster_snapshot_path: <cluster_snapshot_uri>
+    # The name of the storage volume to store the snapshot. You must define it in the `storage_volumes` section.
+    # NOTE: It must be identical with that in the original cluster.
+    storage_volume_name: my_s3_volume
+
+# [Optional] Node information of the new cluster where the snapshot is to be restored.
+# If this section is not specified, the new cluster after recovery only has the Leader FE node.
+# CN nodes retain the information of the original cluster.
+# NOTE: DO NOT include the Leader FE node in this section.
+
+frontends:
+    # FE host.
+  - host: xxx.xx.xx.x1
+    # FE edit_log_port.
+    edit_log_port: 9010
+    # The FE node type. Valid values: `follower` (Default) and `observer`.
+    type: follower
+  - host: xxx.xx.xx.x2
+    edit_log_port: 9010
+    type: observer
+
+compute_nodes:
+    # CN host.
+  - host: xxx.xx.xx.x3
+    # CN heartbeat_service_port.
+    heartbeat_service_port: 9050
+  - host: xxx.xx.xx.x4
+    heartbeat_service_port: 9050
+
+# Information of the storage volume in the new cluster. It is used for restoring a cloned snapshot.
+# NOTE: The name of the storage volume must be identical with that in the original cluster.
+storage_volumes:
+  # Example for S3-compatible storage volume.
+  - name: my_s3_volume
+    type: S3
+    location: s3://defaultbucket/test/
+    comment: my s3 volume
+    properties:
+      - key: aws.s3.region
+        value: us-west-2
+      - key: aws.s3.endpoint
+        value: https://s3.us-west-2.amazonaws.com
+      - key: aws.s3.access_key
+        value: xxxxxxxxxx
+      - key: aws.s3.secret_key
+        value: yyyyyyyyyy
+  # Example for HDFS storage volume.
+  - name: my_hdfs_volume
+    type: HDFS
+    location: hdfs://127.0.0.1:9000/sr/test/
+    comment: my hdfs volume
+    properties:
+      - key: hadoop.security.authentication
+        value: simple
+      - key: username
+        value: starrocks
+```
\ No newline at end of file
diff --git a/docs/en/administration/management/FE_configuration.md b/docs/en/administration/management/FE_configuration.md
index 6cb308061f8394..145fd34d5437ff 100644
--- a/docs/en/administration/management/FE_configuration.md
+++ b/docs/en/administration/management/FE_configuration.md
@@ -1126,6 +1126,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - Description: Whether to enable the Legacy Compatibility for Replication. StarRocks may behave differently between the old and new versions, causing problems during cross-cluster data migration. Therefore, you must enable Legacy Compatibility for the target cluster before data migration and disable it after data migration is completed. `true` indicates enabling this mode.
 - Introduced in: v3.1.10, v3.2.6
 
+##### automated_cluster_snapshot_interval_seconds
+
+- Default: 600
+- Type: Int
+- Unit: Seconds
+- Is mutable: Yes
+- Description: The interval at which the Automated Cluster Snapshot tasks are triggered.
+- Introduced in: v3.4.2
+
 ### User, role, and privilege
 
 ##### privilege_max_total_roles_per_user
diff --git a/docs/ja/administration/cluster_snapshot.md b/docs/ja/administration/cluster_snapshot.md
new file mode 100644
index 00000000000000..f944bc157080ea
--- /dev/null
+++ b/docs/ja/administration/cluster_snapshot.md
@@ -0,0 +1,200 @@
+---
+displayed_sidebar: docs
+sidebar_label: クラスタスナップショット
+---
+
+# 自動クラスタスナップショット
+
+このトピックでは、共有データクラスタでの災害復旧のためにクラスタスナップショットを自動化する方法について説明します。
+
+この機能は v3.4.2 以降でサポートされており、共有データクラスタでのみ利用可能です。
+
+## 概要
+
+共有データクラスタの災害復旧の基本的な考え方は、クラスタの全状態（データとメタデータを含む）をオブジェクトストレージに保存することです。これにより、クラスタが障害に遭遇した場合でも、データとメタデータが無事であれば、オブジェクトストレージから復元できます。さらに、クラウドプロバイダが提供するバックアップやクロスリージョンレプリケーションなどの機能を利用して、リモート復旧やクロスリージョン災害復旧を実現できます。
+
+共有データクラスタでは、CN 状態（データ）はオブジェクトストレージに保存されますが、FE 状態（メタデータ）はローカルに保持されます。オブジェクトストレージが復元のためにクラスタの全状態を持つようにするために、StarRocks はデータとメタデータの両方をオブジェクトストレージに保存する Automated Cluster Snapshot をサポートしています。
+
+### 用語
+
+- **Cluster snapshot**
+
+  クラスタスナップショットとは、特定の瞬間におけるクラスタ状態のスナップショットを指します。カタログ、データベース、テーブル、ユーザーと権限、ロードタスクなど、クラスタ内のすべてのオブジェクトを含みます。ただし、外部カタログの設定ファイルやローカルの UDF JAR パッケージなど、すべての外部依存オブジェクトは含まれません。
+
+- **Automating cluster snapshot**
+
+  システムは最新のクラスタ状態に密接に従ったスナップショットを自動的に維持します。最新のスナップショットが作成されると、古いスナップショットはすぐに削除され、常に1つのスナップショットのみが利用可能です。現在、クラスタスナップショットの自動化タスクはシステムによってのみトリガーされます。手動でスナップショットを作成することはサポートされていません。
+
+- **Cluster Restore**
+
+  スナップショットからクラスタを復元します。
+
+## 使用方法
+
+### Automated Cluster Snapshot を有効にする
+
+Automated Cluster Snapshot はデフォルトで無効になっています。
+
+この機能を有効にするには、次のステートメントを使用します。
+
+構文:
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+パラメータ:
+
+`storage_volume_name`: スナップショットを保存するために使用されるストレージボリュームを指定します。このパラメータが指定されていない場合、デフォルトのストレージボリュームが使用されます。
+
+FE がメタデータチェックポイントを完了した後に新しいメタデータイメージを作成するたびに、自動的にスナップショットが作成されます。スナップショットの名前は、`automated_cluster_snapshot_{timestamp}` という形式でシステムによって生成されます。
+
+メタデータスナップショットは、`/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` に保存されます。データスナップショットは元のデータと同じ場所に保存されます。
+
+FE の設定項目 `automated_cluster_snapshot_interval_seconds` はスナップショット自動化サイクルを制御します。デフォルト値は 1800 秒（30 分）です。
+
+### Automated Cluster Snapshot を無効にする
+
+Automated Cluster Snapshot を無効にするには、次のステートメントを使用します。
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+Automated Cluster Snapshot が無効になると、システムは自動的に古いスナップショットを削除します。
+
+### クラスタスナップショットを表示する
+
+最新のクラスタスナップショットとまだ削除されていないスナップショットを表示するには、ビュー `information_schema.cluster_snapshots` をクエリできます。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返り値:
+
+| フィールド            | 説明                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | スナップショットの名前。                                      |
+| snapshot_type      | スナップショットのタイプ。現在、`automated` のみ利用可能です。 |
+| created_time       | スナップショットが作成された時間。                            |
+| fe_journal_id      | FE ジャーナルの ID。                                         |
+| starmgr_journal_id | StarManager ジャーナルの ID。                                |
+| properties         | まだ利用できない機能に適用されます。                          |
+| storage_volume     | スナップショットが保存されているストレージボリューム。        |
+| storage_path       | スナップショットが保存されているストレージパス。              |
+
+### クラスタスナップショットジョブを表示する
+
+クラスタスナップショットのジョブ情報を表示するには、ビュー `information_schema.cluster_snapshot_jobs` をクエリできます。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返り値:
+
+| フィールド            | 説明                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | スナップショットの名前。                                      |
+| job_id             | ジョブの ID。                                                 |
+| created_time       | ジョブが作成された時間。                                      |
+| finished_time      | ジョブが終了した時間。                                        |
+| state              | ジョブの状態。 有効な値: `INITIALIZING`, `SNAPSHOTING`, `FINISHED`, `EXPIRED`, `DELETED`, `ERROR`。 |
+| detail_info        | 現在の実行ステージの具体的な進捗情報。                        |
+| error_message      | ジョブのエラーメッセージ（ある場合）。                        |
+
+### クラスタを復元する
+
+クラスタスナップショットを使用してクラスタを復元するには、次の手順に従います。
+
+1. **(オプション)** クラスタスナップショットを保存するストレージの場所(ストレージボリューム)が変更された場合、元のストレージパスの下にあるすべてのファイルを新しいパスにコピーする必要があります。これを実現するには、Leader FEノードの `fe/conf` ディレクトリにある設定ファイル **cluster_snapshot.yaml** を変更する必要があります。**cluster_snapshot.yaml** のテンプレートについては、[Appendix](#appendix) を参照してください。
+
+2. Leader FE ノードを起動します。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. **`meta` ディレクトリをクリーニングした後**、他の FE ノードを起動する。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --helper <leader_ip>:<leader_edit_log_port> --daemon
+   ```
+
+4. **`storage_root_path` ディレクトリをクリーニングした後**、CN ノードを起動します。
+
+   ```Bash
+   ./be/bin/start_cn.sh --daemon
+   ```
+
+ステップ 1 で **cluster_snapshot.yaml** を変更した場合、ノードとストレージボリュームはファイルの情報に基づいて新しいクラスタで再設定されます。
+
+## Appendix
+
+**cluster_snapshot.yaml** のテンプレート:
+
+```Yaml
+# 復元のためにダウンロードされるクラスタスナップショットの情報。
+cluster_snapshot:
+    # スナップショットの URI。
+    # 例 1: s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta/image/automated_cluster_snapshot_1704038400000
+    # 例 2: s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta
+    cluster_snapshot_path: <cluster_snapshot_uri>
+    # スナップショットを保存するストレージボリュームの名前。`storage_volumes` セクションで定義する必要があります。
+    # 注意: 元のクラスタと同一である必要があります。
+    storage_volume_name: my_s3_volume
+
+# [オプション] スナップショットが復元される新しいクラスタのノード情報。
+# このセクションが指定されていない場合、復旧後の新しいクラスタはリーダー FE ノードのみを持ちます。
+# CN ノードは元のクラスタの情報を保持します。
+# 注意: Leader FE ノードをこのセクションに含めないでください。
+
+frontends:
+    # FE ホスト。
+  - host: xxx.xx.xx.x1
+    # FE edit_log_port。
+    edit_log_port: 9010
+    # FE ノードタイプ。有効な値: `follower` (デフォルト) と `observer`。
+    type: follower
+  - host: xxx.xx.xx.x2
+    edit_log_port: 9010
+    type: observer
+
+compute_nodes:
+    # CN ホスト。
+  - host: xxx.xx.xx.x3
+    # CN heartbeat_service_port。
+    heartbeat_service_port: 9050
+  - host: xxx.xx.xx.x4
+    heartbeat_service_port: 9050
+
+# 新しいクラスタのストレージボリュームの情報。クローンされたスナップショットを復元するために使用されます。
+# 注意: ストレージボリュームの名前は元のクラスタと同一である必要があります。
+storage_volumes:
+  # S3 互換ストレージボリュームの例。
+  - name: my_s3_volume
+    type: S3
+    location: s3://defaultbucket/test/
+    comment: my s3 volume
+    properties:
+      - key: aws.s3.region
+        value: us-west-2
+      - key: aws.s3.endpoint
+        value: https://s3.us-west-2.amazonaws.com
+      - key: aws.s3.access_key
+        value: xxxxxxxxxx
+      - key: aws.s3.secret_key
+        value: yyyyyyyyyy
+  # HDFS ストレージボリュームの例。
+  - name: my_hdfs_volume
+    type: HDFS
+    location: hdfs://127.0.0.1:9000/sr/test/
+    comment: my hdfs volume
+    properties:
+      - key: hadoop.security.authentication
+        value: simple
+      - key: username
+        value: starrocks
+```
\ No newline at end of file
diff --git a/docs/ja/administration/management/FE_configuration.md b/docs/ja/administration/management/FE_configuration.md
index 43e00c2ec13436..2f0dc8403b1887 100644
--- a/docs/ja/administration/management/FE_configuration.md
+++ b/docs/ja/administration/management/FE_configuration.md
@@ -758,6 +758,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 説明: レプリケーションのレガシー互換性を有効にするかどうか。StarRocks は古いバージョンと新しいバージョンの間で異なる動作をする可能性があり、クロスクラスタデータ移行中に問題が発生する可能性があります。したがって、データ移行の前にターゲットクラスタでレガシー互換性を有効にし、データ移行が完了した後に無効にする必要があります。`true` はこのモードを有効にすることを示します。
 - 導入バージョン: v3.1.10, v3.2.6
 
+##### automated_cluster_snapshot_interval_seconds
+
+- デフォルト: 600
+- タイプ: Int
+- 単位: 秒
+- 変更可能: はい
+- 説明: 自動クラスタスナップショットのタスクがトリガされる間隔。
+- 導入バージョン: v3.4.2
+
 ### ユーザー、ロール、および権限
 
 ##### privilege_max_total_roles_per_user
diff --git a/docs/zh/administration/cluster_snapshot.md b/docs/zh/administration/cluster_snapshot.md
new file mode 100644
index 00000000000000..75f7fd65d09790
--- /dev/null
+++ b/docs/zh/administration/cluster_snapshot.md
@@ -0,0 +1,199 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_cluster_snapshot_{timestamp}`。
+
+元数据快照存储在 `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` 下。数据快照存储在与原始数据相同的位置。
+
+FE 配置项 `automated_cluster_snapshot_interval_seconds` 控制快照自动化周期。默认值为 1800 秒（30 分钟）。
+
+### 禁用自动化集群快照
+
+使用以下语句禁用自动化集群快照：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+一旦禁用自动化集群快照，系统将自动清除历史快照。
+
+### 查看集群快照
+
+您可以通过查询视图 `information_schema.cluster_snapshots` 来查看最新的集群快照和尚未删除的快照。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| snapshot_type      | 快照的类型。目前仅支持 `automated`。                         |
+| created_time       | 快照创建的时间。                                             |
+| fe_journal_id      | FE 日志的 ID。                                               |
+| starmgr_journal_id | StarManager 日志的 ID。                                      |
+| properties         | 应用于尚不可用的功能。                                       |
+| storage_volume     | 存储快照的存储卷。                                           |
+| storage_path       | 存储快照的存储路径。                                         |
+
+### 查看集群快照任务
+
+您可以查询视图 `information_schema.cluster_snapshot_jobs` 来查看集群快照的任务信息。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| job_id             | 任务的 ID。                                                  |
+| created_time       | 任务创建的时间。                                             |
+| finished_time      | 任务完成的时间。                                             |
+| state              | 任务的状态。有效值：`INITIALIZING`、`SNAPSHOTING`、`FINISHED`、`EXPIRED`、`DELETED` 和 `ERROR`。 |
+| detail_info        | 当前执行阶段的具体进度信息。                                 |
+| error_message      | 任务的错误信息（如果有）。                                   |
+
+### 恢复集群
+
+按照以下步骤使用集群快照恢复集群。
+
+1. **（可选）** 如果存储集群快照的存储位置（存储卷）发生了变化，必须将原始存储路径下的所有文件复制到新路径。为此，您必须修改 Leader FE 节点的 `fe/conf` 目录下的配置文件 **cluster_snapshot.yaml**。有关 **cluster_snapshot.yaml** 的模板，请参见[附录](#附录)。
+
+2. 启动 Leader FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. **清空 `meta` 目录后**，启动其他 FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --helper <leader_ip>:<leader_edit_log_port> --daemon
+   ```
+
+4. **清空 `storage_root_path` 目录后**，启动 CN 节点。
+
+   ```Bash
+   ./be/bin/start_cn.sh --daemon
+   ```
+
+如果您在步骤 1 中修改了 **cluster_snapshot.yaml**，节点和存储卷将在新集群中根据文件中的信息重新配置。
+
+## 附录
+
+**cluster_snapshot.yaml** 模板：
+
+```Yaml
+# 要下载的用于恢复的集群快照的信息。
+cluster_snapshot:
+    # 快照的 URI。
+    # 示例一：s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta/image/automated_cluster_snapshot_1704038400000
+    # 示例二：s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta
+    cluster_snapshot_path: <cluster_snapshot_uri>
+    # 用于存储快照的存储卷名称。您必须在 `storage_volumes` 部分中定义它。
+    # 注意：它必须与原始集群中的名称相同。
+    storage_volume_name: my_s3_volume
+
+# [可选] 要恢复快照的新集群的节点信息。
+# 如果未指定此部分，恢复后的集群将只有 Leader FE 节点，CN 节点将保留原始集群的信息。
+# 注意：请勿在此部分中指定 Leader FE 节点。
+
+frontends:
+    # FE Host。
+  - host: xxx.xx.xx.x1
+    # FE edit_log_port。
+    edit_log_port: 9010
+    # FE 节点类型。有效值：`follower`（默认）和 `observer`。
+    type: follower
+  - host: xxx.xx.xx.x2
+    edit_log_port: 9010
+    type: observer
+
+compute_nodes:
+    # CN Host。
+  - host: xxx.xx.xx.x3
+    # CN heartbeat_service_port。
+    heartbeat_service_port: 9050
+  - host: xxx.xx.xx.x4
+    heartbeat_service_port: 9050
+
+# 新集群中的存储卷信息。用于恢复克隆的快照。
+# 注意：存储卷的名称必须与原始集群中的名称相同。
+storage_volumes:
+  # S3 兼容存储卷示例。
+  - name: my_s3_volume
+    type: S3
+    location: s3://defaultbucket/test/
+    comment: my s3 volume
+    properties:
+      - key: aws.s3.region
+        value: us-west-2
+      - key: aws.s3.endpoint
+        value: https://s3.us-west-2.amazonaws.com
+      - key: aws.s3.access_key
+        value: xxxxxxxxxx
+      - key: aws.s3.secret_key
+        value: yyyyyyyyyy
+  # HDFS 存储卷示例。
+  - name: my_hdfs_volume
+    type: HDFS
+    location: hdfs://127.0.0.1:9000/sr/test/
+    comment: my hdfs volume
+    properties:
+      - key: hadoop.security.authentication
+        value: simple
+      - key: username
+        value: starrocks
+```
\ No newline at end of file
diff --git a/docs/zh/administration/management/FE_configuration.md b/docs/zh/administration/management/FE_configuration.md
index f7d336397656a5..5342113bb951cd 100644
--- a/docs/zh/administration/management/FE_configuration.md
+++ b/docs/zh/administration/management/FE_configuration.md
@@ -1118,6 +1118,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 描述：是否为跨集群数据迁移开启旧版本兼容。新旧版本的集群间可能存在行为差异，从而导致跨集群数据迁移时出现问题。因此在数据迁移前，您需要为目标集群开启旧版本兼容，并在数据迁移完成后关闭。`true` 表示开启兼容。
 - 引入版本：v3.1.10, v3.2.6
 
+##### automated_cluster_snapshot_interval_seconds
+
+- 默认值：600
+- 类型：Int
+- 单位：秒
+- 是否动态：是
+- 描述：自动化集群快照任务的触发间隔。
+- 引入版本：v3.4.2
+
 ### 用户，角色及权限
 
 ##### privilege_max_total_roles_per_user


Reviews:
user: login: wangsimo0
state: DISMISSED
author_association: CONTRIBUTOR
submitted_at: 2025-03-20T08:57:10Z
user: login: xiangguangyxg
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-20T11:03:36Z
user: login: wangsimo0
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-03-21T08:44:47Z
user: login: yingtingdong
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-03-21T08:46:48Z

Review comments:
diff_hunk: @@ -0,0 +1,198 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_snapshot_{timestamp}`。
path: docs/zh/administration/cluster_snapshot.md
user: login: xiangguangyxg
body: automated_cluster_snapshot_{timestamp}
created_at: 2025-03-20T10:49:42Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,198 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_snapshot_{timestamp}`。
+
+元数据快照存储在 `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` 下。数据快照存储在与原始数据相同的位置。
+
+FE 配置项 `automated_cluster_snapshot_interval_seconds` 控制快照自动化周期。默认值为 1800 秒（30 分钟）。
+
+### 禁用自动化集群快照
+
+使用以下语句禁用自动化集群快照：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+一旦禁用自动化集群快照，系统将自动清除历史快照。
+
+### 查看集群快照
+
+您可以通过查询视图 `information_schema.cluster_snapshots` 来查看最新的集群快照和尚未删除的快照。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| snapshot_type      | 快照的类型。目前仅支持 `automated`。                         |
+| created_time       | 快照创建的时间。                                             |
+| fe_journal_id      | FE 日志的 ID。                                               |
+| starmgr_journal_id | StarManager 日志的 ID。                                      |
+| properties         | 应用于尚不可用的功能。                                       |
+| storage_volume     | 存储快照的存储卷。                                           |
+| storage_path       | 存储快照的存储路径。                                         |
+
+### 查看集群快照任务
+
+您可以查询视图 `information_schema.cluster_snapshot_jobs` 来查看集群快照的任务信息。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| job_id             | 任务的 ID。                                                  |
+| created_time       | 任务创建的时间。                                             |
+| finished_time      | 任务完成的时间。                                             |
+| state              | 任务的状态。有效值：`INITIALIZING`、`SNAPSHOTING`、`FINISHED`、`EXPIRED`、`DELETED` 和 `ERROR`。 |
+| detail_info        | 当前执行阶段的具体进度信息。                                 |
+| error_message      | 任务的错误信息（如果有）。                                   |
+
+### 恢复集群
+
+按照以下步骤使用集群快照恢复集群。
+
+1. **（可选）** 如果存储集群快照的存储位置（存储卷）发生了变化，必须将原始存储路径下的所有文件复制到新路径。为此，您必须在所有 FE 节点的 **fe/conf** 目录下放置配置文件 **cluster_snapshot.yaml**。有关 **cluster_snapshot.yaml** 的模板，请参见[附录](#附录)。
+
+2. 启动 Leader FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. 启动其他 FE 节点。
path: docs/zh/administration/cluster_snapshot.md
user: login: xiangguangyxg
body: 清空 meta 目录后启动其它 FE 节点
created_at: 2025-03-20T10:50:52Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,198 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_snapshot_{timestamp}`。
+
+元数据快照存储在 `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` 下。数据快照存储在与原始数据相同的位置。
+
+FE 配置项 `automated_cluster_snapshot_interval_seconds` 控制快照自动化周期。默认值为 1800 秒（30 分钟）。
+
+### 禁用自动化集群快照
+
+使用以下语句禁用自动化集群快照：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+一旦禁用自动化集群快照，系统将自动清除历史快照。
+
+### 查看集群快照
+
+您可以通过查询视图 `information_schema.cluster_snapshots` 来查看最新的集群快照和尚未删除的快照。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| snapshot_type      | 快照的类型。目前仅支持 `automated`。                         |
+| created_time       | 快照创建的时间。                                             |
+| fe_journal_id      | FE 日志的 ID。                                               |
+| starmgr_journal_id | StarManager 日志的 ID。                                      |
+| properties         | 应用于尚不可用的功能。                                       |
+| storage_volume     | 存储快照的存储卷。                                           |
+| storage_path       | 存储快照的存储路径。                                         |
+
+### 查看集群快照任务
+
+您可以查询视图 `information_schema.cluster_snapshot_jobs` 来查看集群快照的任务信息。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| job_id             | 任务的 ID。                                                  |
+| created_time       | 任务创建的时间。                                             |
+| finished_time      | 任务完成的时间。                                             |
+| state              | 任务的状态。有效值：`INITIALIZING`、`SNAPSHOTING`、`FINISHED`、`EXPIRED`、`DELETED` 和 `ERROR`。 |
+| detail_info        | 当前执行阶段的具体进度信息。                                 |
+| error_message      | 任务的错误信息（如果有）。                                   |
+
+### 恢复集群
+
+按照以下步骤使用集群快照恢复集群。
+
+1. **（可选）** 如果存储集群快照的存储位置（存储卷）发生了变化，必须将原始存储路径下的所有文件复制到新路径。为此，您必须在所有 FE 节点的 **fe/conf** 目录下放置配置文件 **cluster_snapshot.yaml**。有关 **cluster_snapshot.yaml** 的模板，请参见[附录](#附录)。
+
+2. 启动 Leader FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. 启动其他 FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --helper <leader_ip>:<leader_edit_log_port> --daemon
+   ```
+
+4. **清除本地缓存后** 启动 CN 节点。
path: docs/zh/administration/cluster_snapshot.md
user: login: xiangguangyxg
body: ```suggestion
4. **清空 storage_root_path 对应的目录后** 启动 CN 节点。
```
created_at: 2025-03-20T10:52:25Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,198 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_snapshot_{timestamp}`。
+
+元数据快照存储在 `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` 下。数据快照存储在与原始数据相同的位置。
+
+FE 配置项 `automated_cluster_snapshot_interval_seconds` 控制快照自动化周期。默认值为 1800 秒（30 分钟）。
+
+### 禁用自动化集群快照
+
+使用以下语句禁用自动化集群快照：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+一旦禁用自动化集群快照，系统将自动清除历史快照。
+
+### 查看集群快照
+
+您可以通过查询视图 `information_schema.cluster_snapshots` 来查看最新的集群快照和尚未删除的快照。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| snapshot_type      | 快照的类型。目前仅支持 `automated`。                         |
+| created_time       | 快照创建的时间。                                             |
+| fe_journal_id      | FE 日志的 ID。                                               |
+| starmgr_journal_id | StarManager 日志的 ID。                                      |
+| properties         | 应用于尚不可用的功能。                                       |
+| storage_volume     | 存储快照的存储卷。                                           |
+| storage_path       | 存储快照的存储路径。                                         |
+
+### 查看集群快照任务
+
+您可以查询视图 `information_schema.cluster_snapshot_jobs` 来查看集群快照的任务信息。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| job_id             | 任务的 ID。                                                  |
+| created_time       | 任务创建的时间。                                             |
+| finished_time      | 任务完成的时间。                                             |
+| state              | 任务的状态。有效值：`INITIALIZING`、`SNAPSHOTING`、`FINISHED`、`EXPIRED`、`DELETED` 和 `ERROR`。 |
+| detail_info        | 当前执行阶段的具体进度信息。                                 |
+| error_message      | 任务的错误信息（如果有）。                                   |
+
+### 恢复集群
+
+按照以下步骤使用集群快照恢复集群。
+
+1. **（可选）** 如果存储集群快照的存储位置（存储卷）发生了变化，必须将原始存储路径下的所有文件复制到新路径。为此，您必须在所有 FE 节点的 **fe/conf** 目录下放置配置文件 **cluster_snapshot.yaml**。有关 **cluster_snapshot.yaml** 的模板，请参见[附录](#附录)。
path: docs/zh/administration/cluster_snapshot.md
user: login: xiangguangyxg
body: 您必须修改 Leader FE 节点的 **fe/conf** 目录下的配置文件 **cluster_snapshot.yaml**。
created_at: 2025-03-20T10:56:01Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,198 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_snapshot_{timestamp}`。
+
+元数据快照存储在 `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` 下。数据快照存储在与原始数据相同的位置。
+
+FE 配置项 `automated_cluster_snapshot_interval_seconds` 控制快照自动化周期。默认值为 1800 秒（30 分钟）。
+
+### 禁用自动化集群快照
+
+使用以下语句禁用自动化集群快照：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+一旦禁用自动化集群快照，系统将自动清除历史快照。
+
+### 查看集群快照
+
+您可以通过查询视图 `information_schema.cluster_snapshots` 来查看最新的集群快照和尚未删除的快照。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| snapshot_type      | 快照的类型。目前仅支持 `automated`。                         |
+| created_time       | 快照创建的时间。                                             |
+| fe_journal_id      | FE 日志的 ID。                                               |
+| starmgr_journal_id | StarManager 日志的 ID。                                      |
+| properties         | 应用于尚不可用的功能。                                       |
+| storage_volume     | 存储快照的存储卷。                                           |
+| storage_path       | 存储快照的存储路径。                                         |
+
+### 查看集群快照任务
+
+您可以查询视图 `information_schema.cluster_snapshot_jobs` 来查看集群快照的任务信息。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| job_id             | 任务的 ID。                                                  |
+| created_time       | 任务创建的时间。                                             |
+| finished_time      | 任务完成的时间。                                             |
+| state              | 任务的状态。有效值：`INITIALIZING`、`SNAPSHOTING`、`FINISHED`、`EXPIRED`、`DELETED` 和 `ERROR`。 |
+| detail_info        | 当前执行阶段的具体进度信息。                                 |
+| error_message      | 任务的错误信息（如果有）。                                   |
+
+### 恢复集群
+
+按照以下步骤使用集群快照恢复集群。
+
+1. **（可选）** 如果存储集群快照的存储位置（存储卷）发生了变化，必须将原始存储路径下的所有文件复制到新路径。为此，您必须在所有 FE 节点的 **fe/conf** 目录下放置配置文件 **cluster_snapshot.yaml**。有关 **cluster_snapshot.yaml** 的模板，请参见[附录](#附录)。
+
+2. 启动 Leader FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. 启动其他 FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --helper <leader_ip>:<leader_edit_log_port> --daemon
+   ```
+
+4. **清除本地缓存后** 启动 CN 节点。
+
+   ```Bash
+   ./be/bin/start_cn.sh --daemon
+   ```
+
+如果您在步骤 1 中添加了 **cluster_snapshot.yaml**，节点和存储卷将在新集群中根据文件中的信息重新配置。原始集群的信息将被自动删除或替换。
path: docs/zh/administration/cluster_snapshot.md
user: login: xiangguangyxg
body: ```suggestion
如果您在步骤 1 中修改了 **cluster_snapshot.yaml**，节点和存储卷将在新集群中根据文件中的信息重新配置。
```
created_at: 2025-03-20T10:58:46Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,198 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_snapshot_{timestamp}`。
+
+元数据快照存储在 `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` 下。数据快照存储在与原始数据相同的位置。
+
+FE 配置项 `automated_cluster_snapshot_interval_seconds` 控制快照自动化周期。默认值为 1800 秒（30 分钟）。
+
+### 禁用自动化集群快照
+
+使用以下语句禁用自动化集群快照：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+一旦禁用自动化集群快照，系统将自动清除历史快照。
+
+### 查看集群快照
+
+您可以通过查询视图 `information_schema.cluster_snapshots` 来查看最新的集群快照和尚未删除的快照。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| snapshot_type      | 快照的类型。目前仅支持 `automated`。                         |
+| created_time       | 快照创建的时间。                                             |
+| fe_journal_id      | FE 日志的 ID。                                               |
+| starmgr_journal_id | StarManager 日志的 ID。                                      |
+| properties         | 应用于尚不可用的功能。                                       |
+| storage_volume     | 存储快照的存储卷。                                           |
+| storage_path       | 存储快照的存储路径。                                         |
+
+### 查看集群快照任务
+
+您可以查询视图 `information_schema.cluster_snapshot_jobs` 来查看集群快照的任务信息。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| job_id             | 任务的 ID。                                                  |
+| created_time       | 任务创建的时间。                                             |
+| finished_time      | 任务完成的时间。                                             |
+| state              | 任务的状态。有效值：`INITIALIZING`、`SNAPSHOTING`、`FINISHED`、`EXPIRED`、`DELETED` 和 `ERROR`。 |
+| detail_info        | 当前执行阶段的具体进度信息。                                 |
+| error_message      | 任务的错误信息（如果有）。                                   |
+
+### 恢复集群
+
+按照以下步骤使用集群快照恢复集群。
+
+1. **（可选）** 如果存储集群快照的存储位置（存储卷）发生了变化，必须将原始存储路径下的所有文件复制到新路径。为此，您必须在所有 FE 节点的 **fe/conf** 目录下放置配置文件 **cluster_snapshot.yaml**。有关 **cluster_snapshot.yaml** 的模板，请参见[附录](#附录)。
+
+2. 启动 Leader FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. 启动其他 FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --helper <leader_ip>:<leader_edit_log_port> --daemon
+   ```
+
+4. **清除本地缓存后** 启动 CN 节点。
+
+   ```Bash
+   ./be/bin/start_cn.sh --daemon
+   ```
+
+如果您在步骤 1 中添加了 **cluster_snapshot.yaml**，节点和存储卷将在新集群中根据文件中的信息重新配置。原始集群的信息将被自动删除或替换。
+
+## 附录
+
+**cluster_snapshot.yaml** 模板：
+
+```Yaml
+# 要下载的用于恢复的集群快照的信息。
+cluster_snapshot:
+    # 快照的 URI。
+    # 示例：s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta/image/automated_cluster_snapshot_1704038400000
path: docs/zh/administration/cluster_snapshot.md
user: login: xiangguangyxg
body: ```suggestion
    # 示例1：s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta/image/automated_cluster_snapshot_1704038400000
    # 示例2：s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta
```
created_at: 2025-03-20T10:59:25Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,198 @@
+---
+displayed_sidebar: docs
+sidebar_label: 集群快照
+---
+
+# 自动化集群快照
+
+本文介绍如何在存算分离集群上启用自动化集群快照以实现灾难恢复。
+
+此功能从 v3.4.2 开始支持，仅在存算分离集群上可用。
+
+## 概述
+
+存算分离集群的灾难恢复基本思想是确保完整的集群状态（包括数据和元数据）存储在对象存储中。这样，如果集群发生故障，只要数据和元数据保持完整，就可以从对象存储中恢复。此外，云提供商提供的备份和跨区域复制等功能可以用于实现远程恢复和跨区域灾难恢复。
+
+在存算分离集群中，CN 状态（数据）存储在对象存储中，但 FE 状态（元数据）仍然存储于本地。为了确保对象存储中包含所有用于恢复的集群状态，StarRocks 现在支持在对象存储中自动化集群快照，包括数据和元数据。
+
+### 术语
+
+- **集群快照**
+
+  集群快照指的是在某一时刻的集群状态快照。它包含集群中的所有对象，如 Catalog、数据库、表、用户和权限、导入任务等。它不包括所有外部依赖对象，如 External Catalog 的配置文件和本地 UDF JAR 包。
+
+- **自动化集群快照**
+
+  系统自动维护一个紧随最新集群状态的快照。历史快照将在最新快照创建后立即被删除，始终只保留一个快照。目前，自动化集群快照的任务仅能由系统触发，不支持手动创建快照。
+
+- **集群恢复**
+
+  从快照中恢复集群。
+
+## 使用方法
+
+### 启用自动化集群快照
+
+自动化集群快照默认禁用。
+
+您需要使用以下语句启用此功能：
+
+语法：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT ON
+[STORAGE VOLUME <storage_volume_name>]
+```
+
+参数：
+
+`storage_volume_name`: 指定用于存储快照的存储卷。如果未指定此参数，将使用默认存储卷。
+
+每次 FE 在完成元数据 CheckPoint 后创建新的元数据 Image 时，会自动创建一个快照。快照的名称由系统生成，格式为 `automated_snapshot_{timestamp}`。
+
+元数据快照存储在 `/{storage_volume_locations}/{service_id}/meta/image/automated_cluster_snapshot_timestamp` 下。数据快照存储在与原始数据相同的位置。
+
+FE 配置项 `automated_cluster_snapshot_interval_seconds` 控制快照自动化周期。默认值为 1800 秒（30 分钟）。
+
+### 禁用自动化集群快照
+
+使用以下语句禁用自动化集群快照：
+
+```SQL
+ADMIN SET AUTOMATED CLUSTER SNAPSHOT OFF
+```
+
+一旦禁用自动化集群快照，系统将自动清除历史快照。
+
+### 查看集群快照
+
+您可以通过查询视图 `information_schema.cluster_snapshots` 来查看最新的集群快照和尚未删除的快照。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshots;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| snapshot_type      | 快照的类型。目前仅支持 `automated`。                         |
+| created_time       | 快照创建的时间。                                             |
+| fe_journal_id      | FE 日志的 ID。                                               |
+| starmgr_journal_id | StarManager 日志的 ID。                                      |
+| properties         | 应用于尚不可用的功能。                                       |
+| storage_volume     | 存储快照的存储卷。                                           |
+| storage_path       | 存储快照的存储路径。                                         |
+
+### 查看集群快照任务
+
+您可以查询视图 `information_schema.cluster_snapshot_jobs` 来查看集群快照的任务信息。
+
+```SQL
+SELECT * FROM information_schema.cluster_snapshot_jobs;
+```
+
+返回：
+
+| 字段                | 描述                                                         |
+| ------------------ | ------------------------------------------------------------ |
+| snapshot_name      | 快照的名称。                                                 |
+| job_id             | 任务的 ID。                                                  |
+| created_time       | 任务创建的时间。                                             |
+| finished_time      | 任务完成的时间。                                             |
+| state              | 任务的状态。有效值：`INITIALIZING`、`SNAPSHOTING`、`FINISHED`、`EXPIRED`、`DELETED` 和 `ERROR`。 |
+| detail_info        | 当前执行阶段的具体进度信息。                                 |
+| error_message      | 任务的错误信息（如果有）。                                   |
+
+### 恢复集群
+
+按照以下步骤使用集群快照恢复集群。
+
+1. **（可选）** 如果存储集群快照的存储位置（存储卷）发生了变化，必须将原始存储路径下的所有文件复制到新路径。为此，您必须在所有 FE 节点的 **fe/conf** 目录下放置配置文件 **cluster_snapshot.yaml**。有关 **cluster_snapshot.yaml** 的模板，请参见[附录](#附录)。
+
+2. 启动 Leader FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --cluster_snapshot --daemon
+   ```
+
+3. 启动其他 FE 节点。
+
+   ```Bash
+   ./fe/bin/start_fe.sh --helper <leader_ip>:<leader_edit_log_port> --daemon
+   ```
+
+4. **清除本地缓存后** 启动 CN 节点。
+
+   ```Bash
+   ./be/bin/start_cn.sh --daemon
+   ```
+
+如果您在步骤 1 中添加了 **cluster_snapshot.yaml**，节点和存储卷将在新集群中根据文件中的信息重新配置。原始集群的信息将被自动删除或替换。
+
+## 附录
+
+**cluster_snapshot.yaml** 模板：
+
+```Yaml
+# 要下载的用于恢复的集群快照的信息。
+cluster_snapshot:
+    # 快照的 URI。
+    # 示例：s3://defaultbucket/test/f7265e80-631c-44d3-a8ac-cf7cdc7adec811019/meta/image/automated_cluster_snapshot_1704038400000
+    cluster_snapshot_path: <cluster_snapshot_uri>
+    # 用于存储快照的存储卷名称。您必须在 `storage_volumes` 部分中定义它。
+    # 注意：它必须与原始集群中的名称相同。
+    storage_volume_name: my_s3_volume
+
+# [可选] 要恢复快照的新集群的节点信息。
+# 如果未指定此部分，恢复后将保留原始集群的节点信息。
path: docs/zh/administration/cluster_snapshot.md
user: login: xiangguangyxg
body: ```suggestion
# 如果未指定此部分，恢复后 FE 将只有 Leader 节点，CN 将保留原始集群的节点信息。
```
created_at: 2025-03-20T11:01:08Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1118,6 +1118,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 描述：是否为跨集群数据迁移开启旧版本兼容。新旧版本的集群间可能存在行为差异，从而导致跨集群数据迁移时出现问题。因此在数据迁移前，您需要为目标集群开启旧版本兼容，并在数据迁移完成后关闭。`true` 表示开启兼容。
 - 引入版本：v3.1.10, v3.2.6
 
+##### automated_cluster_snapshot_interval_seconds
+
+- 默认值：1800
path: docs/zh/administration/management/FE_configuration.md
user: login: xiangguangyxg
body: ```suggestion
- 默认值：600
```
created_at: 2025-03-20T11:01:53Z
author_association: CONTRIBUTOR

PR comments:
user: login: github-actions[bot]
created_at: 2025-03-21T07:55:33Z
body: #### [Java-Extensions Incremental Coverage Report]


:white_check_mark: **pass** : 0 / 0 (0%)




author_association: CONTRIBUTOR
user: login: github-actions[bot]
created_at: 2025-03-21T07:55:36Z
body: #### [FE Incremental Coverage Report]


:white_check_mark: **pass** : 0 / 0 (0%)




author_association: CONTRIBUTOR
user: login: github-actions[bot]
created_at: 2025-03-21T07:56:30Z
body: #### [BE Incremental Coverage Report]


:white_check_mark: **pass** : 0 / 0 (0%)




author_association: CONTRIBUTOR
user: login: EsoragotoSpirit
created_at: 2025-03-21T08:40:15Z
body: ignore backport check: branch-3.5
author_association: CONTRIBUTOR
user: login: github-actions[bot]
created_at: 2025-03-21T08:47:13Z
body: @Mergifyio backport branch-3.4
author_association: CONTRIBUTOR
user: login: mergify[bot]
created_at: 2025-03-21T08:47:21Z
body: > backport branch-3.4

#### ✅ Backports have been created

<details>

* [#57165 [Doc] Doc for Automated Cluster Snapshot (backport #57021)](https://github.com/StarRocks/starrocks/pull/57165) has been created for branch `branch-3.4`

</details>


<!---
DO NOT EDIT
-*- Mergify Payload -*-
{"command": "backport branch-3.4", "conclusion": "success", "action_is_running": true}
-*- Mergify Payload End -*-
-->
author_association: CONTRIBUTOR