SPARQLcancelamento de consulta

Para obter o status das SPARQL consultas, use HTTP GET ou POST faça uma solicitação ao https://your-neptune-endpoint:port/sparql/status endpoint.

SPARQLparâmetros de solicitação de cancelamento de consulta

cancelQuery

(Obrigatório) Ordena ao comando de status para cancelar uma consulta. Esse parâmetro não usa um valor.

queryId

(Obrigatório) O ID da SPARQL consulta em execução a ser cancelada.

silent

(Opcional) silent=true Nesse caso, a consulta em execução for cancelada e o código de HTTP resposta for 200. Se não silent estiver presente ousilent=false, a consulta será cancelada com um código de status HTTP 500.

SPARQLexemplos de cancelamento de consulta

Exemplo 1: cancelamento com silent=false

Veja a seguir um exemplo do comando de status que usa curl para cancelar uma consulta com o parâmetro silent definido como false:

curl https://your-neptune-endpoint:port/sparql/status \
  -d "cancelQuery" \
  -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47" \
  -d "silent=false"

A menos que a consulta já tenha começado a transmitir os resultados, a consulta cancelada retornaria um código HTTP 500 com uma resposta como esta:

{
  "code": "CancelledByUserException",
  "requestId": "4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47",
  "detailedMessage": "Operation terminated (cancelled by user)"
}

Se a consulta já retornou um código HTTP 200 (OK) e começou a transmitir os resultados antes de ser cancelada, as informações da exceção de tempo limite serão enviadas para o fluxo de saída normal.

Exemplo 2: cancelamento com silent=true

Veja a seguir um exemplo do mesmo comando de status acima, com a exceção de que o parâmetro silent agora está definido como true:

curl https://your-neptune-endpoint:port/sparql/status \
  -d "cancelQuery" \
  -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47" \
  -d "silent=true"

Esse comando retornaria a mesma resposta de quandosilent=false, mas a consulta cancelada agora retornaria um código HTTP 200 com uma resposta como esta:

{
  "head" : {
    "vars" : [ "s", "p", "o" ]
  },
  "results" : {
    "bindings" : [ ]
  }
}