文档首页/ MapReduce服务 MRS/ 组件操作指南（LTS版）/ 使用Iceberg（MRS 3.6.0.1及之后版本）/ 基于Spark使用Iceberg/ Iceberg DDL语法说明/ Branch
更新时间：2026-06-11 GMT+08:00
查看PDF
分享

Branch

前提条件

执行Branch相关操作前，需执行以下命令设置“write.wap.enabled”为“true”：

ALTER TABLE prod.db.table SET TBLPROPERTIES ( 'write.wap.enabled'='true');

基本语法

  • CREATE BRANCH

    可通过CREATE BRANCH语句创建分支，该语句支持以下选项：

    • IF NOT EXISTS：如果分支已存在，操作不会失败。
    • CREATE OR REPLACE：如果分支已存在，则更新该分支。
    • 在特定快照处创建分支。
    • 创建具有指定保留期的分支：
      • 示例一： 
        ALTER TABLE prod.db.sample CREATE BRANCH audit_branch;
      • 示例二： 
        ALTER TABLE prod.db.sample CREATE BRANCH IF NOT EXISTS audit_branch;
      • 示例三： 
        ALTER TABLE prod.db.sample CREATE OR REPLACE BRANCH audit_branch;
  • REPLACE BRANCH

    可通过REPLACE BRANCH语句更新分支所引用的快照，同时也可更新其保留期：

    ALTER TABLE prod.db.sample REPLACE BRANCH audit_branch AS OF VERSION {current-snapshot-id} RETAIN 60 DAYS;
  • DROP BRANCH

    可通过DROP BRANCH语句删除分支：

    ALTER TABLE prod.db.sample DROP BRANCH audit_branch;

相关文档