CREATE RECIPIENT

  • 아티클

적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 10.4 LTS 이상 검사 '예'로 표시 Unity 카탈로그만 해당

지정된 이름으로 Delta Sharing 수신자를 만들고 활성화 링크를 만듭니다. 같은 이름의 수신자가 이미 있는 경우 예외가 throw됩니다.

받는 사람을 만들고 관리하려면 metastore 관리자이거나 CREATE RECIPIENT metastore에 대한 권한이 있어야 합니다.

활성화 링크를 검색하려면 DESCRIBE RECIPIENT를 사용합니다.

구문

CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
    [ USING ID sharing_identifier ]
    [ COMMENT comment ]
    [ SET PROPERTIES ( property_key [ = ] property_value [, ...] ) ]

매개 변수

  • IF NOT EXISTS

    지정된 이름의 수신자가 없는 경우 수신자를 만듭니다. 같은 이름의 수신자가 이미 있으면 아무 작업도 수행되지 않습니다.

  • recipient_name

    만들 수신자의 이름입니다.

  • sharing_identifier

    데이터를 공유하려는 Delta Sharing 수신자가 소유한 Unity Catalog 메타스토어의 선택적 글로벌 고유 식별자입니다. Delta Sharing 수신자가 실행한 current_metastore 함수의 출력입니다.

    이 옵션을 사용하면 인증 형식이 DATABRICKS로 설정됩니다. 그렇지 않으면 인증 형식이 TOKEN으로 설정되어 공유 날짜에 액세스할 수 있도록 수신자에게 활성화 링크를 보내야 합니다.

  • comment

    선택적 STRING 리터럴입니다. 수신자에 대한 설명입니다.

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

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

    받는 사람에 대한 사용자 지정 속성을 설정합니다.

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

    property_key
{ identifier [. ...] | string_literal }

property_value
{ string_literal }

예제

-- A recipient created for Databricks to Databricks sharing
> CREATE RECIPIENT other_databricks_org USING ID 'azure:westus:f12dcb34-5678-9d4c-1234-c5ac67f8b90a';
> DESCRIBE RECIPIENT other_databricks_org;
 info_name           info_value
 -------------       ----------
 recipient_name      other_databricks_org
 authentication_type DATABRICKS
 owner               alwaysworks@databricks.com
 created_by          alwaysworks@databricks.com
 create_at           2022-01-01T00:00:00.000+0000
 updated_by          alwayswork@databricks.com
 updated_at          2022-01-05T12:00:00.000+0000
 comment
 cloud               azure
 region              westus
 metastore_id        f12dcb34-5678-9d4c-1234-c5ac67f8b90a

-- A recipient created for sharing outside of Databricks
> CREATE RECIPIENT other_org;
> DESCRIBE RECIPIENT other_org;
 info_name               info_value
 ----------------------- ----------
 recipient_name          other_org
 authentication_type     TOKEN
 owner                   alwaysworks@databricks.com
 created_by              alwaysworks@databricks.com
 create_at               2022-01-01T00:00:00.000+0000
 updated_by              alwayswork@databricks.com
 updated_at              2022-01-05T12:00:00.000+0000
 comment                 This is Other Corp
 active_token_id         0160c81f-5262-40bb-9b03-3ee12e6d98d7
 active_token_expiration 2023-01-05T12:00:00.000+0000
 activation_link         https://send/this