Snowflake Data Clean Rooms 의 개요¶

Clean Room 환경 설치¶

Snowflake Data Clean Room 환경 은 Snowflake 계정에 대한 ACCOUNTADMIN 권한이 있는 사람이 전체 Snowflake 계정에 대해 한 번만 설치합니다(사용자 또는 Clean Room당 한 번이 아님).

관리자는 환경을 구성하여 계정에서 어떤 사용자가 Clean Rooms를 만들고 쿼리를 실행할 수 있는지, 어떤 사용자에게 API 액세스 권한이 있는지, 어떤 계정을 Clean Room에서 협업하도록 초대할 수 있는지, Clean Room 작성자가 Clean Room으로 가져올 수 있는 데이터는 무엇인지, 이 계정에서 만든 Clean Room의 쿼리 결과를 내보내는 데 사용할 수 있는 서드 파티 서비스(있는 경우)는 무엇인지 지정할 수 있습니다.

계정에 이미 Clean Room 환경이 설치되어 있는 경우에는 Clean Rooms 관리자에게 문의하여 액세스 권한을 요청하십시오. 계정에 Clean Room 환경이 설치되지 않은 경우 환경 설치 방법을 알아보십시오.

환경을 설치하고 구성한 후 관리자는 다른 Snowflake 사용자에게 Clean Rooms UI, API 또는 둘 다를 사용할 수 있는 권한을 부여합니다.

Clean Room 만들기¶

Snowflake 계정 관리자는 Snowflake 계정의 사용자에게 Clean Rooms를 만들 수 있는 권한을 부여합니다. Clean Room을 만드는 사람을 해당 Clean Room에 대한 공급자 라고 합니다. 공급자는 Clean Rooms를 구성하고 다른 Snowflake 계정의 사용자(또는 Snowflake 계정이 아닌 사용자)와 공유할 수 있습니다. Clean Room을 공유하면 해당 Clean Room에 대해 컨슈머 라고 합니다.

Clean Room을 만든 후 공급자는 테이블 또는 뷰를 Clean Room으로 가져오고(연결하고), 데이터에 대해 실행할 수 있는 쿼리, 조인하거나 결과에 표시할 수 있는 데이터의 열, 그리고 결과로 수행할 수 있는 작업을 지정합니다. (나중에 설명하는 대로 표준 Clean Room에 대한 변형을 만들 수 있습니다.)

그런 다음 공급자는 컨슈머를 Clean Room에 초대하여 자신의 테이블과 뷰를 가져오고 공급자가 지정한 쿼리 중 하나를 실행하도록 합니다. 컨슈머는 Clean Rooms 관리자의 사전 승인을 받아야 Clean Room에 초대받을 수 있습니다.

Clean Room에 참여하기¶

Clean Room을 만들고 구성한 후 공급자는 다른 계정의 사용자에게 Clean Room에 참여하도록 초대를 보냅니다. 이러한 초대된 사용자를 컨슈머 또는 때로는 공동 작업자 라고 합니다. Clean Rooms UI 를 통해 초대된 컨슈머는 Clean Room에 참여할 수 있는 초대장을 이메일로 받게 됩니다. Snowflake 사용자가 Clean Room에 초대받으려면 Clean Room 환경이 설치되어 있어야 하지만, Snowflake 외부 사용자 를 Clean Room에 초대할 수 있습니다. Snowflake 계정은 Clean Rooms 관리자가 허용 목록에 추가해야만 Clean Room 생성자가 해당 계정의 사용자를 초대할 수 있습니다.

(Clean Rooms UI 에서는 컨슈머가 Clean Room 초대를 수락할 때 ‘참여’와 ‘설치’를 모두 사용합니다. Clean Room은 말 그대로 컨슈머의 Clean Room 환경에 설치되어야 하기 때문입니다.)

Clean Room에 참여한 후, 컨슈머는 해당 Clean Room의 템플릿에 필요한 데이터를 가져오고(연결하고), 조인하거나 투영할 수 있는 열 등 데이터 액세스 방법을 지정하고, 템플릿별 필터 또는 기타 매개 변수를 제공한 다음, 템플릿을 실행합니다. 컨슈머는 원하는 경우 템플릿의 반복 실행을 지정할 수 있습니다. 결과는 브라우저에서 보거나 다운로드할 수 있습니다. 공급자가 활성화를 설정하고 컨슈머가 승인한 경우, 컨슈머는 승인된 위치(자신의 Snowflake 계정 또는 공급자가 지정한 서드 파티 활성화 커넥터)로 결과를 내보낼 수 있습니다.

Clean Room으로 가져온 데이터는 공급자나 컨슈머 중 어느 쪽에서도 직접 쿼리하거나 확인할 수 없으며, 해당 Clean Room의 템플릿을 통해서만 액세스할 수 있습니다. 템플릿은 공급자 또는 컨슈머가 Clean Room에 설치한 SQL 쿼리이며, Clean Room에서 사용하려면 상대방이 권한을 부여해야 합니다.

또한 각 당사자는 조인, 투영 또는 내보낼 수 있는 열과 Clean Room에서 실행할 수 있는 템플릿을 포함하여 자체 데이터에 대한 액세스 규칙을 설정할 수 있습니다. 각 당사자는 언제든지 Clean Room에서 자신의 데이터를 삭제할 수 있습니다.

기본적으로 컨슈머만 Clean Room에서 템플릿을 실행할 수 있지만 공급자는 컨슈머에게 Clean Room에서 지정된 템플릿을 실행하도록 요청할 수 있습니다.

쿼리 실행하기¶

모든 Clean Room에는 하나 이상의 템플릿 이 설치되어 있습니다. 템플릿은 템플릿을 실행하는 사람이 제공한 런타임 매개 변수를 포함할 수 있는 SQL 쿼리입니다. 이러한 매개 변수를 통해 사용자는 쿼리에 사용되는 Clean Room의 테이블, 쿼리에 사용되는 열, WHERE 절 필터 등을 지정할 수 있습니다. Clean Room에서 임의의 SQL 쿼리를 실행할 수 없으며, 대신 SQL 쿼리로 평가되는 템플릿을 만들고 상대방에게 해당 템플릿을 실행할 수 있는 권한을 요청해야 합니다.

Snowflake는 웹 앱에서 사용할 수 있는 표준 템플릿 세트를 제공합니다. 이러한 템플릿을 사용하면 대상 그룹 lookalike, 대상 그룹 유사, 인벤토리 예측 및 임의의 SQL 쿼리와 같은 일반적인 사용 사례를 사용할 수 있습니다. 개발자는 Clean Rooms에서 사용할 사용자 지정 템플릿을 만들 수도 있습니다.

템플릿은 Clean Rooms UI 또는 코드에서 실행할 수 있습니다. 해당 Clean Room에서 활성화 가 허용되는 경우 템플릿 결과를 확인하거나 다운로드하거나 공급자, 컨슈머 또는 승인된 서드 파티와 공유할 수 있습니다.

Clean Room 변형¶

위에서 설명한 것처럼 가장 일반적인 Clean Room은 공급자가 데이터를 가져와서 데이터에 대해 실행할 수 있는 하나 이상의 특정 쿼리와 그 결과를 공유할 수 있는 방법을 지정하고, 컨슈머는 자신의 데이터를 가져와서 결합된 데이터에 대해 허용된 쿼리를 실행하는 방식입니다. 그러나 공급자는 표준 Clean Room에 여러 가지 변형을 허용할 수 있습니다.

• 공급자가 컨슈머 데이터에 대해 자체 쿼리를 실행할 수 있도록 허용합니다. 기본적으로 컨슈머만 Clean Room에서 쿼리를 실행할 수 있습니다. Clean Room에 대해 활성화된 경우 공급자는 Clean Room에서 특정 쿼리를 실행할 수 있는 권한을 컨슈머에게 요청할 수 있습니다.

• 쿼리 결과를 쿼리를 실행하는 사람의 (활성화된) Snowflake 계정이나 Meta Ads Manager 또는 The Trade Desk와 같은 Snowflake 승인 서드 파티 계정으로 내보내도록 허용합니다. Clean Room 외부로 데이터를 내보내려면 항상 쿼리 대상 데이터를 공유한 모든 당사자의 승인을 받아야 합니다.

• 양쪽 모두 실행하는 쿼리에서 호출할 수 있는 사용자 지정 Python 코드를 포함하도록 허용합니다. 이 코드는 일반적으로 쿼리가 실행되는 동안 어떤 식으로든 데이터를 필터링하거나 조작하며, 파일 저장, 데이터 내보내기 또는 기타 작업 수행과 같은 외부 작업을 수행할 수 없습니다.

• 액세스 중인 모든 Clean Rooms 공급자의 승인을 받아 다른 Clean Rooms의 데이터에 액세스하도록 쿼리를 허용합니다.

• 여러 쿼리를 함께 연결합니다.

공급자 및 컨슈머 정보¶

Clean Room 공동 작업자는 특정 Clean Room에 대해 공급자 또는 컨슈머 로 분류됩니다. 공급자는 Clean Room을 생성하는 계정이고, 컨슈머는 Clean Room을 공유받는 계정입니다. Clean Room을 만든 계정과 동일한 계정에 있는 사람을 해당 Clean Room의 컨슈머로 초대할 수 없습니다. 동일한 Snowflake 계정의 모든 사용자는 해당 계정의 동일한 Clean Rooms에 대해 동일한 Clean Room 역할(공급자 또는 컨슈머)을 갖습니다.

공급자인지 컨슈머인지 여부는 Snowflake 역할이나 기타 권한이 아니라 Clean Room을 만들었는지 또는 공유받았는지에 따라 결정됩니다.

다음은 공급자 및 컨슈머의 역할에 대한 자세한 내용입니다.

Clean Rooms UI¶

Snowflake Data Clean Rooms는 브라우저에서 관리하고 실행할 수 있습니다. Clean Rooms UI 를 사용하여 공급자 또는 컨슈머로서 Clean Rooms를 생성, 관리 및 사용하거나 관리 계정, 서드 파티 커넥터 및 UI 사용자를 위한 기능 등 다양한 계정 수준 기능을 구성할 수 있습니다.

권한 및 액세스: Clean Room 관리자로부터 Clean Room UI 를 사용할 수 있는 액세스 권한을 부여받아야 합니다.

Clean Room UI 에는 로그인을 위한 이메일 주소, 이름, 비밀번호가 필요합니다. 이메일 주소는 Snowflake 계정 이메일 주소와 일치할 필요는 없지만, Clean Room 관리자가 지정합니다. 사용자 이름과 비밀번호는 사용자가 직접 선택합니다.

Clean Rooms UI 는 Snowflake 웹 애플리케이션인 Snowsight와는 별도의 URL 에서 액세스할 수 있습니다. URL 은 각 계정에 고유합니다.

Clean Rooms UI 사용 방법을 익히려면 Clean Rooms UI 자습서에 따라 실제로 사용해 보거나 Clean Rooms UI에 대한 자세한 내용을 읽어보십시오.

API¶

Snowflake는 Clean Rooms를 만들거나 실행하기 위한 다양한 저장 프로시저를 제공합니다. 이러한 프로시저는 Snowsight 노트북이나 워크시트 또는 기타 명령줄 인터페이스를 통해 호출할 수 있으며, 이를 통해 Snowflake 계정에서 저장 프로시저를 실행할 수 있습니다.

이러한 프로시저를 사용하면 공급자 또는 컨슈머로서 Clean Room을 생성, 관리 또는 사용하는 데 필요한 대부분의 컨슈머 또는 공급자 작업을 수행할 수 있습니다. API 에서는 관리자 작업을 수행할 수 없으며, Clean Room을 관리하려면 웹 앱을 사용해야 합니다. API 에 대한 참조 설명서를 읽어보십시오.

권한 및 액세스: API 를 사용하려면 Snowflake 계정의 Clean Rooms 관리자로부터 samooha_app_role을 사용하기 위한 액세스 권한을 부여받아야 합니다.

Clean Room API 에 대해 읽어보거나 API 자습서에 따라 직접 사용해 보십시오.

Snowflake 계정에 Clean Rooms 환경이 설치되어 있습니까?¶

계정에 Clean Rooms UI 또는 API 가 설치되어 있는지 확인하는 방법은 다음과 같습니다.