Herstellen einer Verbindung mit einer Neptune-DB-Instance über den HTTPS-REST-Endpunkt - Amazon Neptune

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Herstellen einer Verbindung mit einer Neptune-DB-Instance über den HTTPS-REST-Endpunkt

Amazon Neptune stellt einen HTTPS-Endpunkt für Gremlin-Abfragen bereit. Die REST-Schnittstelle ist mit jeder Gremlin-Version kompatibel, die Ihr DB-Cluster verwendet. (Auf der Seite Engine-Version der von Ihnen ausgeführten Engine-Version finden Sie Informationen zur unterstützten Gremlin-Version.)

Anmerkung

Wie in Verschlüsselung während der Übertragung: Herstellen von Verbindungen mit Neptune über SSL/HTTPS beschrieben, erforrdert Neptune jetzt, dass Sie die Verbindung über HTTPS und nicht über HTTP herstellen.

Die folgenden Anweisungen führen Sie durch das Herstellen einer Verbindung zum Gremlin-Endpunkt mittels des curl-Befehls und HTTPS. Sie müssen diese Anweisungen für eine Amazon-EC2-Instance befolgen, die sich in derselben Virtual Private Cloud (VPC) wie Ihre Neptune-DB-Instance befindet.

Der HTTPS-Endpunkt für Gremlin-Abfragen an eine Neptune-DB-Instance ist https://your-neptune-endpoint:port/gremlin.

Anmerkung

Informationen zum Ermitteln des Hostnamens Ihrer Neptune-DB-Instance finden Sie in Verbinden mit Amazo-Neptune-Endpunkten.

Herstellen einer Verbindung mit Neptune über den HTTP-REST-Endpunkt

Im folgenden Beispiel wird curl zum Übermitteln einer Gremlin-Abfrage über HTTP POST verwendet. Die Abfrage wird im JSON-Format im Text des Posts als gremlin-Eigenschaft übermittelt.

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

Dieses Beispiel gibt den ersten Eckpunkt im Diagramm über die g.V().limit(1)-Traversierung zurück. Um etwas anderes abzufragen, ersetzen Sie diese durch eine andere Gremlin-Traversierung.

Wichtig

Der REST-Endpunkt gibt standardmäßig alle Ergebnisse in einem einzelnen JSON-Ergebnissatz zurück. Wenn dieser Ergebnissatz zu groß ist, kann eine OutOfMemoryError-Ausnahme für die Neptune-DB-Instance auftreten.

Sie können dies vermeiden, indem Sie die Aufteilung von Antworten aktivieren (Rückgabe der Ergebnisse in mehreren getrennten Antworten). Siehe Verwenden optionaler nachgestellter HTTP-Header zum Aktivieren mehrteiliger Gremlin-Antworten.

Auch wenn zum Senden von Gremlin-Abfragen HTTP-POST-Anforderungen empfohlen werden, können Sie auch HTTP-GET-Anforderungen verwenden:

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

Neptune unterstützt die Eigenschaft bindings nicht.