Dremio Cloud
Dremio Software
 
On this page

    ALTER BRANCH preview

    Change the reference that the branch head points to.

    Syntax 
    ALTER BRANCH <branch_name>
  ASSIGN { REF[ERENCE] | BRANCH | TAG | COMMIT } <identifier>
  [ IN <catalog_name> ]

    Parameters

    <branch_name>

    String

    The name of the branch that you are assigning a new reference to.

    ASSIGN { REF[ERENCE] | BRANCH | TAG | COMMIT } <identifier>

    String

    Specifies the reference that will be assigned as the new branch head.

    • REF: Identifies a new reference where the specified branch is assigned to, which can be another branch, a tag, or a commit.

    • BRANCH: Identifies a branch reference where the specified branch is assigned to.

    • TAG: Identifies a tag reference where the specified branch is assigned to.

    • COMMIT: Identifies a reference where the specified branch is assigned to. Commit hashes must be enclosed in double quotes (for example, “ff2fe50fef5a030c4fc8e61b252bdc33c72e2b6f929d813833d998b8368302e2”).

    IN <catalog_name>

    String

    Optional

    The name of the Arctic catalog that you want to refer to. If not specified, the current Arctic catalog in the query context is used.

    Examples

    Assign the branch head to a specific commit 
    ALTER BRANCH myBranch
  ASSIGN COMMIT "c7a79c74adf76649e643354c34ed69abfee5a3b070ef68cbe782a072b0a418ba"
    Assign the branch head to a specific branch 
    ALTER BRANCH myBranch
  ASSIGN BRANCH anotherBranch
  IN myCatalog
    Assign the branch head to a specific tag 
    ALTER BRANCH myBranch
  ASSIGN TAG myTag
    Assign the branch head to a specific reference 
    ALTER BRANCH myBranch
  ASSIGN REF tag2