Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Применяется к:
Databricks SQL Databricks Runtime 16.1 и более поздним версиям
Задает тег в каталоге, схеме, таблице, представлении, томе, столбце, функции или внешнем объекте метаданных.
Important
Установка тегов для внешних объектов метаданных находится в общедоступной предварительной версии и требует databricks Runtime 18.2 или более поздней версии.
Чтобы добавить теги в защищаемые объекты каталога Unity, необходимо владеть объектом или иметь все следующие привилегии:
-
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взаимозаменяемы.Note
Для функций и процедур тегов требуется Databricks Runtime 18.1 или более поздней версии.
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