자주 묻는 질문

이 페이지에는 클라우드 데이터 수집과 관련하여 자주 묻는 질문에 대한 답변이 포함되어 있습니다.

이메일을 받은 이유는 무엇인가요? “CDI 동기화 중 오류가 발생했습니다”?

이러한 유형의 이메일은 일반적으로 CDI 설정에 문제가 있음을 의미합니다. 다음은 몇 가지 일반적인 문제와 해결 방법입니다:

CDI가 자격 증명을 사용하여 데이터 웨어하우스 또는 테이블에 액세스할 수 없습니다.

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

테이블을 찾을 수 없습니다.

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

카탈로그를 찾을 수 없습니다.

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

이메일을 받은 이유는 무엇인가요? “CDI 동기화에서 행 오류가 발생했습니다”?

이러한 유형의 이메일은 동기화 중에 일부 데이터를 처리할 수 없음을 의미합니다. 구체적인 오류를 확인하려면 CDI > 동기화 로그로 이동하여 Braze에서 로그를 검토할 수 있습니다.

연결 테스트 및 지원 이메일의 오류를 수정하려면 어떻게 하나요?

테스트 연결이 느리게 실행됨

테스트 연결은 데이터 웨어하우스에서 실행 중이므로 웨어하우스 용량을 늘리면 속도가 향상될 수 있습니다. 서버리스 SQL 인스턴스를 사용하면 워밍업 시간이 최소화되고 쿼리 처리량이 향상되지만 통합 비용이 약간 높아질 수 있습니다.

Snowflake 인스턴스에 연결하는 동안 오류가 발생했습니다: IP로 들어오는 요청은 Snowflake에 액세스할 수 없습니다.

공식 Braze IP를 IP 허용 목록에 추가해 보세요. 자세한 내용은 데이터 웨어하우스 통합을 참조하거나 관련 IP를 허용하세요:

예를 들어 US-01, US-02, US-03, US-04, US-05, US-06, US-07, 다음은 관련 IP 주소입니다.

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

예를 들어 US-08 이 관련 IP 주소입니다:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

예를 들어 US-10 이 관련 IP 주소입니다:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

인스턴스 EU-01 및 EU-02의 경우, 관련 IP 주소는 다음과 같습니다.

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

예를 들어 AU-01 이 관련 IP 주소입니다:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

예를 들어 ID-01 이 관련 IP 주소입니다:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

고객 구성으로 인해 SQL 실행 중 오류가 발생했습니다: 002003 (42S02): SQL 컴파일 오류: 존재하지 않거나 권한이 없습니다.

테이블이 존재하지 않으면 테이블을 생성합니다. 테이블이 존재하는 경우 사용자 및 역할에 테이블에서 읽을 수 있는 권한이 있는지 확인합니다.

스키마를 사용할 수 없습니다.

이 오류가 발생하면 지정된 사용자 또는 역할에 대해 해당 스키마에 대한 액세스 권한을 부여하세요.

역할을 사용할 수 없습니다.

이 오류가 표시되면 해당 사용자가 지정된 역할을 사용할 수 있도록 허용하세요.

사용자 액세스 비활성화

이 오류가 표시되면 해당 사용자에게 Snowflake 계정에 대한 액세스 권한을 허용하세요.

현재 및 이전 키로 Snowflake 인스턴스에 연결하는 중 오류 발생

이 오류가 표시되면 사용자가 현재 공개 키를 사용하고 있는지 확인하여 Braze 대시보드에 표시된 대로 사용 중인 공개 키가 맞는지 확인하세요.

테스트 연결이 느리게 실행됨

관계에 대한 권한이 거부되었습니다. {table_name}

이 오류가 표시되는 경우

해당 사용자에 대한 스키마에 usage 권한을 부여합니다.
해당 사용자에 대해 테이블에 select 권한을 부여합니다.

연결 오류 생성

이 오류가 발생하면 Redshift 엔드포인트와 포트가 올바른지 확인하세요.

SSH 터널 오류 생성

이 오류가 표시되는 경우

Braze 대시보드의 공개 키가 SSH 터널링에 사용되는 ec2 호스트에 있는지 확인합니다.
사용자 아이디가 올바른지 확인합니다.
SSH 터널이 올바른지 확인합니다.

테스트 연결이 느리게 실행됨

사용자에게 테이블을 쿼리할 수 있는 권한이 없습니다.

이 오류가 발생하면 테이블을 쿼리할 수 있는 사용자 권한을 추가하세요.

사용량이 커스텀 할당량을 초과했습니다.

이 오류가 표시되면 할당량을 업데이트해야 현재 속도로 계속 동기화할 수 있습니다.

위치 {지역} 위치에서 테이블을 찾을 수 없습니다.

이 오류가 발생하면 테이블이 올바른 프로젝트 및 데이터 집합에 있는지 확인하세요.

잘못된 JWT 서명

이 오류가 표시되면 계정에 대해 BigQuery API 서비스가 인에이블먼트되어 있는지 확인하세요.

테스트 연결이 느리게 실행됨

테스트 연결은 데이터 웨어하우스에서 실행 중이므로 웨어하우스 용량을 늘리면 속도가 향상될 수 있습니다. 데이터브릭의 경우, Braze가 클래식 및 프로 SQL 인스턴스에 연결할 때 2~5분 정도의 워밍업 시간이 소요될 수 있으며, 이로 인해 연결 설정 및 테스트 중, 그리고 예약된 동기화 시작 시 지연이 발생할 수 있습니다. 서버리스 SQL 인스턴스를 사용하면 워밍업 시간이 최소화되고 쿼리 처리량이 향상되지만 통합 비용이 약간 높아질 수 있습니다.

창고가 중지되어 명령이 실패했습니다.

이 오류가 발생하면 데이터브릭스 웨어하우스가 실행 중인지 확인하세요.

서비스: Amazon S3; 상태 코드: 403; 오류 코드: 403 금지됨

이 오류가 발생하면 데이터브릭을 참조하세요: S3 데이터에 액세스하는 동안 금지된 오류가 발생했습니다.

CDI 통합에 대한 이메일 알림 기본 설정을 업데이트하려면 어떻게 해야 하나요?

각 통합에는 고유한 알림 기본 설정이 있습니다. CDI 페이지로 이동하여 업데이트하려는 통합 이름을 선택합니다. 알림 환경설정 섹션에서 선택한 통합에 관한 알림 수신 방법을 업데이트할 수 있습니다.

향후 UPDATED_AT 이 통합과 동기화되면 어떻게 되나요?

CDI는 UPDATED_AT 을 사용하여 어떤 데이터가 새로운 데이터인지 결정합니다. 향후 UPDATED_AT 날짜 및 시간이 동기화되면 해당 날짜 및 시간 이전의 데이터는 처리되지 않습니다. 이 문제를 해결하려면

정정 UPDATED_AT.
이미 Braze와 동기화된 오래된 데이터를 제거하세요.
새 통합을 생성하여 해당 테이블을 다시 처리합니다.

‘행 동기화’가 내 웨어하우스에 있는 번호와 일치하지 않는 이유는 무엇인가요?

CDI는 UPDATED_AT 을 사용하여 동기화 중에 어떤 레코드를 가져올지 결정합니다. 이 그림을 통해 작동 방식을 확인하세요. 동기화 실행이 시작될 때 CDI는 웨어하우스에 쿼리하여 이전에 처리된 UPDATED_AT 타임스탬프보다 같거나 늦은 모든 레코드( UPDATED_AT )를 가져옵니다. 쿼리가 실행되는 시점에 수집된 모든 레코드는 Braze에 동기화됩니다. 다음은 레코드가 동기화되지 않을 수 있는 일반적인 경우입니다:

이미 처리된 UPDATED_AT 값으로 테이블에 레코드를 추가하고 있습니다.
동기화를 통해 레코드 값을 처리한 후 업데이트하지만 UPDATED_AT 은 변경하지 않고 그대로 둡니다.
동기화가 진행되는 동안 레코드를 추가하거나 업데이트하는 중입니다. CDI 쿼리가 실행되는 시점에 따라 레코드가 선택되지 않는 경합 조건이 있을 수 있습니다.

tip:

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

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

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

CDI의 보안 대책은 무엇인가요?

당사의 조치

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

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

귀하의 조치

사용자와 팀에서 다음과 같은 보안 조치를 설정하는 것이 좋습니다:

자격 증명 액세스를 CDI 작동에 필요한 최소한의 것으로 제한하세요. 특정 테이블 및 뷰에서 선택(및 카운트)을 실행할 수 있어야 하기 때문입니다.
테이블에 액세스할 수 있는 IP를 공식적으로 게시된 Braze IP로 제한합니다.

GitHub 에서 이 페이지를 편집합니다.

New Stuff!