Iceberg表Snapshot保留属性不生效，仅存单个快照求助

• 快照过期规则未触发执行
  history.expire.min-snapshots-to-keep仅定义了快照保留的最小数量规则，但Iceberg不会自动触发快照清理/保留逻辑，需要主动执行过期操作：

  • 通过Iceberg API调用expireSnapshots()方法，明确指定保留规则；
  • 若使用Spark、Flink等计算引擎，可通过对应SQL命令触发，比如Spark中执行CALL system.expire_snapshots('db.table', min_snapshots_to_keep => 6)；
  • 建议配置定时任务定期执行快照过期操作，确保规则持续生效。

• 存在冲突的过期参数配置
  检查是否设置了以下可能覆盖保留规则的参数：

  • history.expire.max-snapshots-to-keep：如果该参数被设为1，会强制限制最大保留快照数为1，即使min-snapshots-to-keep设为6也无法生效；
  • history.expire.max-age-ms：若该参数设置过小（比如仅保留1小时内的快照），且表中只有1个快照在有效期内，最终只会保留这1个快照。

• 表实际生成的快照数量不足
  确认表的快照生成记录：如果表仅执行过一次创建或写入操作，自然只有1个快照，此时配置的“保留6个”只是规则上限，没有足够的快照可以保留。可通过执行写入、更新等操作生成新快照后再检查。

• 配置未正确应用到表属性
  验证表的实际属性是否生效：

  • 执行DESCRIBE EXTENDED <your_table_name>命令查看表属性列表，确认history.expire.min-snapshots-to-keep是否存在且值为6；
  • 确保配置是通过ALTER TABLE <table> SET TBLPROPERTIES ('history.expire.min-snapshots-to-keep'='6')设置的表永久属性，而非会话级临时配置（会话级配置在会话结束后会失效）。

内容的提问来源于stack exchange，提问作者Agrawal Shraddha