Snowflake Data Clean Rooms 의 개요¶

Clean Room 환경 설치¶

The Snowflake Data Clean Room environment is installed once for an entire Snowflake account (not once per user or per clean room) by someone with ACCOUNTADMIN privileges on the Snowflake account.

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

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

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

Clean Room 만들기¶

A Snowflake account administrator grants permission to users in their Snowflake account to be able to create clean rooms. The account that creates a clean room is called a provider for that clean room. Providers can configure and share clean rooms with users in other Snowflake accounts (or even non-Snowflake users). When a clean room is shared with you, you are called a consumer for that clean room.

After creating a clean room, the provider links (imports) tables or views into it, specifies what queries can be run against their data, which columns in their data can be joined or appear in the results, and what can be done with the results.

The provider then invites consumers to join the clean room, link their own tables and views, and run one of the queries specified by the provider. Consumers must be pre-approved by a clean rooms administrator before they can be invited to a 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 계정 또는 공급자가 지정한 서드 파티 활성화 커넥터)로 결과를 내보낼 수 있습니다.

클린룸으로 가져온 데이터는 공급자 또는 컨슈머 어느 쪽이든 직접 쿼리하거나 볼 수 없지만, 클린룸의 템플릿을 통해서만 액세스할 수 있습니다. 템플릿은 공급자 또는 컨슈머가 클린룸에 설치한 SQL 쿼리이며, 클린룸에서 사용하려면 상대방의 허가가 있어야 합니다.

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

기본적으로 컨슈머만 클린룸에서 템플릿을 실행할 수 있지만, 공급자는 클린룸에서 지정된 템플릿을 실행하기 위해 컨슈머에게 권한을 요청할 수 있습니다.

Templates¶

Every clean room has one or more templates installed. A template is a JinjaSQL query that typically includes run-time parameters provided by the template runner. These parameters enable users to specify column or table names or WHERE clause filters. You cannot simply run arbitrary SQL queries in a clean room (unless a provider grants that ability); most clean room usage is limited to templates submitted by the provider or consumer and approved by the other party.

Snowflake provides a few stock templates for common use cases such as audience overlap and reach and frequency templates. You can also create custom templates to use in your clean room. Snowflake Data Clean Rooms supports any valid JinjaSQL template.

템플릿은 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 외부로 데이터를 내보내려면 항상 쿼리 대상 데이터를 공유한 모든 당사자의 승인을 받아야 합니다.

• 당사자 중 어느 쪽이든 실행하는 쿼리로 호출할 수 있는 :doc:`사용자 지정 Python 코드</user-guide/cleanrooms/demo-flows/custom-code>`를 포함할 수 있도록 허용합니다. 이 코드는 일반적으로 쿼리가 실행될 때 어떤 방식으로든 데이터를 필터링하거나 조작합니다. 파일 저장, 데이터 내보내기 또는 기타 작업 수행과 같은 외부 작업은 수행할 수 없습니다.

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

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

공급자 및 컨슈머 정보¶

Clean room collaborators are classified as either a provider or a consumer for a given clean room. A provider is the account that creates a clean room; a consumer is an account that is shared a clean room. You cannot invite someone in the same account where you created a clean room to act as a consumer for that clean room. All users in the same Snowflake account have the same clean room role (provider or consumer) for the same clean rooms in that account.

The provider and consumer roles apply at the Snowflake account level, not the individual user level. That is, if you create clean room cleanroom1 using Snowflake account ABC, then share cleanroom1 with account XYZ, all ABC users with access to cleanroom1 are providers, and all XYZ users with access to cleanroom1 are consumers.

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

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

Clean Rooms UI¶

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

The clean rooms UI is accessed at a separate URL from Snowsight. You can find the login URL here.

Permissions and access: You must be granted access to use the clean room UI by a clean room administrator. The clean rooms UI uses your Snowflake credentials.

Try out the clean rooms UI tutorial or read more about the clean rooms UI.

API¶

Snowflake provides a number of stored procedures to create, manage, and run clean rooms. These procedures can be called through Snowsight notebooks or worksheets or any interface where you can run stored procedures in your Snowflake account. The API does not enable clean room account administration; to administer a clean room account you must use the clean rooms UI.

Permissions and access: In order to use the API you must be granted access to use the SAMOOHA_APP_ROLE by the a clean rooms administrator for your Snowflake account.

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

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

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