자주 묻는 질문

이 페이지에서는 클라우드 데이터 수집에 대해 자주 묻는 질문에 대한 답변을 제공합니다.

CDI 동기화는 얼마나 자주 실행할 수 있나요?

반복 동기화는 최소 5분마다, 최대 한 달에 한 번까지 실행할 수 있습니다. 기본적으로 대시보드에서 설정할 수 있는 가장 짧은 간격은 15분이며, 이를 통해 데이터 웨어하우스 컴퓨팅 비용과 요청량을 관리할 수 있습니다. 5분마다 동기화하려면 Braze 지원팀 또는 고객 성공 매니저에게 문의하세요. 데이터가 변경되는 즉시 동기화하려면 동기화 트리거 엔드포인트를 호출하세요. 자세한 내용은 작동 방식을 참조하세요.

“Error in CDI Sync” 이메일을 받은 이유는 무엇인가요?

이 이메일은 보통 CDI 설정에 문제가 있다는 뜻입니다. 자주 발생하는 문제와 해결 방법은 다음과 같습니다.

CDI가 자격 증명으로 데이터 웨어하우스 또는 테이블에 접근할 수 없음

CDI에 입력한 자격 증명이 잘못되었거나 데이터 웨어하우스에서 잘못 구성되었을 수 있습니다. 자세한 내용은 데이터 웨어하우스 통합을 참조하세요.

테이블을 찾을 수 없음

올바른 데이터베이스 구성으로 통합을 업데이트하거나, 데이터 웨어하우스에 database/table과 같이 일치하는 리소스를 생성해 보세요.

카탈로그를 찾을 수 없음

통합에 설정한 카탈로그가 Braze 카탈로그에 존재하지 않습니다. 통합을 설정한 후에 카탈로그가 삭제되었을 수 있습니다. 이 문제를 해결하려면 다른 카탈로그를 사용하도록 통합을 업데이트하거나, 통합에 지정된 카탈로그 이름과 일치하는 새 카탈로그를 생성하세요.

“Row errors in your CDI sync” 이메일을 받은 이유는 무엇인가요?

이 이메일은 동기화 중에 일부 데이터를 처리하지 못했다는 의미입니다. 구체적인 오류를 확인하려면 Braze에서 CDI > 동기화 로그로 이동하여 로그를 검토하세요.

CDI 설정에서 “Time must be string in ISO8601 Format” 오류를 해결하려면 어떻게 해야 하나요?

이 오류는 CDI 페이로드의 이벤트 time 값이 지원되는 날짜/시간 형식이 아니라는 의미입니다.

이벤트 및 구매 페이로드의 경우, time을 다음 형식 중 하나로 지정하세요.

• ISO 8601 문자열
• yyyy-MM-dd'T'HH:mm:ss:SSSZ

time을 생략하면 Braze는 UPDATED_AT을 이벤트 시간으로 사용합니다.

전체 페이로드 요구 사항은 클라우드 데이터 수집을 위한 테이블 설정을 참조하세요.

연결 테스트 오류 및 지원 이메일 관련 오류는 어떻게 해결하나요?

• snowflake
• redshift
• bigquery
• databricks

CDI 통합에 대한 이메일 알림 환경설정은 어떻게 업데이트하나요?

각 통합에는 자체 알림 환경설정이 있습니다. CDI 페이지로 이동하여 업데이트하려는 통합 이름을 선택하세요. 알림 환경설정 섹션에서 선택한 통합에 대한 알림을 받는 방식을 업데이트할 수 있습니다.

“Incorrect Integration Object” 오류가 표시되는 이유는 무엇인가요?

이 오류는 CDI 통합의 알림 환경설정을 업데이트하려고 할 때, 두 개 이상의 워크스페이스에 동일한 클라우드 스토리지 버킷 또는 폴더를 가리키는 통합이 있는 경우에 발생합니다. 각 클라우드 스토리지 위치는 한 번에 하나의 통합에서만 사용할 수 있습니다.

이 문제를 해결하려면 다음 단계를 따르세요:

1. 동일한 스토리지 위치를 사용하는 CDI 통합이 있는 다른 워크스페이스를 확인합니다.
2. 해당 워크스페이스에서 충돌하는 통합을 제거하거나 다시 구성합니다.
3. 충돌을 제거한 후 알림 환경설정을 업데이트할 수 있습니다.

이제 오류가 더 이상 표시되지 않으며 알림 환경설정을 정상적으로 업데이트할 수 있습니다. 문제가 계속되면 지원 티켓을 열어 주세요.

미래 시점의 UPDATED_AT이 통합과 동기화되면 어떻게 되나요?

CDI는 UPDATED_AT을 사용하여 새 데이터를 판단합니다. 미래 시점의 UPDATED_AT이 동기화되면, 해당 미래 날짜와 시간 이전의 데이터는 처리되지 않습니다. 이 문제를 해결하려면 다음 단계를 따르세요.

1. UPDATED_AT을 수정합니다.
2. Braze와 이미 동기화된 기존 데이터를 삭제합니다.
3. 새 통합을 생성하여 해당 테이블을 다시 처리합니다.

“Rows Synced”가 웨어하우스의 숫자와 일치하지 않는 이유는 무엇인가요?

CDI는 UPDATED_AT을 사용하여 동기화 중에 가져올 레코드를 결정합니다. 작동 방식은 이 그림에서 확인하세요. 동기화 실행이 시작되면 CDI는 웨어하우스에 쿼리를 보내 이전에 처리된 UPDATED_AT 값보다 이후의 UPDATED_AT 값을 가진 모든 레코드를 가져옵니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 가지는 경우, 해당 타임스탬프의 레코드가 다시 동기화될 수도 있습니다. 쿼리가 실행되는 시점에 가져온 레코드는 모두 Braze로 동기화됩니다. 레코드가 동기화되지 않을 수 있는 일반적인 경우는 다음과 같습니다.

• 이미 처리된 UPDATED_AT 값으로 테이블에 레코드를 추가하는 경우
• 동기화로 처리된 후 레코드 값을 업데이트하면서 UPDATED_AT은 변경하지 않는 경우
• 동기화가 진행되는 동안 레코드를 추가하거나 업데이트하는 경우. CDI 쿼리가 실행되는 시점에 따라 경합 조건이 발생하여 레코드를 가져오지 못할 수 있습니다.

팁

앞으로 이러한 동작을 방지하려면 단조 증가하는 UPDATED_AT 값을 사용하고, 예약된 동기화가 실행되는 동안에는 테이블을 업데이트하지 않는 것이 좋습니다.

대규모 CDI 가져오기에는 대부분 고유한 UPDATED_AT 값이 필요한가요?

네. 대용량 실행(예: 약 1,000만 행 초과)에서는 소스 데이터의 UPDATED_AT 값이 대부분 고유한지 확인하세요. 너무 많은 행이 동일한 타임스탬프를 공유하면, CDI가 이후 실행에서 경계 타임스탬프의 행을 다시 선택할 가능성이 높아집니다. 이로 인해 중복 동기화와 데이터 포인트 소비가 늘어날 수 있습니다.

CDI 경계 동작에 대한 자세한 내용은 중복 타임스탬프가 있는 행의 재동기화 방지를 참조하세요.

이 SQL 검사는 어디에서 실행하나요?

CDI 통합에서 사용하는 것과 동일한 테이블 또는 뷰를 대상으로 데이터 웨어하우스 SQL 편집기에서 직접 검사를 실행하세요.

• Snowflake: Projects > Worksheets (자세한 내용은 Snowflake Worksheets 참조)
• Redshift: Query Editor v2 (자세한 내용은 Amazon Redshift Query Editor v2 사용 참조)
• BigQuery: BigQuery Studio SQL 작업 공간 (자세한 내용은 BigQuery Studio 소개 참조)
• Databricks: SQL 편집기(SQL 웨어하우스) (자세한 내용은 Databricks SQL 편집기 참조)
• Fabric: SQL 쿼리 편집기

대규모 동기화를 활성화하거나 확장하기 전에 다음 절차를 따르세요.

1. 검증하려는 정확한 CDI 소스 테이블 또는 뷰와 동기화 기간을 확인합니다.
2. 웨어하우스 SQL 편집기를 열고 CDI에서 사용하는 것과 동일한 데이터베이스와 스키마를 선택한 다음, 소스 테이블 또는 뷰에 대한 읽기 권한이 있는 역할을 사용합니다.
3. 고유 타임스탬프 개수 쿼리를 실행하여 해당 기간에 고유한 UPDATED_AT 값이 몇 개 있는지 측정합니다.
4. UPDATED_AT 기준으로 그룹화하여 행 수를 세는 쿼리를 실행해 행 수가 비정상적으로 많은 타임스탬프를 찾습니다.
5. 많은 행이 동일한 타임스탬프를 공유하는 경우, 연속된 배치가 점진적으로 더 최신의 UPDATED_AT 값을 사용하도록 수집 프로세스를 조정하거나, 타임스탬프 정밀도를 높여 행이 더 고르게 분산되도록 합니다.
6. 집중도가 줄어들 때까지 두 쿼리를 다시 실행한 다음, 동기화를 시작하거나 확장합니다.
7. 시작 후에는 CDI > Sync Log에서 경계 타임스탬프의 예상치 못한 재동기화 볼륨을 모니터링합니다.

웨어하우스에서 다음과 같은 검사를 사용하세요.

1
2
3
4
5
6
7

SELECT
  COUNT(*) AS total_rows,
  COUNT(DISTINCT UPDATED_AT) AS distinct_timestamps,
  ROUND(COUNT(*) * 1.0 / NULLIF(COUNT(DISTINCT UPDATED_AT), 0), 2) AS avg_rows_per_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP);

1
2
3
4
5
6
7
8
9

SELECT
  UPDATED_AT,
  COUNT(*) AS rows_at_timestamp
FROM YOUR_CDI_SOURCE_TABLE
WHERE UPDATED_AT >= CAST('2026-04-01 00:00:00' AS TIMESTAMP)
  AND UPDATED_AT < CAST('2026-04-02 00:00:00' AS TIMESTAMP)
GROUP BY UPDATED_AT
ORDER BY rows_at_timestamp DESC
LIMIT 20;

웨어하우스에서 LIMIT을 지원하지 않는 경우(예: Fabric), TOP과 같은 동등한 구문을 사용하세요.

행 수가 적은 CDI 동기화도 몇 분이 걸리는 이유는 무엇인가요?

CDI 동기화에는 행 처리가 시작되기 전에 고정된 시작 기간이 포함됩니다. 이 시작 시간은 동기화 크기와 관계없이 비슷하기 때문에, 작은 동기화도 몇 분이 걸릴 수 있으며 분당 처리 행 수 기준으로는 더 느리게 보일 수 있습니다. 전체 동기화 시간은 여전히 소스 쿼리의 복잡성, 데이터 형태, 데이터 웨어하우스의 가용 용량에 따라 달라집니다. 자세한 내용은 데이터 웨어하우스 통합을 참조하세요.

동기화 중에 여러 레코드가 동일한 ID를 공유하는 경우 순서가 유지되나요?

처리 순서를 100% 예측할 수는 없습니다. 예를 들어, 동기화 중에 테이블에 동일한 EXTERNAL_ID를 가진 행이 여러 개 있으면 최종 프로필에 어떤 값이 반영될지 보장할 수 없습니다. 페이로드 열에서 서로 다른 속성으로 동일한 EXTERNAL_ID를 업데이트하는 경우, 동기화가 완료되면 모든 변경 사항이 반영됩니다.

CDI 동기화에서 신규 사용자가 생성되지 않는 이유는 무엇인가요?

CDI 통합에 기존 사용자만 업데이트 옵션이 활성화되어 있으면 Braze에 이미 존재하는 사용자만 업데이트되고 신규 사용자는 생성되지 않습니다. 따라서 동기화 테이블의 행이 기존 Braze 사용자와 일치하지 않는 EXTERNAL_ID를 참조하면 해당 행은 건너뜁니다.

CDI로 신규 사용자를 생성하려면 통합 설정에서 기존 사용자만 업데이트 토글을 끄세요. 데이터 설정 > 클라우드 데이터 수집으로 이동한 다음 통합을 선택하세요.

CDI의 보안 조치는 무엇인가요?

Braze의 조치

Braze는 CDI에 대해 다음과 같은 조치를 시행하고 있습니다:

• 모든 자격 증명은 데이터베이스 내에서 암호화되며, 인증된 일부 직원만 접근할 수 있습니다.
• 고객 데이터 웨어하우스에서 데이터를 가져올 때 암호화된 연결을 사용합니다.
• Braze API 엔드포인트에 요청할 때는 고객에게 권장하는 것과 동일한 API 키와 TLS 연결을 사용합니다.
• 라이브러리를 정기적으로 업데이트하고 보안 패치를 적용합니다.

고객의 조치

고객과 고객의 팀에서 다음과 같은 보안 조치를 설정할 것을 권장합니다:

• 자격 증명 접근 권한을 CDI 운영에 필요한 최소한으로 제한하세요. Braze는 특정 테이블과 뷰에서 select(및 count)를 실행할 수 있어야 하기 때문입니다.
• 테이블에 접근할 수 있는 IP를 공식적으로 게시된 Braze IP로 제한하세요.