ALTER RECIPIENT

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime 11.1 及更高版本 check marked yes 仅 Unity Catalog

重命名收件人。 将收件人的所有权转让给新主体。

语法

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。 要运行此语句，你必须是收件人的所有者。

    适用于：check marked yes Databricks SQL SQL 仓库版本 2022.35 或更高版本 check marked yes Databricks Runtime 11.2 及更高版本

    允许使用 SET 作为可选关键字。

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

    适用于：check marked yes Databricks SQL check marked yes Databricks Runtime 12.2 及更高版本。

    设置收件人的自定义属性。 若要运行此语句，你必须是接收者的所有者且拥有元存储的 CREATE RECIPIENT 特权。

    收件人属性可用来与使用同一共享对象的不同收件人共享不同的表分区。 请参阅管理接收者属性和使用接收者属性进行分区筛选。

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

property_value
{ string_literal }

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

    适用于：check marked yes Databricks SQL check marked yes Databricks Runtime 12.2 及更高版本。

    从接收者中删除自定义属性。 若要运行此语句，你必须是接收者的所有者且拥有元存储的 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' );