주 컨텐츠로 이동
Administrator Guide
최종 업데이트: 2026-04-03
문제 해결: API를 통한 커스텀 리포트

문제 해결: API를 통한 커스텀 리포트

어플리케이션 프로그래밍 인터페이스; API 호출 시간이 초과되었습니다.

어플리케이션 프로그래밍 인터페이스; API 호출이 60초 이내에 처리되지 않으면 호출 시간이 초과되고 오류 수신됩니다.
원인
해결방법
데이터세트 간에 조인이 너무 많습니다.
데이터세트 간에 사용되는 조인 수를 제한합니다.
필드가 20개가 넘는 리포트를 검색하고 있습니다.
리포트의 필드 수를 최대 10~20개로 제한합니다. 필드 수가 20개를 초과하는 경우 SFTP를 사용하여 리포트를 검색합니다.
데이터 셰이프가 불규칙합니다. 예를 들어 중첩된 조직이 많습니다.
비정상적으로 큰 데이터세트를 검색하지 마십시오.
필터 없는 리포트가 있습니다.
적절한 필터를 사용하여 데이터 크기 증가를 제한합니다. 예를 들어
어제
또는
오늘과
같이 더 작은 기간 정의하는 필터 로 수정된 데이터를 검색합니다.
이전 요청 / 신청 후 분 이내에 요청 / 신청 했습니다. 이는 대량의 데이터를 반환하거나 조인이 여러 개인 리포트의 경우에 특히 그러합니다.
짧은 시간 내에 여러 건의 어플리케이션 프로그래밍 인터페이스; API 요청 / 신청 피합니다.
여러 페이지의 데이터가 포함된 리포트를 검색하고 있습니다.
리포트 API는 페이징된 데이터세트를 반환하도록 의도적으로 설계되었습니다. 모든 VNDLY HTTP 기반 API의 표준 제약사항입니다. 이 문제를 방지하려면 다음을 수행합니다.
  • 한도(반환되는 행 수) 및 오프셋 (시작 행 수)을 사용하여 단일 데이터 페이지를 검색합니다.
  • 리포트에 포함되는 필드 수를 제한하십시오.
  • 페이징을 수행하지 않고 대량 리포트를 검색하려면 리포트 어플리케이션 프로그래밍 인터페이스; API 대신 SFTP를 사용합니다.

프로덕션 테넌트에서 데이터를 검색할 때 성능 문제가 발생하지만 테스트 테넌트에서는 검색되지 않습니다.

데이터 로드는 프로덕션 테넌트보다 테스트 테넌트에서 적기 때문에 테스트 테넌트에서는 성능 문제가 명확하지 않을 수 있습니다.
솔루션:
  • 프로덕션 고라이브 후 리포트 성능 확인하여 결과가 테스트 테넌트와 유사한지 확인합니다.
  • 프로덕션 로드를 나타내는 크기로 테스트 데이터를 사용하여 테스트 테넌트를 로드합니다.
  • 프로덕션에서의 확장 계획 프로덕션 데이터가 포함된 리포트의 예상 로드 크기와 복잡성 고려합니다. 한도에 근접하여 실행되는 리포트의 경우, 프로그램 성숙화되면 또는 고라이브 이후에 실행되는 리포트의 경우 한도를 초과할 가능성이 높습니다.