Skip to main content
Version: 24.3.x

DROP BRANCH Preview

Remove a branch from a Nessie source.

Syntax
DROP BRANCH [ IF EXISTS ] <branch_name>
{ AT COMMIT <commit_hash> | FORCE }
[ IN <source_name> ]

Parameters

[ IF EXISTS ] Optional

When included, the command succeeds regardless of whether the branch existed. If this clause is not specified, the command fails if the branch to be dropped does not exist.


<branch_name> String

The name of the branch that you are dropping.


AT COMMIT <commit_hash> | FORCE String

Use the AT COMMIT parameter when you want to specify the exact commit hash that the branch is expected to be at. This is helpful to prevent the branch from being dropped if it was modified unexpectedly. Commit hashes must be enclosed in double quotes (for example, “ff2fe50fef5a030c4fc8e61b252bdc33c72e2b6f929d813833d998b8368302e2”). Use the FORCE parameter when you want to drop the branch even if it has been changed.


IN <source_name> String   Optional

The name of the source containing the branch that you want to drop. If not specified, the current source in the query context is used.

Examples

Drop a branch at the specified commit
DROP BRANCH myBranch
AT COMMIT "ff2fe50fef5a030c4fc8e61b252bdc33c72e2b6f929d813833d998b8368302e2"
Use the FORCE parameter to drop the specified branch
DROP BRANCH myBranch
FORCE