Clean Rooms 생성, 가입, 제거 및 제거하기

This topic explains basic clean room actions using both the clean rooms API and the clean rooms UI.

새 Clean Room 만들기

Clean Room을 만들려면 Snowflake 계정에 적절한 권한이 있어야 합니다. Clean Room 생성자를 공급자 라고 합니다.

클린룸 UI의 Clean Rooms 페이지에서 공급자는 클린룸 생성 및 공유를 포함한 클린룸의 라이프사이클을 관리할 수 있습니다. 클린룸 UI에 액세스할 수 없는 경우, Snowflake 계정의 클린룸 관리자에게 문의하세요.

Clean Room을 만들고 공유하려면 다음을 수행하십시오.

  1. 클린룸 UI에 로그인합니다.

  2. 왼쪽 탐색 모음에서 Clean Rooms 를 선택합니다.

  3. + Clean Room 을 선택합니다. 생성 프로세스는 다음과 같은 단계로 이루어집니다.

    1. Add Data 단계를 사용하여 클린룸의 이름을 지정하고 컨슈머와 공유할 테이블을 선택합니다. 이름은 최대 80자, 대소문자 구분 없이 a-z, 0-9, 공백 및 밑줄을 사용할 수 있습니다.

    2. Specify Join Policies 단계를 사용하여 Clean Rooms 계정 관리자가 사용하도록 설정한 ID 공급자를 활성화하고 컨슈머가 참여할 수 있는 열을 선택합니다.

    3. Configure Analysis & Query 단계를 사용하여 Clean Room에서 사용할 수 있는 템플릿, 템플릿별 구성 설정, 활성화 및 개인정보 보호 설정과 같은 추가 기능을 정의할 수 있습니다.

    4. Share Clean Room 단계를 사용하여 컨슈머를 클린룸으로 초대하여 협업을 진행합니다. 또한 Enable Run Analysis & Query 옵션을 사용하여 클린룸에서 분석을 실행할 수 있는 공동 작업자를 지정할 수도 있습니다.

For a full walkthrough of creating a new clean room in the clean rooms UI, try the clean rooms UI tutorial

참고

하나의 계정에서 만들 수 있는 (Clean Rooms + 공동 작업자) 수에는 제한이 있습니다. 테스트 Clean Rooms를 너무 많이 만들면 새 Clean Rooms를 만들기 위해 몇 개를 삭제해야 할 수도 있습니다. 계정에 수용 가능한 인원보다 더 많은 Clean Room이 필요한 경우 Snowflake 지원팀 으로 문의하십시오.

Clean Room 설치하기(가입하기)

If you have been invited to join a clean room, you will receive an email message with a link to install, configure, and run the clean room in the clean rooms UI. You can follow the link and use the clean rooms UI, or install and run the clean room using the API.

클린룸 UI의 Clean Rooms 페이지에서 컨슈머인 사용자는 공급자가 공유한 클린룸을 설치할 수 있습니다. 클린룸을 설치하려면 다음을 수행하세요.

  1. 클린룸 UI에 로그인합니다.

  2. 왼쪽 탐색 모음에서 Clean Rooms 를 선택합니다.

  3. On the Invited tab, find the clean room and select Join. You should get a direct link to this page in an invitation email when you are added as a collaborator in the clean rooms UI.

  4. 공급자의 데이터와 공동 작업할 테이블을 선택한 다음 Next 를 선택합니다.

  5. 이 Clean Room 환경에서 사용할 수 있는 ID 공급자를 선택하고 이 Clean Room에서 사용해야 합니다.

  6. 테이블에서 조인할 수 있는 열과 공급자의 데이터에서 해당 열을 지정합니다.

  7. Next 를 선택합니다.

  8. Clean Room에 할당된 모든 템플릿에 대해 템플릿별 설정을 제공합니다.

  9. Finish 를 클릭하고 선택적으로 템플릿을 즉시 실행하거나 해당 템플릿의 반복 실행을 예약할 수 있습니다.

참고

일부 Clean Rooms에 가입하려고 할 때 다음과 같은 오류가 발생합니다.

Application role `SAMOOHA_BY_SNOWFLAKE.DCR_DELEGATED_CLEANROOM_ROLE` does not exist
or not authorized.

이 오류가 발생하면 다음 코드를 실행하여 Clean Room에 다시 가입해 보십시오.

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.PREPARE_MOUNT_SCRIPT();
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;
Copy

생성한 클린룸 삭제

삭제 후에는 공유 사용자가 다음에 클린룸 UI를 열 때 클린룸이 더 이상 표시되지 않습니다. 클린룸이 삭제될 때 분석이 진행 중인 경우 클린룸이 삭제되기 전에 분석이 완료되지 않을 수 있습니다.

To use the clean rooms UI to delete a clean room that you created, do the following:

  1. 클린룸 UI에 로그인합니다.

  2. 왼쪽 탐색 모음에서 Clean Rooms 를 선택합니다.

  3. 삭제할 Clean Room에서 More (더 많은 옵션을 나타내는 세 개의 세로 점) > Delete 를 선택합니다.

Clean Room 제거(가입 취소)

컨슈머로 설치(조인)한 클린룸을 제거할 수 있습니다. 이렇게 하면 계정의 모든 사용자에 대한 클린룸이 제거됩니다.

  1. 클린룸 UI에 로그인합니다.

  2. 왼쪽 탐색 모음에서 Clean Rooms 를 선택합니다.

  3. Clean Rooms » Joined 으로 이동합니다.

  4. 제거할 Clean Room에서 More (더 많은 옵션을 나타내는 세 개의 세로 점) > Leave 를 선택합니다.

Clean Room에서 테이블 추가 또는 제거하기

Clean Room에서 테이블을 추가하거나 제거하는(연결 또는 연결 해제) 방법은 다음과 같습니다.

UI 를 사용하는 경우 관리자가 등록한 테이블 또는 뷰만 Clean Room에 연결할 수 있습니다. Clean Room에서 사용할 수 있는 테이블이나 뷰가 보이지 않는다면 계정 관리자에게 해당 오브젝트를 계정에 등록해 달라고 요청하십시오.

  • 공급자는 Clean Room을 만들거나 편집할 때 Add Data 단계에서 Clean Room에 연결할 테이블을 선택합니다.

  • 컨슈머는 Clean Room에 가입하거나 편집할 때 Add Data 단계에서 Clean Room에 연결할 테이블을 선택합니다.

테이블이 Clean Room에 추가되면 해당 Clean Room에서 테이블을 제거할 수 없습니다. 하지만 전체 계정에서 데이터를 삭제할 수는 있습니다. Clean Room에서 테이블이나 뷰를 제거해야 하는 경우 Clean Room 관리자에게 문의하십시오.

언어: 한국어