适用于: Databricks SQL Databricks Runtime 16.1 及更高版本
设置目录、架构、表、视图、卷或列上的标记。
要将标记添加到 Unity Catalog 安全对象,必须拥有该对象或具有以下所有特权:
- 对象上的
APPLY TAG
权限 - 对象父架构上的
USE SCHEMA
权限 - 对象父目录上的
USE CATALOG
权限
如果标记受标记特定策略的约束,则还需要ASSIGN
对标记策略具有权限
语法
SET TAG ON
{ CATALOG catalog_name |
COLUMN relation_name . column_name |
{ SCHEMA | DATABASE } schema_name |
TABLE relation_name |
VIEW relation_name |
VOLUME volume_name }
tag_key [ = tag_value ]
参数
CATALOG catalog_name
要标记的目录名称。
COLUMN relation_name 。 column_name
要标记的列的限定名称。
relation_name
必须标识视图或表。relation_name
不得包含 时态规范或选项规范。SCHEMA schema_name
要标记的架构名称。
-
要标记的表或视图名称。 名称不得包含 时态规范或选项规范。
VIEW relation_name
要标记的视图名称。
VOLUME volume_name
要标记的卷的名称。
tag_key
标识符。 如果已经存在具有相同键的标记分配,则会引发异常。
tag_value
可选标识符。 如果未指定,则标记分配将设置为仅限键。
例子
> SET TAG ON CATALOG catalog `cost_center` = `hr`;
> UNSET TAG ON CATALOG catalog cost_center;
> SET TAG ON TABLE catalog.schema.table cost_center = hr;
> UNSET TAG ON TABLE catalog.schema.table cost_center;
> SET TAG ON COLUMN table.ssn pii;
> UNSET TAG ON COLUMN table.ssn pii;
> SELECT table_name, column_name FROM information_schema.column_tags
WHERE tag_name = 'pii' AND schema_name = 'default';
table_name column_name
---------- -----------
table ssn