Share via

ALTER GOVERNED TAG

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 18.1 and above check marked yes Unity Catalog only

Alters the description or the set of allowed values for a governed tag.

To execute this statement, you must have the MANAGE permission on the governed tag.

Syntax

ALTER GOVERNED TAG tag_key { SET DESCRIPTION description | SET VALUES ( value_name [, ...] ) }

Parameters

  • tag_key

    The tag key of an existing governed tag in the account. If there is no governed tag with this tag key, Azure Databricks returns a NOT_FOUND error.

  • SET DESCRIPTION description

    Updates the description for the governed tag. description is a STRING literal.

  • SET VALUES ( value_name [, ...] )

    Updates the allowed values for the governed tag. This operation is declarative, meaning the provided list replaces the existing allowed values entirely. Any previously defined values not included in the new list are removed.

    • value_name

      A STRING literal. The name for an allowed value. Case sensitive.

Examples

-- Remove all allowed values, making the tag key-only.
> ALTER GOVERNED TAG isPii SET VALUES ();

-- Replace the allowed values list.
> ALTER GOVERNED TAG sensitivity_level SET VALUES ('low', 'medium', 'high');

-- Update the description.
> ALTER GOVERNED TAG pii SET DESCRIPTION 'Indicates what kind of personal identifiable information the asset contains';
  • Last updated on