分享方式：

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。 若要執行此語句，您必須是收件者的擁有者。

    適用於： 檢查標示為是 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' );