SET 標記

適用於：勾選為是 Databricks SQL 勾選為是 Databricks Runtime 16.1 和更新版本

在目錄、結構、資料表、檢視、卷、欄、函式或外部元資料物件上設定標籤。

Important

在 外部元資料 物件上設定標籤目前已進入公開預覽階段，且需要 Databricks 執行時 18.2 或以上版本。

若要將標籤新增至 Unity Catalog 安全性實體物件，您必須擁有物件或擁有下列所有許可權：

  • 物件上的 APPLY TAG
  • USE SCHEMA 在物件的父架構上
  • USE CATALOG 在物件的父目錄上

外部元資料物件不包含在目錄或結構中，因此 USE CATALOG 和 USE SCHEMA 不適用。

如果標籤受控管，您也需要ASSIGN受控管標籤的許可權

語法

SET 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 [ = tag_value ]

參數

  • CATALOG catalog_name

    要標記的目錄名稱。

  • COLUMN relation_name 。 欄位名稱

    要標記之數據行的限定名稱。 relation_name 必須識別檢視或數據表。 relation_name 不得包含 時態規格或選項規格。

  • 外部元資料external_metadata_name

    要標記的 外部元資料 物件名稱。

  • { FUNCTION | PROCEDURE } function_name

    要標記的函式或程序名稱。 FUNCTION 和 PROCEDURE 是可互換的。

  • SCHEMA schema_name

    要標記的架構名稱。

  • TABLE relation_name

    要標記的數據表或檢視表名稱。 名稱不得包含 時態規格或選項規格。

  • 檢視 relation_name

    要標記的檢視名稱。

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

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

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

> SELECT catalog_name, schema_name, table_name, tag_name, tag_value
    FROM information_schema.column_tags
    WHERE tag_name = 'pii' AND schema_name = 'default';
  table_name column_name
  ---------- -----------
  table      ssn
  • Last updated on