ALTER RECIPIENT

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 11.3 LTS и более поздней проверка помечены да версии каталога Unity

Переименовывает получателя. Передает права владения получателем новому субъекту.

Синтаксис

ALTER RECIPIENT recipient_name
  { RENAME TO to_recipient_name |
    [ SET ] OWNER TO principal |
    SET PROPERTIES ( property_key [ = ] property_value [, ...] ) |
    UNSET PROPERTIES ( property_key [, ...] ) }

Параметры

  • recipient_name

    Имя изменяемого получателя.

  • RENAME TO to_recipient_name

    Переименовывает получателя. Это имя должно быть уникальным среди всех получателей в хранилище метаданных. Для выполнения этой инструкции необходимо быть владельцем получателя и иметь привилегию CREATE RECIPIENT в хранилище метаданных.

  • [ SET ] OWNER TO principal

    Передает права владения получателем субъекту principal. Для выполнения этой инструкции необходимо быть владельцем получателя.

    Область применения:проверка помечены да Хранилище SQL Databricks SQL версии 2022.35 или более поздней проверка помечены да версии Databricks Runtime 11.3 LTS и выше

    SETдопускается как необязательный ключевое слово.

  • SET PROPERTIES ( property_key [ = ] property_value [, ...] )

    Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 12.2 LTS и более поздних версий.

    Задает настраиваемое свойство получателя. Для выполнения этой инструкции необходимо быть владельцем получателя и иметь CREATE RECIPIENT привилегии в хранилище метаданных.

    Свойства получателя можно использовать для совместного использования разных секций таблиц с разными получателями с помощью одного объекта общего ресурса. См. статью "Управление свойствами получателей" и "Использование свойств получателя" для фильтрации секций.

    property_key
{ identifier [. ...] | string_literal }

property_value
{ string_literal }

  • UNSET PROPERTIES ( '<property-key>' )

    Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 12.2 LTS и более поздних версий.

    Удаляет пользовательское свойство из получателя. Для выполнения этой инструкции необходимо быть владельцем получателя и иметь CREATE RECIPIENT привилегии в хранилище метаданных.

    property_key
{ identifier [. ...] | string_literal }

Примеры

-- Rename a recipient
> ALTER RECIPIENT `Center for Disease Control` RENAME TO cdc;

-- Change ownership of the recipient
> ALTER RECIPIENT cdc OWNER TO `alf@melmak.et`;

-- Change recipient properties
> ALTER RECIPIENT cdc SET PROPERTIES ( 'country' = 'US' );