ALTER RECIPIENT

  • 發行項

適用于：核取標示為是 Databricks SQL 檢查標示為是 Databricks Runtime 11.1 和更新版本 檢查，只標示為是 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 。 若要執行此語句，您必須是收件者的擁有者。

    適用于：核取標示為是 Databricks SQL SQL 倉儲 2022.35 版或更新版本 檢查，標示為是 Databricks Runtime 11.2 和更新版本

    SET 允許作為選擇性關鍵字。

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

    適用于：核取標示為是 Databricks SQL 檢查標示為是 Databricks Runtime 12.2 和更新版本。

    在收件者上設定自訂屬性。 若要執行此語句，您必須是收件者的擁有者，而且具有 CREATE RECIPIENT 中繼存放區的許可權。

    收件者屬性可用來使用相同的共用物件，與不同的收件者共用不同的資料表分割區。 請參閱 管理收件者屬性 和使用 收件者屬性來執行資料分割篩選。

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

property_value
{ string_literal }

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

    適用于：核取標示為是 Databricks SQL 檢查標示為是 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' );