데이터 오퍼링¶

데이터 오퍼링 등록¶

1. 데이터에 대한 :ref:`데이터 오퍼링 사양 <label-dcr_collaboration_data_yaml>`을 생성합니다. 데이터 오퍼링에 대한 다음 세부 정보를 지정합니다.

   • 데이터 오퍼링의 각 데이터 세트에 대한 소스 오브젝트.

   • 각 데이터 세트에 포함할 열.

   • Clean Room 정책 을 채우는 데 사용되는 각 열의 유형(조인 또는 기타). 경우에 따라 개별 열의 형식도 지정합니다.

   • 데이터 오퍼링의 열에 적용할 모든 Snowflake 데이터 보호 정책.

   • 사용자가 데이터에 액세스하는 방법: 템플릿만 사용 또는 자유 형식 SQL 쿼리 도 사용.

2. 데이터 오퍼링 ID를 반환하는 REGISTER_DATA_OFFERING을 호출하여 데이터 오퍼링을 등록합니다.

   이 단계에서는 레지스트리에 대한 읽기 액세스 권한이 있는 계정의 모든 역할이 데이터 오퍼링을 모든 공동 작업에 연결*할 수 있게* 됩니다. 동일한 데이터 오퍼링 ID를 사용하여 여러 공동 작업과 데이터 오퍼링을 공유할 수 있습니다.

데이터 오퍼링 연결¶

연결 프로세스는 공동 작업이 생성되었는지 여부에 따라 다릅니다.

• 공동 작업이 아직 생성되지 않은 경우 데이터 공급자는 공동 작업 소유자에게 데이터 오퍼링을 ID를 제공하여 공동 작업 사양 에 포함할 수 있습니다. 데이터 오퍼링이 공동 작업 사양에 포함된 경우 데이터 오퍼링 ID는 공동 작업에 조인하기 전에 데이터 공급자가 검토할 수 있도록 공동 작업 사양에 표시됩니다.

• 공동 작업이 생성된 경우 데이터 공급자는 공동 작업에 참여하고 데이터 오퍼링 ID, 공동 작업 이름, 데이터를 공유할 수 있는 사용자와 함께 LINK_DATA_OFFERING을 호출합니다. 데이터 오퍼링이 연결된 후 데이터 오퍼링을 사용할 수 있게 되기까지 짧은 지연이 있을 수 있습니다. 데이터 오퍼링 요청이 성공적으로 완료되었는지 확인하려는 경우 VIEW_UPDATE_REQUESTS를 호출합니다. 연결에 성공하면 VIEW_DATA_OFFERINGS를 호출할 때 데이터 오퍼링이 표시되고 사용할 준비가 됩니다.

데이터를 연결할 때 데이터에 액세스할 수 있는 분석 실행자를 지정합니다.

데이터 공급자는 UNLINK_DATA_OFFERING를 호출하여 공동 작업 또는 특정 공동 작업자로부터 데이터 오퍼링을 제거할 수 있습니다.

계정에 등록된 데이터 오퍼링을 보려면 VIEW_REGISTERED_DATA_OFFERINGS를 호출합니다.

분석을 실행하는 방법을 알아보려면 분석 실행 섹션을 참조하세요.

소스 열 이름 바꾸기¶

데이터 오퍼링의 열 이름은 분석 실행자에 노출하기 전에 바꿀 수 있습니다. 이름 바꾸기는 이 테이블에 설명된 대로 데이터 오퍼링 사양 에서 열을 정의하는 category 및 column_type 값에 따라 다릅니다.

예를 들어, 소스 테이블의 열 이름이 user_email_address 인 경우, 이 열이 분석 실행자에 노출되는 방식은 데이터 오퍼링 사양에 정의된 방식에 따라 다릅니다.

...
schema_and_template_policies:
  user_email_address:
    category: join_standard
    column_type: hashed_email_sha256

SELECT HASHED_EMAIL_SHA256
FROM source_table[0];

데이터 오퍼링에 데이터 보호 정책 적용하기¶

Clean Room에서 공유되는 데이터는 여러 가지 방법으로 보호됩니다.

• Clean Room 환경에 등록된 데이터는 데이터 오퍼링 사양에 나열되지 않은 모든 열을 생략하는 보안 뷰로 생성됩니다.

• 보안 뷰는 공동 작업 사양에 지정된 특정 사용자 및 템플릿과만 공유됩니다.

• 데이터에 Snowflake 정책을 추가하여 데이터 사용 방식을 추가로 관리할 수 있습니다.

• Data Clean Room 템플릿 정책 은 또한 데이터 오퍼링 열 분류를 기반으로 적용됩니다.

조인 또는 집계 정책과 같은 Snowflake 데이터 보호 정책을 공유 데이터에 적용하는 두 가지 방법이 있습니다.

• 소스 데이터에 정책을 적용합니다. 소스 데이터에 적용된 모든 정책은 공동 작업에서 노출되는 데이터 세트에 적용됩니다. 공동 작업자에게 정책을 전달합니다.

• 자유 형식 쿼리에 사용되는 경우 데이터 오퍼링에 정책을 적용합니다. 데이터 오퍼링에 대한 자유 형식 쿼리를 허용하는 경우 데이터 오퍼링 사양에서 해당 쿼리에 적용할 정책을 지정할 수 있습니다. 이러한 정책은 소스 테이블의 기존 Snowflake 정책에 추가로 적용됩니다.

CREATE OR REPLACE AGGREGATION POLICY my_db.public.my_agg_policy AS ()
  RETURNS AGGREGATION_CONSTRAINT ->
    AGGREGATION_CONSTRAINT(MIN_GROUP_SIZE => 5);

# Tell data clean rooms to set your aggregation policy on the hashed_email column of
# the data offering
api_version: 2.0.0
spec_type: data_offering
version: 1
name: my_favorite_dataset
datasets:
  - alias: test_freeform_restricted_agg
    data_object_fqn: samooha_provider_sample_database.audience_overlap.customers
    allowed_analyses: template_and_freeform_sql
    object_class: custom
    freeform_sql_policies:
      aggregation_policy:
        name: my_db.public.my_agg_policy
        entity_keys:
          - hashed_email
...

SELECT *
FROM T1
JOIN T2
ON {{ t1_col | sqlsafe | join_policy }} = {{ t2_col | sqlsafe | join_policy }}

명명 경로를 사용하여 데이터 오퍼링 구성하기¶

명명 경로를 사용하여 데이터 오퍼링을 개념적으로 그룹화할 수 있습니다. 이는 각 데이터 오퍼링이 하나 이상의 테이블 또는 뷰를 나타내기 때문에 특히 효과적입니다. 개별 테이블은 collaborator alias.data offering ID.dataset alias 구문을 사용하여 액세스할 수 있습니다. 여기서 데이터 오퍼링 ID는 사용자가 제공한 이름과 버전 값의 조합이며, 별칭은 오퍼링의 단일 테이블입니다.

데이터 오퍼링을 등록할 때 이름, 버전, 별칭을 범위 지정 시스템으로 고려하여 오퍼링 및 별칭별로 데이터를 구성할 수 있습니다. 예를 들어, US 주에 고유한 테이블이 있는 다음과 같은 판매 데이터 오퍼링을 등록할 수 있습니다.

api_version: 2.0.0
spec_type: data_offering
version: v0
name: examplecorp_sales_by_state
datasets:
 - alias: AL
   data_object_fqn: mydb.mysch.al_data
 - alias: NY
   data_object_fqn: mydb.mysch.ny_data
 - alias: CA
   data_object_fqn: mydb.mysch.ca_data

분석 실행자는 이러한 테이블을 user_alias.offering_id.AL, user_alias.offering_id.NY, user_alias.offering_id.CA 로 참조합니다.