UNSET TAG

Removes a tag assignment from a table, view, or column.

Category: catalogDeltaForge extension

Syntax

UNSET TAG <tag_name> ON TABLE|VIEW|COLUMN <object_name>

Description

## Overview Removes a tag assignment from a catalog object (table, view, or column). The tag definition itself is not affected; only the assignment linking the tag to the specified object is removed. Other objects that carry the same tag are not changed. ## Behavior - If the tag is currently assigned to the specified object, the assignment is removed and a confirmation message is returned. - If the tag is not assigned to the object, the command succeeds without error (idempotent behavior). - Column references require four-part naming: zone.schema.table.column. - The command routes through the control plane catalog API. A valid catalog router connection is required. - UNSET TAG does not affect propagated assignments on child objects. If a tag was propagated from a table to its columns, unsetting the tag on the table does not automatically unset it on the columns. Each column assignment must be removed individually. ## Compatibility UNSET TAG is a DeltaForge extension. It is the inverse of SET TAG and removes a single tag assignment from a catalog object.

Examples

-- Remove a PII tag from a table
UNSET TAG pii_type ON TABLE gold.customer.emails;
-- Remove an environment tag from a view
UNSET TAG environment ON VIEW gold.analytics.daily_metrics;
-- Remove a tag from a specific column
UNSET TAG pii_type ON COLUMN gold.customer.users.social_security_number;
-- Remove all governance tags from a decommissioned table
UNSET TAG pii_type ON TABLE bronze.raw.deprecated_events;
UNSET TAG data_owner ON TABLE bronze.raw.deprecated_events;
UNSET TAG sensitivity ON TABLE bronze.raw.deprecated_events;

Pitfalls

See Also

Open in interactive docs →   DeltaForge home →