

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á.

# Usar o SPARQL para acessar os dados de grafo no Amazon Neptune
<a name="get-started-graph-sparql"></a>

O SPARQL é uma linguagem de consulta para o Resource Description Framework (RDF), que é um formato de dados de grafos projetado para a web. O Amazon Neptune é compatível com o SPARQL 1.1. Isso significa que você pode se conectar a uma instância de banco de dados do Neptune e consultar o grafo usando a linguagem de consulta descrita na especificação [SPARQL 1.1 Query Language](https://www.w3.org/TR/sparql11-query/).

 Uma consulta no SPARQL consiste em uma cláusula `SELECT` para especificar as variáveis a serem retornadas e uma cláusula `WHERE` para especificar quais dados corresponder no gráfico. Se não estiver familiarizado com as consultas do SPARQL, consulte [Writing Simple Queries](https://www.w3.org/TR/sparql11-query/#WritingSimpleQueries) no [SPARQL 1.1 Query Language](https://www.w3.org/TR/sparql11-query/). 

O endpoint HTTP para consultas do SPARQL a uma instância de banco de dados do Neptune é `https://your-neptune-endpoint:port/sparql`.

**Para se conectar ao SPARQL**

1. **Você pode obter o endpoint SPARQL para seu cluster Neptune a partir do **SparqlEndpoint**item na seção Saídas da pilha.** CloudFormation 

1. Digite o seguinte para enviar um SPARQL **`UPDATE`** usando HTTP `POST` e o comando **curl**.

   ```
   curl -X POST --data-binary 'update=INSERT DATA { <https://test.com/s> <https://test.com/p> <https://test.com/o> . }' https://your-neptune-endpoint:port/sparql
   ```

   O exemplo anterior insere o seguinte triplo no gráfico padrão do SPARQL: `<https://test.com/s> <https://test.com/p> <https://test.com/o>`

1. Digite o seguinte para enviar um SPARQL **`QUERY`** usando HTTP `POST` e o comando **curl**.

   ```
   curl -X POST --data-binary 'query=select ?s ?p ?o where {?s ?p ?o} limit 10' https://your-neptune-endpoint:port/sparql
   ```

   O exemplo anterior retorna até 10 dos triples (subject-predicate-object) no gráfico usando a `?s ?p ?o` consulta com um limite de 10. Para consultar outro elemento, substitua-a por outra consulta do SPARQL.
**nota**  
O tipo MIME padrão de uma resposta é `application/sparql-results+json` para `SELECT` e consultas `ASK`.  
O tipo MIME padrão de uma resposta é `application/n-quads` para `CONSTRUCT` e consultas `DESCRIBE`.  
Para obter uma lista de todos os tipos MIME disponíveis, consulte [API HTTP do SPARQL](sparql-api-reference.md).