Snowflake Data Clean Rooms 환경 설치하기

시작하기 전에

  • 계정에 Snowflake Data Clean Room 환경이 설치되어 있지 않은 경우 이 페이지의 설치 지침을 따릅니다.

  • 계정에 클린룸 환경이 설치되어 있고 이 환경에 액세스하려는 경우, 관리자에게 계정에서 클린룸 작업을 수행할 수 있는 적절한 권한을 요청합니다.

지원되는 리전

Snowflake Data Clean Rooms 는 다음 클라우드 리전의 Snowflake 계정에서 사용할 수 있습니다.

클라우드 플랫폼

지원되는 리전

Amazon Web Services(AWS)

  • 남아메리카(상파울루)

  • US 동부(북부 버지니아)

  • US 동부(오하이오)

  • US 서부(오레곤)

  • 캐나다(중부)

  • 유럽(런던)

  • EU(아일랜드)

  • EU(프랑크푸르트)

  • EU(파리)

  • EU(스톡홀름)

  • EU(취리히)

  • 아프리카(케이프타운)

  • 아시아 태평양(뭄바이)

  • 아시아 태평양(싱가포르)

  • 아시아 태평양(도쿄)

  • 아시아 태평양(오사카)

  • 아시아 태평양(서울)

  • 아시아 태평양(자카르타)

  • 아시아 태평양(시드니)

Microsoft Azure

  • 중부 US(아이오와)

  • 동부 US 2(버지니아)

  • 멕시코 중부(케레타로)

  • 중남부 US(텍사스)

  • 서부 US 2(워싱턴)

  • 캐나다 중부(토론토)

  • 북유럽(아일랜드)

  • 스웨덴 중부(예블레)

  • 스위스 북부(취리히)

  • UAE 북부(두바이)

  • UK 남부(런던)

  • 서부 유럽(네덜란드)

  • 인도 중부(푸네)

  • 동남아시아(싱가포르)

  • 일본 동부(도쿄)

  • 대한민국 중부(서울)

  • 호주 동부(뉴사우스웨일즈)

Google Cloud(GCP)

  • US 중부1(아이오와)

  • US 동부4(북부 버지니아)

  • 중동 중부 2(담맘)

  • 유럽 서부(프랑크푸르트)

  • 유럽 서부2(런던)

  • 유럽 서부4(네덜란드)

Snowflake Data Clean Rooms 설치 요구 사항

계정, 설치 관리자 및 사용자 요구 사항

Clean Room 환경을 설치하는 경우 Snowflake 계정의 잠재적인 모든 사용자를 위해 설치합니다. 그러나 Clean Room 환경에 대한 액세스 권한은 Clean Room 관리자가 명시적으로 사용자에게 부여해야 합니다.

Snowflake 계정에 Snowflake Data Clean Rooms 를 설치하기 위한 요구 사항은 다음과 같습니다.

  • 계정은 필수 Snowflake Edition 어야 합니다.

    • 공동 작업을 생성하고 소유자가 되려면 Standard Edition 이상이 있어야 합니다.

    • 분석 실행자로 공동 작업에 조인하려면 Standard Edition 이상이 있어야 합니다.

    • 데이터 공급자로 공동 작업에 조인하거나 다른 공동 작업자에게 데이터를 활성화하려면 Enterprise Edition 이상이 있어야 합니다.

  • **설치 관리자가 해당 역할 요구 사항 을 충족**해야 합니다.

  • 독자 계정은 클린룸 애플리케이션을 설치하고 실행하는 데 필요한 데이터 공유를 허용하지 않으므로 독자 계정은 지원되지 않습니다.

  • 데이터 공유 약관에 동의해야 합니다. Snowflake 고객 제어 데이터 공유 기능 약관 을 수락하지 않은 경우 Snowflake 지원팀 에 문의하시기 바랍니다. Snowflake Data Clean Rooms는 Snowflake Service의 일부로 제공되고 Snowflake 고객 제어 데이터 공유 기능 약관과 Snowflake 사용 제한 정책 을 포함한 Snowflake Service 약관이 적용되는 목록 을 활용합니다.

  • 지원되지 않는 계정 수준 매개 변수를 설정 해제해야 합니다. :ref:`지원되지 않는 계정 수준 설정 목록<label-dcr_unsupported_parameters>`을 참조하세요.

이러한 요구 사항을 모두 충족하지 못하여 업그레이드가 필요한 경우 Snowflake 지원 으로 문의하십시오.

지원되지 않는 계정 수준 매개 변수

Snowflake Data Clean Rooms는 특정 계정 수준 매개 변수 값을 지원하지 않습니다. 다음 테이블은 이러한 매개 변수에 필요한 값을 보여줍니다.

매개 변수 이름

필요한 값

참고

DEFAULT_DDL_COLLATION

지원되는 값이 없으며, null이어야 합니다.

:doc:`계정 수준 데이터 정렬</sql-reference/collation>`은 지원되지 않습니다.

QUOTED_IDENTIFIERS_IGNORE_CASE

false

계정에서 매개 변수를 확인하려면 다음 SQL 명령을 실행하고 매개 변수 이름을 :code:`<parameter_name>`으로 바꿉니다.

SHOW PARAMETERS LIKE '<parameter_name>' IN ACCOUNT;

예:

SHOW PARAMETERS LIKE 'DEFAULT_DDL_COLLATION' IN ACCOUNT;

계정 및 사용자 요구 사항

다음은 Clean Room 환경을 설치하는 사용자의 역할에 대한 요구 사항입니다.

  • 해당 계정에 Clean Room 환경을 설치하려면 Snowflake 계정에 ACCOUNTADMIN 역할이 있어야 합니다.

  • ACCOUNTADMIN 역할이 있는 사용자에게는 사용자 오브젝트에 대해 정의된 유효한 이름, 성 및 이메일이 있어야 합니다. 확인하려면 DESCRIBE USER 를 실행하십시오.

Snowflake Data Clean Rooms 환경 설치

Snowflake 계정에 Clean Room 환경을 설치하려면 다음 단계를 따릅니다.

네이티브 앱(1단계)을 항상 설치해야 하지만, 그 후에 코드를 사용하기 위해 Clean Room API를 활성화할 수 있습니다(2단계).

1. 네이티브 애플리케이션 설치하기

Marketplace에서 네이티브 애플리케이션을 설치합니다.

  1. 현재 역할을 ACCOUNTADMIN 으로 설정합니다.

  2. Snowflake Marketplace에서 Snowflake Data Clean Rooms 애플리케이션 을 설치합니다.

  3. Open 을 선택하고 기본 옵션을 수락합니다.

설치에는 몇 분 정도 소요됩니다. 완료되면 2단계로 진행합니다.

2. 클린룸 API 설치

Clean Room API는 UI 또는 API를 통해 Clean Room을 사용해야 합니다.

Snowflake 계정에서 클린룸 API를 설치하는 단계는 다음과 같습니다.

  1. 네이티브 애플리케이션을 설치한 후 Snowflake에서 실행합니다. 탐색 메뉴에서 Catalog » Apps » Snowflake Data Clean Rooms 를 선택합니다. 오른쪽 상단에 있는 Open in Worksheet 버튼을 클릭합니다. 그러면 SQL 명령이 포함된 워크시트가 열립니다.

  2. 다음 참고 사항을 통해 SQL 명령을 실행하여 클린룸 API를 설치합니다.

    • 설치 중에 네이티브 애플리케이션의 이름을 변경한 경우 스크립트 설명에 표시된 대로 스크립트를 수정해야 합니다.

    • 실행하기 전에 전체 설치 스크립트를 검토하려면 DRY_RUN=TRUE 스크립트 줄의 주석 처리를 해제하고 해당 줄까지의 모든 명령을 실행하여 스크립트 내용을 확인하십시오. 해당 명령에 의해 노출되는 설치 스크립트를 수동으로 실행하면 불완전한 설치가 될 수 있으므로 수동으로 실행하지 마십시오.

    • 설치하는 데 몇 분 정도 걸립니다.

  3. API 에 액세스할 수 있는지 확인합니다.

    USE ROLE SAMOOHA_APP_ROLE;
    USE WAREHOUSE app_wh;
    CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.CHECK_MOUNT_STATUS();
    

    FALSE가 반환되는 경우 SAMOOHA_APP_ROLE을 사용 중인지 확인하고, 사용하는 경우 ACCOUNTADMIN 역할을 다시 수행하여 마운트 스크립트 명령을 다시 실행해 보세요.

다음 단계

계정에 Clean Room 환경을 성공적으로 설치했으면 다음을 진행할 수 있습니다.

  • :doc:` 개발자를 추가합니다. </user-guide/cleanrooms/manage-access>` 특정 권한에 따라 Clean Room 환경에 액세스할 수 있도록 Snowflake 계정의 역할에 대한 액세스 권한을 부여합니다.

  • 클라우드 간 자동 복제를 활성화합니다. 기본적으로, Clean Room은 동일한 기본 클라우드 리전의 참여자와만 공유할 수 있습니다. 다른 클라우드 리전 공동 작업자와의 공동 작업을 활성화하려면 계정에 대해 클라우드 간 자동 복제를 활성화해야 합니다.

  • 자동 클린룸 버전 업데이트를 활성화합니다. Snowflake에서 새 버전이 출시될 때마다 클린룸 API 환경이 자동으로 업데이트되도록 활성화합니다. 업데이트를 수동으로 설치할 수도 있지만, 자동 업데이트를 활성화하는 것이 좋습니다.