데이터 Clean Rooms 개발자 가이드예요

데이터 Clean Rooms 개발자 가이드예요

기능 — 일반 공개

현재 이들 리전에서 사용할 수 있어요.

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

이 항목에서는 Snowflake Data Clean Rooms collaborations을 프로그래밍 방식으로 생성하거나 관리하려는 사용자를 위한 지침을 제공해요.

출처: 문서

본문

개발 도구

다음은 Snowflake Data Clean Rooms 협업을 위한 주요 개발자 도구예요.

  • 코딩 환경: Snowflake 계정에서 저장 프로시저를 실행할 수 있는 모든 코딩 환경이 작동해요. 대부분의 개발자는 Snowsight(브라우저 기반 도구)의 워크시트나 Snowflake CLI를 사용해요.

  • Cortex Code: Data Clean Room 프로시저는 Cortex Code를 통해 에이전트 기반 경험으로도 사용할 수 있어요.

환경 설정

Snowflake Data Clean Rooms API를 효과적으로 사용하기 위해 코딩 환경을 설정하는 몇 가지 팁을 소개할게요.

Collaboration API 사용하기

Snowflake는 협업을 생성하고 관리하기 위한 Data Clean Rooms Collaboration API를 제공해요. 이 API는 Snowflake 계정에 액세스할 수 있는 모든 환경에서 실행할 수 있는 저장 프로시저로 구성되어 있어요. 여기에는 Snowsight 노트북, 워크스페이스, 워크시트 및 Snowflake CLI가 포함돼요.

여기 문서에서는 SQL 사용법을 보여 주지만, Python이나 기타 지원되는 Snowflake 언어를 사용할 수도 있어요.

특정 DCR 권한을 통해 사용자에게 전체 API 또는 일부에 대한 액세스 권한을 부여할 수 있어요.

참고

Collaboration API를 사용하려면 적절한 DCR 권한이 필요해요. 세분화된 역할 기반 액세스 제어를 통해 사용자 하위 그룹에 특정 프로시저에 대한 제한된 액세스 권한을 부여할 수 있어요.

SAMOOHA_APP_ROLE에는 전체 API에 대한 사전 구성된 액세스 권한이 있어요.

웨어하우스 선택하기

Collaboration API는 자신의 역할에 USAGE 권한이 있는 웨어하우스에서 사용해야 해요. APP_WH는 사용할 수 있는 여러 웨어하우스 중 하나예요. 필요에 맞는 적절한 웨어하우스를 선택하세요.

일반적인 협업 편집, 생성 또는 삭제 명령에는 표준 웨어하우스면 충분해요. 머신 러닝 워크로드와 같은 대규모 분석을 실행할 때는 더 큰 웨어하우스나 Snowpark 최적화 웨어하우스 사용을 고려해 보세요. 협업을 검토하거나 참여할 때 Snowpark 최적화 웨어하우스를 사용한다면 MAX_CONCURRENCY_LEVEL이 2 이상으로 설정되어 있는지 확인하세요.

테스트 계정 설정하기

다자간 협업을 개발하고 테스트하려면 전체 코딩 액세스 권한이 있는 계정이 최소 두 개 이상 있어야 해요.

사용 사례에 따라 cross-cloud behavior를 테스트하기 위해 다른 클라우드 호스팅 리전에 Snowflake 테스트 계정을 두는 것도 좋아요.

테스트 Snowflake 계정 이름은 일반적인 용도를 알 수 있게 의미 있게 지어 보세요. 예를 들어 “Cross-cloud account” 또는 “Standard Edition account”처럼요. 테스트 계정이 여러 개일 때 Clean Rooms 로그인 페이지에서 계정을 선택해야 하는 경우에 도움이 돼요.

참고 자료 및 리소스

다음 항목은 Snowflake Data Clean Room 개발자에게 유용해요.

참고 항목:

샘플 데이터:

문제 해결: 팁은 data clean room troubleshooting guide를 참조하세요.

유용한 협업 메타데이터: metadata cheat sheet를 참조하여 협업에 대한 유용한 메타데이터를 가져오는 방법을 알아보세요. 예를 들어 협력자(자신 포함)가 특정 협업을 설치했는지 여부를 확인할 수 있어요.

API 쿼리 기록 보기: 지금까지 실행한 Collaboration API(또는 기타) 호출 기록을 보려면 다음 단계를 따르세요:

  1. Snowsight에 로그인하세요.

  2. 탐색 메뉴에서 모니터링 » 쿼리 기록을 선택하세요.

  3. 필터를 사용하여 분석과 연결된 쿼리를 찾은 다음 해당 쿼리 또는 분석을 선택하세요.

기능 예시: Collaboration API의 다양한 기능을 사용하는 방법을 이해하려면 Snowflake DCR 문서의 사용 사례 및 핵심 개념 및 기능 섹션에 있는 예시를 참조하면 돼요.

추가 예시 및 동영상: 추가 코드 예시, 튜토리얼 및 동영상은 샘플 워크시트 및 동영상에서 확인할 수 있어요.

더 알아보기 (Learn more)