En-têtes HTTP de suivi facultatifs pour les réponses en plusieurs parties SPARQL - Amazon Neptune

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

En-têtes HTTP de suivi facultatifs pour les réponses en plusieurs parties SPARQL

Note

Cette fonctionnalité est disponible à partir de la version 1.0.3.0 du moteur Neptune.

La HTTP réponse aux SPARQL requêtes et aux mises à jour est souvent renvoyée en plusieurs parties ou en plusieurs parties. Il peut être difficile de diagnostiquer une défaillance qui survient après qu'une requête ou une mise à jour commence à envoyer ces fragments, d'autant plus que le premier arrive avec un code d'HTTPétat de200.

À moins que vous ne demandiez explicitement des en-têtes de suivi, Neptune ne signale un tel échec qu'en ajoutant un message d'erreur dans le corps du message, qui est généralement corrompu.

Pour faciliter la détection et le diagnostic de ce type de problème, vous pouvez inclure un en-tête de remorques à encodage de transfert (TEte: trailers) dans votre demande (voir, par exemple, la MDN page sur les en-têtes de requête TE). De cette manière, Neptune inclura deux nouveaux champs d'en-tête dans les en-têtes de suivi des fragments de réponse :

  • X-Neptune-Status : contient le code de réponse suivi d'un nom court. Par exemple, en cas de réussite, l'en-tête final serait : X-Neptune-Status: 200 OK. En cas d'échec, le code de réponse est un code d'erreur du moteur Neptune, tel que X-Neptune-Status: 500 TimeLimitExceededException.

  • X-Neptune-Detail : est vide pour les demandes qui ont abouti. En cas d'erreur, il contient le message JSON d'erreur. Comme seuls les ASCII caractères sont autorisés dans les valeurs HTTP d'en-tête, la JSON chaîne est URL codée. Le message d'erreur est également toujours ajouté au corps du message de réponse.