

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Como usar o `explain` do SPARQL para analisar a execução de consultas do Neptune
<a name="sparql-explain-using"></a>

O atributo `explain` do SPARQL é uma ferramenta de autoatendimento no Amazon Neptune que ajuda a compreender a abordagem da execução realizada pelo mecanismo do Neptune. Para invocar o `explain`, você passa um parâmetro para uma solicitação HTTP ou HTTPS no formulário `explain={{mode}}`.

O valor do modo pode ser `static`, `dynamic` ou `details`:
+ No modo *estático*, o `explain` imprime somente a estrutura estática do plano de consulta.
+ No modo *dynamic*, o `explain` também inclui aspectos dinâmicos do plano de consulta. Esses aspectos podem incluir o número de associações intermediárias que fluem por meio dos operadores, a proporção de associações de entrada para associações de saída e o tempo total utilizado pelos operadores.
+ No modo de *detalhes*, `explain` imprime as informações mostradas no modo `dynamic` mais detalhes adicionais, como a string de consulta SPARQL real e a contagem de intervalo estimada para o padrão subjacente a um operador de junção.

O Neptune é compatível com o uso do `explain` com todos os três protocolos de acesso de consulta do SPARQL listados na especificação [W3C SPARQL 1.1 Protocol](https://www.w3.org/TR/sparql11-protocol/#query-operation), ou seja:

1. HTTP GET

1. HTTP POST usando parâmetros codificados por URL

1. HTTP POST usando parâmetros de texto

Para obter informações sobre o mecanismo de consulta do SPARQL, consulte [Como o mecanismo de consulta do SPARQL funciona no Neptune](sparql-explain-engine.md).

Para obter informações sobre o tipo de saída produzido ao invocar o `explain` do SPARQL, consulte [Exemplos de invocação do SPARQL `explain` no Neptune](sparql-explain-examples.md).