Activating query results¶

컨슈머가 자신의 Snowflake 계정으로 결과를 푸시하는 방법은 다음과 같습니다.

공급자

1. 표준 Clean Room과 마찬가지로 Clean Room을 만들고, 데이터 세트를 연결하고, 참여 정책을 설정합니다.

2. 지원되는 Snowflake 표준 템플릿 을 선택하거나 사용자 지정 활성화 템플릿 을 Clean Room에 추가합니다. 이 Clean Room을 UI 에서 사용하려면 템플릿 설명서에 설명된 대로 적절한 활성화 필드가 있는 웹 양식을 제공해야 합니다.

3. provider.enable_template_for_consumer_activation 을 호출하여 컨슈머 활성화를 위한 템플릿을 활성화합니다.

4. To specify which provider columns can be activated, set the activation policy in the clean room for the enabled template by calling provider.set_activation_policy.

5. 평소와 같이 컨슈머 공동 작업자를 추가하고 기본 릴리스 지시문을 설정한 다음 Clean Room을 게시합니다.

컨슈머

1. 표준 Clean Room과 마찬가지로 Clean Room을 설치하고, 데이터 세트를 연결하고, 참여 정책을 설정합니다.

2. To specify which consumer columns can be activated, set the activation policy in the clean room for that template by calling consumer.set_activation_policy.

3. consumer.run_activation 을 호출하여 활성화를 실행하고 마지막 매개 변수를 TRUE 로 설정하여 컨슈머 활성화를 표시합니다.

4. 아래 설명된 대로 결과를 봅니다.

예

Download the following examples and upload them as worksheet files in your Snowflake account. You will need separate accounts for the provider and consumer, each with the clean rooms API installed. Replace the information as noted in the sample files. See instructions to upload a SQL worksheet into your Snowflake account.

• 공급자 예시 코드

• 컨슈머 예시 코드

컨슈머가 공급자의 Snowflake 계정에 결과를 푸시하는 방법은 다음과 같습니다.

1. 공급자

1. 표준 방식으로 Clean Room을 만듭니다.

2. 데이터 세트를 연결합니다. 또한 공급자는 samooha_by_snowflake_local_db.library.temp_public_key 테이블을 Clean Room에 연결해야 합니다.

3. 표준 방식으로 참여 정책을 설정합니다.

4. :ref:`지원되는 Snowflake 표준 템플릿<label-dcr_activation_supported_templates>`을 선택하거나 :ref:`사용자 지정 활성화 템플릿<label-dcr_custom_templates_activation>`을 클린룸에 추가합니다. 이 클린룸을 클린룸 UI에서 사용하려면 적절한 활성화 필드가 있는 :ref:`웹 양식을 제공<label-dcr_define_user_form>`해야 합니다.

5. To specify which provider columns can be activated, set the activation policy in the clean room for that template by calling provider.set_activation_policy.

6. 평소와 같이 컨슈머 공동 작업자를 추가하고 기본 릴리스 지시문을 설정한 다음 Clean Room을 게시합니다. (Clean Room UI 가 설치되어 있지 않은 경우 컨슈머 추가 후 provider.setup_provider_activation_share_mount_task 를 호출하십시오.)

2. 컨슈머

1. 표준 Clean Room과 마찬가지로 Clean Room을 설치하고, 데이터 세트를 연결하고, 참여 정책을 설정합니다.

2. Set the activation policy in the clean room for that template to specify which consumer columns can be activated by calling consumer.set_activation_policy.

3. consumer.run_activation 을 호출하여 활성화를 실행하고 마지막 인자를 FALSE 로 설정하여 공급자 활성화를 표시합니다.

참고

활성화된 데이터의 암호화된 버전은 컨슈머의 계정에 28일 동안 테이블 SAMOOHA_LOCAL_DB_NAME_PLACEHOLDER.PUBLIC.CONSUMER_ACTIVATION_SUMMARY에 저장됩니다. 28일이 지난 데이터는 컨슈머 계정에서 삭제됩니다.

3. 공급자

1. 컨슈머가 계정에 데이터를 처음 활성화할 때는 컨슈머가 데이터를 활성화한 후 약 30분 동안 이 계정에 대해 Clean Rooms UI 에 로그인해야 합니다. 그 후 데이터가 계정에 표시됩니다. 이 작업은 컨슈머 계정마다 Clean Room당 한 번만 수행됩니다. 나중에 동일한 Clean Room에서 동일한 컨슈머가 활성화할 때는 이 단계가 필요하지 않습니다.

   결과를 계정에 저장하기 전에 암호를 해독해야 하므로 시간이 다소 걸릴 수 있습니다. 암호 해독 작업은 60분 후에 시간이 초과되며, 이 경우 provider.update_activation_warehouse 를 호출하여 암호 해독에 사용되는 웨어하우스 크기를 늘리십시오.

2. 아래 설명된 대로 결과를 봅니다.

예

Download the following examples and upload them as worksheet files in your Snowflake account. You will need separate accounts for the provider and consumer, each with the clean rooms API installed. Replace the information as noted in the sample files. See instructions to upload a SQL worksheet into your Snowflake account.

• 공급자 예시 코드

• 컨슈머 예시 코드

공급자가 자신의 Snowflake 계정으로 결과를 푸시하는 방법은 다음과 같습니다. 여기에는 사용자 지정 템플릿, 공급자 실행 분석, 공급자 활성화 등 여러 기술이 결합되어 있으므로 공급자와 컨슈머 간에 여러 차례의 요청과 승인이 필요합니다.

1. 공급자

1. 표준 Clean Room의 경우와 같이 Clean Room을 만들고, 데이터 세트를 연결하고, 참여 정책을 설정하며, 한 가지 예외가 있습니다. 테이블 samooha_by_snowflake_local_db.library.temp_public_key 에서 연결해야 합니다. 공급자가 실행하는 데이터는 암호화되며, 이를 통해 결과의 암호화 및 암호 해독이 가능합니다.

2. 지원되는 Snowflake 표준 템플릿 을 선택하거나 사용자 지정 활성화 템플릿 을 Clean Room에 추가합니다. 이 Clean Room을 UI 에서 사용하려면 템플릿 설명서에 설명된 대로 활성화를 지원하기 위한 적절한 필드가 포함된 웹 양식을 제공해야 합니다.

3. Set the activation policy in the clean room for that template to specify which provider columns can be activated by calling provider.set_activation_policy.

4. 표준 방식으로 컨슈머 공동 작업자를 추가하십시오. Clean Room UI 가 설치되지 않은 경우 사용자를 추가한 후 provider.setup_provider_activation_share_mount_task 를 호출해야 합니다.

5. provider.enable_provider_run_analysis 를 호출하여 Clean Room에서 공급자 실행 분석을 활성화합니다. 이 작업은 공동 작업자 추가 후, 공동 작업자가 Clean Room을 설치하기 전에 수행해야 합니다. 컨슈머가 Clean Room을 설치한 후 이 설정을 변경하는 경우 컨슈머가 Clean Room을 다시 설치해야 변경 사항을 적용할 수 있습니다.

6. 기본 릴리스 지시문을 설정하고 평소와 같이 Clean Room을 게시합니다.

2. 컨슈머

1. 표준 Clean Room에서와 같이 Clean Room을 설치하고, 데이터 세트를 연결하고, 참여 정책을 설정합니다.

2. Set the activation policy in the clean room for that template to specify which consumer columns can be activated by calling consumer.set_activation_policy.

3. 공급자

• provider.request_provider_activation_consent 를 호출하여 활성화 템플릿을 실행할 수 있는 권한을 컨슈머에게 요청하십시오.

4. 컨슈머

1. consumer.enable_templates_for_provider_run 을 호출하여 공급자에게 이 Clean Room에서 지정된 템플릿을 실행할 권한을 부여합니다.

2. consumer.approve_provider_activation_consent 를 호출하여 이 Clean Room에서 지정된 템플릿의 결과를 활성화할 수 있는 권한을 공급자에게 부여하십시오.

5. 공급자

1. provider.mount_request_logs_for_all_consumers 를 호출하여 공급자 활성화에서 컨슈머 데이터를 공유할 수 있도록 설정합니다.

2. provider.submit_analysis_request 를 호출하여 활성화 템플릿을 실행합니다. 요청이 로그에 표시되기까지 몇 분 정도 걸리므로 provider.check_analysis_status 를 호출하여 상태를 확인하십시오. 상태가 SUCCESS 로 보고된 후에도 결과가 해독되어 공급자의 Snowflake 테이블에 기록되는 데는 추가 시간이 필요합니다. 해독된 모든 데이터는 결과 테이블에 한 번에 추가됩니다. 세그먼트 또는 활성화 ID 에 대한 결과 테이블을 주기적으로 확인하십시오. 암호 해독 작업은 60분 후에 시간이 초과되며, 이 경우 provider.update_activation_warehouse 를 호출하여 암호 해독에 사용되는 웨어하우스 크기를 늘리십시오.

참고

컨슈머가 템플릿을 승인한 후 템플릿을 수정하려면 다음 단계를 수행해야 하며, 그렇지 않으면 provider.submit_analysis_request 에서 마지막으로 승인된 버전의 템플릿을 계속 실행합니다.

1. 공급자는 provider.add_custom_sql_template 을 호출하여 템플릿을 업데이트합니다. create_or_update_cleanroom_listing 을 다시 호출할 필요가 없습니다.

2. 컨슈머가 consumer.enable_templates_for_provider_run 을 호출합니다.

3. 컨슈머가 consumer.approve_provider_activation_consent 를 호출합니다.

4. 이제 공급자 활성화를 위해 업데이트된 템플릿이 준비되었습니다.

일반적인 오류

• Object cleanroom_name.CLEANROOM.TEMP_RESULT_DATA does not exist or not authorized - 어떤 이유로 임시 결과 테이블을 생성할 수 없습니다. 템플릿에 SQL 오류가 있거나 템플릿이 명시적으로 테이블을 생성하지 않았을 수 있습니다. 오류 세부 정보를 확인하십시오.

• Query validation checks failed - 활성화 정책에 없는 일부 열이 템플릿에 사용되었습니다.

예

Download the following examples and upload them as worksheet files in your Snowflake account. You will need separate accounts for the provider and consumer, each with the clean rooms API installed. Replace the information as noted in the sample files. See instructions to upload a SQL worksheet into your Snowflake account.

• 공급자 예시 코드

• 컨슈머 예시 코드