ALTER RECIPIENT

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL Databricks Runtime 11.1 以上 「はい」のチェック マーク 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 「はい」のチェックマーク 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' );