描述受控标签

适用于：检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 18.1 及更高 版本检查标记为“是 Unity 目录”

返回现有受治理标记的元数据。

Syntax

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

Parameters

  • tag_key

    帐户中现有受治理标记的标记键。 如果没有带此标记键的受控制标记，Azure Databricks将返回 NOT_FOUND 错误。

  • AS JSON

    可选。 以 JSON 字符串而不是格式化报表的形式返回受治理的标记元数据。

结果

返回具有以下字段的格式化报表：

  • Tag Key：标记键。
  • Id：受治理标记的唯一标识符。
  • Description：说明（如果已设置）。
  • Values：允许的值（如果已定义）。
  • Create Time：创建受治理标记时的时间戳。
  • Update Time：上次更新受治理标记时的时间戳。

示例

> 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
  • Last updated on