

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.

# Comment utiliser la fonction SPARQL `explain` pour analyser l'exécution des requêtes
<a name="sparql-explain-using"></a>

La fonctionnalité `explain` SPARQL est un outil en libre-service dans Amazon Neptune qui vous aide à comprendre l'approche d'exécution adoptée par le moteur Neptune. Pour appeler `explain`, vous transmettez un paramètre à une demande HTTP ou HTTPS dans le formulaire `explain=mode`.

Sa valeur de mode peut prendre l'une des valeurs suivantes : `static`, `dynamic` ou `details`.
+ En mode *statique*, `explain` affiche uniquement la structure statique du plan de requête.
+ En mode *dynamique*, `explain` inclut également les aspects dynamiques du plan de requête. Ces aspects peuvent inclure le nombre de liaisons intermédiaires transitant via les opérateurs et le ratio de liaisons sortantes par rapport aux liaisons entrantes, ainsi que le temps total pris par les opérateurs.
+ En mode *détails*, `explain` imprime les informations affichées en mode `dynamic`, ainsi que des détails supplémentaires tels que la chaîne de requête SPARQL réelle et le nombre de plages estimé pour le modèle sous-jacent d'un opérateur de jointure.

Neptune prend en charge l'utilisation de la fonctionnalité `explain` avec les trois protocoles d'accès aux requêtes SPARQL répertoriés dans la spécification [W3C SPARQL 1.1 Protocol](https://www.w3.org/TR/sparql11-protocol/#query-operation), à savoir :

1. HTTP GET

1. HTTP POST à l'aide de paramètres encodés en URL

1. HTTP POST à l'aide de paramètres de texte

Pour plus d'informations sur le moteur de requête SPARQL, consultez [Fonctionnement du moteur de requête SPARQL dans Neptune](sparql-explain-engine.md).

Pour plus d'informations sur le type de résultat généré par l'appel de la fonction `explain` SPARQL, consultez [Exemples d'invocation de la fonctionnalité SPARQL `explain` dans Neptune](sparql-explain-examples.md).