Snowflake Data Clean Rooms 개발자 가이드¶

개발 도구¶

Clean Rooms를 위한 주요 개발자 도구는 다음과 같습니다.

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

• The clean rooms UI: Use the clean rooms UI to configure, manage, or create clean rooms. Most clean room analysts use the UI rather than code, so it’s important to see and test the experience of your clean rooms in the UI. Additionally, there are a handful of features that are available only in the clean rooms UI.

• Snowsight 는 데이터베이스 및 기타 오브젝트를 탐색하고 오브젝트를 검색하는 데 유용합니다.

• Clean rooms API: API documentation is divided into provider and consumer topic pages.

코딩 설정¶

-- Set up environment.
USE ROLE SAMOOHA_APP_ROLE;
USE WAREHOUSE app_wh;

-- Call your clean rooms API functions.
...

GRANT USAGE ON WAREHOUSE <your_warehouse> TO SAMOOHA_APP_ROLE;`

계정, 사용자 및 역할 설정하기¶

You aren’t required to use the clean rooms UI to develop clean rooms: most clean room functionality is available by calling the API. However, a few features are available only in the UI, and some are faster to perform in the UI. And because many users use the UI exclusively, it’s important to see how your clean room behaves in the UI. Therefore, you should ask a clean room administrator to add you as a clean room manager or higher in the appropriate clean room accounts.

사용 사례에 따라 다른 웹 호스팅 리전에 추가 Snowflake 계정을 설정하여 :doc:`클라우드 간 동작</user-guide/cleanrooms/enabling-laf>`을 테스트할 수도 있습니다.

Name your test Snowflake accounts meaningfully to indicate their typical usage: for example, “Consumer account,” “Provider account,” and “Cross-cloud account.” This can help when you have multiple test accounts and must choose an account on the clean rooms login page.

클린룸 환경에 설치된 항목 확인¶

Snowflake Data Clean Rooms는 설치 시 많은 로컬 데이터베이스를 생성합니다. :doc:`/user-guide/cleanrooms/installation-details`에서 클린룸 패키지로 실행되거나 설치된 작업 및 오브젝트에 대한 세부 정보를 찾을 수 있습니다.

샘플 데이터¶

클린룸 환경은 사용할 수 있는 :ref:`몇 가지 샘플 데이터 세트<label-dcr_samooha_sample_database>`를 설치합니다.

Snowflake를 사용하여 :doc:`합성 테스트 데이터를 생성</user-guide/synthetic-data>`할 수도 있습니다.

Clean Rooms UI 와 코드에서 동일한 계정을 사용하고 있는지 확인하기¶

예를 들어 코드에서 Clean Room을 만든 다음 Clean Rooms UI 에서 그 모양을 확인할 때와 같이 코딩 환경과 Clean Rooms UI 를 동일한 Snowflake 계정으로 열어야 하는 경우가 많습니다. 각각에서 동일한 Snowflake 계정을 사용하고 있는지 확인하는 것이 중요합니다.

Snowsight does not have a shortcut to open the clean rooms UI for the same account, or the reverse, so you must be sure to log in to the same account in each environment.

Clean Room 이름과 Clean Room ID¶

When using the API, for procedures that take a clean room name argument, determine whether to use the clean room name or the clean room ID as follows:

• API 를 사용하여 Clean Room을 생성한 경우 Clean Room 이름 을 사용합니다.

• 클린룸이 클린룸 UI에 생성된 경우 클린룸 **ID**를 사용합니다. provider.view_cleanrooms 또는 ``provider.describe_cleanroom``을 호출하여 클린룸 이름과 ID를 모두 볼 수 있습니다.

Update your clean room whenever you make UI changes¶

When you change any clean room properties that affect the UI, call provider.create_or_update_cleanroom_listing to propagate the changes.

코드 또는 UI 에서 생성된 Clean Rooms 간의 상호 운용성¶

When you create a clean room using the API, some features are not modifiable in the clean rooms UI. For example, you cannot add additional templates, even stock Snowflake templates, in code for a UI-created clean room. You also cannot change the differential privacy settings.

컨슈머가 조인 정책을 설정하거나 조인된 클린룸에서 다른 기본 작업을 수행할 수 없음¶

적절한 역할(SAMOOHA_APP_ROLE)로 Clean Room을 설치했는지 확인합니다. Clean Room을 설치할 때 SAMOOHA_APP_ROLE 을 사용하지 않았다면 일반적으로 권한 오류와 같은 많은 문제가 발생할 수 있습니다. 이 경우 consumer.uninstall_cleanroom 조차도 실패하므로 올바른 역할을 하는 Clean Room을 제거한 다음 다시 설치하는 추가 단계를 수행해야 합니다.

-- Who owns the clean room?
SHOW SHARES LIKE 'SAMOOHA_CLEANROOM_REQUESTS_<cleanroom_name>';

-- If the owner role is not SAMOOHA_APP_ROLE, you must drop the share, then
-- uninstall the clean room.
DROP SHARE SAMOOHA_CLEANROOM_REQUESTS_<cleanroom_name>;
CALL samooha_by_snowflake_local_db.consumer.uninstall_cleanroom($cleanroom_name);
USE ROLE SAMOOHA_APP_ROLE;
CALL samooha_by_snowflake_local_db.consumer.install_cleanroom($cleanroom_name, '<provider_locator>');

생성한 Clean Room을 찾을 수 없음¶

한 계정에서 Clean Room을 만들었는데 공동 작업자의 계정에서 볼 수 없는 경우 몇 가지 이유가 있을 수 있습니다.

• Clean Room이 다른 클라우드 호스팅 리전에서 생성되었으며 클라우드 간 자동 복제 를 활성화하지 않았습니다.

• provider.create_or_update_cleanroom_listing 을 호출하여 Clean Room을 게시하지 않았습니다.

• provider.view_cleanrooms() 대신 consumer.view_cleanrooms() 를 호출하고 있습니다(또는 그 반대).

• Clean Room을 공유하지 않았거나, 잘못된 계정으로 Clean Room을 공유했거나, Snowsight/Clean rooms UI/CLI 에서 잘못된 공동 작업자 계정에 로그인했습니다. Clean Room을 볼 수 있는 계정이 Clean Room을 공유한 계정인지, 그리고 해당 공유 계정에 로그인되어 있는지 확인합니다.

• Clean Room을 게시한 후 공동 작업자가 볼 수 있는 시점까지는 약간의 지연이 있습니다.

알 수 없는 함수¶

프로시저를 호출하고 다음 코드 조각과 같은 오류가 발생하는 경우:

Unknown user-defined function SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.CONSUMER.<procedure name>

다음은 몇 가지 가능한 원인입니다.

네임스페이스를 잘못 입력했습니다.

해당 프로시저의 적절한 consumer 또는 provider 버전을 호출해야 합니다. 많은 프로시저에는 공급자 버전과 컨슈머 버전이 모두 있습니다.

함수 이름을 잘못 입력했습니다.

올바른 명명은 참조 가이드를 확인하세요.

제한된 액세스 실행 역할이 부여되었으며 호출한 함수가 자신의 역할에서 허용되지 않습니다.

다음 SQL 코드를 실행하여 이를 테스트합니다.

USE DATABASE samooha_by_snowflake_local_db;
CALL IS_DATABASE_ROLE_IN_SESSION('samooha_run_role');

Copy

코드 조각이 TRUE를 반환하는 경우 클린룸 API에 대한 제한된 액세스 실행 역할 권한이 있습니다. 더 많은 액세스 권한이 필요한 경우 클린룸 관리자에게 전체 액세스 권한을 요청하세요. :ref:`consumer.grant_run_on_cleanrooms_to_role documentation<label-dcr_sproc_consumer_manage_role_access>`에서 허용되는 실행 역할 프로시저 목록을 참조하세요.

SAMOOHA_APP_ROLE이 없음

SAMOOHA_APP_ROLE을 사용할 수 있는지 확인하려면 다음 명령을 실행합니다.

-- Get current user name.
SELECT current_user();

-- Add current user name in place as indicated.
SHOW GRANTS TO USER <current_user_name> ->> select * from $1 where "role" = 'SAMOOHA_APP_ROLE';

Copy

결과를 얻지 못한 경우 관리자에게 클린룸에 대한 API 액세스를 요청하세요.

사용자가 클린룸을 설치했는지 확인¶

다음 SQL 코드를 실행하여 지정된 사용자가 지정된 클린룸을 설치했는지 확인할 수 있습니다. $consumer_locator 및 ``$cleanroom_name``을 컨슈머 로케이터 및 클린룸 이름으로 바꿉니다.

SELECT * FROM snowflake.data_sharing_usage.application_state
  WHERE consumer_account_locator = $consumer_locator
    AND CONTAINS(package_name, UPPER(REPLACE($cleanroom_name, ' ', '_')));

쿼리 또는 분석 기록 확인¶

UI 또는 코드에서 실행된 분석에 대한 쿼리 기록을 볼 수 있습니다. 이러한 기록은 별도로 저장되고 확인됩니다.