OpenSharing에 대한 데이터 받는 사람 관리

이 페이지에서는 공급자가 Azure Databricks 기존 OpenSharing 받는 사람을 관리하는 방법을 설명합니다. 수신자는 데이터를 공유하는 대상인 사용자 또는 그룹의 신원을 나타내는 이름이 지정된 개체입니다.

자격 증명 파일에서 가져온 공급자 개체를 관리하려는 데이터 수신자는 데이터 받는 사람에 대한 OpenSharing 공급자 관리를 대신 참조하세요.

수신자를 만들려면 OpenSharing용 데이터 수신자 만들기(Databricks-to-Databricks 공유), 베어러 토큰을 사용하여 Databricks 비사용자를 위한 수신자 개체 만들기(Databricks-to-Open 공유) 또는 OpenSharing 수신자에 대한 Open ID Connect(OIDC) 페더레이션 사용 설정을(를) 참조하세요. 공유를 관리하려면 OpenSharing에 대한 공유 관리를 참조하세요.

받는 사람을 만들고 공유를 만든 후에는 받는 사람에게 해당 공유에 대한 액세스 권한을 부여할 수 있습니다.

받는 사람에게 공유 액세스 권한을 부여하려면 Azure Databricks Notebook 또는 Databricks SQL 쿼리 편집기에서 카탈로그 탐색기, Databricks Unity 카탈로그 CLI 또는 GRANT ON SHARE SQL 명령을 사용할 수 있습니다.

필요한 권한: 다음 중 하나:

메타스토어 관리자.
공유 및 받는 사람 개체((USE SHARE + SET SHARE PERMISSION) 또는 공유 소유자) AND (USE RECIPIENT 또는 받는 사람 소유자)에 대해 위임된 사용 권한 또는 소유권.

자세한 내용은 OpenSharing 데이터 공유에 대한 액세스 관리(공급자용)를 참조하세요.

수신자 보기

받는 사람 목록을 보려면 Azure Databricks Notebook 또는 Databricks SQL 쿼리 편집기에서 카탈로그 탐색기, Databricks Unity 카탈로그 CLI 또는 SHOW RECIPIENTS SQL 명령을 사용할 수 있습니다.

필요한 권한: 메타스토어의 USE RECIPIENT 모든 받는 사람을 볼 수 있는 권한이 있어야 합니다. 다른 사용자는 자신이 소유한 수신자에만 접근할 수 있습니다.

카탈로그 탐색기

Azure Databricks 작업 영역에서 을 클릭합니다.카탈로그.
카탈로그 창 위쪽에서 을 클릭합니다. 기어 아이콘을 클릭하고 OpenSharing을 선택합니다.

또는 오른쪽 위 모서리에서 OpenSharing 공유 > 를 클릭합니다.
내가 공유함 탭에서 받는 사람을 클릭합니다.

SQL

Notebook 또는 Databricks SQL 쿼리 편집기에서 다음 명령을 실행합니다. 선택적으로 <pattern>를 LIKE 조건자로 바꾸십시오.

SHOW RECIPIENTS [LIKE <pattern>];

CLI

Databricks CLI를 사용하여 다음 명령을 실행합니다.

databricks recipients list

수신자 세부 정보 보기

받는 사람에 대한 세부 정보를 보려면 Azure Databricks Notebook 또는 Databricks SQL 쿼리 편집기에서 카탈로그 탐색기, Databricks Unity 카탈로그 CLI 또는 DESCRIBE RECIPIENT SQL 명령을 사용할 수 있습니다.

필요한 권한: Metastore 관리자, USE RECIPIENT 권한이 있는 사용자 또는 수신 객체 소유자.

세부 정보는 다음과 같습니다.

수신자의 창작자, 제작 타임스탬프, 댓글, 인증 유형(DATABRICKS, TOKEN, EMAILOAUTH_CLIENT_CREDENTIALS, , 또는 OIDC_FEDERATION) EMAIL 유형은 DATABRICKS 또는 TOKEN 연결을 래핑합니다. 자세한 내용은 이메일 수신자 관리를 참조하세요.
받는 사람이 전달자 토큰과 Databricks-to-Open 공유를 사용하는 경우 토큰 수명, 활성화 링크, 활성화 상태(자격 증명 다운로드 여부) 및 IP 액세스 목록(할당된 경우)입니다.
받는 사람이 OIDC 페더레이션과 Databricks-to-Open 공유를 사용하는 경우( 받는 사람 엔드포인트, MTLS 엔드포인트, 페더레이션 정책 및 IP 액세스 목록(할당된 경우).
받는 사람이 Databricks-Databricks 공유를 사용하는 경우: 그것은 받는 사람의 Unity 카탈로그 메타스토어의 클라우드, 지역, 메타스토어 ID와 활성화 상태를 포함합니다.
사용자 지정 속성을 포함한 받는 사람 속성입니다. 받는 사람 속성 관리를 참조하세요.

카탈로그 탐색기

Azure Databricks 작업 영역에서 을 클릭합니다.카탈로그.
카탈로그 창 위쪽에서 을 클릭합니다. 기어 아이콘을 클릭하고 OpenSharing을 선택합니다.

또는 오른쪽 위 모서리에서 OpenSharing 공유 > 를 클릭합니다.
공유한 사람 탭에서 받는 사람을 클릭한 후, 받는 사람을 선택합니다.

SQL

Notebook 또는 Databricks SQL 쿼리 편집기에서 다음 명령을 실행합니다.

DESCRIBE RECIPIENT <recipient-name>;

CLI

Databricks CLI를 사용하여 다음 명령을 실행합니다.

databricks recipients get <recipient-name>

받는 사람의 공유 권한 보기

받는 사람에게 액세스 권한이 부여된 공유 목록을 보려면 Azure Databricks Notebook 또는 Databricks SQL 쿼리 편집기에서 카탈로그 탐색기, Databricks CLI 또는 SHOW GRANTS TO RECIPIENT SQL 명령을 사용할 수 있습니다.

필요한 권한: Metastore 관리자, USE RECIPIENT 권한이 있는 사용자 또는 수신 객체 소유자.

카탈로그 탐색기

Azure Databricks 작업 영역에서 을 클릭합니다.카탈로그.
카탈로그 창 위쪽에서 을 클릭합니다. 기어 아이콘을 클릭하고 OpenSharing을 선택합니다.

또는 오른쪽 위 모서리에서 OpenSharing 공유 > 를 클릭합니다.
공유한 사람 탭에서 받는 사람을 클릭한 후, 받는 사람을 선택합니다.
공유 탭으로 이동하여 수신자와 공유된 공유 목록을 봅니다.

SQL

Notebook 또는 Databricks SQL 쿼리 편집기에서 다음 명령을 실행합니다.

SHOW GRANTS TO RECIPIENT <recipient-name>;

CLI

Databricks CLI를 사용하여 다음 명령을 실행합니다.

databricks recipients share-permissions <recipient-name>

받는 사람을 업데이트하다

받는 사람을 업데이트하려면 Azure Databricks Notebook 또는 Databricks SQL 쿼리 편집기에서 카탈로그 탐색기, Databricks Unity 카탈로그 CLI 또는 ALTER RECIPIENT SQL 명령을 사용할 수 있습니다.

업데이트할 수 있는 속성에는 받는 사람 이름, 소유자, 메모 및 사용자 지정 속성이 포함됩니다.

필요한 권한: 소유자를 업데이트하려면 메타스토어 관리자이거나 수신자 개체의 소유자여야 합니다. 이름을 업데이트하려면 권한이 CREATE RECIPIENT 소유자여야 합니다. 주석 또는 사용자 지정 속성을 업데이트하려면 소유자여야 합니다.

카탈로그 탐색기

Azure Databricks 작업 영역에서 을 클릭합니다.카탈로그.
카탈로그 창 위쪽에서 을 클릭합니다. 기어 아이콘을 클릭하고 OpenSharing을 선택합니다.

또는 오른쪽 위 모서리에서 OpenSharing 공유 > 를 클릭합니다.
공유한 사람 탭에서 받는 사람을 클릭한 후, 받는 사람을 선택합니다.
받는 사람 세부 정보 페이지에서 다음을 수행합니다.
- 소유자를 업데이트합니다.
- 메모를 편집하거나 추가합니다.
- 받는 사람의 이름을 바꿉니다.
  
  을 클릭합니다. 케밥 메뉴를 클릭하고 이름 바꾸기를 선택합니다.
- 사용자 지정 받는 사람 속성을 편집, 제거 또는 추가합니다.
  
  Edit icon받는 사람 속성옆에 있는 편집 아이콘을 클릭합니다. 그런 다음 속성 이름(키) 및 값을 추가합니다. 자세한 내용은 받는 사람 속성 관리를 참조 하세요.
- 토큰 인증 받는 사람만:
  - 인증 링크보고 복사합니다. 수신자에게 연결 정보를 보내기 참조
  - 토큰 관리전달자 토큰을 회전하거나 업데이트합니다. 받는 사람 토큰 관리를참조하세요.
- OIDC 페더레이션 수신자만 해당:
  - OIDC 페더레이션 정책아래에서 정책 추가을 클릭하십시오. OpenSharing 받는 사람에 대한 OIDC(Open ID Connect) 페더레이션 사용을 참조하세요.
  - 받는 사람 엔드포인트와 받는 사람 MTLS 엔드포인트를 보고 복사하세요.

SQL

Notebook 또는 Databricks SQL 쿼리 편집기에서 다음 중 하나 이상의 명령을 실행합니다.

ALTER RECIPIENT <recipient-name> RENAME TO <new-recipient-name>;

ALTER RECIPIENT <recipient-name> OWNER TO <new-owner>;

COMMENT ON RECIPIENT <recipient-name> IS "<new-comment>";

ALTER RECIPIENT <recipient-name> SET PROPERTIES ( <property-key>  =  property_value [, ...] )

ALTER RECIPIENT <recipient-name> UNSET PROPERTIES ( <property-key> [, ...] )

속성에 대한 자세한 내용은 받는 사람 속성 관리를 참조 하세요.

CLI

받는 사람 이름, 주석, 소유자, IP 액세스 목록 또는 사용자 지정 속성에 대한 업데이트가 포함된 JSON 파일을 만듭니다.

{
  "name": "new-recipient-name",
  "owner": "someone-else@example.com",
  "comment": "something new",
  "ip_access_list": {
    "allowed_ip_addresses": ["8.8.8.8", "8.8.8.4/10"]
  },
  "property": {
    "country": "us",
    "id": "001"
  }
}

이제 Databricks CLI를 사용해 다음 명령을 실행합니다. <recipient-name>을 현재 수신자 이름으로 바꾸고 update-recipient-settings.json을 JSON 파일의 파일 이름으로 바꿉니다.

databricks recipients update --json-file update-recipient-settings.json

속성에 대한 자세한 내용은 받는 사람 속성 관리를 참조 하세요.

(선택 사항) 액세스 목록을 사용하여 수신자 액세스 제한

Databricks-to-Open 공유 받는 사람에 대한 제한된 IP 주소 집합에 대한 수신자 액세스를 제한할 수 있습니다. IP 액세스 목록을 사용하여 OpenSharing 받는 사람 액세스 제한(Databricks-to-Open 공유)을 참조하세요.

이메일 수신자 관리

Important

이 기능은 베타 버전으로 제공됩니다. 사용하려면 제공자 계정의 관리자가 계정 콘솔 Previews 페이지에서 이메일로 OpenSharing을 활성화해야 합니다. 계정 수준 미리 보기 관리를 참조하세요.

이메일로 수신자를 초대하면, OpenSharing은 인증 유형 EMAIL이 있는 부모 수신자를 생성합니다. 부모의 근본적인 연결은 한 명 이상의 자녀 수신자로 나타난다:

TOKEN 자유롭게 나누는 아이.
Databricks 간 공유를 위한 DATABRICKS 하위 항목입니다.

부모 수신자를 관리합니다. 자식 수신자를 직접 편집할 수 없으며, 부모 수신자에게 변경된 사항은 자식에게 전파됩니다. 하지만 개별 자녀 수신자는 삭제할 수 있습니다.

수신자가 생성되면 각 자녀 수신자의 연결 상태를 확인할 수 있습니다:

대기 중: 수신자는 TOKEN 이메일을 받았지만 자격증명 파일을 다운로드하지 않았습니다.
활성화됨: DATABRICKS 또는 TOKEN 수신자가 공유 항목에 액세스했습니다.
만료: 수신자의 TOKEN 토큰이 만료되었습니다. 토큰을 회전시켜 수신자가 여전히 공유 데이터에 접근할 수 있는지 확인하세요.

수신자의 TOKEN 토큰을 새로고침하거나 회전시키려면 '수신자 토큰 관리'를 참조하세요.

이미 받은 공유에 대한 초대를 다시 보내려면, 수신자를 삭제하고 다시 생성한 후 공유 접근 권한을 부여하세요. 전체 목록은 이메일 공유 제한 을 참조하세요.

받는 사람 속성 관리

받는 사람 개체에는 데이터 공유 액세스를 구체화하는 데 사용할 수 있는 미리 정의된 속성이 포함됩니다. 예를 들어 다음을 수행하는 데 사용할 수 있습니다.

다른 받는 사람과 서로 다른 테이블 파티션을 공유하면 받는 사람 간에 데이터 경계를 유지하면서 여러 받는 사람과 동일한 공유를 사용할 수 있습니다.
받는 사람 속성에 따라 행 또는 열 수준에서 테이블 데이터에 대한 받는 사람 액세스를 제한하는 동적 보기를 공유합니다.

사용자 지정 속성을 만들 수도 있습니다.

미리 정의된 속성은 다음으로 databricks. 시작하고 포함합니다.

databricks.accountId: 데이터 받는 사람이 속한 Azure Databricks 계정(Databricks-to-Databricks 공유만 해당).
databricks.metastoreId: 데이터 받는 사람이 속한 Unity 카탈로그 메타스토어입니다(Databricks-to-Databricks 공유에만 해당).
databricks.name: 데이터 받는 사람의 이름입니다.

값일 수 있는 사용자 지정 속성에는 예를 들어 country포함할 수 있습니다. 예를 들어 사용자 지정 속성을 'country' = 'us' 받는 사람에게 연결하는 경우 국가별로 테이블 데이터를 분할하고 미국 데이터가 있는 행만 해당 속성이 할당된 받는 사람과 공유할 수 있습니다. 받는 사람 속성에 따라 행 또는 열 액세스를 제한하는 동적 보기를 공유할 수도 있습니다. 자세한 예제는 받는 사람 속성을 사용하여 파티션 필터링 을 수행하고 공유에 동적 보기를 추가하여 행과 열을 필터링하는 방법을 참조하세요.

요구 사항

Databricks Runtime 12.2 이상을 실행하는 SQL 웨어하우스 또는 컴퓨팅을 사용해야 합니다.

받는 사람을 만들거나 업데이트할 때 속성 추가

받는 사람을 만들 때 속성을 추가하거나 기존 받는 사람에 대한 속성을 업데이트할 수 있습니다. Azure Databricks Notebook 또는 Databricks SQL 쿼리 편집기에서 카탈로그 탐색기, Databricks Unity 카탈로그 CLI 또는 SQL 명령을 사용할 수 있습니다.

필요한 권한: Metastore 관리자 또는 Unity 카탈로그 메타스토어에 대한 권한이 있는 CREATE RECIPIENT 사용자입니다.

카탈로그 탐색기

카탈로그 탐색기를 사용하여 받는 사람을 만들거나 업데이트하는 경우 다음을 수행하여 사용자 지정 속성을 추가하거나 업데이트합니다.

받는 사람 세부 정보 페이지로 이동합니다.

새 받는 사람을 만드는 경우 만들기를 클릭한 후 이 페이지로 이동합니다. 기존 수신자 정보를 업데이트하려면 을 클릭하여 이 페이지로 이동한 다음, 기어 아이콘 > OpenSharing > 내가 공유함 > 수신자로 이동하여 해당 수신자를 선택합니다.
페이지의 오른쪽 아래, 받는 사람 속성 아래에서 을 클릭합니다. Azure Databricks 받는 사람의 경우에는 databricks.metastoreID 옆의 연필을 클릭하고, 일반 받는 사람의 경우 databricks.name 옆의 연필을 클릭합니다.
속성 이름(키) 및 값을 입력합니다.

예를 들어 국가별로 공유 데이터를 필터링하고 이 받는 사람과 미국 데이터만 공유하려는 경우 값이 "US"인 "country"라는 키를 만들 수 있습니다.
저장을 클릭합니다.

SQL

받는 사람을 만들 때 사용자 지정 속성을 추가하려면 Notebook 또는 Databricks SQL 쿼리 편집기에서 다음 명령을 실행합니다.

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
[USING ID '<sharing-identifier>'] /* Skip this if you are using open sharing */
[COMMENT "<comment>"]
PROPERTIES ( '<property-key>' = '<property-value>' [, ...] );

<property-key> 는 문자열 리터럴 또는 식별자일 수 있습니다. <property-value> 는 문자열 리터럴이어야 합니다.

다음은 그 예입니다.

CREATE RECIPIENT acme PROPERTIES ('country' = 'us', 'partner_id' = '001');

기존 받는 사람에 대한 사용자 지정 속성을 추가, 편집 또는 삭제하려면 다음 중 하나를 실행합니다.

ALTER RECIPIENT <recipient-name> SET PROPERTIES ( '<property-key>' = '<property-value>' [, ...] );

ALTER RECIPIENT <recipient-name> UNSET PROPERTIES ( '<property-key>' );

CLI

받는 사람을 만들 때 사용자 지정 속성을 추가하려면 Databricks CLI를 사용하여 다음 명령을 실행합니다. 자리 표시자 값을 바꾸세요.

<recipient-name>: 수신자의 이름입니다.
<property-key> 는 문자열 리터럴 또는 식별자일 수 있습니다.
<property-value> 는 문자열 리터럴이어야 합니다.

databricks recipients create \
--json='{
  "name": "<recipient-name>",
  "properties_kvpairs": {
    "properties": {
      "<property-key>": "<property-value>",
    }
  }
}'

다음은 그 예입니다.

databricks recipients create \
--json='{
  "name": "<recipient-name>",
  "properties_kvpairs": {
    "properties": {
      "country": "us",
      "partner_id":"001"
    }
  }
}'

기존 받는 사람에 대한 사용자 지정 속성을 추가하거나 편집하려면 다음 대신 update사용합니다create.

databricks recipients update \
--json='{
  "name": "<recipient-name>",
  "properties_kvpairs": {
    "properties": {
      "country": "us",
      "partner_id":"001"
    }
  }
}'

받는 사람 속성 보기

받는 사람 속성을 보려면 받는 사람 세부 정보 보기의 지침을 따릅니다.

수신자 삭제

받는 사람을 삭제하려면 Azure Databricks Notebook 또는 Databricks SQL 쿼리 편집기에서 카탈로그 탐색기, Databricks Unity 카탈로그 CLI 또는 DROP RECIPIENT SQL 명령을 사용할 수 있습니다. 수신자를 삭제하려면 수신자 개체 소유자여야 합니다.

수신자를 삭제하면 수신자가 나타내는 사용자는 더 이상 공유 데이터에 액세스할 수 없습니다. Databricks-to-Open 공유 시나리오에서 받는 사람이 사용하는 토큰은 무효화됩니다.

필요한 권한: 수신자 개체 소유자

카탈로그 탐색기

Azure Databricks 작업 영역에서 을 클릭합니다.카탈로그.
카탈로그 창 위쪽에서 을 클릭합니다. 기어 아이콘을 클릭하고 OpenSharing을 선택합니다.

또는 오른쪽 위 모서리에서 OpenSharing 공유 > 를 클릭합니다.
공유한 사람 탭에서 받는 사람을 클릭한 후, 받는 사람을 선택합니다.
수신자 탭에서 수신자를 찾아 선택합니다.
을 클릭합니다. 케밥 메뉴를 클릭하고 삭제를 선택합니다.
확인 대화 상자에서 삭제를 클릭합니다.

SQL

Notebook 또는 Databricks SQL 쿼리 편집기에서 다음 명령을 실행합니다.

DROP RECIPIENT [IF EXISTS] <recipient-name>;

CLI

Databricks CLI를 사용하여 다음 명령을 실행합니다.

databricks recipients delete <recipient-name>

피드백

이 페이지가 도움이 되었나요?

2026-09-30 에 마지막으로 업데이트됨

OpenSharing에 대한 데이터 받는 사람 관리

수신자에게 공유에 대한 액세스 권한 부여

수신자 보기

카탈로그 탐색기

SQL

CLI

수신자 세부 정보 보기

카탈로그 탐색기

SQL

CLI

받는 사람의 공유 권한 보기

카탈로그 탐색기

SQL

CLI

받는 사람을 업데이트하다

카탈로그 탐색기

SQL

CLI

(선택 사항) 액세스 목록을 사용하여 수신자 액세스 제한

이메일 수신자 관리

받는 사람 속성 관리

요구 사항

받는 사람을 만들거나 업데이트할 때 속성 추가

카탈로그 탐색기

SQL

CLI

받는 사람 속성 보기

수신자 삭제

카탈로그 탐색기

SQL

CLI

피드백

추가 리소스