diff --git a/docs/content/engines/spark.md b/docs/content/engines/spark.md index 113da01bba78..946ab1415ae3 100644 --- a/docs/content/engines/spark.md +++ b/docs/content/engines/spark.md @@ -576,6 +576,48 @@ s CALL sys.expire_snapshots(table => 'default.T', retain_max => 10) + + create_tag + + To create a tag based on given snapshot. Arguments: +
  • table: the target table identifier. Cannot be empty.
  • +
  • tag: name of the new tag. Cannot be empty.
  • +
  • snapshot(Long): id of the snapshot which the new tag is based on.
  • + + CALL sys.create_tag(table => 'default.T', tag => 'my_tag', snapshot => 10) + + + delete_tag + + To delete a tag. Arguments: +
  • table: the target table identifier. Cannot be empty.
  • +
  • tag: name of the tag to be deleted.
  • + + CALL sys.delete_tag(table => 'default.T', tag => 'my_tag') + + + rollback + + To rollback to a specific version of target table. Argument: +
  • table: the target table identifier. Cannot be empty.
  • +
  • version: id of the snapshot or name of tag that will roll back to.
  • + + + CALL sys.rollback(table => 'default.T', version => 'my_tag')
    + CALL sys.rollback(table => 'default.T', version => 10) + + + + remove_orphan_files + + To remove the orphan data files and metadata files. Arguments: +
  • table: the target table identifier. Cannot be empty.
  • +
  • older_than: to avoid deleting newly written files, this procedure only deletes orphan files older than 1 day by default. This argument can modify the interval.
  • + + + CALL sys.remove_orphan_files(table => 'default.T', older_than => '2023-10-31 12:00:00') + +