콘텐츠로 건너뛰기

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

이 페이지에서는 클라우드 데이터 수집(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!