多部分SPARQL響應的可選HTTP尾隨標題 - Amazon Neptune

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

多部分SPARQL響應的可選HTTP尾隨標題

注意

此功能從 Neptune 引擎 1.0.3.0 版開始可用。

SPARQL查詢和更新的回HTTP應通常會傳回一個以上的零件或區塊。在查詢或更新開始傳送這些區塊之後，很難診斷發生的失敗，特別是因為第一個區塊的HTTP狀態碼送達200。

除非您明確請求結尾標頭，否則 Neptune 只會透過將錯誤訊息附加到訊息本文 (通常已損毀) 來報告此類失敗。

若要更輕鬆地偵測和診斷此類問題，您可以在要求中加入轉移編碼 (TE) 預告片標頭 (te: trailers) () (例如，請參閱 TE 要求標頭的相關MDN頁面)。這樣做會導致 Neptune 在回應區塊的結尾標頭內包括兩個新的標頭欄位：

  • X-Neptune-Status – 包含回應碼，後面接著簡短名稱。例如，若成功，結尾標頭將是：X-Neptune-Status: 200 OK。若失敗，回應代碼將是 Neptune 引擎錯誤代碼，例如 X-Neptune-Status: 500 TimeLimitExceededException。

  • X-Neptune-Detail – 對於成功的請求而言是空的。在錯誤的情況下，它包含JSON錯誤消息。由於HTTP標題值中只允許使用ASCII字元，因此會對JSON字串進行URL編碼。錯誤訊息仍會附加至回應訊息本文。