다음을 통해 공유

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 ]
    [ PROPERTIES ( property_key [ = ] property_value [, ...] ) ]

매개 변수

  • IF NOT EXISTS

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

  • recipient_name

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

  • sharing_identifier

    데이터를 공유하려는 델타 공유 받는 사람이 소유한 Unity 카탈로그 메타스토어의 선택적 전역 고유 식별자입니다. Delta Sharing 수신자가 실행한 current_metastore 함수의 출력입니다.

    이 옵션을 사용하면 인증 유형이 DATABRICKS설정되고, 그렇지 않으면 인증 유형이 TOKEN설정되므로 공유 날짜에 액세스하기 위해 받는 사람에게 활성화 링크를 보내야 합니다.

  • comment

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

  • 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