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 <source_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 <source_name> String   Optional

The name of the source that you want to refer to. If not specified, the current source 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 mySource

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