Amazon Neptune 엔진 버전 1.0.4.2.R2(2021년 6월 1일) - Amazon Neptune

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

Amazon Neptune 엔진 버전 1.0.4.2.R2(2021년 6월 1일)

2021년 6월 1일부터 엔진 버전 1.0.4.2.R2가 일반적으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.

이 릴리스의 후속 패치 릴리스

이번 엔진 릴리스에서 알려진 문제

문제:

공백이 있는 경우 Accept 헤더의 미디어 유형을 준수하지 못하는 SPARQL 버그가 있습니다.

예를 들어 -H "Accept: text/csv; q=1.0, */*; q=0.1" 가 포함된 쿼리는 CSV 출력이 아닌 JSON 출력을 반환합니다.

해결 방법:

헤더의 Accept 절에서 공백을 제거하면 엔진이 요청된 올바른 형식으로 출력을 반환합니다. 즉, -H "Accept: text/csv; q=1.0, */*; q=0.1" 대신 다음을 사용합니다.

-H "Accept: text/csv;q=1.0,*/*;q=0.1"

이 엔진 릴리스의 새로운 기능

  • 새로운 R5d 인스턴스 유형이 추가되었으며, 여기에는 대량의 속성 값 또는 RDF 리터럴 조회와 관련된 사용 사례에서 읽기 속도를 높이기 위한 조회 캐시가 포함되어 있습니다. 읽기 쿼리를 가속화할 수 있는 Neptune 조회 캐시의 내용을 참조하세요.

  • 새로운 lab-mode 파라미터가 추가되었으며, 이를 통해 실험용 DFE 엔진을 useDFE 쿼리 힌트와 함께 쿼리별로만 호출할 수 있습니다.

이 엔진 릴리스의 개선 사항

  • TinkerPop 3.4.10에 대한 지원이 추가되었습니다.

  • Gremlin 스크립트 요청을 보낼 때 withStrategies( ) 구성 단계를 사용하기 위한 지원이 추가되었습니다. 특히 SubgraphStrategy, PartitionStrategy, ReadOnlyStrategy, EdgeLabelVerificationStrategy, ReservedKeysVerificationStrategy가 모두 지원됩니다.

  • 쿼리 도중의 V() 순회 최적화가 추가되었습니다. 이전에는 Neptune에서 이러한 순회가 최적화되지 않았습니다.

  • RFC 2141 URN을 대량 로드의 baseUrinamedGraphUri 파라미터로 사용할 수 있도록 지원이 추가되었습니다.

이 엔진 릴리스에서 수정된 결함

  • 구문 분석기에서 잘못된 쿼리가 유효한 것으로 처리되는 Gremlin 버그가 수정되었습니다.

  • cap().unfold()aggregate() 부작용을 펼치면 valueMap()에서 예외가 발생하는 Gremlin 버그가 수정되었습니다.

  • addV() 단계 후 일부 property() 단계에서 ‘cannot cast to String’ 오류와 함께 실패가 발생하는 Gremlin 버그가 수정되었습니다.

  • 일부 조건부 삽입 패턴에서 동시 수정 예외가 발생하지 않도록 Gremlin 버그가 수정되었습니다.

  • 이제 쿼리 요청 제한 시간이 세션 제한 시간을 초과할 수 없도록 Gremlin 버그가 수정되었습니다.

  • 원격 서버를 사용할 수 없을 때 LOAD 또는 UNLOAD를 사용한 업데이트가 HTTP 코드 400이 아닌 HTTP 코드 500으로 인해 실패가 발생하는 것을 방지하고자 SPARQL 버그가 수정되었습니다.

  • commitNum 또는 32비트 부호 있는 정수 제한(2,147,483,647)보다 큰 opNum 값을 사용했을 때 스트림 API 호출 실패가 발생하는 버그가 수정되었습니다.

이 릴리스에서 지원되는 쿼리 언어 버전

DB 클러스터를 버전 1.0.4.2.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.

  • Gremlin 버전: 3.4.10

  • SPARQL 버전: 1.1

엔진 릴리스 1.0.4.2.R2에 대한 업그레이드 경로

이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.

이 릴리스로 자동으로 업그레이드하지 않습니다.

이 릴리스로 업그레이드

Amazon Neptune 1.0.4.2.R2를 이제 정식 버전으로 사용할 수 있습니다.

DB 클러스터가 이 릴리스에 대한 업그레이드 경로가 있는 엔진 버전을 실행하는 경우 지금 업그레이드할 수 있습니다. 콘솔에서 DB 클러스터 작업을 사용하여 또는 SDK를 사용하여 적격 클러스터를 업그레이드할 수 있습니다. 다음 CLI 명령은 적격 클러스터를 즉시 업그레이드합니다.

Linux, OS X, Unix의 경우:

aws neptune modify-db-cluster \ --db-cluster-identifier (your-neptune-cluster) \ --engine-version 1.0.4.2 \ --apply-immediately

Windows의 경우

aws neptune modify-db-cluster ^ --db-cluster-identifier (your-neptune-cluster) ^ --engine-version 1.0.4.2 ^ --apply-immediately

업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 해당 인스턴스에서 데이터베이스를 다시 시작해야 하므로 가동 중지가 20~30초에서 수분까지 발생할 수 있으며, 이후 DB 클러스터 사용을 재개할 수 있습니다.

업그레이드하기 전에 항상 테스트 수행

새로운 메이저 또는 마이너 Neptune 엔진 버전이 릴리스되면 업그레이드하기 전에 먼저 해당 버전에서 항상 Neptune 애플리케이션을 테스트하세요. 마이너 업그레이드이더라도 코드에 영향을 줄 수 있는 새로운 기능이나 동작이 도입될 수 있습니다.

먼저 현재 버전의 릴리스 노트 페이지를 대상 버전의 릴리스 노트 페이지와 비교하여 쿼리 언어 버전에 변경 사항이나 기타 주요 변경 사항이 있는지 확인합니다.

프로덕션 DB 클러스터를 업그레이드하기 전에 새 버전을 테스트하는 가장 좋은 방법은 프로덕션 클러스터를 복제하여 새 엔진 버전을 실행하도록 하는 것입니다. 이렇게 하면 프로덕션 DB 클러스터에 영향을 주지 않고 복제본에서 쿼리를 실행할 수 있습니다.

업그레이드하기 전에 항상 수동 스냅샷 생성

업그레이드하기 전에 항상 DB 클러스터의 수동 스냅샷을 생성하는 것이 좋습니다. 자동 스냅샷은 단기적인 보호 기능만 제공하는 반면, 수동 스냅샷은 명시적으로 삭제하기 전까지는 계속 사용할 수 있습니다.

경우에 따라 Neptune은 업그레이드 프로세스의 일부로 수동 스냅샷을 생성하지만, 여기에 의존해서는 안 되며 항상 자체 수동 스냅샷을 만들어야 합니다.

DB 클러스터를 업그레이드 전 상태로 되돌릴 필요가 없다고 판단되면 직접 만든 수동 스냅샷과 Neptune이 생성한 수동 스냅샷(있는 경우)을 명시적으로 삭제할 수 있습니다. Neptune이 수동 스냅샷을 생성하는 경우 이름은 preupgrade로 시작하고 DB 클러스터 이름, 소스 엔진 버전, 대상 엔진 버전, 날짜가 차례로 뒤따릅니다.

참고

보류 중인 작업이 진행 중인 동안 업그레이드를 시도하면 다음과 같은 오류가 발생할 수 있습니다.

We're sorry, your request to modify DB cluster (cluster identifier) has failed. Cannot modify engine version because instance (instance identifier) is running on an old configuration. Apply any pending maintenance actions on the instance before proceeding with the upgrade.

이 오류가 발생하면 보류 중인 작업이 완료될 때까지 기다리거나, 유지 관리 기간을 즉시 실행하여 이전의 업그레이드를 완료합니다.

엔진 버전 업그레이드에 대한 자세한 내용은 Amazon Neptune DB 클러스터 유지 관리 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 AWS Premium Support를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.