大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:DROP SNAPSHOT

· 52CE 我爱测

从仓库中删除数据快照,同时删除该快照在远端存储系统中的数据文件。与仅解除 StarRocks 中映射关系的 DROP REPOSITORY 不同,该语句会删除备份数据本身。

DROP SNAPSHOT

从仓库中删除数据快照,同时删除该快照在远端存储系统中的数据文件。与仅解除 StarRocks 中映射关系的 DROP REPOSITORY 不同,该语句会删除备份数据本身。

删除不可撤销。快照被删除后,无法再通过 RESTORE 恢复。

该语句自 v4.2.0 起支持。

  • 当有 BACKUP 作业正在写入该快照,或有 RESTORE 作业正在读取该快照时,无法删除。
  • 当快照所在仓库为只读时,无法删除。

权限要求

用户需拥有 System 级别的 REPOSITORY 权限。

GRANT REPOSITORY ON SYSTEM TO ROLE <role_name>;

语法

DROP SNAPSHOT <snapshot_name> ON <repository_name> [FORCE]

参数说明

参数 说明
snapshot_name 待删除快照的名称。
repository_name 快照所属仓库的名称。
FORCE 跳过创建集群的校验直接删除。参见下文。

快照归属

每个快照都记录了创建它的集群 ID。不带 FORCE 时,StarRocks 仅在该 ID 与当前集群一致时才执行删除。当前集群的 ID 可通过 SHOW SNAPSHOT 的 ClusterId 列以及 SHOW FRONTENDS 的 ClusterId 列查看。

以下情况该语句会报错:

  • 快照由共用同一仓库的其他集群创建;
  • 快照在 v4.2.0 之前创建,因而未记录集群 ID;
  • 快照元数据不可读,包括备份仍在进行中,以及备份中断后残留的情况。

如需删除上述快照,请使用 FORCE。删除非本集群创建的快照会移除其他集群可能仍在依赖的数据,使用前请确认该数据确实可以删除。

示例

示例一:从仓库 example_repo 中删除快照 backup1。

DROP SNAPSHOT backup1 ON example_repo;

示例二:从仓库 example_repo 中删除并非由本集群创建的快照 legacy_backup。

DROP SNAPSHOT legacy_backup ON example_repo FORCE;

相关文档

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。