SET タグ

適用対象:チェックマーク付き: はい Databricks SQL チェックマーク付き: はい Databricks Runtime 16.1 以降

カタログ、スキーマ、テーブル、ビュー、ボリューム、列、関数、または外部メタデータ オブジェクトにタグを設定します。

Important

外部メタデータ オブジェクトにタグを設定するにはパブリック プレビュー段階であり、Databricks Runtime 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。 column_name

    タグ付けする列の修飾名。 relation_name ビューまたはテーブルを識別する必要があります。 relation_name には、テンポラル仕様またはオプション指定を含めてはなりません。

  • EXTERNAL METADATA external_metadata_name

    タグ付けする 外部メタデータ オブジェクトの名前。

  • { FUNCTION | PROCEDURE } function_name

    タグ付けする関数またはプロシージャの名前。 FUNCTION と PROCEDURE は交換可能です。

  • SCHEMA schema_name

    タグ付けするスキーマの名前。

  • TABLE relation_name

    タグ付けするテーブルまたはビューの名前。 この名前には、テンポラル指定やオプション指定を含めないでください。

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

> 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