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 [, ...] ) }

參數

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

相關文章

• CREATE RECIPIENT
• DESCRIBE RECIPIENT
• DROP RECIPIENT
• SHOW RECIPIENTS
• COMMENT ON 收件者