Skip to main content

ALTER BRANCH

Change the reference that the branch head points to.

Syntax
ALTER BRANCH <branch_name>
ASSIGN { REF[ERENCE] | BRANCH | TAG | COMMIT } <reference_name>
[ 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 } <reference_name> 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