Skip to content

내보내기 문제 해결

이 페이지는 CSV 및 API 워크플로우 모두에서 발생하는 내보내기 관련 일반적인 문제 해결 시나리오를 다룹니다.

탭을 사용하여 기본값 Braze S3 버킷으로 내보낼지, 아니면 클라우드 스토리지 파트너로 내보낼지 선택하십시오.

기본 내보내기 대상으로 지정된 저장소 파트너가 없는 경우, Braze는 자체 Amazon S3 버킷을 사용하여 내보내기 파일을 보관합니다. 이 설정의 파일은 임시 파일이며 4시간 후에 만료됩니다.

CSV 내보내기

대시보드에서 CSV를 내보낼 때, Braze는 로그인한 사용자에게 다운로드 링크를 이메일로 발송합니다. 해당 링크는 Braze의 S3 버킷에 호스팅된 ZIP 파일을 가리킵니다. ZIP 파일 내부에는 여러 개의 작은 파일들이 포함되어 있으며, 이 파일들이 합쳐져 내보내기 파일을 구성합니다.

링크를 사용하려면 Braze 대시보드에 로그인해야 하며, 파일은 4시간 동안만 이용 가능합니다. 그 후 링크는 더 이상 작동하지 않으며 데이터는 삭제됩니다. 매우 큰 규모의 내보내기(500,000명 이상의 사용자)에서 반복적인 실패가 발생할 경우, 내보내기가 실패할 수 있습니다. 그 경우, 내보내기를 더 작은 그룹이나 필드로 나누어 보거나, 저장 파트너를 설정하는 것을 고려해 보십시오.

일반적인 오류

  • 오류가AccessDenied 발생하면 해당 파일이 이미 만료되었거나 준비되기 전에 열려고 시도했을 수 있습니다. 더 큰 보고서는 생성하는 데 시간이 더 오래 걸리므로, 잠시 기다린 후 다시 시도해 주세요.
  • 오류는ExpiredToken 4시간의 시간이 지났음을 의미합니다. 내보내기를 다시 실행하여 새로운 링크를 생성하십시오.
  • 이 메시지는Looks like the file doesn't exist anymore일반적으로 이메일이 전송되었지만 파일이 S3에 업로드가 완료되지 않았을 때 나타납니다. 몇 분만 기다리면 보통 해결됩니다.
  • 특정 필드(예:- =, +, , 또는 @)의 시작 부분에 추가된 아포스트로피는 예상됩니다. 예를 들어,-1943 는'-1943CSV에서 로 변환됩니다. Braze는 스프레드시트 프로그램이 데이터를 잘못 해석하는 것을 방지하기 위해 이렇게 합니다. 이는 /users/export/segment 엔드포인트에서 반환되는 JSON 내보내기와 같은 내보내기에는 적용되지 않습니다.

API 수출

클라우드 스토리지를 사용하지 않고 Export API를 통해 내보낼 경우, Braze는 파일을 자체 S3 버킷에 기록합니다. 이메일을 받지 못할 것입니다. 대신 API 응답에 임시 다운로드 URL이 포함됩니다. 수출 파일은 ZIP 형식으로 제공되며, 각 ZIP 파일에는 여러 JSON 파일이 포함되어 있습니다. 각 JSON 파일에는 한 줄에 한 명의 사용자가 기록됩니다.

CSV 내보내기처럼 API 링크도 4시간 후에 만료됩니다. 링크를 너무 일찍 클릭하면 파일이 아직 준비되지 않아 오류가 발생할 수 있습니다. 파일이 준비되면 Braze에서 알림을 받으려면 요청 시 callback_endpoint알림을 제공할 수 있습니다.

대규모 API 내보내기도 시간 초과될 수 있습니다. 그럴 경우, 더 작은 요청을 해보거나 저장소 파트너를 연결하여 해당 볼륨을 처리하도록 하십시오.

일반적인 오류

  • AccessDenied 또는ExpiredToken일반적으로 링크가 만료되었거나 아직 준비되지 않았음을 의미합니다. 내보내기를 다시 실행하거나 조금 더 기다려 주세요.

대시보드의 ‘기술 파트너’ 페이지에서 스토리지 파트너(예: Amazon S3, Google Cloud Storage 또는 Azure Blob)를 연결하고 이를 기본값 내보내기 대상으로 설정하면, Braze가 내보낸 데이터를 해당 버킷에 직접 기록합니다. 이 설정은 일반적으로 대용량 내보내기에 더 안정적입니다.

CSV 내보내기

CSV 내보내기 시, Braze에서 다운로드 링크를 이메일로 발송합니다. 해당 링크는 짧은 시간(일반적으로 약 4시간) 후에 만료됩니다. 저장 파트너가 연결되어 있고 기본값 내보내기 대상으로 설정된 경우, Braze는 내보낸 데이터의 사본을 연결된 버킷에도 전달합니다. 해당 사본은 귀사의 인프라에 저장되며, 만료 및 보존 기간은 귀사의 스토리지 정책을 따릅니다.

클라우드 스토리지에서 CSV 내보내기 파일은 ZIP 파일로 압축됩니다. ZIP 파일 내부에는 여러 개의 작은 CSV 파일이 포함되어 있습니다. 대규모 내보내기는 종종 여러 조각(예: 각각 약 5,000명의 사용자)으로 분할되며, 조각 크기는 달라질 수 있습니다. 파일 크기가 작다고 해서 데이터가 누락된 것은 아닙니다. 이메일로 전송된 링크가 실패하더라도 저장소에 복사해 둔 데이터는 성공적으로 복구할 수 있으므로, 언제든지 버킷에서 직접 데이터를 가져올 수 있습니다.

일반적인 오류

  • AccessDenied Braze가 귀하의 버킷에 쓰기 작업을 수행할 수 없음을 의미합니다. 자격 증명과 권한이 여전히 유효한지 다시 한번 확인하십시오.
  • ExpiredToken Braze가 버킷에 대한 접근 권한을 상실한 경우 표시됩니다. Braze 대시보드에서 자격 증명을 업데이트하세요.
  • 일부 파일이 예상보다 작게 보이는 것은 정상적인 현상입니다. 수출 프로세스는 안정성을 위해 의도적으로 파일을 분할합니다.
  • 특정 필드(예:- =, +, , 또는 @)의 시작 부분에 추가된 아포스트로피는 예상됩니다. 예를 들어,-1943 는'-1943CSV에서 로 변환됩니다. Braze는 스프레드시트 프로그램이 데이터를 잘못 해석하는 것을 방지하기 위해 이렇게 합니다. 이는 /users/export/segment 엔드포인트에서 반환되는 JSON 내보내기와 같은 내보내기에는 적용되지 않습니다.

API 수출

스토리지 파트너가 연결된 상태에서 API를 통해 데이터를 내보낼 때, 내보낸 파일은 귀하의 버킷에 기록됩니다. 이메일이 발송되지 않습니다. 기본 객체는 저장소에 존재하며 보존 설정을 따르지만, Braze가 반환하는 다운로드 URL은 여전히 시간 제한이 있을 수 있습니다. 각 ZIP 파일에는 JSON 객체가 포함되어 있으며, 각 객체는 한 줄에 하나씩 배치됩니다. 대용량 내보내기는 단일 ZIP 파일 대신 여러 ZIP 파일로 분할될 수 있으며, 이는 일반적으로 대용량 내보내기에 더 안정적인 방법입니다.

일반적인 오류

  • AccessDenied Braze가 버킷에 쓰기 작업을 수행할 수 없거나 객체가 이후에 삭제된 경우 발생합니다. 권한을 확인하고 외부에서 파일을 삭제하는 것이 없는지 확인하십시오.
  • ExpiredToken Braze의 버킷에 대한 액세스 자격 증명이 오래되었음을 의미합니다. 대시보드에서 새로고침하세요.
  • 파일이 누락되었거나 예상보다 작은 경우, 먼저 Braze 외부에서 객체를 삭제하는 요소가 없는지 확인하십시오. 파일 크기가 더 작아질 것으로 예상됩니다.
Github   GitHub 에서 이 페이지를 편집합니다.
New Stuff!