기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Neptune openCypher HTTPS Word엔드포인트

openCypher 엔드포인트에서 HTTPS 읽기 및 쓰기 쿼리

openCypher HTTPS Word엔드포인트는 GET 및 POST 메서드를 모두 사용하여 읽기 및 업데이트 쿼리를 지원합니다. DELETE 및 PUT 메서드는 지원되지 않습니다.

다음 지침은 curl 명령과 HTTPS를 사용하여 openCypher 엔드포인트에 연결하는 방법을 안내합니다. Neptune DB 인스턴스와 동일한 Virtual Private Cloud(VPC)의 Amazon EC2 인스턴스에서 다음 지침을 따라야 합니다.

구문은 다음과 같습니다.

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

다음은 POST를 사용하는 샘플 읽기 쿼리와 GET을 사용하는 샘플 읽기 쿼리입니다.

1. POST 사용:

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

2. 사용GET(쿼리 문자열은 URL로 인코딩됨):

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

다음은 POST를 사용하는 샘플 쓰기/업데이트 쿼리와 GET을 사용하는 샘플 쓰기/업데이트 쿼리입니다.

1. POST 사용:

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

2. 사용GET(쿼리 문자열은 URL로 인코딩됨):

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

default openCypher JSON Word결과 형식

다음 JSON 형식은 기본적으로 반환되거나 요청 헤더를 로 명시적으로 설정하여 반환됩니다Accept: application/json. 이 형식은 대다수 라이브러리의 모국어 기능을 사용하여 객체로 쉽게 구문 분석할 수 있도록 설계되었습니다.

반환되는 JSON 문서에는 쿼리 반환 값이 results포함된 필드 1개가 포함되어 있습니다. 아래 예제는 공통 값에 대한 JSON 형식을 보여줍니다.

값 응답 예제:

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

노드 응답 예제:

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

관계 응답 예제:

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

경로 응답 예제:

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