Uso del punto de conexión HTTP REST para conectarse a una instancia de base de datos de Neptune

Amazon Neptune proporciona un punto de conexión HTTP para las consultas de Gremlin. La interfaz REST es compatible con cualquier versión de Gremlin que utilice su clúster de base de datos (consulte la página de versiones del motor de Neptune que esté utilizando para determinar qué versión de Gremlin admite).

nota

Como se explica en Cifrado en tránsito: conexión con Neptune mediante SSL/HTTPS, Neptune ahora requiere que se conecte mediante HTTPS en lugar de HTTP.

Las siguientes instrucciones le ayudarán a conectar con el punto de enlace de Gremlin mediante el comando curl y HTTPS. Siga estas instrucciones desde una instancia de Amazon EC2 que esté en la misma nube privada virtual (VPC) que su instancia de base de datos de Neptune.

El punto de conexión HTTPS para las consultas de Gremlin a una instancia de base de datos de Neptune es https://your-neptune-endpoint:port/gremlin.

nota

Para obtener información acerca de cómo encontrar el nombre de host de la instancia de base de datos de Neptune, consulte Conexión a los puntos de conexión de Amazon Neptune.

Para conectarse a Neptune mediante el punto de conexión HTTP REST

En el siguiente ejemplo se utiliza curl para enviar una consulta de Gremlin a través de HTTP POST. La consulta se envía en formato JSON en el cuerpo de la publicación como propiedad gremlin.

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

Este ejemplo devuelve el primer vértice del gráfico utilizando el recorrido g.V().limit(1). Puede consultar otra cosa sustituyéndolo por otro recorrido de Gremlin.

importante

De manera predeterminada, el punto de conexión REST devuelve todos los resultados en un único conjunto de resultados JSON. Si este conjunto de resultados es demasiado grande, se puede producir una excepción OutOfMemoryError en la instancia de base de datos de Neptune.

Para evitarlo, habilite las respuestas fragmentadas (los resultados se devuelven en una serie de respuestas independientes). Consulte Use encabezados finales HTTP opcionales para habilitar las respuestas de Gremlin compuestas por varias partes.

Aunque se recomiendan las solicitudes HTTP POST para enviar consultas de Gremlin, también es posible utilizar solicitudes HTTP GET:

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

nota

Neptune no admite la propiedad bindings.