Dremio Cloud
Dremio Software
 
On this page

    ALTER TAG preview

    Change the reference that the tag points to.

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

    Parameters

    <tag_name>

    String

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

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

    String

    Specifies a reference to assign a tag from.

    • REF: Identifies a reference, which can be a branch, another tag, or a commit.

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

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

    • COMMIT: Identifies a commit reference where the specified tag 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 assign a tag. If not specified, the current Arctic catalog in the query context is used.

    Examples

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