Skip to main content
Last updated on

SHOW GOVERNED TAGS

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

Lists all governed tags in the account.

Syntax​

SHOW GOVERNED TAGS [ [ LIKE ] regex_pattern ]

Parameters​

  • regex_pattern

    Optional. A regular expression pattern used to filter the results by tag key. Only governed tags whose tag key matches the pattern are returned.

Result​

Returns a result table with the following columns:

  • Tag Key STRING NOT NULL: The tag key.
  • Description STRING: The description, if set.
  • Values STRING: The allowed values, if defined.
  • Create Time STRING: The timestamp when the governed tag was created. NULL for system-defined tags.
  • Update Time STRING: The timestamp when the governed tag was last updated. NULL for system-defined tags.

Examples​

SQL
-- List all governed tags in the account.
> SHOW GOVERNED TAGS;
  Tag Key  Description       Values       Create Time                    Update Time
  -------  ----------------  -----------  -----------------------------  -----------------------------
  isPii    If contains PII   true, false  2026-01-20T03:42:57.765+00:00  2026-01-20T03:42:57.765+00:00

-- List governed tags matching a pattern.
> SHOW GOVERNED TAGS LIKE 'pii*';