マルチパートSPARQLレスポンスのオプションのHTTP末尾ヘッダー - Amazon Neptune

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

マルチパートSPARQLレスポンスのオプションのHTTP末尾ヘッダー

注記

この機能は、Neptune エンジンリリース 1.0.3.0 からアクセスできます。

SPARQL クエリと更新に対するHTTP応答は、多くの場合、複数の部分またはチャンクで返されます。クエリまたは更新がこれらのチャンクの送信を開始した後に発生する障害を診断するのは難しい場合があります。特に、最初のチャンクが HTTPのステータスコードで到着したためです200。

末尾のヘッダーを明示的にリクエストしない限り、Neptune は、エラーメッセージをメッセージ本文に追加することによってのみ、そのような障害を報告しますが、通常これは破損しています。

このような問題の検出と診断を容易にするために、リクエストに Transfer-Encoding (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エンコードされます。エラーメッセージは、レスポンスメッセージ本文にも追加されます。