显示受治理标签

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

列出帐户中的所有受治理标记。

Syntax

SHOW GOVERNED TAGS [ [ LIKE ] regex_pattern ]

Parameters

  • regex_pattern

    可选。 用于按标记键筛选结果的正则表达式模式。 仅返回标记键与模式匹配的受治理标记。

结果

返回包含以下列的结果表:

  • Tag Key STRING NOT NULL:标记键。
  • Description STRING:说明(如果已设置)。
  • Values STRING:允许的值(如果已定义)。
  • Create Time STRING:创建受治理标记时的时间戳。 系统定义的标记的 NULL。
  • Update Time 字符串:上次更新受治理标记时的时间戳。 系统定义的标记的 NULL。

示例

-- 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*';