Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Le point de terminaison Amazon Neptune openCypher HTTPS

openCypher lire et écrire des requêtes sur le HTTPS point de terminaison

Le openCypher HTTPS point de terminaison prend en charge les requêtes de lecture et de mise à jour en utilisant à la fois la POST méthode GET et. Les méthodes DELETE et PUT ne sont pas prises en charge.

Les instructions suivantes vous indiquent comment vous connecter au point de openCypher terminaison à l'aide de la curl commande etHTTPS. Vous devez suivre ces instructions depuis une EC2 instance Amazon située dans le même cloud privé virtuel (VPC) que votre instance de base de données Neptune.

La syntaxe est la suivante :

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

Voici des exemples de requêtes de lecture, l'une avec POST et l'autre avec GET :

1. En utilisant POST :

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

2. En utilisant GET (la chaîne de requête est URL codée) :

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

Voici des exemples de requêtes d'écriture ou de mise à jour, l'une avec POST et l'autre avec GET :

1. En utilisant POST :

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

2. En utilisant GET (la chaîne de requête est URL codée) :

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

Le format de openCypher JSON résultats par défaut

Le JSON format suivant est renvoyé par défaut, ou en définissant explicitement l'en-tête de la demande surAccept: application/json. Ce format est conçu pour être facilement analysé en objets à l'aide des fonctionnalités du langage natif de la plupart des bibliothèques.

Le JSON document renvoyé contient un champ qui contient les results valeurs renvoyées par la requête. Les exemples ci-dessous montrent le JSON formatage des valeurs courantes.

Exemple de réponse pour une valeur :

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

Exemple de réponse pour un nœud :

{
  "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
        }
      }
    }
  ]
}

Exemple de réponse pour une relation :

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

Exemple de réponse pour un chemin :

{
  "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
          }
        }
      ]
    }
  ]
}