Usar o endpoint REST HTTP para conectar-se a uma instância de banco de dados do Neptune - Amazon Neptune

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 endpoint REST HTTP para conectar-se a uma instância de banco de dados do Neptune

nota

Atualmente, o Neptune não oferece suporte a HTTP/2 para solicitações da API REST. Os clientes devem usar HTTP/1.1 ao se conectar aos endpoints.

As instruções a seguir explicam como conectar-se ao endpoint do SPARQL usando o comando curl e conectando-se por meio de HTTPS e usando a sintaxe HTTP. Siga estas instruções em uma instância do Amazon EC2 na mesma nuvem privada virtual (VPC) que a instância de banco de dados do Neptune.

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

nota

Para obter informações sobre como localizar o nome do host da instância de banco de dados do Neptune, consulte a seção Conectar-se a endpoints do Amazon Neptune.

O Amazon Neptune fornece um endpoint HTTP para consultas do SPARQL. A interface REST é compatível com o SPARQL versão 1.1.

CONSULTA usando HTTP POST

O exemplo a seguir usa o curl para enviar uma QUERY do SPARQL por meio do HTTP POST.

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 de mídia MIME padrão de uma resposta é application/sparql-results+json para consultas SELECT e ASK.

O tipo MIME padrão de uma resposta é application/n-quads para CONSTRUCT e consultas DESCRIBE.

Para obter uma lista dos tipos de mídia usados pelo Neptune para serialização, consulte Formatos de serialização do RDF usados pelo SPARQL no Neptune.

UPDATE usando HTTP POST

O exemplo a seguir usa o curl para enviar uma UPDATE do SPARQL por meio do HTTP POST.

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>