Amazon Neptune 엔진 버전 1.0.3.0(2020년 8월 3일) - Amazon Neptune
패치 릴리스새로운 기능개선 사항수정된 결함지원되는 쿼리 언어 버전업그레이드 경로Upgrading

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

Amazon Neptune 엔진 버전 1.0.3.0(2020년 8월 3일)

2020년 8월 3일부터 엔진 버전 1.0.3.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.

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

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

  • Neptune에 쿼리 실행 속도를 크게 높일 수 있는 새로운 대체 쿼리 엔진(DFE)이 도입되었습니다. Amazon Neptune 대체 쿼리 엔진(DFE)를 참조하세요.

  • DFE는 새로운 통계 엔드포인트를 통해 관리되는 Neptune 그래프 데이터에 대해 사전 생성된 통계를 사용합니다. DFE 통계를 참조하세요.

  • 이제 새 includeQueuedLoads 파라미터를 FALSE로 설정하여 로더 Get-Status API에서 반환한 로드 ID 목록에서 대기 중인 로드 작업을 제외할 수 있습니다. Neptune 로더 Get-Status 요청 파라미터를 참조하세요.

  • Neptune은 이제 SPARQL 쿼리 응답의 후행 헤더를 지원합니다. 이 헤더에는 응답 청크를 반환하기 시작한 후 요청이 실패할 경우 오류 코드와 메시지가 포함될 수 있습니다. 멀티파트 SPARQL 응답을 위한 선택적 HTTP 후행 헤더를 참조하세요.

  • 또한 이제 Neptune에서는 Gremlin 쿼리에 청크 응답 인코딩을 사용할 수 있습니다. SPARQL의 경우와 마찬가지로 응답 청크에는 쿼리가 응답 청크를 반환하기 시작한 후 오류가 발생할 경우 오류 코드와 메시지를 포함할 수 있는 후행 헤더가 있습니다. 선택적 HTTP 후행 헤더를 사용하여 여러 부분으로 구성된 Gremlin 응답 활성화를 참조하세요.

이 엔진 릴리스의 개선 사항

  • 이제 Gremlin에서 전체 텍스트 검색을 위해 ElasticSearch에 대량 요청 크기를 제공할 수 있습니다.

  • SPARQL GROUP BY 쿼리의 메모리 사용량이 개선되었습니다.

  • 특정 언바운드 필터를 정리하는 새로운 Gremlin 쿼리 최적화 프로그램이 추가되었습니다.

  • IAM을 사용하여 인증된 WebSocket 연결이 열린 상태로 유지될 수 있는 최대 시간을 36시간에서 10일로 늘렸습니다.

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

  • POST 요청에서 인코딩되지 않은 URL 파라미터를 보낸 경우 Neptune이 HTTP 상태 코드 500과 InternalServerErrorException을 반환하는 버그가 수정되었습니다. 이제 Neptune은 400 및 BadRequestException의 HTTP 상태 코드와 Failure to process the POST request parameters 메시지를 반환합니다.

  • WebSocket 연결 결함이 올바르게 보고되지 않던 Gremlin 버그가 수정되었습니다.

  • sideEffects가 사라지는 것과 관련된 Gremlin 버그가 수정되었습니다.

  • 전체 텍스트 검색 batchsize 파라미터가 제대로 지원되지 않던 Gremlin 버그가 수정되었습니다.

  • bothE 방향별로 toV 및 fromV가 개별적으로 처리되도록 Gremlin 버그가 수정되었습니다.

  • hasLabel 단계에서 Edge pathType과 관련된 Gremlin 버그가 수정되었습니다.

  • 정적 바인딩을 사용한 조인 순서 변경이 제대로 작동하지 않는 SPARQL 버그가 수정되었습니다.

  • 사용할 수 없는 Amazon S3 버킷이 올바르게 보고되지 않는 SPARQL 업데이트 로드 버그가 수정되었습니다.

  • 하위 쿼리의 SERVICE 노드 문제가 올바르게 보고되지 않는 SPARQL 버그가 수정되었습니다.

  • 중첩된 FILTER EXISTS 또는 FILTER NOT EXISTS 조건을 포함하는 쿼리가 적절하게 평가되지 않는 SPARQL 버그가 수정되었습니다.

  • 쿼리 생성을 통해 SPARQL 서비스 엔드포인트를 호출할 때 중복으로 생성된 바인딩을 올바르게 처리하도록 SPARQL 버그가 수정되었습니다.

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

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

  • Gremlin 버전: 3.4.3

  • SPARQL 버전: 1.1

엔진 릴리스 1.0.3.0에 대한 업그레이드 경로

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

클러스터의 AutoMinorVersionUpgrade 파라미터가 True로 설정되어 있으면 유지 관리 기간 동안 이 릴리스 날짜로부터 2~3주 후에 클러스터가 자동으로 이 엔진 릴리스로 업그레이드 됩니다.

이 릴리스로 업그레이드

Amazon Neptune 1.0.3.0을 이제 정식 버전으로 사용할 수 있습니다.

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

Linux, OS X, Unix의 경우:

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

Windows의 경우

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.0.3.0 ^
    --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 팀에 도움을 요청할 수 있습니다.