기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Neptune 엔진 버전 1.0.2.2(2020년 3월 9일) 2020년 3월 9일부터 엔진 버전 1.0.2.2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다. ## 이 릴리스의 후속 패치 릴리스 + [릴리스: 1.0.2.2.R2(2020년 4월 2일)](engine-releases-1.0.2.2.R2.md) + [릴리스: 1.0.2.2.R3(2020년 7월 22일)](engine-releases-1.0.2.2.R3.md) + [릴리스: 1.0.2.2.R4(2020년 7월 23일)](engine-releases-1.0.2.2.R4.md) + [릴리스: 1.0.2.2.R5(2020년 10월 12일)](engine-releases-1.0.2.2.R5.md) + [릴리스: 1.0.2.2.R6(2021년 2월 19일)](engine-releases-1.0.2.2.R6.md) ## 이 엔진 릴리스의 개선 사항 + 롤백되고 있는 트랜잭션에 대한 정보를 상태 API에 추가했습니다. [인스턴스 상태](access-graph-status.md)을(를) 참조하세요. + Apache TinkerPop 버전을 3.4.3으로 업그레이드했습니다. 버전 3.4.3은 Neptune(3.4.1)에서 지원하는 이전 버전과 하위 호환됩니다. 동작에 약간의 변화가 있습니다. 존재하지 않는 세션을 닫으려고 할 때 Gremlin은 더 이상 오류를 반환하지 않습니다([존재하지 않는 세션을 닫을 때 오류 방지](https://issues.apache.org/jira/browse/TINKERPOP-2237) 참조). + Gremlin 전체 텍스트 검색 단계 실행 시 성능 병목 현상을 제거했습니다. ## 이 엔진 릴리스에서 수정된 결함 + 쿼리에서 빈 그래프 패턴을 처리할 때 발생하는 SPARQL 버그를 수정했습니다. + URL 인코딩 쿼리에서 인코딩되지 않은 세미콜론을 처리할 때 발생하는 SPARQL 버그를 수정했습니다. + `Union` 단계에서 반복되는 버텍스를 처리할 때 발생하는 Gremlin 버그를 수정했습니다. + `.simplePath()` 내부의 `.cyclicPath()` 또는 `.repeat()`를 사용한 쿼리가 잘못된 결과를 반환하게 만든 Gremlin 버그를 수정했습니다. + 하위 순회가 해결책을 반환하지 않을 경우 `.project()`에서 잘못된 결과를 반환하게 만든 Gremlin 버그를 수정했습니다. + 읽기-쓰기 충돌에서 비롯된 오류로 인해 `InternalFailureException`이 아닌 `ConcurrentModificationException`이 발생하는 Gremlin 버그를 수정했습니다. + `.group().by(...).by(values("property"))` 실패의 원인이 된 Gremlin 버그를 수정했습니다. + 전체 텍스트 검색 단계의 프로필 출력에 발생한 Gremlin 버그를 수정했습니다. + Gremlin 세션에서 리소스 유출을 수정했습니다. + 경우에 따라 상태 API가 올바른 명령 가능 버전을 보고하지 못하던 버그를 수정했습니다. + Amazon S3 이외의 위치에 대한 URL이 대량 로드 요청에서 소스로 사용되도록 허용한 대량 로더 버그를 수정했습니다. + 자세한 로드 상태의 벌크 로더 버그를 수정했습니다. ## 이 릴리스에서 지원되는 쿼리 언어 버전 DB 클러스터를 버전 1.0.2.2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다. + *Gremlin 버전:* `3.4.3` + *SPARQL 버전:* `1.1` ## 엔진 릴리스 1.0.2.2에 대한 업그레이드 경로 이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다. 클러스터의 `AutoMinorVersionUpgrade` 파라미터가 `True`로 설정되어 있으면 유지 관리 기간 동안 이 릴리스 날짜로부터 2\$13주 후에 클러스터가 자동으로 이 엔진 릴리스로 업그레이드 됩니다. ## 이 릴리스로 업그레이드 Amazon Neptune 1.0.2.2를 이제 정식 버전으로 사용할 수 있습니다. DB 클러스터가 이 릴리스에 대한 업그레이드 경로가 있는 엔진 버전을 실행하는 경우 지금 업그레이드할 수 있습니다. 콘솔에서 DB 클러스터 작업을 사용하여 또는 SDK를 사용하여 적격 클러스터를 업그레이드할 수 있습니다. 다음 CLI 명령은 적격 클러스터를 즉시 업그레이드합니다. Linux, OS X, Unix의 경우: ``` 1. aws neptune modify-db-cluster \ 2. --db-cluster-identifier (your-neptune-cluster) \ 3. --engine-version 1.0.2.2 \ 4. --apply-immediately ``` Windows의 경우: ``` 1. aws neptune modify-db-cluster ^ 2. --db-cluster-identifier (your-neptune-cluster) ^ 3. --engine-version 1.0.2.2 ^ 4. --apply-immediately ``` 업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 해당 인스턴스에서 데이터베이스를 다시 시작해야 하므로 가동 중지가 20\$130초에서 수분까지 발생할 수 있으며, 이후 DB 클러스터 사용을 재개할 수 있습니다. ### 업그레이드하기 전에 항상 테스트 수행 새로운 메이저 또는 마이너 Neptune 엔진 버전이 출시되면 업그레이드하기 전에 해당 버전에서 항상 Neptune 애플리케이션을 먼저 테스트하세요. 마이너 업그레이드라도 코드에 영향을 줄 수 있는 새로운 기능이나 동작이 도입될 수 있습니다. 먼저 현재 버전의 릴리스 노트 페이지를 대상 버전의 릴리스 노트 페이지와 비교하여 쿼리 언어 버전에 변경 사항이나 기타 주요 변경 사항이 있는지 확인합니다. 프로덕션 DB 클러스터를 업그레이드하기 전에 새 버전을 테스트하는 가장 좋은 방법은 프로덕션 클러스터를 복제하여 새 엔진 버전을 실행하도록 하는 것입니다. 그러면 프로덕션 DB 클러스터에 영향을 주지 않고 복제본에서 쿼리를 실행할 수 있습니다. ### 업그레이드하기 전에 항상 수동 스냅샷 생성 업그레이드하기 전에 항상 DB 클러스터의 수동 스냅샷을 생성하는 것이 좋습니다. 자동 스냅샷은 단기적인 보호만 제공하는 반면, 수동 스냅샷은 명시적으로 삭제하기 전까지는 계속 사용할 수 있습니다. 경우에 따라 Neptune은 업그레이드 프로세스의 일부로 수동 스냅샷을 생성하지만, 여기에 의존해서는 안 되며 항상 자체 수동 스냅샷을 만들어야 합니다. DB 클러스터를 업그레이드 전 상태로 되돌릴 필요가 없다고 판단되면 직접 만든 수동 스냅샷과 Neptune이 생성한 수동 스냅샷(있는 경우)을 명시적으로 삭제할 수 있습니다. Neptune이 수동 스냅샷을 생성하는 경우 이름은 `preupgrade`로 시작하고 DB 클러스터 이름, 소스 엔진 버전, 대상 엔진 버전, 날짜가 차례로 뒤따릅니다. **참고** [보류 중인 작업이 진행 중](manage-console-maintaining)인 동안 업그레이드를 시도하면 다음과 같은 오류가 발생할 수 있습니다. ``` 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 클러스터 유지 관리](cluster-maintenance.md) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다. # Amazon Neptune 엔진 버전 1.0.2.2.R6(2021년 2월 19일) 2021년 2월 19일부터 엔진 버전 1.0.2.2.R6이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다. ## 이 엔진 릴리스에서 수정된 결함 + `ConcurrentModificationException`이 발생했을 때 특정 상황에서 응답 코드로 `InternalFailureException`이 설정되었던 Gremlin 버그가 수정되었습니다. + 특정 상황에서 엣지나 버텍스를 업데이트하면 일시적으로 `InternalFailureException`이 발생할 수 있는 Gremlin 버그가 수정되었습니다. ## 이 릴리스에서 지원되는 쿼리 언어 버전 DB 클러스터를 버전 1.0.2.2.R6으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다. + *Gremlin 버전:* `3.4.8` + *SPARQL 버전:* `1.1` ## 엔진 릴리스 1.0.2.2.R6에 대한 업그레이드 경로 엔진 버전 `1.0.2.2`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다. 이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다. ## 이 릴리스로 업그레이드 Amazon Neptune 1.0.2.2.R6을 이제 정식 버전으로 사용할 수 있습니다. DB 클러스터가 이 릴리스에 대한 업그레이드 경로가 있는 엔진 버전을 실행하는 경우 지금 업그레이드할 수 있습니다. 콘솔에서 DB 클러스터 작업을 사용하여 또는 SDK를 사용하여 적격 클러스터를 업그레이드할 수 있습니다. 다음 CLI 명령은 적격 클러스터를 즉시 업그레이드합니다. Linux, OS X, Unix의 경우: ``` 1. aws neptune modify-db-cluster \ 2. --db-cluster-identifier (your-neptune-cluster) \ 3. --engine-version 1.0.2.2 \ 4. --apply-immediately ``` Windows의 경우: ``` 1. aws neptune modify-db-cluster ^ 2. --db-cluster-identifier (your-neptune-cluster) ^ 3. --engine-version 1.0.2.2 ^ 4. --apply-immediately ``` 업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 해당 인스턴스에서 데이터베이스를 다시 시작해야 하므로 가동 중지가 20\$130초에서 수분까지 발생할 수 있으며, 이후 DB 클러스터 사용을 재개할 수 있습니다. ### 업그레이드하기 전에 항상 테스트 수행 새로운 메이저 또는 마이너 Neptune 엔진 버전이 출시되면 업그레이드하기 전에 해당 버전에서 항상 Neptune 애플리케이션을 먼저 테스트하세요. 마이너 업그레이드라도 코드에 영향을 줄 수 있는 새로운 기능이나 동작이 도입될 수 있습니다. 먼저 현재 버전의 릴리스 노트 페이지를 대상 버전의 릴리스 노트 페이지와 비교하여 쿼리 언어 버전에 변경 사항이나 기타 주요 변경 사항이 있는지 확인합니다. 프로덕션 DB 클러스터를 업그레이드하기 전에 새 버전을 테스트하는 가장 좋은 방법은 프로덕션 클러스터를 복제하여 새 엔진 버전을 실행하도록 하는 것입니다. 그러면 프로덕션 DB 클러스터에 영향을 주지 않고 복제본에서 쿼리를 실행할 수 있습니다. ### 업그레이드하기 전에 항상 수동 스냅샷 생성 업그레이드하기 전에 항상 DB 클러스터의 수동 스냅샷을 생성하는 것이 좋습니다. 자동 스냅샷은 단기적인 보호만 제공하는 반면, 수동 스냅샷은 명시적으로 삭제하기 전까지는 계속 사용할 수 있습니다. 경우에 따라 Neptune은 업그레이드 프로세스의 일부로 수동 스냅샷을 생성하지만, 여기에 의존해서는 안 되며 항상 자체 수동 스냅샷을 만들어야 합니다. DB 클러스터를 업그레이드 전 상태로 되돌릴 필요가 없다고 판단되면 직접 만든 수동 스냅샷과 Neptune이 생성한 수동 스냅샷(있는 경우)을 명시적으로 삭제할 수 있습니다. Neptune이 수동 스냅샷을 생성하는 경우 이름은 `preupgrade`로 시작하고 DB 클러스터 이름, 소스 엔진 버전, 대상 엔진 버전, 날짜가 차례로 뒤따릅니다. **참고** [보류 중인 작업이 진행 중](manage-console-maintaining)인 동안 업그레이드를 시도하면 다음과 같은 오류가 발생할 수 있습니다. ``` 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 클러스터 유지 관리](cluster-maintenance.md) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다. # Amazon Neptune 엔진 버전 1.0.2.2.R5(2020년 10월 12일) 2020년 10월 12일부터 엔진 버전 1.0.2.2.R5가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다. ## 이 엔진 릴리스의 개선 사항 + Gremlin `properties()` 단계의 성능이 향상되었습니다. + 설명 및 프로필 보고서에 `BindOp` 및 `MultiplexerOp`에 관한 세부 정보가 추가되었습니다. + SPARQL 쿼리 응답의 경우 Content-Type 헤더에 `charset`이 추가되어 HTTP 클라이언트가 사용 중인 charset을 자동으로 인식할 수 있습니다. ## 이 엔진 릴리스에서 수정된 결함 + `CancellationException`이 처리되지 않던 SPARQL 버그가 수정되었습니다. + 중첩된 옵션을 포함하는 쿼리가 제대로 작동하지 않는 SPARQL 버그가 수정되었습니다. + `ConcurrentModificationException`으로 인해 쿼리가 중단될 수 있는 LOAD의 SPARQL 버그가 수정되었습니다. + 쿼리 응답이 gzip으로 압축되지 않는 SPARQL 버그가 수정되었습니다. + `groupBy()` 단계의 Gremlin 버그가 수정되었습니다. + `local()` 단계 내에서 `aggregate()` 단계를 사용하는 것과 관련된 Gremlin 버그가 수정되었습니다. + 집계 값을 사용하는 술어 `bothE()` 뒤에 붙이는 것과 관련된 Gremlin 버그가 수정되었습니다. + `repeat()` 단계 내에서 `bothE()` 단계를 사용하는 것과 관련된 Gremlin 버그가 수정되었습니다. + `both()` 단계와 관련된 잠재적인 Gremlin 메모리 누수가 수정되었습니다. + '/' 기호로 끝나는 엔드포인트가 제대로 처리되지 않아 요청 지표가 누락되는 버그가 수정되었습니다. + 요청 대기열이 가득 차지 않은 경우에도 `ThrottlingException`이 발생할 수 있는 버그가 수정되었습니다. + `LOAD_DATA_FAILED_DUE_TO_FEED_MODIFIED_OR_DELETE` 등의 이유로 로드가 실패할 때 로드 상태를 가져오는 버그가 수정되었습니다. ## 이 릴리스에서 지원되는 쿼리 언어 버전 DB 클러스터를 버전 1.0.2.2.R5로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다. + *Gremlin 버전:* `3.4.3` + *SPARQL 버전:* `1.1` ## 엔진 릴리스 1.0.2.2.R5에 대한 업그레이드 경로 엔진 버전 `1.0.2.2`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다. 이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다. ## 이 릴리스로 업그레이드 Amazon Neptune 1.0.2.2.R5를 이제 정식 버전으로 사용할 수 있습니다. DB 클러스터가 이 릴리스에 대한 업그레이드 경로가 있는 엔진 버전을 실행하는 경우 지금 업그레이드할 수 있습니다. 콘솔에서 DB 클러스터 작업을 사용하여 또는 SDK를 사용하여 적격 클러스터를 업그레이드할 수 있습니다. 다음 CLI 명령은 적격 클러스터를 즉시 업그레이드합니다. Linux, OS X, Unix의 경우: ``` 1. aws neptune modify-db-cluster \ 2. --db-cluster-identifier (your-neptune-cluster) \ 3. --engine-version 1.0.2.2 \ 4. --apply-immediately ``` Windows의 경우: ``` 1. aws neptune modify-db-cluster ^ 2. --db-cluster-identifier (your-neptune-cluster) ^ 3. --engine-version 1.0.2.2 ^ 4. --apply-immediately ``` 업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 해당 인스턴스에서 데이터베이스를 다시 시작해야 하므로 가동 중지가 20\$130초에서 수분까지 발생할 수 있으며, 이후 DB 클러스터 사용을 재개할 수 있습니다. ### 업그레이드하기 전에 항상 테스트 수행 새로운 메이저 또는 마이너 Neptune 엔진 버전이 출시되면 업그레이드하기 전에 해당 버전에서 항상 Neptune 애플리케이션을 먼저 테스트하세요. 마이너 업그레이드라도 코드에 영향을 줄 수 있는 새로운 기능이나 동작이 도입될 수 있습니다. 먼저 현재 버전의 릴리스 노트 페이지를 대상 버전의 릴리스 노트 페이지와 비교하여 쿼리 언어 버전에 변경 사항이나 기타 주요 변경 사항이 있는지 확인합니다. 프로덕션 DB 클러스터를 업그레이드하기 전에 새 버전을 테스트하는 가장 좋은 방법은 프로덕션 클러스터를 복제하여 새 엔진 버전을 실행하도록 하는 것입니다. 그러면 프로덕션 DB 클러스터에 영향을 주지 않고 복제본에서 쿼리를 실행할 수 있습니다. ### 업그레이드하기 전에 항상 수동 스냅샷 생성 업그레이드하기 전에 항상 DB 클러스터의 수동 스냅샷을 생성하는 것이 좋습니다. 자동 스냅샷은 단기적인 보호만 제공하는 반면, 수동 스냅샷은 명시적으로 삭제하기 전까지는 계속 사용할 수 있습니다. 경우에 따라 Neptune은 업그레이드 프로세스의 일부로 수동 스냅샷을 생성하지만, 여기에 의존해서는 안 되며 항상 자체 수동 스냅샷을 만들어야 합니다. DB 클러스터를 업그레이드 전 상태로 되돌릴 필요가 없다고 판단되면 직접 만든 수동 스냅샷과 Neptune이 생성한 수동 스냅샷(있는 경우)을 명시적으로 삭제할 수 있습니다. Neptune이 수동 스냅샷을 생성하는 경우 이름은 `preupgrade`로 시작하고 DB 클러스터 이름, 소스 엔진 버전, 대상 엔진 버전, 날짜가 차례로 뒤따릅니다. **참고** [보류 중인 작업이 진행 중](manage-console-maintaining)인 동안 업그레이드를 시도하면 다음과 같은 오류가 발생할 수 있습니다. ``` 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 클러스터 유지 관리](cluster-maintenance.md) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다. # Amazon Neptune 엔진 버전 1.0.2.2.R4(2020년 7월 23일) 2020년 7월 23일부터 엔진 버전 1.0.2.2.R4가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다. ## 이 엔진 릴리스의 개선 사항 + 사용하지 않는 메모리를 운영 체제에 더 자주 릴리스하여 메모리 사용량을 개선했습니다. + 또한 SPARQL GROUP BY 쿼리의 메모리 사용량도 개선되었습니다. + IAM을 사용하여 인증된 WebSocket 연결이 열린 상태로 유지될 수 있는 최대 시간을 36시간에서 10일로 늘렸습니다. + 쿼리 지연 시간을 진단하고 인스턴스 유형을 조정하는 데 유용한 `BufferCacheHitRatio` CloudWatch 지표가 추가되었습니다. [Neptune 지표](cw-metrics.md#cw-metrics-available)을(를) 참조하세요. ## 이 엔진 릴리스에서 수정된 결함 + 유휴 상태이거나 만료된 IAM WebSocket 연결을 종료하는 버그가 수정되었습니다. 이제 Neptune은 연결을 종료하기 전에 종료 프레임을 전송합니다. + 중첩된 FILTER EXISTS 또는 FILTER NOT EXISTS 조건을 포함하는 쿼리를 평가할 때 발생하던 SPARQL 버그가 수정되었습니다. + 특정 극한 조건일 때 서버에서 스레드가 차단되는 원인이 되었던 SPARQL 쿼리 종료 버그가 수정되었습니다. + `hasLabel` 단계에서 엣지 pathType과 관련된 Gremlin 버그가 수정되었습니다. + `bothE` 방향별로 `toV` 및 `fromV`가 개별적으로 처리되도록 Gremlin 버그가 수정되었습니다. + sideEffects가 사라지는 것과 관련된 Gremlin 버그가 수정되었습니다. ## 이 릴리스에서 지원되는 쿼리 언어 버전 DB 클러스터를 버전 1.0.2.2.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다. + *Gremlin 버전:* `3.4.3` + *SPARQL 버전:* `1.1` ## 엔진 릴리스 1.0.2.2.R4에 대한 업그레이드 경로 엔진 버전 `1.0.2.2`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다. 이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다. ## 이 릴리스로 업그레이드 Amazon Neptune 1.0.2.2.R4를 이제 정식 버전으로 사용할 수 있습니다. DB 클러스터가 이 릴리스에 대한 업그레이드 경로가 있는 엔진 버전을 실행하는 경우 지금 업그레이드할 수 있습니다. 콘솔에서 DB 클러스터 작업을 사용하여 또는 SDK를 사용하여 적격 클러스터를 업그레이드할 수 있습니다. 다음 CLI 명령은 적격 클러스터를 즉시 업그레이드합니다. Linux, OS X, Unix의 경우: ``` 1. aws neptune modify-db-cluster \ 2. --db-cluster-identifier (your-neptune-cluster) \ 3. --engine-version 1.0.2.2 \ 4. --apply-immediately ``` Windows의 경우: ``` 1. aws neptune modify-db-cluster ^ 2. --db-cluster-identifier (your-neptune-cluster) ^ 3. --engine-version 1.0.2.2 ^ 4. --apply-immediately ``` 업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 해당 인스턴스에서 데이터베이스를 다시 시작해야 하므로 가동 중지가 20\$130초에서 수분까지 발생할 수 있으며, 이후 DB 클러스터 사용을 재개할 수 있습니다. ### 업그레이드하기 전에 항상 테스트 수행 새로운 메이저 또는 마이너 Neptune 엔진 버전이 출시되면 업그레이드하기 전에 해당 버전에서 항상 Neptune 애플리케이션을 먼저 테스트하세요. 마이너 업그레이드라도 코드에 영향을 줄 수 있는 새로운 기능이나 동작이 도입될 수 있습니다. 먼저 현재 버전의 릴리스 노트 페이지를 대상 버전의 릴리스 노트 페이지와 비교하여 쿼리 언어 버전에 변경 사항이나 기타 주요 변경 사항이 있는지 확인합니다. 프로덕션 DB 클러스터를 업그레이드하기 전에 새 버전을 테스트하는 가장 좋은 방법은 프로덕션 클러스터를 복제하여 새 엔진 버전을 실행하도록 하는 것입니다. 그러면 프로덕션 DB 클러스터에 영향을 주지 않고 복제본에서 쿼리를 실행할 수 있습니다. ### 업그레이드하기 전에 항상 수동 스냅샷 생성 업그레이드하기 전에 항상 DB 클러스터의 수동 스냅샷을 생성하는 것이 좋습니다. 자동 스냅샷은 단기적인 보호만 제공하는 반면, 수동 스냅샷은 명시적으로 삭제하기 전까지는 계속 사용할 수 있습니다. 경우에 따라 Neptune은 업그레이드 프로세스의 일부로 수동 스냅샷을 생성하지만, 여기에 의존해서는 안 되며 항상 자체 수동 스냅샷을 만들어야 합니다. DB 클러스터를 업그레이드 전 상태로 되돌릴 필요가 없다고 판단되면 직접 만든 수동 스냅샷과 Neptune이 생성한 수동 스냅샷(있는 경우)을 명시적으로 삭제할 수 있습니다. Neptune이 수동 스냅샷을 생성하는 경우 이름은 `preupgrade`로 시작하고 DB 클러스터 이름, 소스 엔진 버전, 대상 엔진 버전, 날짜가 차례로 뒤따릅니다. **참고** [보류 중인 작업이 진행 중](manage-console-maintaining)인 동안 업그레이드를 시도하면 다음과 같은 오류가 발생할 수 있습니다. ``` 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 클러스터 유지 관리](cluster-maintenance.md) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다. # Amazon Neptune 엔진 버전 1.0.2.2.R3(2020년 7월 22일) 엔진 릴리스 1.0.2.2.R3은 [엔진 릴리스 1.0.2.2.R4](engine-releases-1.0.2.2.R4.md)에 통합되었습니다. # Amazon Neptune 엔진 버전 1.0.2.2.R2(2020년 4월 2일) 2020년 4월 2일부터 엔진 버전 1.0.2.2.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다. ## 이 엔진 릴리스의 개선 사항 + 이제는 작업이 완료될 때까지 기다렸다가 다음 작업을 시작하지 않고 최대 64개의 대량 로드 작업을 대기열 처리할 수 있습니다. `dependencies` 명령의 `load` 파라미터를 사용하면 대기열에 있는 로드 요청의 실행이 이전에 대기열에 있던 하나 이상의 로드 작업이 성공적으로 완료되는 것에 의존하게 만들 수도 있습니다. [Neptune 로더 명령](load-api-reference-load.md)을(를) 참조하세요. + 이제 전체 텍스트 검색 출력을 정렬할 수 있습니다([전체 텍스트 검색 파라미터](full-text-search-parameters.md) 참조). + 이제 Neptune 스트림을 호출하기 위한 DB 클러스터 파라미터가 있으며 이 기능은 랩 모드에서 제거되었습니다. [Neptune 스트림 활성화](streams-using-enabling.md)을(를) 참조하세요. ## 이 엔진 릴리스에서 수정된 결함 + 인스턴스 생성을 지연시켰던 서버 시작 시 확률 실패를 수정하였습니다. + 쿼리의 `BIND` 문으로 인해 join-order 계획에서 옵티마이저가 선택되지 않은 패턴으로 시작되는 옵티마이저 문제를 수정했습니다. ## 이 릴리스에서 지원되는 쿼리 언어 버전 DB 클러스터를 버전 1.0.2.2.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다. + *Gremlin 버전:* `3.4.3` + *SPARQL 버전:* `1.1` ## 엔진 릴리스 1.0.2.2.R2에 대한 업그레이드 경로 엔진 버전 `1.0.2.2`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다. 이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다. ## 이 릴리스로 업그레이드 Amazon Neptune 1.0.2.2.R2를 이제 정식 버전으로 사용할 수 있습니다. DB 클러스터가 이 릴리스에 대한 업그레이드 경로가 있는 엔진 버전을 실행하는 경우 지금 업그레이드할 수 있습니다. 콘솔에서 DB 클러스터 작업을 사용하여 또는 SDK를 사용하여 적격 클러스터를 업그레이드할 수 있습니다. 다음 CLI 명령은 적격 클러스터를 즉시 업그레이드합니다. Linux, OS X, Unix의 경우: ``` 1. aws neptune modify-db-cluster \ 2. --db-cluster-identifier (your-neptune-cluster) \ 3. --engine-version 1.0.2.2 \ 4. --apply-immediately ``` Windows의 경우: ``` 1. aws neptune modify-db-cluster ^ 2. --db-cluster-identifier (your-neptune-cluster) ^ 3. --engine-version 1.0.2.2 ^ 4. --apply-immediately ``` 업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 해당 인스턴스에서 데이터베이스를 다시 시작해야 하므로 가동 중지가 20\$130초에서 수분까지 발생할 수 있으며, 이후 DB 클러스터 사용을 재개할 수 있습니다. ### 업그레이드하기 전에 항상 테스트 수행 새로운 메이저 또는 마이너 Neptune 엔진 버전이 출시되면 업그레이드하기 전에 해당 버전에서 항상 Neptune 애플리케이션을 먼저 테스트하세요. 마이너 업그레이드라도 코드에 영향을 줄 수 있는 새로운 기능이나 동작이 도입될 수 있습니다. 먼저 현재 버전의 릴리스 노트 페이지를 대상 버전의 릴리스 노트 페이지와 비교하여 쿼리 언어 버전에 변경 사항이나 기타 주요 변경 사항이 있는지 확인합니다. 프로덕션 DB 클러스터를 업그레이드하기 전에 새 버전을 테스트하는 가장 좋은 방법은 프로덕션 클러스터를 복제하여 새 엔진 버전을 실행하도록 하는 것입니다. 그러면 프로덕션 DB 클러스터에 영향을 주지 않고 복제본에서 쿼리를 실행할 수 있습니다. ### 업그레이드하기 전에 항상 수동 스냅샷 생성 업그레이드하기 전에 항상 DB 클러스터의 수동 스냅샷을 생성하는 것이 좋습니다. 자동 스냅샷은 단기적인 보호만 제공하는 반면, 수동 스냅샷은 명시적으로 삭제하기 전까지는 계속 사용할 수 있습니다. 경우에 따라 Neptune은 업그레이드 프로세스의 일부로 수동 스냅샷을 생성하지만, 여기에 의존해서는 안 되며 항상 자체 수동 스냅샷을 만들어야 합니다. DB 클러스터를 업그레이드 전 상태로 되돌릴 필요가 없다고 판단되면 직접 만든 수동 스냅샷과 Neptune이 생성한 수동 스냅샷(있는 경우)을 명시적으로 삭제할 수 있습니다. Neptune이 수동 스냅샷을 생성하는 경우 이름은 `preupgrade`로 시작하고 DB 클러스터 이름, 소스 엔진 버전, 대상 엔진 버전, 날짜가 차례로 뒤따릅니다. **참고** [보류 중인 작업이 진행 중](manage-console-maintaining)인 동안 업그레이드를 시도하면 다음과 같은 오류가 발생할 수 있습니다. ``` 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 클러스터 유지 관리](cluster-maintenance.md) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.