콘텐츠로 건너뛰기

카탈로그 데이터 동기화 및 삭제

이 페이지에서는 클라우드 데이터 수집(CDI)으로 카탈로그 데이터를 동기화하는 방법을 설명합니다. 카탈로그 동기화는 모든 CDI 소스에서 지원되며, 각 소스의 소스 테이블 또는 파일 형식은 해당 소스 페이지에 설명되어 있습니다.

1단계: 새 카탈로그 만들기

카탈로그용 CDI 통합을 새로 만들기 전에 새 카탈로그를 만들거나, 통합에 사용할 기존 카탈로그를 확인해야 합니다. 새 카탈로그를 만드는 방법은 몇 가지가 있으며, 어떤 방법을 사용해도 CDI 통합에 사용할 수 있습니다.

카탈로그 스키마를 변경하려면(예: 새 필드 추가 또는 필드 유형 변경) 업데이트된 데이터가 CDI를 통해 동기화되기 전에 카탈로그 대시보드에서 변경해야 합니다. 데이터 웨어하우스 데이터와 Braze의 스키마 간 충돌을 피하려면 동기화가 일시 중지되었거나 실행 일정이 잡혀 있지 않을 때 이러한 업데이트를 진행하는 것이 좋습니다.

2단계: 카탈로그 동기화 설정하기

카탈로그 동기화 설정은 같은 소스의 사용자 데이터 동기화 과정과 거의 동일합니다. 소스 페이지를 열고 소스 테이블 또는 파일 형식에 대한 카탈로그 항목 탭을 선택한 다음, 해당 페이지에서 나머지 설정을 완료합니다.

소스 카탈로그 설정
Snowflake Snowflake 소스 테이블
Amazon Redshift Redshift 소스 테이블
Google BigQuery BigQuery 소스 테이블
Databricks Databricks 소스 테이블
Microsoft Fabric Microsoft Fabric 소스 테이블
Amazon S3 Amazon S3 파일 형식
Google Cloud Storage Google Cloud Storage 파일 형식
Azure Blob Storage Azure Blob Storage 파일 형식

어떤 소스를 사용하든 다음 사항이 적용됩니다.

  • 동기화를 생성할 때 카탈로그 동기화 유형을 선택합니다.
  • 동기화를 식별할 수 있도록 동기화 이름을 입력합니다.
  • 업데이트할 카탈로그에서 기존 카탈로그 사용을 선택한 다음 카탈로그를 선택하거나, 새 카탈로그 생성을 선택하고 카탈로그 이름을 입력합니다.
  • 기존 동기화의 자격 증명이 이미 있다면 재사용할 수 있지만, 카탈로그 소스 테이블에 대한 액세스 권한도 부여해야 합니다.

필수 열

열 필수 여부 설명
ID 예 생성하거나 업데이트할 카탈로그 항목의 ID입니다.
PAYLOAD 예 Braze의 카탈로그 항목에 동기화할 필드의 JSON 문자열입니다.
DELETED 선택 사항 true로 설정하면 해당 카탈로그 항목이 카탈로그에서 제거됩니다.
UPDATED_AT 데이터 웨어하우스 소스만 해당 이 행이 업데이트되거나 추가된 시간입니다. 파일 스토리지 소스는 UPDATED_AT 열을 지원하지 않습니다.

통합 작동 방식

동기화가 실행될 때마다 Braze는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 모든 행을 가져옵니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 가지는 경우, 해당 타임스탬프의 행이 다시 동기화될 수 있습니다.

Braze는 데이터 웨어하우스에서 카탈로그 데이터로 뷰를 생성하여 동기화가 실행될 때마다 완전히 새로 고쳐지는 소스 테이블을 설정할 것을 권장합니다. 뷰를 사용하면 매번 쿼리를 다시 작성할 필요가 없습니다. 웨어하우스의 SQL 방언으로 작성된 예시는 소스 페이지의 카탈로그 아이템 탭을 참조하세요.

어떤 소스를 사용하든 다음 사항이 적용됩니다.

  • 통합에서 가져온 데이터는 제공된 id를 기준으로 대상 카탈로그의 아이템을 생성하거나 업데이트하는 데 사용됩니다.
  • DELETED가 true로 설정되면 해당 카탈로그 아이템이 삭제됩니다.
  • 동기화는 데이터 포인트를 기록하지 않지만, 동기화된 모든 데이터는 총 카탈로그 사용량에 포함됩니다. 이 사용량은 저장된 총 데이터를 기준으로 측정되므로 변경된 데이터만 동기화하는 것에 대해 걱정할 필요가 없습니다.
New Stuff!