ALTER RECIPIENT
適用於: Databricks SQL Databricks Runtime 11.3 LTS 和更新版本 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 [, ...] ) }
Parameters
-
要改變之收件者的名稱。
RENAME TO
to_recipient_name重新命名收件者。 在中繼存放區中的所有 recipients 中,名稱必須是唯一的。 若要執行此語句,您必須是收件者的擁有者,且具有
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
中繼存放區的許可權。可以利用收件者屬性來使用相同的共享物件,將不同的 table 分割區與不同的 recipients 進行共用。 參閱 管理收件者屬性 及 使用收件者屬性進行 partition 篩選。
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' );