共用方式為

ALTER RECIPIENT

  • 發行項

適用於：檢查標示為 [yes] Databricks SQL 檢查標示為 [yes] Databricks Runtime 11.3 LTS 和更新版本 檢查標示為 [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 [, ...] ) }

Parameters

  • recipient_name

    要改變之收件者的名稱。

  • 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' );