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 [, ...] ) }
参数
-
要更改的收件人的名称。
RENAME TO
to_recipient_name重命名收件人。 该名称在元存储中的所有收件人中必须是唯一的。 要运行此语句,你必须是收件人的所有者且拥有元存储的
CREATE RECIPIENT
权限。[ SET ] OWNER TO
principal将收件人的所有权转移给
principal
。 要运行此语句,你必须是收件人的所有者。适用于: Databricks SQL 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' );