API de status de consulta do SPARQL

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

Parâmetros de solicitação do status de consulta do SPARQL

queryId (opcional)

O ID de uma consulta SPARQL em execução. Exibe apenas o status da consulta especificada.

Sintaxe da resposta do status de consulta do SPARQL

{
    "acceptedQueryCount": integer,
    "runningQueryCount": integer,
    "queries": [
      {
        "queryId":"guid",
        "queryEvalStats":
          {
            "subqueries": integer,
            "elapsed": integer,
            "cancelled": boolean
          },
        "queryString": "string"
      }
    ]
}

Valores da resposta do status de consulta do SPARQL

acceptedQueryCount

O número de consultas aceitas desde o último reinício do mecanismo do Neptune.

runningQueryCount

O número de consultas SPARQL em execução atualmente.

queries

Uma lista de consultas SPARQL atuais.

queryId

Um ID de GUID da consulta. O Neptune atribui automaticamente esse valor de ID a cada consulta, ou você também pode atribuir seu próprio ID (consulte Injetar um ID personalizado em uma consulta do Gremlin ou do SPARQL no Neptune).

queryEvalStats

Estatísticas dessa consulta.

subconsultas

Número de subconsultas nesta consulta.

elapsed

O número de milissegundos em que a consulta esteve em execução até agora.

cancelado

Verdadeiro indica que a consulta foi cancelada.

queryString

A consulta enviada.

Exemplo de status de consulta do SPARQL

A seguir está um exemplo de comando de status usando curl e HTTP GET.

curl https://your-neptune-endpoint:port/sparql/status

Essa saída mostra uma única consulta em execução.

{
    "acceptedQueryCount":9,
    "runningQueryCount":1,
    "queries": [
        {
            "queryId":"fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
            "queryEvalStats":
                {
                    "subqueries": 0,
                    "elapsed": 29256,
                    "cancelled": false
                },
            "queryString": "SELECT ?s ?p ?o WHERE {?s ?p ?o}"
        }
    ]
}