未设置标签

适用于:选中标记为“是” Databricks SQL 选中标记为“是” Databricks Runtime 16.1 及更高版本

删除目录、架构、表、视图、卷、列、函数或外部元数据对象的标记。

Important

外部元数据 对象中删除标记是公共预览版,需要 Databricks Runtime 18.2 或更高版本。

若要从 Unity 目录安全对象中删除标记,必须拥有该对象或具有以下所有特权:

  • 对象上的 APPLY TAG 权限
  • 对象父架构上的 USE SCHEMA 权限
  • 对象父目录上的 USE CATALOG 权限

外部元数据对象不包含在目录或架构中,因此USE CATALOGUSE SCHEMA不适用。

语法

UNSET TAG ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      EXTERNAL METADATA external_metadata_name |
      { FUNCTION | PROCEDURE } function_name |
      { SCHEMA | DATABASE } schema_name |
      TABLE relation_name |
      VIEW  relation_name |
      VOLUME volume_name }
    tag_key

参数

  • CATALOG catalog_name

    要删除标记的目录名称。

  • COLUMN relation_name column_name

    要从中删除标记的列的限定名称。 relation_name 必须标识视图或表。 relation_name 不得包含 时态规范或选项规范

  • 外部元数据external_metadata_name

    要从中删除标记 的外部元数据 对象的名称。

  • { FUNCTION | PROCEDURE } function_name

    要从中删除标记的函数或过程的名称。

    注释

    标记函数和过程需要 Databricks Runtime 18.1 或更高版本。

  • SCHEMA schema_name

    要从中删除标记的架构的名称。

  • TABLE relation_name

    要从中删除标记的表或视图的名称。 名称不得包含 时态规范或选项规范

  • VIEW relation_name

    要从中删除标记的视图的名称。

  • VOLUME volume_name

    要从中删除标记的卷的名称。

  • tag_key

    标识符。 如果找不到标记,则会引发异常。

例子

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

> SET TAG ON FUNCTION catalog.schema.my_func cost_center = hr;

> UNSET TAG ON FUNCTION catalog.schema.my_func cost_center;