Snowflake Data Clean Rooms: 설치된 오브젝트¶
이 항목에서는 클린룸 환경을 설치할 때 계정에 생성되는 오브젝트에 대한 정보를 제공합니다.
애플리케이션 패키지¶
|samooha-clean-room-plural|는 다음 애플리케이션 패키지를 설치합니다.
SAMOOHA_CLEANROOM_cleanroom name
공급자 계정에는 생성된 클린룸당 하나의 애플리케이션 패키지가 있습니다. 여기에는 공급자가 만든 클린룸의 모든 핵심 애플리케이션 논리가 포함되어 있습니다. 또한 클린룸과 데이터를 공유하는 데 사용되는 보안 뷰와 클린룸 상태를 저장하는 여러 테이블도 포함되어 있습니다. 여기에는 컨슈머의 현재 차등 개인정보 보호 예산, 열 및 조인 정책, 클린룸에 연결된 테이블의 이름을 기록하는 테이블이 포함됩니다.
데이터베이스¶
SAMOOHA_BY_SNOWFLAKE¶
이 데이터베이스에는 클린룸을 만들고 관리하는 데 사용되는 모든 핵심 기능과 애플리케이션 논리가 포함되어 있습니다. 이 데이터베이스에는 다음과 같은 스키마가 있습니다.
- ADMIN 스키마
이 스키마에는 다음과 같은 앱 수준 세부 정보가 포함되어 있습니다.
적용된 패치(버전, 명령).
버전 정보(숫자).
- APP_SCHEMA 스키마
이 스키마에는 모든 클린룸 흐름을 원활하게 하는 데 필요한 함수와 프로시저가 포함되어 있습니다. 주요 세부 정보는 다음과 같습니다.
함수를 암호화하고 암호 해독합니다.
개발자 APIs 및 클린룸 UI에서 클린룸을 생성, 설치, 작업하는 데 사용하는 클린룸 프로시저입니다.
- TEMPLATES 스키마
이 스키마에는 Snowflake가 제공하는 SQL Jinja 템플릿이 포함되어 있습니다.
이러한 사전 구축된 템플릿은 Snowflake Data Clean Rooms 내에서 안전한 데이터 협업을 위해 바로 사용할 수 있는 SQL 쿼리를 제공합니다. Jinja 템플릿을 활용해 사용자 지정이 가능하며, 이를 통해 특정 데이터 공유 시나리오에 맞춰 쿼리를 맞춤화할 수 있습니다.
SAMOOHA_BY_SNOWFLAKE_LOCAL_DB¶
이 데이터베이스는 Snowflake 설치 프로세스 중 클린룸 UI에서 생성됩니다. 이는 계정에 로컬로 존재합니다. 애플리케이션은 아니지만 애플리케이션 논리를 포함하고 있습니다.
이 데이터베이스에는 다음 두 가지 유형의 데이터가 있습니다.
사용자와 클린룸 UI가 클린룸을 만들고 관리하는 데 사용하는 개발자 APIs입니다.
ID 확인과 같은 흐름 중 PUBLIC 스키마에 저장되는 사용자가 소유한 중간 데이터 세트입니다. 예를 들어, LiveRamp의 확인 및 트랜스코딩 프로세스의 출력 테이블은 PUBLIC 스키마에 저장되고, 클린룸 UI에 의해 클린룸에 연결되는 뷰에 조인됩니다.
데이터베이스에는 다음과 같은 스키마가 있습니다.
- ADMIN 스키마
이 스키마에는 다음과 같이 계정과 관련된 특정 클린룸 기능을 작동하는 데 필요한 정보가 포함되어 있습니다.
여러 리전이나 클라우드 플랫폼에서 협업하기 위해 클라우드 간 자동 복제를 사용합니다.
개발자 APIs에서 클린룸 UI로 클린룸을 등록하기 위해 필요한 클린룸 메타데이터 업데이트.
Snowflake 계정으로 클린룸 UI의 기능과 관련된 현재 프로시저의 버전 관리.
공동 작업자로부터 다시 공유되는 클린룸 공유 세트의 변경 사항을 수신하고 변경 사항에 따라 필요한 경우 클린룸을 활성화/비활성화할 수 있는 작업 및 스트림.
- CONSUMER 스키마
이 스키마에는 :doc:`컨슈머 API 프로시저</user-guide/cleanrooms/consumer>`의 정의와 몇 가지 일반적인 컨슈머 작업이 포함됩니다.
- ID_HUB 스키마
이 스키마에는 ID 허브와 관련된 프로시저와 중간 테이블이 포함되어 있습니다.
- INFORMATION_SCHEMA 스키마
모든 Snowflake 데이터베이스와 마찬가지로 이 데이터베이스에는 계정에서 만든 오브젝트에 대한 광범위한 메타데이터 정보를 제공하는 시스템 정의 뷰와 테이블 함수 집합으로 구성된 INFORMATION_SCHEMA 스키마(“데이터 사전”)가 포함되어 있습니다.
- LIBRARY 스키마
이 스키마에는
library
네임스페이스 API 프로시저의 정의뿐 아니라 공급자와 컨슈머 모두가 사용하는 몇 가지 일반적인 작업과 프로시저가 포함됩니다.- PROVIDER 스키마
이 스키마에는 :doc:`공급자 API 프로시저</user-guide/cleanrooms/provider>`의 정의와 몇 가지 일반적인 공급자 작업이 포함됩니다.
- PUBLIC 스키마
이 스키마에는 사용자와 클린룸 UI가 클린룸을 만들고 관리하는 데 사용하는 개발자 APIs가 포함됩니다. 또한 ID 확인과 같은 흐름 중 PUBLIC 스키마에 저장되는 사용자가 전적으로 소유한 중간 데이터 세트도 포함되어 있습니다. 예를 들어, LiveRamp의 확인 및 트랜스코딩 프로세스의 출력 테이블은 PUBLIC 스키마에 저장되고 클린룸 UI에 의해 클린룸에 연결되는 뷰에 조인됩니다.
이 스키마에는 다음과 같은 테이블이 있습니다.
CLEANROOM_RECORD: 이 테이블에는 사용자 및 마지막 업데이트 타임스탬프와 함께 클린룸의 상태(생성됨, 삭제됨)가 포함됩니다. 클린룸 UI에서 업데이트가 수행된 경우 사용자는 서비스 계정 사용자입니다. 업데이트가 개발자 APIs를 사용하여 |sf-web-interface|에서 수행된 경우 사용자는 API를 호출한 실제 사용자입니다. 이 테이블에서 클린룸 데이터베이스 이름을 사용자 지정할 수 있습니다.
CONNECTOR_CONFIGURATION: 이 테이블은 계정에 구성된 커넥터 목록입니다.
REPORTS: 이 테이블에는 클린룸 UI에 컨슈머가 저장한 보고서 목록이 포함되어 있습니다. 표준 보고서의 최상위 결과는 테이블에 저장됩니다.
HORIZONTAL_ANALYSIS_<report ID>: 클린룸 UI에서 실행된 SQL 쿼리 템플릿 및 사용자 지정 템플릿으로 실행된 분석의 출력입니다.
CONSUMER_ACTIVATION_SUMMARY: 컨슈머 활성화 결과.
PROVIDER_ACTIVATION_SUMMARY: 공급자 활성화 결과.
이 데이터베이스에는 3개의 공유가 생성됩니다.
SAMOOHA_INTERNAL_GOVERNANCE_SUMMARY SHARE_NAV2: 이 공유에는 PUBLIC 스키마의 GOVERNACE_SUMMARY 및 ACTIVATION 테이블에 대한 뷰가 포함되어 있습니다. 이는 이 계정으로 클린룸을 설치한 모든 공급자와 공유되며, 거버넌스 정보와 공급자 활성화를 다시 공유하는 데 사용됩니다.
SAMOOHA_INTERNAL_LOGS_SHARE_NAV2: 이 공유는 LOG_EVENTS 테이블에 위치하며, 주로 서드 파티 네이티브 앱을 사용하는 경우 ID 해결 프로시저가 어떻게 진행되고 있는지에 대한 로그를 Snowflake에 공유하는 데 사용됩니다. PII 또는 데이터는 다시 공유되지 않으며, 트랜스코딩/해결에 사용된 서드 파티 앱 APIs의 성공/실패 여부만 공유됩니다.
SAMOOHA_INTERNAL_PROVIDER_METADATA_NAV2: 이 공유는 API에서 UI로 등록 요청을 보내는 데 사용되는 ADMIN.METADATA_UPDATE_REQUESTS 그리고 관리형 계정에서 사용량을 기록하는 데에만 사용되는 ADMIN.RESOURCE_MONITOR_USAGE 테이블 두 개에 있습니다.
SAMOOHA_CLEANROOM_cleanroom ID
¶
각 클린룸에는 설치된 템플릿, 요청 로그, LAF 상태 등 해당 클린룸의 모든 세부 정보가 포함된 관련 데이터베이스가 있습니다. 이 데이터베이스에는 다음 스키마가 포함됩니다.
Admin: 암호화 키, 개인정보 보호 예산, 요청 로그, 공급자 분석 요청 등.
Shared_schema: 조인 정책, LAF 상태, 연결된 테이블, 버전.
Templates: 이 클린룸의 활성화 템플릿, 사용자 지정 템플릿, 템플릿 체인 목록.
SAMOOHA_CLEANROOM_REQUESTS_clean room ID
¶
이는 공급자 측에서는 데이터베이스이고 컨슈머 측에서는 공유입니다. 이는 컨슈머용 클린룸 설치 과정의 일부로 컨슈머가 클린룸 공급자에게 다시 보내는 양에 해당합니다. 이 데이터베이스에는 컨슈머가 클린룸에 대해 제기한 모든 요청에 대한 정보가 포함되어 있으며 컨슈머의 차등 개인정보 보호 예산 사용을 추적하는 데 사용됩니다.
SAMOOHA_CLEANROOM_CONSUMER_clean room ID
¶
이 데이터베이스는 컨슈머 계정에만 설치됩니다. 컨슈머 데이터의 보안된 뷰와 같은 오브젝트를 클린룸에 공유하거나, 적용되는 경우 컨슈머 열/조인 정책을 공유하는 데 사용됩니다. 여기에 있는 테이블은 다음과 같습니다.
SAMOOHA_CLEANROOM_CONSUMER_clean room ID.SHARED.REQUESTS
. 이 테이블은 컨슈머가 정확히 어떤 쿼리를 실행하려고 시도했는지 보여줍니다. 여기서 PROPOSED_QUERY는 컨슈머의 템플릿에서 렌더링된 쿼리입니다.
SAMOOHA_SAMPLE_DATABASE¶
이 데이터베이스에는 클린룸에서 사용할 수 있는 샘플 데이터 세트가 포함되어 있습니다.
작업¶
다음은 클린룸에서 사용하는 몇 가지 작업으로, 사용자 환경에서 실행 중인 것을 확인할 수 있습니다.
다음 프로시저를 실행하여 주어진 작업에 대한 자세한 정보를 찾을 수 있습니다.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.DCR_HEALTH.DCR_TASKS_HEALTH_CHECK();
작업 및 웨어하우스 사용 비용을 보는 방법을 알아보세요.
작업 이름 |
설명 |
웨어하우스 |
엔터티 수준 |
---|---|---|---|
|
계정에서 차등 개인정보 보호가 활성화된 경우 공동 작업자로부터 수신되는 공유를 마운트하고, 복구하고, 유효성을 검사합니다. DP가 활성화된 경우 분석이 과도하게 실행되는 것을 방지하기 위해 더 높은 빈도로 동일한 작업이 추가됩니다. 기본 일정: 1분. |
서버리스 |
계정당 |
|
공동 작업자로부터 수신되는 공유를 마운트하고, 복구하고, 유효성을 검사합니다. 기본 일정: 30분. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
생성된 클린룸에 대한 기준 메트릭을 계산합니다. 기본 일정: 3시간. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
조인된 클린룸에 대한 기준 메트릭을 계산합니다. 기본 일정: 3시간. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
각 컨슈머에 대한 활성화를 위해 수신 공유를 마운트합니다. 기본 일정: 15분. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
각 공급자의 클린룸에 있는 각 템플릿에서 개인정보 보호 및 보안 문제를 검사합니다. 기본 일정: 30분. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
컨슈머가 다시 보낸 활성화 데이터의 암호를 해독합니다. 기본 일정: 요청에 의해 트리거됩니다. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
자동 실행 보고서를 설정합니다. 기본 일정: 60분. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
새 버전이 출시되면 네이티브 앱을 자동으로 업그레이드합니다. 기본 일정: 요청에 의해 트리거됩니다. |
SAMOOHA_TASK_WAREHOUSE |
계정당 |
|
자동 실행으로 설정된 보고서를 실행합니다. 기본 일정: 1일. |
사용자가 선택한 웨어하우스. |
계정당 |
|
컨슈머에서 공급자로 다시 스트리밍된 반환 요청에 대한 리스너를 설정합니다. 클린룸이 활성화되었는지 여부를 결정합니다. 기본 일정: 요청에 의해 트리거됩니다. |
SAMOOHA_TASK_WAREHOUSE |
공동 작업자당 |
|
클린룸에 대한 차등 개인정보 보호 예산을 처리합니다. 기본 일정: 요청에 의해 트리거됩니다. |
SAMOOHA_TASK_WAREHOUSE |
공동 작업자당 |
|
클린룸에 대한 템플릿 요청을 처리합니다. 기본 일정: 요청에 의해 트리거됩니다. |
SAMOOHA_TASK_WAREHOUSE |
공동 작업자당 |
PROCESS_PROVIDER_ANALYSIS_REQUESTS |
실제 공급자 분석을 실행합니다. 기본 일정: 요청에 의해 트리거됩니다. |
|
클린룸당 |
|
공급자 분석 인프라를 설정하고 공급자 분석 요청을 처리합니다. 기본 일정: 요청에 의해 트리거됩니다. |
SAMOOHA_TASK_WAREHOUSE |
클린룸당 |
|
모든 클린룸의 개인정보 보호 예산을 재설정합니다. 기본 일정: 1일. |
SAMOOHA_TASK_WAREHOUSE |
클린룸당 |
|
클린룸에 연결된 데이터 세트의 고유 값을 계산하여 필터 드롭다운을 활성화합니다. 기본 일정: 1일. |
SAMOOHA_TASK_WAREHOUSE |
클린룸당 |
|
각 웨어하우스에 대해 예약된 보고서를 실행합니다. 보고하는 웨어하우스를 사용합니다. 기본 일정: 1일. |
DCR_WH_* |
클린룸 보고서당 |
웨어하우스¶
|samooha-clean-room-plural|는 계정에 다음 웨어하우스를 설치합니다. 필요에 따라 웨어하우스의 크기를 변경할 수 있습니다.
웨어하우스 이름 |
참고 |
---|---|
APP_WH |
XSMALL 웨어하우스가 API에 액세스할 수 있으며, 새로운 클린룸을 설정하고, 권한 및 데이터 공유를 관리합니다. |
DCR_WH_SMALL |
일반 SMALL 웨어하우스 |
DCR_WH_Medium |
일반 MEDIUM 웨어하우스 |
DCR_WH_Large |
일반 LARGE 웨어하우스 |
DCR_WH_XLarge |
일반 XLARGE 웨어하우스 |
DCR_WH_2XLARGE |
일반 XXLARGE 웨어하우스 |
DCR_WH_4XLarge |
일반 X4LARGE 웨어하우스 |
DCR_WH_OPT_XLarge |
Snowpark에 최적화된 XLARGE 웨어하우스 |
DCR_WH_OPT_2XLarge |
Snowpark에 최적화된 XXLARGE 웨어하우스 |
DCR_WH_OPT_4XLarge |
Snowpark에 최적화된 X4LARGE 웨어하우스 |
PROVIDER_RUN_<cleanroom_identifier> |
공급자가 실행한 분석을 실행하는 컨슈머 계정의 웨어하우스입니다. |
SAMOOHA_TASK_WAREHOUSE |
개인정보 보호 및 보안 검사, 자동 실행 보고서 처리, 데이터 통계 계산, 컨슈머 템플릿 요청 처리 등 다양한 작업에 사용되는 XSMALL 웨어하우스. |
DCR_ACTIVATION_WAREHOUSE |
공급자에게 전송된 활성화 결과의 암호를 해독하는 데 사용됩니다. 기본 크기는 XL이지만, ``provider.update_activation_warehouse``를 호출하여 크기를 수정할 수 있습니다. |