Snowflake Data Clean Room 환경과 함께 설치되는 항목들이에요.

기능 — 일반 공급

현재 these regions에서 사용할 수 있어요.

정부 및 VPS 배포 환경에서는 사용할 수 없어요.

이 항목에서는 Snowflake Data Clean Room 환경을 설치하고 콜라보레이션을 생성하거나 참여할 때 계정에 생성되는 객체에 대한 정보를 제공해요. Provider 및 Consumer Clean Room에 대한 자세한 내용은 Snowflake Data Clean Rooms: Installed objects를 참조하세요.

출처: 문서

본문

개괄

다음 다이어그램은 양자 간 협업을 단순화하여 나타낸 것입니다:

다이어그램에 대한 참고 사항:

이 다이어그램은 Data Clean Rooms Collaboration API를 사용하여 협업을 만들고 관리하는 두 협업자를 보여줍니다.

다이어그램의 협업 정의 YAML에 표시된 대로 협업자 A는 소유자이자 생성자입니다.
다이어그램의 데이터 오퍼링 공유에 표시된 대로 협업자 A와 B는 모두 데이터 제공자입니다.
협업 정의가 허용하는 경우 협업자 A와 B는 모두 분석 실행자로 활동할 수 있습니다.
협업자 B는 협업에 템플릿을 추가했습니다.
Secure Collaboration Orchestrator(SCO)는 해당 리전의 모든 계정에 대한 협업을 관리하는 데 사용되는 전용 Snowflake 계정입니다. 각 리전마다 SCO가 있습니다. 협업에 대한 SCO는 소유자의 계정 리전에 따라 결정됩니다.
각 협업에 대해 SCO는 앱 패키지와 함께 리스팅을 생성합니다. 협업자는 이 리스팅에서 SFDCR_*collaboration_name*이라는 애플리케이션을 설치하며, 이를 통해 협업에 액세스할 수 있습니다.
협업자는 로컬 SAMOOHA_BY_SNOWFLAKE_LOCAL_DB의 DCR Collaboration API를 통해 협업과 상호 작용합니다.

협업자는 데이터 오퍼링을 생성하고, SCO는 협업 정의에 따라 해당 데이터를 협업자와 공유합니다. SCO는 협업, 데이터 오퍼링, 템플릿 및 분석 사양을 사용하여 어떤 템플릿으로 누가 어떤 데이터에 액세스할 수 있는지, 어떤 데이터를 누구에게 활성화할 수 있는지, 자유 형식 SQL 액세스가 제공되는지 여부와 같은 협업 정책을 적용합니다.

애플리케이션

다음 애플리케이션은 Snowflake Data Clean Rooms 환경을 설치하거나 협업에 참여할 때 설치됩니다:

Data Clean Rooms 네이티브 애플리케이션 SAMOOHA_BY_SNOWFLAKE

Snowflake Data Clean Rooms 환경 설치 중에 설치되는 애플리케이션입니다. 각 계정에는 Snowflake Data Clean Rooms Marketplace 리스팅에서 이 부트스트래퍼 애플리케이션이 설치됩니다. 이 애플리케이션은 로컬 DB에서 사용하는 라이브러리 프로시저, 위임 역할 및 헬퍼 함수를 제공하며 로컬 DB 및 클린룸 객체에서 작동합니다.

협업 애플리케이션 SFDCR_*collaboration_name*

계정이 참여하는 협업별로 설치되는 애플리케이션입니다. 설치 계정에 맞게 필터링된 보안 뷰(예: DATA_OFFERINGS, TEMPLATE_SPECS, CODE_SPECS)가 있는 COLLABORATION 스키마와 참여, 실행 및 탈퇴 작업을 처리하는 저장 프로시저가 있는 COLLABORATION_INTERNAL 스키마를 제공합니다. 클린룸 로컬 DB에 쓰고 SCO로 메시지를 다시 보냅니다.

데이터베이스

다음 데이터베이스는 Snowflake Data Clean Rooms 환경을 설치하거나 협업에 참여할 때 생성됩니다:

SFDCR_LOCAL_*collaboration_name*

활성화된 데이터 및 로컬 전용 데이터의 뷰를 포함하여 설치된 협업에 로컬인 정보를 포함합니다.

SAMOOHA_BY_SNOWFLAKE_LOCAL_DB

이 데이터베이스는 계정에 Snowflake Data Clean Rooms 환경을 설치할 때 생성됩니다. 계정에 로컬입니다. 애플리케이션은 아니지만 애플리케이션 로직을 포함합니다.

이 데이터베이스에는 다음 스키마가 있습니다:

ADMIN 스키마

권한 관리, 버전 정보 및 외부 테이블 분석 활성화를 포함한 관리 기능을 위한 로컬 DB의 스키마입니다.

COLLABORATION 스키마

협업 클린룸 기능을 위한 로컬 DB의 기본 스키마입니다. 메시지 처리를 위한 태스크, 스트림 및 프로시저를 포함합니다.

REGISTRY 스키마

등록된 템플릿, 데이터 오퍼링, 코드 사양 및 객체-레지스트리 매핑 테이블을 저장합니다.

*registry_name*_REGISTRY 스키마

사용자 지정 레지스트리를 만들 때 생성되는 스키마입니다. 예를 들어 sales_data라는 사용자 지정 레지스트리를 만들면 시스템은 sales_data_registry라는 스키마를 생성합니다.

공유 및 리스팅

다음은 협업에서 정의된 역할에 따라 협업별로 관련되고 생성되는 공유 및 리스팅입니다. **``**``**``**``**``**``**

객체 이름/형식	유형	설명
SFDCR: SCO collaboration_id	Incoming Listing	SCO가 사용자가 생성하거나 초대된 모든 협업에 대해 공유하는 리스팅입니다.
SCO_DATA_OFFERINGS_LISTING_hash	Outgoing Listing	데이터 제공자가 협업자에게 공유하는 데이터 오퍼링의 리스팅 이름입니다.
SCO_ACTIVATION_LISTING_hash	Outgoing Listing	분석 실행자가 다른 협업자에게 공유하는 활성화 결과의 리스팅 이름입니다.
SCO_STAGED_CODE_LISTING_hash	Outgoing Listing	코드 제공자가 코드 실행을 위해 분석 실행자에게 공유하는 스테이징된 코드의 리스팅 이름입니다.
SCO_DATA_OFFERINGS_SHARE_hash	Outgoing Share	데이터 제공자가 데이터 오퍼링(데이터셋, 정책)을 협업자에게 공유하기 위해 생성하는 공유입니다.
SCO_ACTIVATION_SHARE_hash	Outgoing Share	분석 실행자가 활성화 결과를 다른 협업자에게 다시 공유하기 위해 생성하는 공유입니다.
SCO_STAGED_CODE_SHARE_hash	Outgoing Share	코드 제공자가 코드 실행을 위해 분석 실행자에게 생성하는 공유입니다.

태스크

다음은 새로운 Snowflake Data Clean Rooms 환경 운영과 관련된 태스크입니다. 레거시 제공자 및 소비자 클린룸 관련 태스크는 Snowflake Data Clean Rooms: 설치된 객체를 참조하세요. ``

****

Task 이름	설명	Warehouse
EXPECTED_VERSION_TASK	새 버전이 출시됨에 따라 네이티브 앱과 로컬 db를 자동으로 업그레이드합니다. 빈도: 요청에 따라 트리거됩니다.	SAMOOHA_TASK_WAREHOUSE
collaboration_name_hash_OWNER_AUTO_JOIN	소유자가 시작한 협업에 자동으로 참여하도록 소유자가 활성화하는 Task입니다. 빈도: 1분마다 실행되며 1시간 후 일시 중단됩니다.	사용자가 지정한 Warehouse

샘플 데이터

샘플 데이터는 SAMOOHA_SAMPLE_DATABASE 데이터베이스에 저장됩니다. 이 데이터베이스에는 테스트 데이터로 사용할 수 있는 DEMO.CUSTOMERS 및 DEMO.CUSTOMERS_2라는 샘플 데이터 테이블이 포함되어 있습니다.

참고

CUSTOMERS_2 테이블은 2025년 9월에 추가되었습니다. 그 이전에 Clean Rooms 환경을 설치했다면 이 샘플 테이블이 설치되지 않았을 수 있습니다. CUSTOMERS_2가 설치되어 있는지 확인하려면 다음 SQL 코드를 실행할 수 있습니다.

SHOW TABLES LIKE 'CUSTOMERS_2' IN SCHEMA SAMOOHA_SAMPLE_DATABASE.DEMO;

응답에 행이 없으면 사용자 또는 ACCOUNTADMIN 역할을 가진 사람이 다음 명령을 실행하여 샘플 테이블을 설치해야 합니다.

USE ROLE ACCOUNTADMIN;
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;

Warehouses

Snowflake Data Clean Rooms는 계정에 다음 warehouse를 설치합니다. 필요에 따라 모든 warehouse의 크기를 변경할 수 있습니다. 일반적인 Clean Room 편집, 생성 또는 삭제 명령에는 XS warehouse를 사용하는 것이 좋습니다. 대규모 분석(예: 머신 러닝 워크로드)을 실행할 때는 더 큰 warehouse 또는 Snowpark-optimized warehouse를 사용하는 것이 좋습니다.

warehouse 사용 비용을 확인하는 방법 알아보기.

Warehouse 이름	비고
APP_WH	XSMALL warehouse로, 기본적으로 SAMOOHA_APP_ROLE에 액세스 권한이 제공됩니다.
SAMOOHA_TASK_WAREHOUSE	자동 업그레이드와 같은 작업에 사용되는 XSMALL warehouse입니다.

Snowflake Data Clean Room 환경과 함께 설치되는 항목들이에요.