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 Warehouse 버전 2022.35 이상 검사 '예'로 표시 Databricks Runtime 11.3 LTS 이상

    SET는 선택적 키워드로 허용됩니다.

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

    적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 12.2 LTS 이상.

    받는 사람에 대한 사용자 지정 속성을 설정합니다. 이 문을 실행하려면 받는 사람의 소유자여야 하며 CREATE RECIPIENT metastore에 대한 권한이 있어야 합니다.

    받는 사람 속성을 사용하여 동일한 공유 개체를 사용하여 다른 받는 사람과 다른 테이블 파티션을 공유할 수 있습니다. 받는 사람 속성 관리 및 받는 사람 속성 사용을 참조하여 파티션 필터링을 수행합니다.

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

    적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 12.2 LTS 이상.

    받는 사람에서 사용자 지정 속성을 제거합니다. 이 문을 실행하려면 받는 사람의 소유자여야 하며 CREATE RECIPIENT metastore에 대한 권한이 있어야 합니다.

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