Skip to main content
Last updated on

DESCRIBE GOVERNED TAG

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

Returns the metadata of an existing governed tag.

Syntax​

{ DESC | DESCRIBE } GOVERNED TAG tag_key [ AS JSON ]

Parameters​

  • tag_key

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

  • AS JSON

    Optional. Returns the governed tag metadata as a JSON string instead of a formatted report.

Result​

Returns a formatted report with the following fields:

  • Tag Key: The tag key.
  • Id: The unique identifier of the governed tag.
  • Description: The description, if set.
  • Values: The allowed values, if defined.
  • Create Time: The timestamp when the governed tag was created.
  • Update Time: The timestamp when the governed tag was last updated.

Examples​

SQL
> DESCRIBE GOVERNED TAG isPii;
  info_name    info_value
  -----------  ---------------------------------------------------------------
  Tag Key      isPii
  Id           72eba6bd-4373-4026-b14a-6642cee9ee82
  Description  Indicates what personal identifiable information the asset contains
  Values       true, false
  Create Time  2025-09-03 16:36:58.027
  Update Time  2026-02-14 01:20:33.443