Snowflake Data Clean Rooms: 컨슈머 API 참조 가이드¶
아래 콘텐츠는 Snowflake Data Clean Rooms에서 컨슈머를 위해 제공하는 모든 개발자 APIs에 대한 세부 정보입니다. 모든 함수는 다음 스키마 내부에 있습니다.
samooha_by_snowflake_local_db.consumer
환경 설정¶
개발자 APIs를 사용하여 Snowflake Data Clean Room으로 작업하기 전에 다음 명령을 실행하여 Snowflake 환경을 설정합니다. SAMOOHA_APP_ROLE 역할이 없는 경우 계정 관리자에게 문의하십시오.
use role samooha_app_role;
use warehouse app_wh;
공급자가 사용자와 공유한 클린룸의 이름을 지정합니다.
set cleanroom_name = 'Test Cleanroom 1';
클린룸 설치¶
다음 명령을 통해 공급자가 공유한 클린룸을 설치합니다.
consumer.install_cleanroom¶
설명: 연결된 공급자와 선택된 클린룸을 사용하여 컨슈머 계정에 클린룸을 설치합니다.
입력: cleanroom_name (string), provider_account_locator (string)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.install_cleanroom($cleanroom_name, '<PROVIDER_ACCOUNT_LOCATOR>');
consumer.is_enabled¶
설명: 클린룸이 설치되면 공급자 측에서 설정을 완료하고 활성화하는 데 약 1분이 걸립니다. 이 함수를 사용하면 사용자가 클린룸의 상태를 확인하고, 활성화되어 있는지 여부를 확인할 수 있습니다. 일반적으로 클린룸을 설치한 후 약 1분 후에 플래그가 True로 전환됩니다.
입력: cleanroom_name (string)
출력: 활성화됨(부울)
예제:
call samooha_by_snowflake_local_db.consumer.is_enabled($cleanroom_name);
consumer.uninstall_cleanroom¶
설명: 컨슈머 계정에서 클린룸을 제거합니다. 이렇게 하면 공유 클린룸 데이터베이스를 포함하여 클린룸과 관련된 모든 데이터베이스가 제거됩니다. 클린룸은 언제든지 consumer.install_cleanroom 을 사용하여 다시 설치할 수 있습니다.
입력: cleanroom_name (string)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.uninstall_cleanroom($cleanroom_name);
Provider Run Analysis 설정¶
library.is_provider_run_enabled¶
설명: 이 클린룸에 Provider Run Analysis가 활성화되어 있는지 확인합니다. 참고: consumer.enable_templates_for_provider_run 을 호출하여 명시적인 승인을 획득해야 합니다(아래 참조).
입력: cleanroom_name (string)
출력: 활성화된 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.is_provider_run_enabled($cleanroom_name)
library.is_consumer_run_enabled¶
설명: 이 클린룸에서 Consumer Run Analysis가 활성화되었는지 확인합니다. 이 플래그는 클린룸 컨슈머(설치 관리자)가 분석을 실행할 수 있는지, 아니면 공동 작업에 대한 데이터 기여자 역할을 할 수 있는지 여부를 결정합니다.
입력: cleanroom_name (string)
출력: 활성화된 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.is_consumer_run_enabled($cleanroom_name)
consumer.enable_templates_for_provider_run¶
설명: 클린룸에 Provider Run Analysis가 활성화된 경우(즉, 클린룸 공급자가 분석을 실행할 수 있도록 클린룸을 표시한 경우), 컨슈머가 이 프로시저를 호출하여 이를 활성화해야 합니다. 이 프로시저는 분석을 실행할 공급자에 템플릿별로 명시적인 승인을 제공하는 데 필요합니다.
마지막 부울 매개 변수를 TRUE로 설정하면 컨슈머가 공급자의 분석에 대해 차등 개인정보 보호를 활성화할 수 있습니다.
입력: cleanroom_name (string), template_names (array), enable_differential_privacy(boolean)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.enable_templates_for_provider_run($cleanroom_name, ['prod_overlap_analysis'], FALSE);
데이터 등록 및 등록 취소¶
다음 명령을 사용하여 데이터베이스, 스키마, 오브젝트를 등록하고 등록을 취소합니다. 테이블과 뷰는 클린룸에 연결하기 전에 등록되어야 합니다. 데이터베이스나 스키마를 등록하면 해당 데이터베이스나 스키마에 있는 모든 오브젝트가 등록됩니다.
consumer.register_db¶
설명: 클린룸에 데이터베이스를 추가하면 데이터베이스의 모든 데이터 세트를 연결할 수 있습니다. 이것이 호출되지 않으면 samooha_app_role에 개별적으로 권한을 부여해야 합니다.
입력: db_name (string)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.register_db('SAMOOHA_SAMPLE_DATABASE');
library.register_schema¶
설명: register_db
와 유사하지만, 스키마 수준에서 작동합니다. 정규화된 스키마 이름을 나타내는 배열 또는 문자열을 전달하고 SAMOOHA_APP_ROLE 역할에 대한 권한 부여를 선택하면 사용자가 스키마의 오브젝트를 클린룸에 연결할 수 있습니다.
관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 생성된 스키마)를 등록하려면 library.register_managed_access_schema
를 대신 사용합니다.
입력: schema_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.register_schema(['SAMOOHA_SAMPLE_DATABASE.DEMO']);
library.register_managed_access_schema¶
설명: register_schema
와 유사하지만, WITH MANAGED ACCESS 매개 변수를 사용하여 생성한 스키마를 등록합니다. 정규화된 스키마 이름을 나타내는 배열 또는 문자열을 전달하고 SAMOOHA_APP_ROLE 역할에 대한 권한 부여를 선택하면 사용자가 스키마의 오브젝트를 클린룸에 연결할 수 있습니다.
입력: schema_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.register_managed_access_schema(['SAMOOHA_SAMPLE_DATABASE.DEMO']);
library.register_table_or_view¶
설명: 모든 유형의 테이블과 뷰를 등록합니다.
입력: object_names (array), is_view (boolean), is_iceberg (boolean), is_external (boolean), is_under_managed_access_schema (boolean)
출력: success message (string)
예
테이블을 등록하려면:
call samooha_by_snowflake_local_db.library.register_table_or_view(
['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS'],
false,
false,
false,
false);
Iceberg 테이블을 등록하려면:
call samooha_by_snowflake_local_db.library.register_table_or_view(
['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS'],
false,
true,
false,
false);
library.register_table¶
설명: register_db
와 유사하지만 테이블 수준에서 작동합니다. 정규화된 테이블 이름을 나타내는 배열 또는 문자열을 전달하고 SAMOOHA_APP_ROLE 역할에 대한 권한 부여가 이루어지면 사용자가 테이블을 클린룸에 연결할 수 있습니다.
관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 생성된 스키마)에 테이블을 등록하려면 대신 library.register_managed_access_table
을 사용합니다.
입력: table_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.register_table(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
library.register_managed_access_table¶
설명: register_table
과 유사하지만, WITH MANAGED ACCESS 매개 변수로 생성된 스키마에 테이블을 등록합니다. 정규화된 테이블 이름을 나타내는 배열 또는 문자열을 전달하고 SAMOOHA_APP_ROLE 역할에 대한 권한 부여가 이루어지면 사용자가 테이블을 클린룸에 연결할 수 있습니다.
입력: table_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.register_managed_access_table(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
library.register_view¶
설명: register_db
와 유사하지만, 뷰 수준에서 작동합니다. 정규화된 뷰 이름을 나타내는 배열 또는 문자열을 전달하고 SAMOOHA_APP_ROLE 역할에 대한 권한 부여를 선택하면 사용자가 뷰를 클린룸에 연결할 수 있습니다.
관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 만든 스키마)에 보기를 등록하려면 대신 library.register_managed_access_view
를 사용합니다.
입력: view_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.register_view(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
library.register_managed_access_view¶
설명: register_view
와 유사하지만, WITH MANAGED ACCESS 매개 변수로 생성된 스키마에 뷰를 등록합니다. 정규화된 뷰 이름을 나타내는 배열 또는 문자열을 전달하고 SAMOOHA_APP_ROLE 역할에 대한 권한 부여를 선택하면 사용자가 뷰를 클린룸에 연결할 수 있습니다.
입력: view_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.register_managed_access_view(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
library.unregister_db¶
설명: register_db
프로시저를 되돌리고 SAMOOHA_APP_ROLE 역할 및 Snowflake Data Clean Room 기본 애플리케이션에 부여된 데이터베이스 수준 부여를 제거합니다. 이렇게 하면 UI 드롭다운 요소에서 모든 데이터베이스도 제거됩니다.
입력: db_name (string)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.unregister_db('SAMOOHA_SAMPLE_DATABASE');
library.unregister_schema¶
설명: 스키마의 등록을 취소하여 사용자가 해당 테이블과 뷰를 클린룸에 연결하는 것을 방지합니다.
관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 생성된 스키마)를 등록 해지하려면 library.unregister_managed_access_schema
를 대신 사용합니다.
입력: schema_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.unregister_schema(['SAMOOHA_SAMPLE_DATABASE.DEMO']);
library.unregister_managed_access_schema¶
설명: unregister_schema
와 유사하지만, WITH MANAGED ACCESS 매개 변수를 사용하여 생성한 스키마를 등록 취소합니다.
입력: schema_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.unregister_managed_access_schema(['SAMOOHA_SAMPLE_DATABASE.DEMO']);
library.unregister_table_or_view¶
설명: 모든 유형의 테이블과 뷰를 등록 취소합니다.
입력: object_names (array), is_view (boolean), is_iceberg (boolean), is_external (boolean), is_under_managed_access_schema (boolean)
출력: success message (string)
예
테이블 등록을 취소하려면:
call samooha_by_snowflake_local_db.library.unregister_table_or_view(
['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS'],
false,
false,
false,
false);
library.unregister_table¶
설명: unregister_db
와 유사하지만, 테이블 수준에서 작동합니다. 완전히 정규화된 테이블 이름을 나타내는 배열이나 문자열을 전달하여 테이블의 등록을 취소할 수 있습니다. 사용자는 등록되지 않은 테이블을 클린룸에 연결할 수 없습니다.
관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 생성된 스키마)에 테이블을 등록 취소하려면 대신 library.unregister_managed_access_table
을 사용합니다.
입력: table_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.unregister_table(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
library.unregister_managed_access_table¶
설명: unregister_table
과 유사하지만, 관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 생성된 스키마)의 테이블 등록을 취소합니다.
입력: table_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.unregister_managed_access_table(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
library.unregister_view¶
설명: unregister_db
와 유사하지만, 뷰 수준에서 작동합니다. 완전히 정규화된 뷰 이름을 나타내는 배열이나 문자열을 전달하여 뷰의 등록을 취소할 수 있습니다. 사용자는 등록되지 않은 뷰를 클린룸에 연결할 수 없습니다.
관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 만든 스키마)에 보기를 등록 취소하려면 대신 library.unregister_managed_access_view
를 사용합니다.
입력: view_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.unregister_view(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
library.unregister_managed_access_view¶
설명: unregister_view
와 유사하지만, 관리되는 액세스 스키마(즉, WITH MANAGED ACCESS 매개 변수로 생성된 스키마)의 뷰 등록을 취소합니다.
입력: view_name (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.library.unregister_managed_access_view(['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
데이터 세트 추가¶
consumer.link_datasets¶
설명: 사용자는 Snowflake 테이블을 클린룸에 연결하고 클린룸 내에서 테이블의 안전한 뷰를 만들어 테이블을 공유할 수 있습니다.
입력: cleanroom_name (string), tables_list (array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.link_datasets($cleanroom_name, ['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']);
Provider Run Analysis를 위한 보안 정책 설정하기¶
consumer.set_join_policy¶
설명: Provider Run Analysis를 사용하여 클린룸 내에서 템플릿을 실행할 때 공급자가 조인을 수행할 수 있는 열을 지정합니다. 열 정책은 바꾸기 전용 이므로 함수가 다시 호출되면 이전에 설정된 열 정책이 현재 정책으로 완전히 바뀝니다.
이 검사는 승인되지 않은 열이 있는지 데이터에 대해 실행할 SQL 쿼리를 구문 분석하는 방식으로 수행됩니다. 와일드카드가 포함된 쿼리는 이러한 검사를 통해 포착되지 않을 수 있으며, 분석 템플릿을 설계할 때는 여전히 신중해야 합니다.
입력: cleanroom_name(string), table_and_col_names(array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.set_join_policy($cleanroom_name, ['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS:EMAIL', 'SAMOOHA_SAMPLE_DATABASE.DEMO.EXPOSURES:EMAIL']);
consumer.set_column_policy¶
설명: 공급자가 작업을 수행할 수 있는 데이터의 열을 설정합니다. 이 작업은 템플릿을 추가한 후에만 호출해야 합니다. 이 함수도 템플릿의 함수이므로 입력은 template_name:full_table_name:column_name 형식이어야 합니다. 열 정책은 바꾸기 전용 이므로 함수가 재호출되면 이전에 설정된 열 정책이 현재 정책으로 완전히 바뀝니다.
이메일과 같은 ID 열에서는 열 정책을 호출해서는 안 됩니다. 이는 집계 및 그룹화 열에만 사용해야 합니다.
이 검사는 승인되지 않은 열이 있는지 데이터에 대해 실행할 SQL 쿼리를 구문 분석하는 방식으로 수행됩니다. 와일드카드가 포함된 쿼리는 이러한 검사를 통해 포착되지 않을 수 있으며, 분석 템플릿을 설계할 때는 여전히 신중해야 합니다.
확인은 차원 또는 measure_columns 라는 SQL Jinja 인자에 대해 수행됩니다. 이 검사를 활성화하려면 이러한 태그를 사용해야 합니다.
입력: cleanroom_name(string), analysis_and_table_and_columns(array)
출력: 성공 메시지(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.set_column_policy($cleanroom_name,
['prod_overlap_analysis:SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS:STATUS',
'prod_overlap_analysis:SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS:AGE_BAND',
'prod_overlap_analysis:SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS:DAYS_ACTIVE',
'prod_overlap_analysis:SAMOOHA_SAMPLE_DATABASE.DEMO.EXPOSURES:CAMPAIGN']);
템플릿¶
다음 명령을 사용하면 클린룸에서 사용 가능한 템플릿으로 작업할 수 있습니다.
consumer.view_template_definition¶
설명: 클린룸 템플릿 정의는 템플릿에 전달해야 할 매개 변수를 결정하는 데 도움이 됩니다.
참고
모든 Samooha 프로시저는 암호화되어 있으며 기본적으로 볼 수 없습니다. 하지만 사용자가 추가한 사용자 지정 템플릿은 모두 표시됩니다.
입력: cleanroom_name (string), template_name (string)
출력: 템플릿 정의(문자열)
예제:
call samooha_by_snowflake_local_db.consumer.view_template_definition($cleanroom_name, 'prod_overlap_analysis');
consumer.get_arguments_from_template¶
설명: 데이터를 구성하는 방법과 각 템플릿에 필요한 데이터를 정의하여 출력을 쉽게 수집할 수 있도록 합니다.
입력: cleanroom_name (string), template_name (string)
출력: 인자 목록 및 사양(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.get_arguments_from_template($cleanroom_name, 'prod_overlap_analysis');
템플릿 체인¶
다음 명령을 사용하면 사용자는 클린룸에서 사용할 수 있는 템플릿 체인을 사용하여 작업할 수 있습니다. 템플릿 체인 사용에 대한 일반적인 정보는 개발자 APIs를 사용하여 템플릿을 순차적으로 실행하기를 참조하십시오.
consumer.view_added_template_chains¶
설명: 클린룸에서 현재 활성화된 템플릿 체인을 봅니다.
입력: cleanroom_name (string)
출력: The added template chains (table)
예제:
call samooha_by_snowflake_local_db.consumer.view_added_template_chains($cleanroom_name);
consumer.view_template_chain_definition¶
설명: 템플릿 체인의 특성을 반환합니다.
입력: cleanroom_name (string), template_chain_name (string)
출력: The template chain definition (string)
예제:
call samooha_by_snowflake_local_db.consumer.view_template_chain_definition($cleanroom_name, 'insights_chain');
consumer.get_arguments_from_template_chain¶
설명: 템플릿 체인의 모든 템플릿에 대한 예상 인자를 반환합니다.
입력: cleanroom_name (string), template__chain_name (string)
출력: 인자 목록 및 사양(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.get_arguments_from_template_chain($cleanroom_name, 'insights_chain');
분석 및 활성화 실행¶
다음 명령은 지정된 템플릿을 기반으로 특정 분석이나 활성화를 실행합니다.
consumer.run_analysis¶
설명: 템플릿이나 템플릿 체인을 사용하여 분석을 실행합니다. 컨슈머 및 공급자 테이블은 별도로 지정해야 하며, 필요하지 않은 경우 특정 입력은 비워둘 수 있습니다. 템플릿 또는 템플릿 체인은 특정 분석을 위해 구성된 논리를 실행하고 결합된 데이터를 테이블로 반환합니다. 유일한 선택적 입력은 “epsilon”입니다. 즉, 쿼리가 얼마나 많은 개인정보 보호 예산을 소비해야 하는지를 나타냅니다. 지정하지 않으면 기본값은 0.1입니다.
입력: cleanroom_name (string), {template_name | template_chain_name} (string), consumer_tables (array), provider_tables (array), analysis_arguments (object)
출력: 템플릿 계산 출력(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.run_analysis(
$cleanroom_name, -- cleanroom
'prod_overlap_analysis', -- template name
['SAMOOHA_SAMPLE_DATABASE.MYDATA.CONVERSIONS'], -- Consumer tables
['SAMOOHA_SAMPLE_DATABASE.DEMO.EXPOSURES'], -- Provider tables
object_construct( -- Rest of the custom arguments needed for the template
'dimensions', ['p.CAMPAIGN'], -- always use p. to refer to fields in provider tables, and c. to refer to fields in consumer tables. Use p2, p3, etc. for more than one provider table and c2, c3, etc. for more than one consumer table.
'measure_column', ['p.EXP_COST'],
'measure_type', ['COUNT'],
'where_clause', 'p.EMAIL=c.EMAIL'
)
);
consumer.run_activation¶
설명: 활성화를 위해 결과를 공급자에게 다시 보내는 템플릿을 실행합니다.
결과를 공급자에게 다시 활성화하는 방법에 대한 자세한 내용은 개발자 APIs를 사용하여 공급자에게 결과 활성화하기를 참조하십시오.
입력: cleanroom_name (string), segment_name (string), template_name (string), consumer_tables (array), provider_tables (array), activation_arguments (object)
출력: Success message
예제:
call samooha_by_snowflake_local_db.consumer.run_activation(
$cleanroom_name,
'my_activation_segment',
'activation_custom_template',
['consumer_source_table'],
['provider_source_table'],
object_construct( -- Custom arguments needed for the template
'dimensions', ['p.CAMPAIGN'], -- always use p. to refer to fields in provider tables, and c. to refer to fields in consumer tables. Use p2, p3, etc. for more than one provider table and c2, c3, etc. for more than one consumer table.
'where_clause', 'p.EMAIL=c.EMAIL'
));
컨슈머 정의 템플릿¶
다음 APIs 을 사용하면 클린룸에 컨슈머 정의 템플릿을 추가할 수 있습니다. 자세한 내용은 개발자 API를 사용하여 컨슈머 정의 템플릿 추가하기 섹션을 참조하십시오.
consumer.create_template_request¶
설명: 클린룸 공급자에게 사용자 지정 템플릿을 클린룸에 추가할 수 있도록 승인해 달라는 요청을 보냅니다.
입력: cleanroom_name (string), template_name (string), template_definition (string)
출력: 성공 메시지(문자열)
예제:
CALL samooha_by_snowflake_local_db.consumer.create_template_request('dcr_cleanroom',
'my_analysis',
$$
SELECT
identifier({{ dimensions[0] | column_policy }})
FROM
identifier({{ my_table[0] }}) c
INNER JOIN
identifier({{ source_table[0] }}) p
ON
c.identifier({{ consumer_id }}) = identifier({{ provider_id | join_policy }})
{% if where_clause %} where {{ where_clause | sqlsafe | join_and_column_policy }} {% endif %};
$$);
consumer.list_template_requests¶
설명: 컨슈머가 클린룸에 템플릿을 추가하기 위해 요청한 내용을 나열합니다.
입력: cleanroom_name (string)
출력: request_id(string), provider_identifier(string), template_name(string), template_definition(string), request_status(string), reason(string)
예제:
CALL samooha_by_snowflake_local_db.consumer.list_template_requests('dcr_cleanroom');
클린룸 메타데이터 getter 메서드¶
다음 메서드는 클린룸의 관련 속성을 보여줍니다.
consumer.describe_cleanroom¶
설명: 템플릿, 데이터 세트, 정책 등 클린룸에 추가된 항목에 대한 모든 정보가 포함된 텍스트 요약을 만듭니다.
입력: cleanroom_name(string)
출력: 클린룸의 광범위한 설명 문자열(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.describe_cleanroom($cleanroom_name);
consumer.view_provider_datasets¶
설명: 공급자가 클린룸에 추가한 모든 데이터 세트를 봅니다.
입력: cleanroom_name(string)
출력: 클린룸의 모든 공급자 데이터 세트 이름(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.view_provider_datasets($cleanroom_name);
consumer.view_join_policy¶
설명: 컨슈머가 컨슈머 데이터 세트에 설정한, 클린룸 내부에서 사용자가 안전하게 참여할 수 있는 열을 간략하게 설명합니다.
입력: cleanroom_name (string)
출력: 조인 정책(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.view_join_policy($cleanroom_name);
consumer.view_provider_join_policy¶
설명: 공급자가 공급자 데이터 세트에 설정한 클린룸 내에서 사용자가 안전하게 조인할 수 있는 열을 간략하게 설명합니다.
입력: cleanroom_name (string)
출력: 조인 정책(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.view_provider_join_policy($cleanroom_name);
consumer.view_added_templates¶
설명: 클린룸에 있는 모든 활성 템플릿을 봅니다.
입력: cleanroom_name (string)
출력: 추가된 템플릿(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.view_added_templates($cleanroom_name);
consumer.view_column_policy¶
설명: 컨슈머가 클린룸에 적용한 모든 열 정책을 봅니다.
입력: cleanroom_name (string)
출력: 열 정책(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.view_column_policy($cleanroom_name);
consumer.view_provider_column_policy¶
설명: 공급자가 클린룸에 적용한 모든 열 정책을 봅니다.
입력: cleanroom_name (string)
출력: 열 정책(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.view_provider_column_policy($cleanroom_name);
consumer.view_cleanrooms¶
설명: 최근에 생성된 모든 클린룸을 생성된 날짜별로 정렬하여 표시합니다.
입력:
출력: 생성 날짜별로 정렬된 모든 기존 클린룸(테이블)
예제:
call samooha_by_snowflake_local_db.consumer.view_cleanrooms();
consumer.is_dp_enabled¶
설명: 클린룸에서 차등 개인정보 보호가 활성화되었는지 확인합니다.
입력: cleanroom_name(string)
출력: 클린룸에 DP가 활성화되어 있는지 여부(부울)
예제:
call samooha_by_snowflake_local_db.consumer.is_dp_enabled($cleanroom_name);
consumer.view_remaining_privacy_budget¶
설명: 클린룸에서 쿼리를 수행하는 데 사용할 수 있는 잔여 개인정보 보호 예산을 봅니다. 예산이 재설정될 때까지 run_analysis에 대한 추가 호출은 허용되지 않습니다. 예산은 매일 재설정됩니다.
차등 개인정보 보호가 활성화되지 않은 경우 개인정보 보호 예산은 임의로 높은 수준(예: 10000)으로 설정되며 소진되지 않습니다.
입력: cleanroom_name (string)
출력: 남은 개인정보 보호 예산(부동소수점)
예제:
call samooha_by_snowflake_local_db.consumer.view_remaining_privacy_budget($cleanroom_name);
일반 도우미 메서드¶
일반적으로 클린룸 기능을 활용하는 데 도움이 되는 방법은 다음과 같습니다.
library.enable_local_db_auto_upgrades¶
설명: 새 버전이 릴리스될 때 Snowflake Data Clean Rooms용 Snowflake Native App을 자동으로 업그레이드하는 작업 samooha_by_snowflake_local_db.admin.expected_version_task
를 활성화합니다.
입력: None
출력: 성공 메시지(문자열)
예제:
CALL samooha_by_snowflake_local_db.library.enable_local_db_auto_upgrades();
library.disable_local_db_auto_upgrades¶
설명: 새 버전이 릴리스될 때 Snowflake Data Clean Rooms용 Snowflake Native App을 자동으로 업그레이드하는 작업 samooha_by_snowflake_local_db.admin.expected_version_task
를 비활성화합니다.
입력: None
출력: 성공 메시지(문자열)
예제:
CALL samooha_by_snowflake_local_db.library.disable_local_db_auto_upgrades();