멀티파트 SPARQL 응답을 위한 선택적 HTTP 후행 헤더 - Amazon Neptune

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

멀티파트 SPARQL 응답을 위한 선택적 HTTP 후행 헤더

참고

이 기능은 Neptune 엔진 릴리스 1.0.3.0부터 사용할 수 있습니다.

SPARQL 쿼리 및 업데이트에 대한 HTTP 응답은 종종 2개 이상의 부분 또는 청크로 반환됩니다. 쿼리 또는 업데이트가 이러한 청크를 보내기 시작한 후 발생하는 오류를 진단하기 어려울 수 있습니다. 첫 번째 청크가 200 HTTP 상태 코드로 도착하기 때문에 더욱 그렇습니다.

후행 헤더를 명시적으로 요청하지 않으면 Neptune은 보통 손상된 메시지 본문에 오류 메시지를 추가하는 방식으로만 오류를 보고합니다.

이러한 종류의 문제를 더 쉽게 감지하고 진단할 수 있도록 요청에 전송 인코딩(TE) 후행 헤더(te: trailers)를 포함할 수 있습니다(예: TE 요청 헤더에 대한 MDN 페이지 참조). 이렇게 하면 Neptune이 응답 청크의 후행 헤더에 2개의 새 헤더 필드를 포함하게 됩니다.

  • X-Neptune-Status   –   응답 코드와 짧은 이름이 차례로 들어 있습니다. 예를 들어, 성공하면 후행 헤더는 X-Neptune-Status: 200 OK와 같습니다. 장애가 발생한 경우 응답 코드는 X-Neptune-Status: 500 TimeLimitExceededException과 같은 Neptune 엔진 오류 코드가 됩니다.

  • X-Neptune-Detail   –   요청이 성공하면 비어 있습니다. 오류가 발생한 경우 JSON 오류 메시지가 포함됩니다. HTTP 헤더 값에는 ASCII 문자만 사용할 수 있으므로, JSON 문자열은 URL로 인코딩됩니다. 오류 메시지는 계속해서 응답 메시지 본문에 추가됩니다.