Snowflake Data Clean Rooms: ID 및 데이터 공급자 커넥터¶

전제 조건¶

1. Acxiom 커넥터를 구성하기 전에 Acxiom에 문의하여 네이티브 앱 설치에 대한 도움을 받아야 합니다.

2. 클린룸 관리자가 커넥터를 구성하기 전에 Acxiom 네이티브 앱 소유자는 다음을 수행해야 합니다.

   1. Snowsight 에 로그인합니다.

   2. Acxiom 네이티브 앱에 대한 소유권이 있는 역할을 가정합니다. 예를 들어, acxiom_admin_role 역할이 Acxiom 네이티브 앱의 소유자인 경우 다음을 실행합니다.

      USE ROLE acxiom_admin_role;
      

      Copy

   3. 다음 명령을 실행하여 Snowflake Data Clean Rooms 에 Acxiom realid_app_role 애플리케이션 역할에 대한 액세스 권한을 부여합니다.

      GRANT APPLICATION ROLE <acxiom_app_database>.realid_app_role
        TO ROLE samooha_app_role;
      

      Copy

Acxiom Real ID 커넥터 구성¶

Acxiom Real ID 커넥터를 구성하려면:

1. 웹 앱에서 클린룸 환경에 로그인합니다.

2. 왼쪽 탐색 모음에서 Connectors 를 선택합니다.

3. Identity & Data Providers 탭을 선택합니다.

4. Acxiom - Real ID 를 확장합니다.

5. Application Database 필드에 Acxiom 네이티브 앱이 설치한 애플리케이션 데이터베이스의 이름을 입력합니다.

6. Warehouse 드롭다운 목록에서 웨어하우스 크기를 선택합니다. Snowflake는 DCR_WH_XLarge 를 권장하지만, 웨어하우스 크기 및 성능에 대한 Acxiom의 지침 을 확인하는 것이 좋습니다. Snowflake Data Clean Rooms 과 함께 사용할 웨어하우스 만들기에 대한 자세한 내용은 웨어하우스 옵션 추가 섹션을 참조하십시오.

7. Save 를 선택합니다.

전제 조건¶

1. 앞서 설명한 대로 Acxiom Real ID 네이티브 앱을 설치해야 합니다.

2. Acxiom Real ID Transcoding 애플리케이션을 설치해야 합니다.

3. 공동 작업자에게 연락하여 Acxiom Real ID Transcoding 네이티브 앱을 설치할 때 생성된 클라이언트 ID 및 클라이언트 시크릿을 받으십시오.

4. 클린룸 관리자가 커넥터를 구성하기 전에 Acxiom 네이티브 앱 소유자는 다음을 수행해야 합니다.

   1. Snowsight 에 로그인합니다.

   2. Acxiom 네이티브 앱에 대한 소유권이 있는 역할을 가정합니다. 예를 들어, acxiom_admin_role 역할이 Acxiom 네이티브 앱의 소유자인 경우 다음을 실행합니다.

      USE ROLE acxiom_admin_role;
      

      Copy

   3. 다음 명령을 실행하여 Snowflake Data Clean Rooms 에 Acxiom realid_app_role 애플리케이션 역할에 대한 액세스 권한을 부여합니다.

      GRANT APPLICATION ROLE <acxiom_app_database>.realid_app_role TO ROLE samooha_app_role;
      

      Copy

Acxiom Real ID Transcoding 커넥터 구성하기¶

Acxiom Real ID Transcoding 커넥터를 구성하려면:

1. 웹 앱에서 클린룸 환경에 로그인합니다.

2. 왼쪽 탐색 모음에서 Connectors 를 선택합니다.

3. Identity & Data Providers 탭을 선택합니다.

4. Acxiom Real ID Transcoding 를 확장합니다.

5. Application Database 필드에 Acxiom 네이티브 앱이 설치한 애플리케이션 데이터베이스의 이름을 입력합니다.

6. Client ID 필드에 네이티브 앱을 설치할 때 Acxiom에서 제공한 클라이언트 ID를 입력합니다.

7. Client Secret 필드에 네이티브 앱을 설치할 때 Acxiom에서 제공한 클라이언트 시크릿을 입력합니다.

8. Warehouse 드롭다운 목록에서 웨어하우스 크기를 선택합니다. Snowflake는 DCR_WH_Medium 을 권장하지만, 웨어하우스 크기 및 성능에 대한 Acxiom의 지침 을 확인하는 것이 좋습니다. Snowflake Data Clean Rooms 과 함께 사용할 웨어하우스 만들기에 대한 자세한 내용은 웨어하우스 옵션 추가 섹션을 참조하십시오.

9. Acxiom Collaborator 섹션에서 공동 작업자를 한 명 이상 선택하고 Acxiom Real ID Transcoding 네이티브 앱을 설치할 때 생성된 클라이언트 ID 및 클라이언트 시크릿을 선택합니다. 공동 작업자가 목록에 표시되지 않으면 클린룸 환경에 추가 해야 합니다.

10. Save 를 선택합니다.

1단계: Merkury Identity Connector 네이티브 앱 설치하기¶

1. Merkury Identity Connector 네이티브 앱 설치: IDConnector@dentsu.com으로 Merkury에 문의하여 계정에 목록을 추가합니다.

2. SAMOOHA_APP_ROLE 역할에 권한 부여

   1. Snowsight에 로그인합니다.

   2. Merkury 네이티브 앱에 대한 소유권을 가진 역할을 가정합니다. 예를 들어, ACCOUNTADMIN 역할이 Merkury 네이티브 앱의 소유자인 경우 USE ROLE ACCOUNTADMIN; 을 실행합니다.

   3. 다음 명령을 실행하여 Snowflake Data Clean Rooms에 Merkury DCR_DB_ROLE 애플리케이션 역할에 대한 액세스 권한을 부여합니다.

   GRANT APPLICATION ROLE <merkury_app_database>.DCR_DB_ROLE TO ROLE samooha_app_role;
   

   Copy

2단계: Merkury Identity Connector 네이티브 앱 구성¶

1. 웹 앱에서 클린룸에 로그인합니다.

2. 왼쪽 탐색 모음에서 Connectors 를 선택합니다.

3. Identity & Data Providers 탭을 선택합니다.

4. Merkury Identity Connector 를 확장합니다.

5. Application database 필드에 Merkury ID 네이티브 앱이 설치한 애플리케이션 데이터베이스의 이름을 입력합니다.

6. 본인 인증을 수행합니다.

TransUnion TruAudience ID 캐시¶

Snowflake는 TransUnion 공동 작업자 IDs를 레코드를 고유하게 식별하는 소스 테이블의 값에 매핑하는 캐시를 유지합니다. 예를 들어, 캐시는 각 공동 작업자 ID를 소스 테이블의 user_id 열에 있는 값에 매핑할 수 있습니다. 캐시는 SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS 테이블에 저장됩니다. 이 테이블에 포함되는 열은 다음과 같습니다.

열	데이터 타입	설명
inputid	VARCHAR	통합 중에 Unique Record Column 으로 선택한 열의 값입니다.
collaborationid	VARCHAR	입력 ID 및 기타 통합 매개 변수를 기반으로 생성된 TransUnion 협업 ID입니다.
lastprocessed	TIMESTAMP_NTZ	TransUnion이 협업 ID를 생성한 타임스탬프입니다.

캐시에서 다음 작업을 수행할 수 있습니다.

캐시 삭제

TRUNCATE SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS;

Copy

캐시에서 특정 레코드 삭제

작은따옴표로 묶은 값을 쉼표로 구분한 목록으로 지정하여 캐시에서 특정 레코드를 삭제할 수 있습니다. 예를 들어, 입력 IDs가 123456 및 abcedf 인 레코드를 삭제하려면 다음을 실행합니다.

DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS
  WHERE inputid IN ('123456', 'abcedf');

Copy

별도의 데이터 세트에서 입력 IDs에 따라 여러 레코드 삭제

입력 IDs가 다른 테이블의 열에 있는 경우 캐시에서 여러 레코드를 삭제할 수 있습니다. 예를 들어, 삭제할 입력 IDs가 my_db.my_schema.ref_table 테이블의 user_id 열에 나열되어 있으면 다음을 실행합니다.

DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS
  WHERE INPUTID IN (
    SELECT user_id as INPUTID
    FROM my_db.my_schema.ref_table
  );

Copy

배치의 모든 레코드 추가

TransUnion 의 뷰에 있는 배치의 모든 레코드를 캐시에 추가할 수 있습니다.

INSERT INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS (
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
SELECT
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
FROM <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW
WHERE BATCHID = '<BATCH_ID>';

Copy

배치의 모든 레코드 병합

TransUnion의 뷰에 있는 배치의 모든 레코드를 기존 입력 ID 레코드를 해당되는 새 협업 IDs와 마지막으로 처리된 새 타임스탬프로 덮어쓰면 캐시에 병합할 수 있습니다.

MERGE INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS CT
USING <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW OT
  ON
    CT.INPUTID = OT.INPUTID
    AND OT.BATCHID = '<BATCH_ID>'
WHEN MATCHED THEN
  UPDATE SET
    CT.COLLABORATIONID = OT.COLLABORATIONID,
    CT.LASTPROCESSED = OT.LASTPROCESSED
WHEN NOT MATCHED THEN
  INSERT (
    INPUTID,
    COLLABORATIONID,
    LASTPROCESSED
  ) VALUES (
      OT.INPUTID,
      OT.COLLABORATIONID,
      OT.LASTPROCESSED
  );

Copy

입력 ID 레코드에 대한 공동 작업자 IDs 추가

데이터 세트의 열로 존재하고 특정 배치에도 존재하는 입력 ID 레코드에 대해 공동 작업자 IDs를 추가할 수 있습니다.

INSERT INTO SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.SAMOOHA_INTERNAL_TRANSUNION_ID_GENERATION_RECORDS (
  INPUTID,
  COLLABORATIONID,
  LASTPROCESSED
)
  SELECT
    INPUTID,
    COLLABORATIONID,
    LASTPROCESSED
  FROM <TRANSUNION_APPLICATION_DATABASE>.SHARE_SCHEMA.REF_MATCHING_OUTPUT_VIEW
  WHERE INPUTID IN (
    SELECT <column_name_containing_input_ids_to_be_added> as INPUTID
    FROM <dataset_fqtn_containing_input_ids_to_be_added>
    )
    AND BATCHID = '<BATCH_ID>';

Copy