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

O Amazon Neptune fornece um endpoint HTTP para consultas do Gremlin. A interface REST é compatível com qualquer versão do Gremlin que o cluster de banco de dados esteja usando (consulte a página de versão do mecanismo da versão do mecanismo do Neptune que você está executando para determinar qual versão do Gremlin é compatível).

nota

Conforme abordado em Criptografia em trânsito: estabelecer conexão com o Neptune Using SSL/HTTPS usando SSL/HTTPS, o Neptune agora exige que você se conecte usando HTTPS em vez de HTTP.

As instruções a seguir explicam como conectar-se ao endpoint do Gremlin usando o comando curl e HTTPS. Você deve seguir 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 Gremlin para uma instância de banco de dados do Neptune é https://your-neptune-endpoint:port/gremlin.

nota

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

Como conectar-se ao Neptune usando o endpoint REST HTTP

O exemplo a seguir usa o curl para enviar uma consulta do Gremlin por meio de HTTP POST. A consulta é enviada no formato JSON no corpo da postagem como a propriedade gremlin.

curl -X POST -d '{"gremlin":"g.V().limit(1)"}' https://your-neptune-endpoint:port/gremlin

Este exemplo exibe o primeiro vértice do grafo usando o percurso g.V().limit(1). É possível consultar outro elemento substituindo-o por outro percurso do Gremlin.

Importante

Por padrão, o endpoint REST exibe todos os resultados em um único conjunto de resultados JSON. Se esse conjunto de resultados for grande demais, uma exceção OutOfMemoryError poderá ocorrer na instância de banco de dados do Neptune.

É possível evitar isso habilitando respostas fragmentadas (resultados gerados em uma série de respostas separadas). Consulte Usar cabeçalhos finais HTTP opcionais para habilitar respostas do Gremlin em várias partes.

Embora as solicitações HTTP POST sejam recomendadas para enviar consultas do Gremlin, também é possível usar solicitações HTTP GET:

curl -G "https://your-neptune-endpoint:port?gremlin=g.V().count()"

nota

O Neptune não é compatível com a propriedade bindings.