Der Amazon Neptune Neptun-Endpunkt openCypher HTTPS

openCypher Abfragen auf dem HTTPS Endpunkt lesen und schreiben

Der openCypher HTTPS Endpunkt unterstützt Lese- und Aktualisierungsabfragen, die GET sowohl die als auch die POST Methode verwenden. Die Methoden DELETE und PUT werden nicht unterstützt.

Die folgenden Anweisungen zeigen Ihnen, wie Sie mithilfe des curl Befehls und eine Verbindung zum openCypher Endpunkt herstellenHTTPS. Sie müssen diesen Anweisungen von einer EC2 Amazon-Instance aus folgen, die sich in derselben Virtual Private Cloud (VPC) wie Ihre Neptune-DB-Instance befindet.

Die Syntax lautet wie folgt:

HTTPS://(the server):(the port number)/openCypher

Dies sind Beispiele für Leseabfragen. Eine Abfrage verwendet POST und eine Abfrage verwendet GET:

1. Verwenden von POST:

curl HTTPS://server:port/openCypher \
  -d "query=MATCH (n1) RETURN n1;"

2. Verwenden GET (die Abfragezeichenfolge ist URL -codiert):

curl -X GET \
  "HTTPS://server:port/openCypher?query=MATCH%20(n1)%20RETURN%20n1"

Dies sind Beispiele für Schreib-/Aktualisierungsabfragen. Eine Abfrage verwendet POST und eine Abfrage verwendet GET:

1. Verwenden von POST:

curl HTTPS://server:port/openCypher \
  -d "query=CREATE (n:Person { age: 25 })"

2. Verwenden von GET (die Abfragezeichenfolge ist URL -kodiert):

curl -X GET \
  "HTTPS://server:port/openCypher?query=CREATE%20(n%3APerson%20%7B%20age%3A%2025%20%7D)"

Das Standardergebnisformat openCypher JSON

Das folgende JSON Format wird standardmäßig zurückgegeben oder indem der Anforderungsheader explizit auf festgelegt wirdAccept: application/json. Dieses Format soll mithilfe nativer Features der meisten Bibliotheken leicht in Objekte geparst werden können.

Das zurückgegebene JSON Dokument enthält ein Feldresults, das die Rückgabewerte der Abfrage enthält. Die folgenden Beispiele zeigen die JSON Formatierung für allgemeine Werte.

Beispiel für eine Wertantwort:

{
  "results": [
    {
      "count(a)": 121
    }
  ]
}

Beispiel für eine Knotenantwort:

{
  "results": [
    {
      "a": {
        "~id": "22",
        "~entityType": "node",
        "~labels": [
          "airport"
        ],
        "~properties": {
          "desc": "Seattle-Tacoma",
          "lon": -122.30899810791,
          "runways": 3,
          "type": "airport",
          "country": "US",
          "region": "US-WA",
          "lat": 47.4490013122559,
          "elev": 432,
          "city": "Seattle",
          "icao": "KSEA",
          "code": "SEA",
          "longest": 11901
        }
      }
    }
  ]
}

Beispiel für eine Beziehungsantwort:

{
  "results": [
    {
      "r": {
        "~id": "7389",
        "~entityType": "relationship",
        "~start": "22",
        "~end": "151",
        "~type": "route",
        "~properties": {
          "dist": 956
        }
      }
    }
  ]
}

Beispiel für eine Pfadantwort:

{
  "results": [
    {
      "p": [
        {
          "~id": "22",
          "~entityType": "node",
          "~labels": [
            "airport"
          ],
          "~properties": {
            "desc": "Seattle-Tacoma",
            "lon": -122.30899810791,
            "runways": 3,
            "type": "airport",
            "country": "US",
            "region": "US-WA",
            "lat": 47.4490013122559,
            "elev": 432,
            "city": "Seattle",
            "icao": "KSEA",
            "code": "SEA",
            "longest": 11901
          }
        },
        {
          "~id": "7389",
          "~entityType": "relationship",
          "~start": "22",
          "~end": "151",
          "~type": "route",
          "~properties": {
            "dist": 956
          }
        },
        {
          "~id": "151",
          "~entityType": "node",
          "~labels": [
            "airport"
          ],
          "~properties": {
            "desc": "Ontario International Airport",
            "lon": -117.600997924805,
            "runways": 2,
            "type": "airport",
            "country": "US",
            "region": "US-CA",
            "lat": 34.0559997558594,
            "elev": 944,
            "city": "Ontario",
            "icao": "KONT",
            "code": "ONT",
            "longest": 12198
          }
        }
      ]
    }
  ]
}