次の方法で共有


ALTER RECIPIENT

適用対象: check marked yes 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 に転送します。 このステートメントを実行するには、受信者の所有者である必要があります。

    適用対象: check marked yes Databricks SQL SQL ウェアハウス バージョン 2022.35 以降 「はい」のチェックマーク Databricks Runtime 11.3 LTS 以降

    SET は省略可能なキーワードとして使用できます。

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

    適用対象: check marked yes Databricks SQL 「はい」のチェック マーク Databricks Runtime 12.2 LTS 以上。

    受信者のカスタム プロパティを設定します。 このステートメントを実行するには、受信者の所有者であり、メタストアに対する CREATE RECIPIENT 特権を持っている必要があります。

    受信者のプロパティを使用すると、異なる受信者と同じ共有オブジェクトを使用して、異なるテーブル パーティションを共有できます。 「受信者のプロパティを管理する」および「受信者のプロパティを使用してパーティションのフィルター処理を行う」を参照してください。

    property_key
    { identifier [. ...] | string_literal }
    
    property_value
    { string_literal }
    
  • UNSET PROPERTIES ( '<property-key>' )

    適用対象: check marked yes 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' );