기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
HTTP GET 요청을 다음과 같은 로컬 엔드포인트 중 하나에 전송하는 REST API를 사용하여 Neptune 스트림에 액세스합니다.
SPARQL 그래프 DB의 경우:
https://.Neptune-DNS:8182/sparql/streamGremlin 또는 openCypher 그래프 DB의 경우:
https://또는Neptune-DNS:8182/propertygraph/streamhttps://.Neptune-DNS:8182/pg/stream
참고
엔진 릴리스 1.1.0.0부터 Gremlin 스트림 엔드포인트(https://)와 관련 출력 형식(Neptune-DNS:8182/gremlin/streamGREMLIN_JSON)은 더 이상 사용되지 않습니다. 이전 버전과의 호환성을 위해 계속 지원되고 있지만, 향후 릴리스에서 제거될 수 있습니다.
HTTP GET 작업만 허용됩니다.
HTTP 요청에 gzip을 허용된 압축 형식(예: "Accept-Encoding: gzip")으로 지정하는 Accept-Encoding 헤더가 포함된 경우 Neptune은 응답의 gzip 압축을 지원합니다.
파라미터
-
limit– 길이(선택 사항). 범위: 1~100,000. 기본값: 10.반환할 최대 레코드 수를 지정합니다. 수정이 불가능하고
limit파라미터에 지정된 레코드 수보다 우선하는 응답의 경우 10MB로 크기가 제한됩니다. 10MB 제한에 도달하면 이러한 응답에 임곗값 위반 레코드가 포함됩니다. -
iteratorType– 문자열(선택 사항).이 파라미터는 다음 값 중 하나를 가질 수 있습니다.
AT_SEQUENCE_NUMBER(기본) – 읽기가commitNum및opNum파라미터에서 공동으로 지정된 이벤트 시퀀스 번호부터 시작해야 한다는 것을 나타냅니다.AFTER_SEQUENCE_NUMBER– 읽기가commitNum및opNum파라미터에서 공동으로 지정된 이벤트 시퀀스 번호 바로 뒤부터 시작해야 한다는 것을 나타냅니다.TRIM_HORIZON– 읽기가 시스템에서 잘리지 않은 마지막 레코드, 즉 변경-로그 스트림에서 만료되지 않은(아직 삭제되지 않은) 가장 오래된 레코드에서 시작되어야 한다는 것을 나타냅니다. 이 모델은 특정한 시작 이벤트 시퀀스 번호가 없을 때 애플리케이션 시작 단계에서 유용합니다.LATEST– 읽기가 시스템에서 가장 최근 레코드, 즉 변경-로그 스트림에서 만료되지 않은(아직 삭제되지 않은) 최신 레코드에서 시작되어야 한다는 것을 나타냅니다. 이는 재해 복구 또는 제로 다운타임 업그레이드 중과 같이 오래된 레코드를 처리하지 않기 위해 현재 최상위 스트림에서 레코드를 읽어야 하는 경우에 유용합니다. 이 모드에서는 최대 하나의 레코드만 반환된다는 점에 유의하세요.
-
commitNum– 길이로, iteratorType이AT_SEQUENCE_NUMBER또는AFTER_SEQUENCE_NUMBER인 경우 필수입니다.변경-로그 스트림에서 읽어올 시작 레코드의 커밋 수입니다.
iteratorType이TRIM_HORIZON또는LATEST인 경우 이 파라미터는 무시됩니다. -
opNum– 길이로, 선택 사항(기본값은1)입니다.변경-로그 스트림 데이터에서 읽어오기를 시작하기 위해 지정된 커밋 내의 작업 시퀀스 수입니다.
SPARQL 그래프 데이터를 변경하는 작업에서는 일반적으로 작업당 단일 변경 레코드만 생성됩니다. 그러나 다음 예제에서와 같이 Gremlin 그래프 데이터를 변경하는 작업은 작업당 여러 개의 변경 레코드를 생성할 수 있습니다.
INSERT– 하나의 Gremlin 버텍스에는 여러 개의 레이블이 포함될 수 있으며, 하나의 Gremlin 요소에는 여러 개의 속성이 포함될 수 있습니다. 요소가 삽입되면 각 레이블 및 속성에 대해 별도의 변경 레코드가 생성됩니다.UPDATE– Gremlin 요소 속성이 변경되면 2개의 변경 레코드가 생성됩니다. 하나는 이전 값을 제거하기 위한 것이고, 다른 하나는 새 값을 삽입하기 위한 것입니다.-
DELETE– 삭제된 각 요소 속성에 대해 별도의 변경 레코드가 생성됩니다. 예를 들어 속성이 포함된 Gremlin 엣지가 삭제되면 각각의 속성에 대해 하나의 변경 레코드가 생성되고, 그 이후에 엣지 레이블 삭제를 위해 또 하나가 생성됩니다.Gremlin 버텍스가 삭제되면 모든 수신 및 발신 엣지 속성이 먼저 삭제되고, 그 다음으로는 엣지 레이블과 버텍스 속성이, 그리고 마지막으로 버텍스 레이블이 삭제됩니다. 삭제를 할 때마다 변경 레코드가 생성됩니다.
