Utilizzo dell'endpoint HTTPS REST per connettersi a un'istanza database Neptune

Amazon Neptune fornisce un endpoint HTTPS per le query Gremlin. L'interfaccia REST è compatibile con qualsiasi versione di Gremlin utilizzata dal cluster database (consulta la pagina di rilascio del motore della versione del motore Neptune che stai utilizzando per determinare quale rilascio di Gremlin supporta).

Nota

Come illustrato in Crittografia in transito: connessione a Neptune utilizzando il protocollo SSL/HTTPS, Neptune ora richiede la connessione tramite HTTPS anziché HTTP.

Le istruzioni seguenti mostrano come connettersi a un endpoint di Gremlin utilizzando il comando curl e HTTPS. Segui queste istruzioni da un'istanza Amazon EC2 nello stesso cloud privato virtuale (VPC) dell'istanza database Neptune.

L'endpoint HTTPS per le query Gremlin in un'istanza database Neptune è https://your-neptune-endpoint:port/gremlin.

Nota

Per informazioni su come trovare il nome host dell'istanza database Neptune, consulta Connessione agli endpoint Amazon Neptune.

Per connettersi a Neptune utilizzando l'endpoint HTTP REST

L'esempio seguente utilizza curl per inviare una query Gremlin tramite HTTP POST. La query viene inviata in formato JSON nel corpo del post come proprietà gremlin.

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

Questo esempio restituisce il primo vertice nel grafo utilizzando l'attraversamento g.V().limit(1). Per eseguire una query su qualcos'altro, sostituirlo con un altro attraversamento Gremlin.

Importante

Per impostazione predefinita, l'endpoint REST restituisce tutti i risultati in un unico insieme di risultati JSON. Se questo insieme di risultati è troppo grande, può verificarsi un'eccezione OutOfMemoryError sull'istanza database Neptune.

È possibile evitare tale problema abilitando le risposte in blocchi (risultati restituiti in una serie di risposte separate). Per informazioni, consulta Utilizzo di intestazioni HTTP finali opzionali per abilitare le risposte Gremlin in più parti.

Sebbene le richieste HTTP POST siano consigliate per l'invio di query Gremlin, è possibile utilizzare anche le richieste HTTP GET:

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

Nota

Neptune non supporta la proprietà bindings.