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

Amazon Neptune openCypher HTTPS 엔드포인트

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

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

다음 지침은 및 curl 명령을 사용하여 openCypher 엔드포인트에 연결하는 방법을 안내합니다HTTPS. Neptune DB EC2 인스턴스와 동일한 가상 프라이빗 클라우드(VPC)의 Amazon 인스턴스에서 다음 지침을 따라야 합니다.

구문은 다음과 같습니다.

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)"

기본 openCypher JSON 결과 형식

다음 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
          }
        }
      ]
    }
  ]
}