기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Neptune의 엔진 릴리스
Amazon Neptune은 정기적으로 엔진 업데이트를 릴리스합니다.
[instance-status API](access-graph-status.md) 또는 Neptune 콘솔을 사용하여 현재 설치한 엔진 릴리스 버전을 확인할 수 있습니다. 버전 번호는 최초 메이저 릴리스를 실행하는지, 마이너 릴리스를 실행하는지 아니면 패치 릴리스를 실행 중인지를 알려줍니다. 릴리스 번호 매기기에 대한 자세한 내용은 [엔진 버전 번호](cluster-maintenance.md#engine-version-numbers) 단원을 참조하십시오.
일반적인 업데이트에 대한 자세한 정보는 [클러스터 유지 관리](cluster-maintenance.md) 섹션을 참조하세요.
엔진 릴리스 1.3.0.0부터 엔진 버전은 아래 표와 같은 구조를 갖게 됩니다. 마이너 버전 번호는 [`AutoMinorVersionUpgrade`](engine-maintenance-management.md#using-amvu) 처리를 위해 평가되는 번호입니다.
| 버전 | 제품 버전 | 메이저 버전 | 마이너 버전 | 패치 버전 | Status | 해제 | 수명 종료 | 다음으로 업그레이드: |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [1.4.7.0](engine-releases-1.4.7.0.md) | 1 | 4 | 7 | 0 | *active* | 2026-03-03 | 2027-06-03 | 해당 사항 없음 |
| [1.4.6.3](engine-releases-1.4.6.3.md) | 1 | 4 | 6 | 3 | *active* | 2025-12-18 | 2027-06-03 | 1.4.7.0 |
| [1.4.6.2](engine-releases-1.4.6.2.md) | 1 | 4 | 6 | 2 | *active* | 2025-11-18 | 2027-06-03 | 1.4.7.0 |
| [1.4.6.1](engine-releases-1.4.6.1.md) | 1 | 4 | 6 | 1 | *active* | 2025-09-18 | 2027-03-06 | 1.4.6.2 |
| [1.4.6.0](engine-releases-1.4.6.0.md) | 1 | 4 | 6 | 0 | *active* | 2025-09-02 | 2027-03-06 | 1.4.6.1 |
| [1.4.5.1](engine-releases-1.4.5.1.md) | 1 | 4 | 5 | 1 | *active* | 2025-06-30 | 2027-03-06 | 1.4.6.0 |
| [1.4.5.0](engine-releases-1.4.5.0.md) | 1 | 4 | 5 | 0 | *active* | 2025-04-09 | 2027-03-06 | 1.4.5.1 |
| [1.4.4.0](engine-releases-1.4.4.0.md) | 1 | 4 | 4 | 0 | *active* | 2025-02-24 | 2027-03-06 | 1.4.5.0 |
| [1.4.3.0](engine-releases-1.4.3.0.md) | 1 | 4 | 3 | 0 | *active* | 2025-01-21 | 2027-03-06 | 1.4.4.0 |
| [1.4.2.0](engine-releases-1.4.2.0.md) | 1 | 4 | 2 | 0 | *active* | 2024-12-19 | 2027-03-06 | 1.4.3.0 |
| [1.4.1.0](engine-releases-1.4.1.0.md) | 1 | 4 | 1 | 0 | *active* | 2024-11-21 | 2027-03-06 | 1.4.2.0 |
| [1.4.0.0](engine-releases-1.4.0.0.md) | 1 | 4 | 0 | 0 | *active* | 2024-11-06 | 2027-03-06 | 1.4.1.0 |
| [1.3.4.0](engine-releases-1.3.4.0.md) | 1 | 3 | 4 | 0 | *active* | 2024-10-01 | 2027-03-06 | 1.4.0.0 |
| [1.3.3.0](engine-releases-1.3.3.0.md) | 1 | 3 | 3 | 0 | *active* | 2024-08-05 | 2027-03-06 | 1.3.4.0 |
| [1.3.2.1](engine-releases-1.3.2.1.md) | 1 | 3 | 2 | 1 | *active* | 2024-06-20 | 2027-03-06 | 1.3.3.0 |
| [1.3.2.0](engine-releases-1.3.2.0.md) | 1 | 3 | 2 | 0 | *active* | 2024-06-10 | 2027-03-06 | 1.3.2.1 |
| [1.3.1.0](engine-releases-1.3.1.0.md) | 1 | 3 | 1 | 0 | *active* | 2024-03-06 | 2027-03-06 | 1.3.2.1 |
| [1.3.0.0](engine-releases-1.3.0.0.md) | 1 | 3 | 0 | 0 | *active* | 2023-11-15 | 2027-03-06 | 1.3.2.1 |
아래 표에는 버전 종료에 대한 정보와 함께 1.0.1.0 이후의 모든 엔진 릴리스가 나열되어 있습니다. 이 표의 날짜를 참고하여 테스트 및 업그레이드 주기를 계획할 수 있습니다.
| 버전 | 메이저 버전 | 마이너 버전 | Status | 해제 | 수명 종료 | 다음으로 업그레이드: |
| --- | --- | --- | --- | --- | --- | --- |
| [1.2.1.2](engine-releases-1.2.1.2.md) | 1.2 | 1.2 | *active* | 2024-08-05 | 2026-06-30 | 1.3.0.0 |
| [1.2.1.1](engine-releases-1.2.1.1.md) | 1.2 | 1.1 | *active* | 2024-03-11 | 2026-06-30 | 1.3.0.0 |
| [1.2.1.0](engine-releases-1.2.1.0.md) | 1.2 | 1.0 | *active* | 2023-03-08 | 2026-06-30 | 1.3.0.0 |
| [1.2.0.2](engine-releases-1.2.0.2.md) | 1.2 | 0.2 | *active* | 2022-11-16 | 2026-06-30 | 1.3.0.0 |
| [1.2.0.1](engine-releases-1.2.0.1.md) | 1.2 | 0.1 | *active* | 2022-10-26 | 2026-06-30 | 1.3.0.0 |
| [1.2.0.0](engine-releases-1.2.0.0.md) | 1.2 | 0.0 | *active* | 2022-07-21 | 2026-06-30 | 1.3.0.0 |
| [1.1.1.0](engine-releases-1.1.1.0.md) | 1.1 | 1.0 | *active* | 2022-04-19 | 2026-06-30 | 1.2.1.0 |
| [1.1.0.0](engine-releases-1.1.0.0.md) | 1.1 | 0.0 | *deprecated* | 2021-11-19 | 2025-03-15 | 1.1.1.0 |
| [1.0.5.1](engine-releases-1.0.5.1.md) | 1.0 | 5.1 | *deprecated* | 2021-10-01 | 2023-01-30 | 1.1.0.0 |
| [1.0.5.0](engine-releases-1.0.5.0.md) | 1.0 | 5.0 | *deprecated* | 2021-07-27 | 2023-01-30 | 1.1.0.0 |
| [1.0.4.2](engine-releases-1.0.4.2.md) | 1.0 | 4.2 | *deprecated* | 2021-06-01 | 2023-01-30 | 1.1.0.0 |
| [1.0.4.1](engine-releases-1.0.4.1.md) | 1.0 | 4.1 | *deprecated* | 2020-12-08 | 2023-01-30 | 1.1.0.0 |
| [1.0.4.0](engine-releases-1.0.4.0.md) | 1.0 | 4.0 | *deprecated* | 2020-10-12 | 2023-01-30 | 1.1.0.0 |
| [1.0.3.0](engine-releases-1.0.3.0.md) | 1.0 | 3.0 | *deprecated* | 2020-08-03 | 2023-01-30 | 1.1.0.0 |
| [1.0.2.2](engine-releases-1.0.2.2.md) | 1.0 | 2.2 | *deprecated* | 2020-03-09 | 2022-07-29 | 1.0.3.0 |
| [1.0.2.1](engine-releases-1.0.2.1.md) | 1.0 | 2.1 | *deprecated* | 2019-11-22 | 2022-07-29 | 1.0.3.0 |
| [1.0.2.0](engine-releases-1.0.2.0.md) | 1.0 | 2.0 | *deprecated* | 2019-11-08 | 2020-05-19 | 1.0.3.0 |
| [1.0.1.2](engine-releases-1.0.1.2.md) | 1.0 | 1.2 | *deprecated* | 2019-10-15 | — | — |
| [1.0.1.1](engine-releases-1.0.1.1.md) | 1.0 | 1.1 | *deprecated* | 2019-08-13 | — | — |
| [1.0.1.0.\$1](engine-releases-1.0.1.0.md) | 1.0 | 1.0.\$1 | *deprecated* | 2019-07-02 및 이전 | — | — |
## 메이저 엔진 버전 지원 종료 계획
Neptune 엔진 버전은 거의 항상 분기 말에 수명이 다합니다. 예외는 중요한 보안 또는 가용성 문제가 생기는 경우에만 발생합니다.
엔진 버전의 수명이 다하면 Neptune 데이터베이스를 최신 버전으로 업그레이드해야 합니다.
일반적으로 Neptune 엔진 버전은 다음과 같이 계속 제공됩니다.
+ **마이너 엔진 버전:** 마이너 엔진 버전은 출시 후 최소 6개월 동안 계속 사용할 수 있습니다.
+ **메이저 엔진 버전:** 메이저 엔진 버전은 출시 후 최소 12개월 동안 계속 사용할 수 있습니다.
엔진 버전이 수명 종료되기 최소 3개월 전에 AWS 는 계정 AWS 과 연결된 이메일 주소로 자동 이메일 알림을 보내고 동일한 메시지를 [AWS Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/aws-health-dashboard-status.html)에 게시합니다. 이로 인해 업그레이드를 계획하고 준비할 시간을 확보할 수 있습니다.
엔진 버전의 수명이 다하면 더 이상 해당 버전을 사용하여 새 클러스터나 인스턴스를 만들 수 없으며, 자동 크기 조정도 해당 버전을 사용하여 인스턴스를 생성할 수 없습니다.
실제로 수명이 다한 엔진 버전은 유지 관리 기간 동안 자동으로 업그레이드됩니다. 엔진 버전 사용 종료 3개월 전에 전송되는 메시지에는 자동으로 업그레이드될 버전, DB 클러스터에 미치는 영향, 권장 조치 등 자동 업데이트와 관련된 세부 정보가 포함됩니다.
**중요**
데이터베이스 엔진 버전을 최신으로 유지하는 것은 사용자의 책임입니다. AWS 에서는 최신 보안, 개인 정보 보호, 가용성 보호 기능의 혜택을 누릴 수 있도록 모든 고객에게 데이터베이스를 최신 엔진 버전으로 업그레이드하기를 촉구합니다. 사용 중단일이 지난 지원되지 않는 엔진 또는 소프트웨어('레거시 엔진')에서 데이터베이스를 운영하는 경우 가동 중단을 비롯한 보안, 개인 정보 보호 및 운영 위험에 직면할 가능성이 커집니다.
엔진에서 데이터베이스를 운영하려면 AWS 서비스 사용에 적용되는 계약이 적용됩니다. 레거시 엔진은 일반적으로 사용할 수 없습니다. 레거시 엔진 AWS 에 대한 지원을 더 이상 제공하지 AWS 않으며, 레거시 엔진이 서비스, AWS그 계열사 또는 제3자에게 보안 또는 책임 위험 또는 손해 위험을 초래한다고 AWS 판단되는 경우 언제든지 레거시 엔진에 대한 액세스 또는 사용에 제한을 둘 수 있습니다. 레거시 엔진에서 콘텐츠를 계속 실행하기로 결정하면 콘텐츠를 사용할 수 없거나 복구할 수 없게 되거나 콘텐츠가 손상될 수 있습니다. 레거시 엔진에서 실행되는 데이터베이스에는 서비스 수준에 관한 계약(SLA) 예외가 적용됩니다.
레거시 엔진에서 실행되는 데이터베이스 및 관련 소프트웨어에는 버그, 오류, 결함 및/또는 유해한 구성 요소가 포함되어 있습니다. 따라서 계약 또는 서비스 조건에 상반되는 내용이 있더라도 AWS 는 레거시 엔진을 "있는 그대로" 제공합니다.
# Amazon Neptune 엔진 버전 1.4.7.0(2026-03-03)
2026-03-03부터 엔진 버전 1.4.7.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**일시적으로 사용할 수 없는 업그레이드**
글로벌 데이터베이스(GDB) 클러스터 업그레이드와 관련된 알려진 문제로 인해 현재 Neptune 엔진 버전 1.4.7.0으로의 업그레이드를 사용할 수 없습니다. 몇 주 후에 업그레이드가 활성화될 것으로 예상됩니다.
## 이 엔진 릴리스의 새로운 기능
+ OC를 통해 Parquet 및 CSV 파일에 대한 S3 지원에서 openCypher 읽기. [neptune.read()](access-graph-opencypher-21-extensions-s3-read.md) 설명서를 참조하세요.
+ openCypher 지리 공간 쿼리 함수. 이 릴리스에는 ISO/IEC 13249-3:2016 표준을 기반으로 하는 12개의 공간 유형 함수, 빠른 검색을 위해 새 지오메트리 인덱스에 저장된 POINT의 새로운 지오메트리 속성 유형, WKT(Well-Known Text) 형식 지원이 포함되어 있습니다. [공간 데이터](access-graph-opencypher-22-spatial-data.md) 및 [공간 함수](access-graph-opencypher-22-spatial-functions.md) 설명서를 참조하십시오.
## 이 엔진 릴리스의 개선 사항
+ LIMIT 값이 작은 결과 집합을 포함하여 작은 결과 집합을 반환하는 SPARQL 하위 쿼리의 쿼리 성능 개선
+ 변수가 매우 많은 수의 상수 값에 의해 제한되는 경우(예: SPARQL VALUES 절 또는 OpenCypher UNWIND 절) 쿼리 성능이 개선되었습니다.
+ 사전 삽입에 대한 일부 최적화를 통해 지연 시간이 짧은 삽입 쿼리 개선
+ DFE 엔진에 새로운 Gremlin 언어 단계가 추가되었습니다([DFE의 Gremlin 단계 적용](gremlin-step-coverage-in-DFE.md) 범위 참조).
+ 경로 및 순회 단계: `order(local)`
+ 집계 및 수집 단계: `dedup(local)`
+ 를 포함한 OpenCypher 쿼리의 성능 개선`COLLECT(DISTINCT ...)`. Rewrite [COLLECT(DISTINCT ...) 쿼리에 설명된 재작성](best-practices-content-11.md)은 엔진 버전 1.4.7.0 이상을 사용할 때 더 이상 필요하지 않습니다.
## 이 엔진 릴리스에서 수정된 결함
일반 수정 사항:
+ 대량의 엣지 파일을 로드할 때 대량 로드가 응답하지 않도록 수정
+ 릴리스 1.4.0.0, 1.4.1.0 및 1.4.2.0의 보조 클러스터 업데이트에 영향을 미치는 글로벌 데이터베이스 클러스터 패치 문제를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.7.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.7.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.7.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.7.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.4.6.3(2025-12-18)
2025-12-18부터 엔진 버전 1.4.6.3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 결함 수정(1.4.6.3)
**일반적인 수정 사항**
+ 내부 서버 오류로 잘못 분류된 일부 예외는 이제 데이터 흐름 엔진(DFE) 실행 중에 메모리 부족 예외로 올바르게 보고됩니다.
+ 인라인 엣지 ID 검증에서 예상치 못한 사전 항목 유형이 발생한 경우 시작 중에 Neptune 데이터베이스 인스턴스가 실패할 수 있는 문제를 수정했습니다. 인라인 엣지 ID 검증은 이제 Gremlin 쿼리 엔진 구성에 대해서만 실행되며 비 URI 사전 항목을 정상적으로 처리합니다.
+ 잘못된 엔드포인트 확인으로 인해 Neptune 대량 로더가 특정 리전의 S3에 연결하지 못할 수 있는 문제를 수정했습니다.
**openCypher 수정 사항**
+ 를 사용하는 쿼리에서 가끔 발생하는 엔진 충돌을 수정했습니다`CALL`.
+ 변형 쿼리의 제한 시간 및 취소 처리를 수정했습니다.
+ 에 전달된 속성 값 중 하나에 null 값이 있을 때 `MERGE` 절이 잘못된 결과를 제공하는 버그`MERGE`를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.6.3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.6.3으로의 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.6.3 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.3 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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](https://aws.amazon.com/support) AWS Support를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.4.6.2(2025-11-18)
2025-11-18부터 엔진 버전 1.4.6.2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항**
+ 내부 장애 예외(IFEs)로 잘못 분류된 일부 예외는 이제 데이터 흐름 엔진(DFE) 실행 중에 동시 수정 예외(CMEs)로 올바르게 보고됩니다.
**Gremlin 수정 사항**
+ Gremlin over DFE의 엔진 안정성 개선
**openCypher 수정 사항**
+ openCypher MERGE 쿼리가 수신 관계 방향(")을 잘못 처리하는 Neptune 엔진 릴리스 1.4.6.0에 도입된 문제를 수정했습니다. MERGE (n)"[:type]-(m)과 같은 패턴을 사용하는 쿼리는 이제 올바른 방향으로 관계를 생성합니다.
+ 제대로 롤백되지 않은 라이터 트랜잭션에서 실패한 커밋 작업을 수정했습니다.
+ 이제 파라미터화된 값을 참조하는 MERGE 쿼리에 최적화된 쿼리 계획이 지원됩니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.6.2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.6.2에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.6.2 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.2 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼과 [AWSPremium](https://aws.amazon.com/support) AWSSupport를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.4.6.1(2025년 9월 18일)
2025년 9월 18일부터 엔진 버전 1.4.6.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항**
+ 릴리스 [Amazon Neptune 엔진 버전 1.4.6.0(2025년 9월 2일)](engine-releases-1.4.6.0.md)에서 도입된 RFC 1918에 부합하지 않는 프라이빗 IP 범위를 사용하는 클러스터에 대한 네트워크 검사를 제거했습니다.
**Gremlin 수정 사항**
+ 트랜잭션과 관련된 Websocket 연결 관리 문제를 해결했습니다.
+ gremlin DFE 모드를 사용할 때 드물게 발생하는 인스턴스 재시작 문제를 해결했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.6.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.6.1에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.6.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.1 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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](https://aws.amazon.com/support) AWS Support를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.4.6.0(2025년 9월 2일)
2025년 9월 2일부터 엔진 버전 1.4.6.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**주의**
1.4.6.0 엔진 버전에는 IAM 인증 없이 데이터베이스 VPC에 대해 RFC 1918이 아닌 호환 프라이빗 IP 범위를 사용하는 클러스터에 대한 새로운 네트워크 검사가 포함되어 있습니다. 이 VPC 및 IAM 구성이 있는 경우 RFC 1918 프라이빗 IP 범위를 사용하도록 데이터베이스 VPC를 업데이트하거나 1.4.6.0으로 업그레이드한 후 쿼리 오류를 방지하기 위해 IAM 인증을 활성화해야 합니다.
## 이 엔진 릴리스의 새로운 기능
+ 퍼블릭 엔드포인트를 사용하여 Neptune에 연결합니다. 자세한 내용은 [Neptune 퍼블릭 엔드포인트](neptune-public-endpoints.md)를 참조하세요.
## 이 엔진 릴리스의 개선 사항
**일반적인 개선 사항**
+ 업데이트 작업에 대한 SPARQL 성능이 개선되었습니다.
+ `CREATE`, `MERGE`및 `SET`(변이) 작업에 대한 openCypher 성능이 개선되었습니다.
+ CALL 하위 쿼리 작업에 대한 openCypher 성능이 개선되었습니다.
**openCypher 개선 사항**
+ 쿼리 [수준 제한 시간을 지원하기 위해 새 쿼리](opencypher-query-hints-timeout-hint.md) 힌트가 추가되었습니다.
## 이 엔진 릴리스에서 수정된 결함
**Gremlin 수정 사항**
+ Gremlin 세션에 대한 연결은 생성한 채널과 동일한 채널에서 이루어져야 합니다. 즉, 여러 클라이언트 인스턴스를 동일한 세션에 연결할 수 없습니다.
+ Gremlin 세션은 클라이언트가 닫힐 때 항상 닫히지만, 이제 연결 종료 시 시작된 서버에 대해서도 닫혀 의도하지 않거나 예기치 않은 재연결을 방지합니다.
+ 대용량 Blob 유형 데이터를 읽는 Gremlin 쿼리의 메모리 누수를 수정했습니다.
**openCypher 수정 사항**
+ `CALL` 하위 쿼리 후 변수 처리를 수정했습니다.
+ 산술 오버플로 시나리오를 올바르게 처리하기 위한 `reduce` 함수 관련 문제를 수정했습니다.
+ 쿼리 계획 캐시가 활성화된 경우 파라미터화된 쿼리에 영향을 미치는 메모리 누수를 수정했습니다.
+ 복잡한 `WHERE` 절에서 `NOT EXISTS` 사용되는의 문제를 수정했습니다.
+ BadRequestException으로 잘못 보고된 CMEs)를 수정했습니다.
**SPARQL 수정 사항**
+ 원격 소스를 사용할 수 없는 경우 SPARQL `LOAD/UNLOAD`에 대한 오류 메시지가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.6.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.6.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.6.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.6.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼과 [AWSPremium](https://aws.amazon.com/support) AWSSupport를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.4.5.1(2025년 6월 30일)
2025년 6월 30일부터 엔진 버전 1.4.5.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항**
+ 모든 쿼리 언어에 영향을 미치는 서버리스 규모 조정 문제를 수정했습니다.
+ `collect(distinct())` 목록에서 실행할 때 일부 openCypher 쿼리에서 내부 오류가 반환되는 문제를 수정했습니다.
+ OpenSearch 서버리스를 사용할 때 동시 FTS 쿼리로 인해 다른 동시 FTS 쿼리가 종료되는 문제를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.5.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.5.1에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.5.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.5.1 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.4.5.0(2025년 4월 9일)
2025년 4월 9일부터 엔진 버전 1.4.5.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**주의**
특정 Serverless 구성에서 발생할 수 있는 문제로 인해 1.4.5.0으로의 업그레이드를 일시적으로 일시 중지했습니다. 1.4.5.1 엔진 버전으로 업그레이드하는 것이 좋습니다. 1.4.5.0으로의 업그레이드가 일시적으로 비활성화되었습니다.
## 이 엔진 릴리스의 새로운 기능
+ DFE 엔진에 새로운 Gremlin 언어 단계가 추가되었습니다.
+ **경로 및 순회 단계: **asDate(), dateAdd(), dateDiff(), fail(), Inject(), label(), path(), project(), repeat(), sack(), select(), unfold(), disjunct(), drop(), identity(), intersect(), length(), loop(), barrier(), order(), range(), reverse(), sample(), cap(), split(), filter(), flatMap(), map(), sideEffect(), union(), index()
+ **집계 및 수집 단계: **aggregate(global), combine(), count(), dedup(global), fold(), group(), groupCount()
+ **수학 단계: **max(), mean(), min(), sum()
+ **요소 단계: **otherV(), elementMap(), element(), V(), out(), in(), both(), outE(), inE(), bothE(), outV(), inV(), bothV(), otherV()
+ **속성 단계: **properties(), key(), valueMap(), value()
+ **필터 단계: **and(), coalesce(), coin(), is(), local(), none(), not(), or(), where()
+ **문자열 조작 단계: **concat(), lTrim(), rTrim(), substring(), toLower(), toUpper(), trim()
+
**조건자:**
+ 비교: eq, neq, lt, lte, gt, gte
+ 포함: within, without
+ TextP: endingWith, containing, notStartingWith, notEndingWith, notContaining
+ P: and, or, between, outside, inside
DFE에서 사용 가능한 모든 Gremlin 단계에 대한 자세한 내용은 [DFE의 Gremlin 단계 적용 범위](gremlin-step-coverage-in-DFE.md) 섹션을 참조하세요.
## 이 엔진 릴리스의 개선 사항
**일반적인 개선 사항**
+ 느린 쿼리 로그 잠금 대기 시간이 개선되었습니다. 느린 쿼리 로그에는 이제 공유 및 배타적 잠금에 대한 대기 시간 지표가 포함됩니다. 읽기-쓰기 승격이 지연되는 경우 각 트랜잭션의 일부로 저장됩니다. 이러한 지표는 느린 쿼리 로그의 storageCounters 섹션에 표시됩니다.
+ 다음 암호 제품군에 대한 지원이 중단되었습니다.
+ TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256
+ TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384
+ TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256
+ TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384
**Gremlin 개선 사항**
+ Gremlin 언어에 많은 새로운 단계가 추가되었습니다. 자세한 내용은 [DFE의 Gremlin 단계 적용 범위](gremlin-step-coverage-in-DFE.md) 단원을 참조하십시오.
**openCypher 개선 사항**
+ CREATE, MERGE 및 SET(변환) 성능이 개선되었습니다.
+ CALL 하위 쿼리 성능이 개선되었습니다.
+ 멀티파트 openCypher 응답에 대한 HTTP 후행 헤더 지원이 추가되었습니다. 자세한 내용은 [선택적 HTTP 후행 헤더](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-queries.html#optional-http-trailing-headers)를 참조하세요.
+ openCypher에 일, 월 및 연도 시간 함수가 추가되었습니다. 자세한 내용은 [시간 함수](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#temporal-functions)를 참조하세요.
```
RETURN day(datetime('2021-06-03T01:48:14Z'))
{
"results": [{
"day(datetime('2021-06-03T01:48:14Z'))": 3
}]
}
```
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항**
+ Audit/SlowQueryLog 로그 파일을 삭제하는 문제를 수정했습니다.
**Gremlin 수정 사항**
+ 결과 캐시 기능이 비활성화된 상태에서 실행 중인 Gremlin 쿼리 문제를 수정했습니다. iterate()로 끝나는 쿼리는 빈 응답을 반환하는 대신 결과를 반환했습니다.
+ 동일한 키를 사용하는 동시 쿼리로 인해 발생하는 Gremlin 결과 캐시 문제를 수정했습니다. 동시 실행 중인 쿼리 중 하나가 빈 결과를 반환하는 대신 결과를 잘못 반환했습니다.
+ 정리 시간을 늘려 제한 시간 또는 취소로 인해 쿼리가 Amazon S3 멀티파트 업로드에 실패하는 Amazon S3 내보내기 쿼리 문제를 수정했습니다.
+ Gremlin Amazon S3 내보내기와 관련된 권한 문제를 수정했습니다.
**SPARQL 수정 사항**
+ 초기 선언만 사용하게 하는 여러 기본 IRIs를 선언하는 SPARQL 쿼리 처리 문제를 수정했습니다.
+ 잘못된 패턴 문자열을 사용하여 SPARQL `REPLACE` 함수를 처리할 때 오류가 반환되는 문제를 수정했습니다.
+ 유니코드 데이터와 함께 대소문자 비민감성(`"i"`) 플래그를 사용하여 SPARQL `REPLACE` 함수를 처리하는 문제를 수정했습니다.
+ 잘못된 `\u` 및 `\U` 코드포인트 이스케이프 시퀀스를 사용하여 SPARQL 쿼리를 구문 분석할 때 응답이 반환되지 않는 문제를 수정했습니다.
+ SPARQL `IRI` 함수에서 현재 기본 IRIs에 대한 상대 IRI를 항상 올바르게 해결하지 못하는 문제를 수정했습니다.
+ 접두사 이름을 사용한 `SPARQL INSERT DATA` 및 `DELETE DATA` 업데이트가 현재 기본 IRIs 대한 상대 IRI를 올바르게 해결하지 못하는 문제를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.5.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.5.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.5.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.5.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼과 [AWSPremium](https://aws.amazon.com/support) AWSSupport를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.4.4.0(2025년 2월 24일)
2025년 2월 24일부터 엔진 버전 1.4.4.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**주의**
쿼리에서 숫자 유형 파라미터의 중복 사용을 처리하는 버그로 인해 숫자 파라미터 값과 관련된 파라미터화된 쿼리를 실행하는 사용 사례에서는 쿼리 계획 캐시가 일시적으로 지원되지 않습니다. 예:
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
문 또는 딕셔너리 인덱스에 대한 인덱스 검색을 많이 수행하는 쿼리는 5%의 성능 회귀를 볼 수 있습니다. 예를 들어 모든 버텍스의 수를 가져오거나 모든 버텍스의 `id`를 가져오는 것은 영향을 받지 않습니다. 모든 버텍스의 모든 속성을 가져오면 최대 5%의 회귀를 볼 수 있습니다.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항**
+ 별표(`*`)와 별칭 표현식을 포함하는 `WITH` 절로 인해 openCypher에서 잘못된 쿼리 구문 분석이 발생하는 문제를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.4.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.4.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.4.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.4.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.4.3.0(2025년 1월 21일)
2025년 1월 21일부터 엔진 버전 1.4.3.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**주의**
쿼리에서 숫자 유형 파라미터의 중복 사용을 처리하는 버그로 인해 숫자 파라미터 값과 관련된 파라미터화된 쿼리를 실행하는 사용 사례에서는 쿼리 계획 캐시가 일시적으로 지원되지 않습니다. 예:
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
문 또는 딕셔너리 인덱스에 대한 인덱스 검색을 많이 수행하는 쿼리는 5%의 성능 회귀를 볼 수 있습니다. 예를 들어 모든 버텍스의 수를 가져오거나 모든 버텍스의 `id`를 가져오는 것은 영향을 받지 않습니다. 모든 버텍스의 모든 속성을 가져오면 최대 5%의 회귀를 볼 수 있습니다.
## 이 엔진 릴리스의 새로운 기능
+ [Amazon S3로 Gremlin 쿼리 결과 내보내기](exporting-gremlin.md). Gremlin 쿼리 결과를 Amazon S3로 직접 내보냅니다. 이 기능을 사용하면 쿼리 응답으로 반환하는 대신 Amazon S3 버킷으로 내보내 대규모 쿼리 결과를 효율적으로 처리할 수 있습니다.
```
g.V().
hasLabel('Comment').
valueMap().
call('neptune.query.exportToS3', [
'destination': 's3://your-bucket/path/result.json',
'format': 'GraphSONv3',
'keyArn': 'optional-kms-key-arn'
])
```
+ **R7i 인스턴스** 이제 다음 리전에서 최대 48xlarge의 R7i 인스턴스 패밀리를 사용할 수 있습니다.
+ ap-northeast-1 – 아시아 태평양(도쿄)
+ ap-northeast-2 - 아시아 태평양(서울)
+ ap-south-1 - 아시아 태평양(뭄바이)
+ ap-southeast-1 – 아시아 태평양(싱가포르)
+ ap-southeast-2 – 아시아 태평양(시드니)
+ ap-southeast-3 – 아시아 태평양(자카르타)
+ ca-central-1 - 캐나다(중부)
+ eu-central-1 – 유럽(프랑크푸르트)
+ eu-north-1 - 유럽(스톡홀름)
+ eu-south-2 – 유럽(스페인)
+ eu-west-1 – 유럽(아일랜드)
+ eu-west-2 - 유럽(런던)
+ eu-west-3 - 유럽(파리)
+ us-east-1 – 미국 동부(버지니아 북부)
+ us-east-2 – 미국 동부(오하이오)
+ us-west-1 - 미국 서부(캘리포니아 북부)
+ us-west-2 – 미국 서부(오리건)
## 이 엔진 릴리스의 개선 사항
**일반적인 개선 사항**
+ 딕셔너리 폐영역 회수(GC)에 대한 랩 모드 지원
활성화하면 사용하지 않는 딕셔너리 항목이 백그라운드 작업에 의해 정리됩니다. `VolumeBytesUsed`를 줄이지 않고 인덱스에서 새 삽입을 위한 공간을 확보합니다. `VolumeBytesUsed`의 성장률은 딕셔너리 GC를 활성화하면 그렇지 않은 경우에 비해 낮을 수 있습니다. `neptune_streams` 파라미터가 활성화되지 않은 경우 속성 그래프 데이터(Gremlin 또는 openCypher를 통해 삽입됨)에 적용됩니다. 자세한 내용은 [Neptune 딕셔너리 폐영역 회수](storage-gc.md) 섹션을 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항**
+ DFE 엔진을 사용할 때 FreeableMemory에 영향을 미치는 두 가지 메모리 누수 문제를 수정했습니다.
**openCypher 수정 사항**
+ 중복 행에 대해 MERGE ON MATCH/ON CREATE 관련 문제를 해결합니다.
```
UNWIND [1, 1] AS id
MERGE (n:Person {id: id})
ON CREATE SET n.p = 5
ON MATCH SET n.p = 6
```
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.3.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.3.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.3.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.3.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.4.2.0(2024년 12월 19일)
2024년 12월 19일부터 엔진 버전 1.4.2.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**주의**
쿼리에서 숫자 유형 파라미터의 중복 사용을 처리하는 버그로 인해 숫자 파라미터 값과 관련된 파라미터화된 쿼리를 실행하는 사용 사례에서는 쿼리 계획 캐시가 일시적으로 지원되지 않습니다. 예:
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
문 또는 딕셔너리 인덱스에 대한 인덱스 검색을 많이 수행하는 쿼리는 5%의 성능 회귀를 볼 수 있습니다. 예를 들어 모든 버텍스의 수를 가져오거나 모든 버텍스의 `id`를 가져오는 것은 영향을 받지 않습니다. 모든 버텍스의 모든 속성을 가져오면 최대 5%의 회귀를 볼 수 있습니다.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항**
+ OPTIONAL MATCH 및 목록 이해 내에서 동일한 변수를 통해 여러 속성에 액세스할 수 있는 쿼리의 실행 계획 및 성능이 수정되었습니다. 예:
```
MATCH (n)
WHERE n.name = 'A'
OPTIONAL MATCH (n)-[:knows]->(m)
WHERE m.name = 'C' or m.city = 'B'
RETURN m
```
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.2.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.2.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.2.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.2.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.4.1.0(2024년 11월 21일)
2024년 11월 21일부터 엔진 버전 1.4.1.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**주의**
쿼리에서 숫자 유형 파라미터의 중복 사용을 처리하는 버그로 인해 숫자 파라미터 값과 관련된 파라미터화된 쿼리를 실행하는 사용 사례에서는 쿼리 계획 캐시가 일시적으로 지원되지 않습니다. 예제:
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
문 또는 딕셔너리 인덱스에 대한 인덱스 검색을 많이 수행하는 쿼리는 5%의 성능 회귀를 볼 수 있습니다. 예를 들어 모든 버텍스의 수를 가져오거나 모든 버텍스의 `id`를 가져오는 것은 영향을 받지 않습니다. 모든 버텍스의 모든 속성을 가져오면 최대 5%의 회귀를 볼 수 있습니다.
## 이 엔진 릴리스의 새로운 기능
+ 정의된 범위 내에서 작업을 실행할 수 있도록 읽기 전용 하위 쿼리가 있는 `CALL` 하위 쿼리에 대한 지원이 추가되었습니다. `CALL` 하위 쿼리는 수신되는 각 행에 대해 한 번 실행되며 하위 쿼리에 반환된 변수는 엔클로징 쿼리의 외부 범위에 사용할 수 있습니다. 외부 범위의 변수는 가져오기 `WITH` 절을 사용하여 `CALL` 하위 쿼리로 가져올 수 있습니다. 자세한 내용은 [Neptune의 CALL 하위 쿼리 지원](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#call-subquery-support)을 참조하세요.
```
MATCH (origin:airport {code:"AUS"})-[:route]->(stopover)
CALL {
WITH stopover
MATCH (stopover)-[r:route]->(destination)
RETURN destination
ORDER BY r.dist DESC LIMIT 2
}
RETURN stopover, destination
```
+ openCypher 함수를 추가했습니다. 문자열, 컬렉션 작업 및 컬렉션 정렬에 도움이 되는 8가지 새로운 함수를 소개합니다. 이러한 함수로는 `textIndexOf`, `collToSet`, `collSubtract`, `collIntersection`,`collSort`, `collSortMaps`, `collSortMulti`, `collSortNodes`, 이 있습니다. 설명, 입력 파라미터, 출력 및 예제를 보려면 [Neptune openCypher 함수](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#opencypher-compliance-new-functions)를 참조하세요.
## 이 엔진 릴리스의 개선 사항
**Gremlin 개선 사항**
+ 새 랩 모드 파라미터 `AccurateQRCMemoryEstimation`. [Gremlin 쿼리 결과 캐시](https://docs.aws.amazon.com//neptune/latest/userguide/gremlin-results-cache.html)를 활성화하면 데이터베이스에서 쿼리 결과를 캐싱할 수 있습니다. 기본적으로 대략적인 추정치는 캐시된 결과의 크기를 결정하는 데 사용됩니다. 이 랩 모드 파라미터 `AccurateQRCMemoryEstimation`이 활성화되면 캐시된 결과의 크기 추정에 근사치 대신 정확한 크기 추정이 사용됩니다.
+ 기본 실행 엔진에서 실행되는 Gremlin 쿼리에서 "not" 필터 최적화 문제를 수정했습니다. 이 문제는 outV()/inV()/otherV() 단계 중 하나와 결합된 not() 단계를 사용하여 엣지를 필터링할 때 쿼리에 영향을 미쳤습니다. 샘플 쿼리는 다음과 같습니다.
+ `g.E().hasLabel("knows").not(outV().hasId("5"))`
+ `g.V().has('airport','code','SDF').outE().where(not(otherV().has(id, within('1','5','7')))).count()`
**openCypher 개선 사항**
+ 대규모 정적 목록 또는 맵을 사용하는 쿼리의 성능이 개선되었습니다. 속성이 있는 노드를 삽입/업서트하는 데 사용되는 많은 중첩 맵 목록에 대해 UNWIND가 있는 특정 쿼리는 성능이 크게 향상됩니다.
+ 쿼리에 사용되는 값에 대해 일관된 데이터 유형을 가정하도록 엔진에 지시하는 새로운 openCypher 쿼리 힌트를 소개합니다. 새 openCypher 쿼리 힌트에 대한 자세한 내용은 [AssumeConsistentDataTypes](https://docs.aws.amazon.com//neptune/latest/userguide/opencypher-query-hints-AssumeConsistentDataTypes.html)를 참조하세요.
+ 텍스트 및 컬렉션 값을 처리하기 위한 [새로운 openCypher 함수](https://docs.aws.amazon.com//neptune/latest/userguide/access-graph-opencypher-extensions.html#opencypher-compliance-new-functions) 세트를 소개합니다.
## 이 엔진 릴리스에서 수정된 결함
**Gremlin 수정 사항**
+ `GraphTraversalSource` "g" 객체에서 `withStrategies()/withoutStrategies()/with()` 단계를 사용할 때 순회 쿼리의 바이트코드 표현을 빌드하기 위한 TinkerPop OSS 코드 경로의 문제를 수정했습니다. 이 문제는 동일한 전략에 대한 기존 지침을 대체하는 대신 Bytecode에 새 지침을 잘못 추가했으며 결과 캐시 무효화 중에 캐시 키 불일치로 인해 저장된 결과가 지워졌습니다.
**openCypher 수정 사항**
+ CREATE/MERGE/MATCH 절의 ``~id`match`에 대한 동작을 수정했습니다. null 또는 비문자열 유형과 같은 잘못된 ``~id`` 값을 사용하는 경우 이제 CREATE/MERGE 절의 경우 올바른 예외가 발생하고 `MATCH` 절의 경우 0개의 결과가 반환됩니다.
+ 사용자가 집계 함수(예: sum())와 함께 지원되지 않는 유형의 값을 사용할 때 IFE가 수정되었습니다.
+ 많은 쿼리 워크로드의 지연 시간이 짧은 일부 변형 쿼리가 OutOfMemory 오류로 인해 실패하는 문제를 수정했습니다.
**SPARQL 수정 사항**
+ `'%'` 문자가 포함된 SPARQL 쿼리를 처리할 때 발생하는 감사 로그 문제를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.1.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.1.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.1.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.1.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼과 [AWSPremium](https://aws.amazon.com/support) AWSSupport를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.4.0.0(2024년 11월 6일)
2024년 11월 6일부터 엔진 버전 1.4.0.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
[엔진 릴리스 1.3.0.0](engine-releases-1.3.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.3.0.0 이전 엔진 버전에서 엔진 버전 1.3.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.3`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1` 또는 `neptune1.2`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.3.0.0 이상에서는 작동하지 않습니다. 마찬가지로 엔진 버전 1.4.0.0 이상에는 1.4.0.0 클러스터 파라미터 그룹을 사용해야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
**주의**
쿼리에서 숫자 유형 파라미터의 중복 사용을 처리하는 버그로 인해 숫자 파라미터 값과 관련된 파라미터화된 쿼리를 실행하는 사용 사례에서는 쿼리 계획 캐시가 일시적으로 지원되지 않습니다. 예제:
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
문 또는 딕셔너리 인덱스에 대한 인덱스 검색을 많이 수행하는 쿼리는 5%의 성능 회귀를 볼 수 있습니다. 예를 들어 모든 버텍스의 수를 가져오거나 모든 버텍스의 `id`를 가져오는 것은 영향을 받지 않습니다. 모든 버텍스의 모든 속성을 가져오면 최대 5%의 회귀를 볼 수 있습니다.
## 이 엔진 릴리스의 새로운 기능
+ 명시적 ID가 없는 속성 그래프에 엣지가 추가되면 기본적으로 서버는 UUID 기반 엣지 ID를 할당하며, 이는 사전에 저장됩니다. 이제 서버는 새 클러스터 파라미터 `neptune_enable_server_generated_edge_id = 1`을 설정하여 사전 오버헤드 없이 내부 관리형 8바이트 정수를 사용하여 IDs를 할당합니다. 따라서 쿼리를 변경하지 않고도 스토리지를 절약하고 쿼리 성능을 개선할 수 있습니다. 이 기능은 현재 Gremlin 쿼리 언어를 통한 삽입에만 지원됩니다.
+ DFE 엔진의 중첩 순회에서 Gremlin limit() 단계 실행에 대한 지원이 추가되었습니다.
```
g.V().project("foo").by(out().order().by(T.id).limit(1))
```
## 이 엔진 릴리스의 개선 사항
**일반적인 개선 사항**
+ 트랜잭션이 완료되고 로그가 복구에 더 이상 필요하지 않으면 Neptune은 대규모 트랜잭션이 보유한 실행 취소 스토리지를 자동으로 회수합니다.
+ 글로벌 데이터베이스 유지 가능 복제본에 대한 지원이 추가되었습니다. 이 기능을 사용하면 기본 클러스터에서 라이터 인스턴스를 다시 시작하는 동안 보조 클러스터가 읽기 요청을 계속 처리할 수 있습니다. 이전에는 라이터 인스턴스가 재시작될 때, 보조 클러스터의 모든 리더 인스턴스도 함께 재시작되었습니다. 이번 릴리스에서는 보조 클러스터 리더 인스턴스가 라이터 인스턴스 재시작 중에도 계속해서 읽기 요청을 처리하여 클러스터 내 읽기 가용성을 향상시킵니다.
+ 이제 감사 로그가 동기식으로 작성되므로 모든 쿼리가 로깅됩니다. 이는 특히 대규모 쿼리(>100kb) 또는 고처리량 워크로드(>1000qps)의 성능에 영향을 미칠 수 있습니다.
**Gremlin 개선 사항**
+ 쿼리당 제한 시간은 기본적으로 클러스터 수준 제한 시간보다 작게 적용됩니다. 이전 릴리스에서는 이 검사가 도입되었지만 랩 모드 파라미터 'StrictTimeoutValidation'을 통해 명시적으로 활성화해야 했습니다. 이 릴리스에서는 'StrictTimeoutValidation'이 기본적으로 활성화되어 있으며 이전 동작을 유지하려면 명시적으로 비활성화해야 합니다.
**openCypher 개선 사항**
+ 이전 릴리스에서는 랩 모드 파라미터 `DatetimeMillisecond`를 통해 활성화된 [확장된 날짜/시간 형식 지원](https://docs.aws.amazon.com//neptune/latest/userguide/feature-opencypher-compliance.html#opencypher-compliance-time-na)을 도입했습니다. 이제 이 확장된 날짜/시간 형식 지원이 기본적으로 활성화됩니다.
**SPARQL 개선 사항**
+ 쿼리 권한에 대한 새로운 명시적 IAM 작업입니다.
```
Previously:
COPY: WriteDataViaQuery & ReadDataViaQuery
MOVE: WriteDataViaQuery & DeleteDataViaQuery
DELETEINSERT: ReadDataViaQuery & DeleteDataViaQuery
Now,
COPY: WriteDataViaQuery & ReadDataViaQuery & DeleteDataViaQuery
MOVE: WriteDataViaQuery & ReadDataViaQuery & DeleteDataViaQuery
DELETEINSERT: ReadDataViaQuery, WriteDataViaQuery if there is INSERT clause, DeleteDataViaQuery if there is DELETE clause.
```
## 이 엔진 릴리스에서 수정된 결함
**일반적인 수정 사항:**
+ 확장 중에 데이터베이스가 다시 시작될 수 있는 서버리스 인스턴스 문제를 수정했습니다.
+ 다운로드 또는 교체 시 로그 파일에 액세스할 수 없고 경우에 따라 CPU 사용량이 증가할 수 있는 감사 로그 파일 관리 관련 문제를 해결했습니다.
+ DFE 엔진에서 맵 출력 생성 지연 최적화와 관련된 쿼리 문제를 수정했습니다.
+ 감사 로그와 느린 쿼리 로그 간에 타임스탬프가 일치하지 않는 문제를 수정했습니다.
**Gremlin 수정 사항**
+ Gremlin WebSocket 연결 관리에서 연결 유휴 제한 시간을 초과하여 실행 중인 쿼리가 조기에 종료되는 문제를 해결했습니다. 이는 특히 AIOHTTP 전송을 사용하는 Python Gremlin 클라이언트에 영향을 미쳤습니다.
**openCypher 수정 사항**
+ collect(distinct(n)) 쿼리 구성 중에 null 값이 있을 때 내부 실패 예외가 발생하는 수집 단계의 문제를 수정했습니다.
+ 쿼리 계획 캐시가 활성화된 경우 쿼리에서 `NullPointerException`이 발생할 수 있는 문제를 수정했습니다.
+ 쿼리에 LIMIT 절이 포함된 경우 필요한 것보다 많은 데이터를 평가한 문제를 수정했습니다.
+ 쿼리 계획 캐시가 있는 파라미터화된 쿼리에서 범위 작업(<, <=, >, >=)을 사용하면 중복 결과가 발생하는 문제를 수정했습니다.
+ 볼트 연결을 사용하여 UNION 및 UNION ALL 작업을 수행할 때 결과 열을 바꾸는 문제를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.4.0.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.4.0.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.4.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.4.0.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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) 단원을 참조하십시오. 질문이나 우려 사항이 있는 경우 커뮤니티 포럼과 [AWSPremium](https://aws.amazon.com/support) AWSSupport를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.3.4.0(2024년 10월 1일)
2024년 10월 1일부터 엔진 버전 1.3.4.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
[엔진 릴리스 1.3.0.0](engine-releases-1.3.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.3.0.0 이전 엔진 버전에서 엔진 버전 1.3.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.3`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1` 또는 `neptune1.2`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.3.0.0 이상에서는 작동하지 않습니다. 마찬가지로 엔진 버전 1.4.0.0 이상에는 1.4.0.0 클러스터 파라미터 그룹을 사용해야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
**주의**
작업 기반 권한 부여 정책에 업데이트 연산자를 사용할 때 특정 조건에서 존재할 수 있는 SPARQL 1.1 업데이트 작업에서 문제가 감지되었습니다. 작업 기반 권한 부여 정책과 함께 SPARQL 1.1 업데이트 작업을 사용하는 경우이 문제에 대한 수정 사항이 포함된 최신 Neptune 마이너 엔진 버전(최소 1.3.4.0)으로 업그레이드하는 것이 좋습니다.
다음 쿼리와 같이 숫자 유형 파라미터의 중복 사용을 처리하는 문제로 인해 숫자 파라미터 값과 관련된 파라미터화된 쿼리에 대해 쿼리 계획 캐시가 일시적으로 비활성화되었습니다.
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
## 이 엔진 릴리스의 개선 사항
+ DFE 엔진의 중첩 순회에서 Gremlin limit() 단계 실행에 대한 지원이 추가되었습니다.
+ 아래에 나열된 Gremlin 결과 캐시와 관련된 CloudWatch 지표가 추가되어 결과 캐시 지연 시간을 진단하고 조정하는 데 유용할 수 있습니다. 자세한 내용은 [Neptune 지표](https://docs.aws.amazon.com//neptune/latest/userguide/cw-metrics.html#cw-metrics-available)를 참조하세요.
```
NumResultCacheHit
NumResultCacheMiss
ResultCacheSizeInBytes
ResultCacheItemCount
ResultCacheOldestItemTimestamp
ResultCacheNewestItemTimestamp
```
## 이 엔진 릴리스에서 수정된 결함
**일반적인 개선 사항**
+ 드문 경우지만 쿼리 오류를 반환하는 대신 엔진이 충돌하는 문제를 수정했습니다.
**Gremlin 수정 사항**
+ 클라이언트 또는 프록시가 설정된/사용된 HTTP 연결을 통해 웹 소켓 업그레이드 요청을 전송할 때 요청 처리 및 오류 보고를 개선했습니다(이전에는 "gremlin 스크립트가 제공되지 않음, 코드 MissingParameterException" 오류가 포함된 400개의 응답이 반환됨).
+ 단일 카디널리티 속성 값 업데이트를 사용하여 `mergeV` 단계 처리를 최적화했습니다. 예를 들어 아래 쿼리는 이제 Neptune에서 기본적으로 지원됩니다.
```
g.mergeV([(T.id): 1234]). option(onMatch, ['age': single(20), 'name': single('alice'), 'city': set('miami')])
```
+ 에서 쿼리가 실패하는 Gremlin DFE 쿼리 평가 문제를 수정했습니다`InternalFailureException`. 이 오류는 다음 예제와 `select` 같이의 특정 패턴에서 발생했습니다.
```
g.V("1").as("a").as("b").select("a","b").dedup()
```
**openCypher 수정 사항**
+ null 값으로 `collect(distinct())`를 실행하면 오류가 반환되는 문제를 수정했습니다.
+ 범위 필터(파라미터 값에 대해 />=)가 포함된 파라미터화된 쿼리를 실행하면 결과가 중복되거나 누락되는 문제를 수정했습니다.
+ DFE 엔진이 제한 쿼리에서 요청된 것보다 더 많은 출력을 생성하여 메모리 부족 오류가 발생할 수 있는 버그를 수정했습니다.
**SPARQL 수정 사항**
+ IAM 인증 지원 클러스터에서 페더레이션 SPARQL 업데이트 쿼리를 실행하여 오류가 반환되는 문제를 수정했습니다.
+ SPARQL 1.1 업데이트 작업에 대한 작업 기반 권한을 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.3.4.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.3.4.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.3.4.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.4.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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](https://aws.amazon.com/support) AWS Support를 통해 지원 팀을 이용할 수 있습니다.
# Amazon Neptune 엔진 버전 1.3.3.0(2024년 8월 5일)
2024년 8월 5일부터 엔진 버전 1.3.3.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
[엔진 릴리스 1.3.0.0](engine-releases-1.3.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.3.0.0 이전 엔진 버전에서 엔진 버전 1.3.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.3`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1` 또는 `neptune1.2`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.3.0.0 이상에서는 작동하지 않습니다. 마찬가지로 엔진 버전 1.4.0.0 이상에는 1.4.0.0 클러스터 파라미터 그룹을 사용해야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
**주의**
엔진 릴리스 1.3.3.0에는 알아야 할 몇 가지 잠재적 문제가 도입되었습니다. 자세한 내용은 아래의 [릴리스 1.3.3.0의 문제 완화](#1.3.3.0-mitigation) 섹션을 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 개선 사항**
+ 조건자 캐시에 조건자가 많을 때 엔진이 불안정해지는 문제를 수정했습니다.
**openCypher 수정 사항**
+ 내부 예외가 발생한 후에도 쿼리 실행이 중단된 상태로 유지될 수 있는 문제를 수정했습니다.
+ 쿼리 계획 캐시를 사용할 때 내부 예외로 쿼리가 실패할 수 있는 문제를 수정했습니다.
**SPARQL 수정 사항**
+ 작업 기반 권한 부여 정책과 함께 GSP를 사용할 때 특정 조건에서 존재할 수 있는 SPARQL 1.1 Graph Store HTTP 프로토콜(GSP) 문제를 수정했습니다.
## 릴리스 1.3.3.0의 문제 완화
+ 숫자 필터 값을 사용하는 쿼리는 쿼리 계획 캐시를 사용할 때 잘못된 결과를 반환할 수 있습니다. 문제를 방지하려면 쿼리 힌트 `QUERY:PLANCACHE "disabled"`를 사용하여 쿼리 계획 캐시를 건너뜁니다. 예를 들어, 다음을 사용합니다.
```
USING QUERY:PLANCACHE "disabled"
MATCH (n:person)
WHERE n.yearOfBirth > $year
RETURN n
parameters={"year":1950}
```
+ 동일한 파라미터 이름을 여러 번 사용하는 쿼리는 다음 오류가 발생하여 실패할 수 있습니다. `Parameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled` 이러한 경우 위와 같은 쿼리 계획 캐시를 건너뛰거나이 예제와 같이 파라미터를 복제합니다.
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
힌트 `QUERY:PLANCACHE "disabled"`를 사용하거나 파라미터를 수정합니다.
```
MATCH (n:movie) WHERE n.runtime>=$rt_min RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$dur_min RETURN n
parameters={"rt_min":130, "dur_min":130}
```
+ Bolt 프로토콜로 실행된 쿼리는 쿼리가 UNION 또는 UNION ALL 쿼리인 경우 잘못된 결과를 생성할 수 있습니다. 문제를 방지하려면 HTTP 엔드포인트를 사용하여 특정 쿼리를 실행하는 것이 좋습니다. 또는 Bolt 프로토콜을 사용할 때 유니언의 각 부분을 개별적으로 실행합니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.3.3.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.3.3.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.3.3.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.3.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.3.2.1(2024년 6월 20일)
2024년 6월 20일부터 엔진 버전 1.3.2.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
[엔진 릴리스 1.3.0.0](engine-releases-1.3.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.3.0.0 이전 엔진 버전에서 엔진 버전 1.3.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.3`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1` 또는 `neptune1.2`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.3.0.0 이상에서는 작동하지 않습니다. 마찬가지로 엔진 버전 1.4.0.0 이상에는 1.4.0.0 클러스터 파라미터 그룹을 사용해야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
**주의**
엔진 릴리스 1.3.2.1에는 알아야 할 몇 가지 잠재적 문제가 도입되었습니다. 자세한 내용은 아래의 [릴리스 1.3.2.1의 문제 완화](#1.3.2.1-mitigation) 섹션을 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
**openCypher 수정 사항**
+ `SKIP` 및 `LIMIT`를 파라미터로 사용하는 내부 `WITH` 절이 포함된 파라미터화된 쿼리에 대한 쿼리 계획 캐시 기능에서 버그가 감지되었습니다. SKIP/LIMIT 값이 제대로 파라미터화되지 않았으므로 다른 파라미터 값을 가진 동일한 캐시된 쿼리 계획의 후속 실행은 여전히 첫 번째 실행과 동일한 결과를 반환합니다. 이 문제는 수정되었습니다.
```
# insert some nodes
UNWIND range(1, 10) as i CREATE (s {name: i}) RETURN s
# sample query
MATCH (p)
WITH p ORDER BY p.name SKIP $s LIMIT $l
RETURN p.name as res
# first time executing with {"s": 2, "l": 1}
{
"results" : [ {
"res" : 3
} ]
}
# second time executing with {"s": 2, "l": 10}
# due to bug, produces
{
"results" : [ {
"res" : 3
} ]
}
# with fix, produces correct results:
{
"results" : [ {
"res" : 3
}, {
"res" : 4
}, {
"res" : 5
}, {
"res" : 6
}, {
"res" : 7
}, {
"res" : 8
}, {
"res" : 9
}, {
"res" : 10
} ]
}%
```
+ 전달된 파라미터가 데이터베이스에 아직 없는 경우 파라미터화된 변형 쿼리가 `InternalFailureException`을 발생시키는 버그를 수정했습니다.
+ 쿼리 리소스 정리 중에 교착 상태에 도달한 후 파라미터화된 Bolt 쿼리가 멈춘 버그를 수정했습니다.
## 1.3.2.0에서 이월된 1.3.2.1의 변경 사항
### 엔진 릴리스 1.3.2.0에서 이월된 개선 사항
**일반적인 개선 사항**
+ TLS\$1AES\$1128\$1GCM\$1SHA256 및 TLS\$1AES\$1256\$1GCM\$1SHA384 암호 제품군을 포함하여 TLS 버전 1.3에 대한 지원이 추가되었습니다. TLS 1.3은 옵션입니다. TLS 1.2는 여전히 최소값입니다.
+ dateime 형식에 대한 openCypher 확장 지원은 이 버전의 lab\$1mode에 있습니다. 테스트하는 것이 좋습니다.
**Gremlin 개선 사항**
+ TinkerPop 3.7.x 업그레이드
+ Gremlin 언어의 대규모 확장을 제공합니다.
+ 문자열, 목록 및 날짜를 처리하는 새로운 단계입니다.
+ `mergeV()` 단계 내에서 카디널리티를 지정하는 새로운 구문입니다.
+ 이제 `union()` 함수를 시작 단계로 사용할 수 있습니다.
+ 3.7.x의 변경 사항에 대한 자세한 내용은 [TinkerPop 업그레이드 설명서](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_tinkerpop_3_7_1)를 참조하세요.
+ Java용 클라이언트 Gremlin 언어 드라이버를 업그레이드할 때 serializer 클래스의 [이름 바꾸기](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming)가 취소되었습니다. 지정된 경우 구성 파일 및 코드에서 패키지 및 클래스 이름을 업데이트해야 합니다.
+ `StrictTimeoutValidation`(랩모드 `StrictTimeoutValidation`을 통해 `StrictTimeoutValidation=enabled`를 포함하여 활성화된 경우에만 해당): `StrictTimeoutValidation` 파라미터의 값이 `enabled`인 경우, 요청 옵션 또는 쿼리 힌트로 지정된 쿼리별 제한 시간 값은 파라미터 그룹에서 전역으로 설정된 값을 초과할 수 없습니다. 이 경우 Neptune은 `InvalidParameterException`을 발생시킵니다. 이 설정은 값이 `disabled`일 때 `/status` 엔드포인트의 응답에서 확인할 수 있으며, Neptune 버전 1.3.2.0 및 1.3.2.1에서 이 파라미터의 기본값은 `Disabled`입니다.
**openCypher 개선 사항**
+ Amazon Neptune 엔진 버전 1.3.2.0은 이전 엔진 릴리스에 비해 openCypher 쿼리 성능에 대해 최대 9배 더 빠른 처리량과 10배 더 높은 처리량을 제공합니다.
+ 지연 시간이 짧은 쿼리 및 처리량 성능 개선: 지연 시간이 짧은 openCypher 쿼리에 대한 전반적인 성능 개선. 또한 새 버전은 이러한 쿼리의 처리량을 개선합니다. 파라미터화된 쿼리를 사용할 때 개선 사항이 더 중요합니다.
+ 쿼리 계획 캐시 지원: 쿼리가 Neptune에 제출되면 쿼리 문자열이 구문 분석, 최적화 및 쿼리 계획으로 변환된 다음 엔진에서 실행됩니다. 애플리케이션은 종종 서로 다른 값으로 인스턴스화되는 일반적인 쿼리 패턴에 의해 지원됩니다. 쿼리 계획 캐시는 쿼리 계획을 캐싱하여 반복되는 패턴에 대한 구문 분석 및 최적화를 방지함으로써 전체 지연 시간을 줄일 수 있습니다. 자세한 내용은 [Amazon Neptune의 쿼리 계획 캐시](access-graph-qpc.md) 섹션을 참조하세요.
+ DISTINCT 집계 쿼리의 성능이 개선되었습니다.
+ null 가능한 변수와 관련된 조인의 성능이 개선되었습니다.
+ id(노드/관계) 조건자와 같지 않은가 포함된 쿼리의 성능이 개선되었습니다.
+ 날짜/시간 기능에 대한 지원이 확대되었습니다(`DatetimeMillisecond=enabled`를 포함하여 랩 모드 `DatetimeMillisecond`를 통해서 활성화된 경우에만 해당). 자세한 내용은 [Neptune openCypher 구현의 일시적인 지원(Neptune Analytics 및 Neptune Database 1.3.2.0 이상)](feature-opencypher-compliance.md#opencypher-compliance-time-na) 섹션을 참조하세요.
### 엔진 릴리스 1.3.2.0에서 이월된 결함 수정
**일반적인 개선 사항**
+ Graphlytics 버킷에 대한 액세스를 검증할 때 NeptuneML 오류 메시지가 업데이트되었습니다.
**Gremlin 수정 사항**
+ 경로가 아닌 기여 단계에 레이블이 포함된 시나리오의 경우 DFE 쿼리 번역에서 누락된 레이블 정보를 수정했습니다. 예:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'marko').
has("name", TextP.regex("mark.*")).as("p1").
not(out().has("name", P.within("peter"))).
out().as('p2').
dedup('p1', 'p2')
```
+ 두 개의 DFE 조각에서 쿼리가 실행되고 첫 번째 조각이 만족스럽지 않은 노드에 최적화될 때 발생하는 DFE 쿼리 변환의 `NullPointerException` 버그를 수정했습니다. 예:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'doesNotExists').
has("name", TextP.regex("mark.*")).
inject(1).
V().
out().
has('name', 'vadas')
```
+ by() 모듈레이터 내부에 ValueTraversal이 포함된 쿼리의 입력값이 Map일 때 Neptune이 `InternalFailureException`을 발생시킬 수 있는 버그를 수정했습니다. 예:
```
g.V().
hasLabel("person").
project("age", "name").by("age").by("name").
order().by("age")
```
**openCypher 수정 사항**
+ 메모리 부족(OOM) 상황을 방지하기 위해 UNWIND 작업(예: 값 목록을 개별 값으로 확장)을 개선했습니다. 예:
```
MATCH (n)-->(m)
WITH collect(m) AS list
UNWIND list AS m
RETURN m, list
```
+ UNWIND를 통해 ID가 주입되는 여러 MERGE 작업의 경우 사용자 지정 ID 최적화가 수정되었습니다. 예:
```
UNWIND [{nid: 'nid1', mid: 'mid1'}, {nid: 'nid2', mid: 'mid2'}] as ids
MERGE (n:N {`~id`: ids.nid})
MERGE (m:M {`~id`: ids.mid})
```
+ 속성 액세스를 사용하는 복잡한 쿼리와 양방향 관계를 사용하는 여러 홉을 계획하는 동안 메모리 폭발을 수정했습니다. 예:
```
MATCH (person1:person)-[:likes]->(res)-[:partOf]->(group)-[:knows]-(:entity {name: 'foo'}),
(person1)-[:knows]->(person2)-[:likes]-(res2), (comment)-[:presentIn]->(:Group {name: 'barGroup'}),
(person1)-[:commented]->(comment2:comment)-[:partOf]->(post:Post), (comment2)-[:presentIn]->(:Group {name: 'fooGroup'}),
(comment)-[:contains]->(info:Details)-[:CommentType]->(:CommentType {name: 'Positive'}),
(comment2)-[:contains]->(info2:Details)-[:CommentType]->(:CommentType {name: 'Positive'})
WHERE datetime('2020-01-01T00:00') <= person1.addedAfter <= datetime('2023-01-01T23:59') AND comment.approvedBy = comment2.approvedBy
MATCH (comment)-[:contains]->(info3:Details)-[:CommentType]->(:CommentType {name: 'Neutral'})
RETURN person1, group.name, info1.value, post.ranking, info3.value
```
+ null을 변수별로 그룹화하여 집계 쿼리를 수정했습니다. 예:
```
MATCH (n)
RETURN null AS group, sum(n.num) AS result
```
**SPARQL 수정 사항**
+ 많은 트리플과 큰 토큰이 포함된 INSERT DATA와 같은 대규모 쿼리의 구문 분석 시간을 개선하기 위해 SPARQL 구문 분석기를 수정했습니다.
### 릴리스 1.3.2.1의 문제 완화
+ 숫자 필터 값을 사용하는 쿼리는 쿼리 계획 캐시를 사용할 때 잘못된 결과를 반환할 수 있습니다. 문제를 방지하려면 쿼리 힌트 `QUERY:PLANCACHE "disabled"`를 사용하여 쿼리 계획 캐시를 건너뜁니다. 예를 들어, 다음을 사용합니다.
```
USING QUERY:PLANCACHE "disabled"
MATCH (n:person)
WHERE n.yearOfBirth > $year
RETURN n
parameters={"year":1950}
```
+ 동일한 파라미터 이름을 여러 번 사용하는 쿼리는 다음 오류가 발생하여 실패할 수 있습니다. `Parameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled` 이러한 경우 위와 같은 쿼리 계획 캐시를 건너뛰거나이 예제와 같이 파라미터를 복제합니다.
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
힌트 `QUERY:PLANCACHE "disabled"`를 사용하거나 파라미터를 수정합니다.
```
MATCH (n:movie) WHERE n.runtime>=$rt_min RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$dur_min RETURN n
parameters={"rt_min":130, "dur_min":130}
```
+ Bolt 프로토콜로 실행된 쿼리는 쿼리가 UNION 또는 UNION ALL 쿼리인 경우 잘못된 결과를 생성할 수 있습니다. 문제를 방지하려면 HTTP 엔드포인트를 사용하여 특정 쿼리를 실행하는 것이 좋습니다. 또는 Bolt 프로토콜을 사용할 때 유니언의 각 부분을 개별적으로 실행합니다.
### 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.3.2.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.3.2.1에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.3.2.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.2.1 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.3.2.0(2024년 6월 10일)
2024년 6월 10일부터 엔진 버전 1.3.2.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
[엔진 릴리스 1.3.0.0](engine-releases-1.3.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.3.0.0 이전 엔진 버전에서 엔진 버전 1.3.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.3`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1` 또는 `neptune1.2`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.3.0.0 이상에서는 작동하지 않습니다. 마찬가지로 엔진 버전 1.4.0.0 이상에는 1.4.0.0 클러스터 파라미터 그룹을 사용해야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
**주의**
엔진 릴리스 1.3.2.0에는 알아야 할 몇 가지 잠재적 문제가 도입되었습니다. 자세한 내용은 아래의 [릴리스 1.3.2.0의 문제 완화](#1.3.2.0-mitigation) 섹션을 참조하세요.
## 이 엔진 릴리스의 개선 사항
**일반적인 개선 사항**
+ TLS\$1AES\$1128\$1GCM\$1SHA256 및 TLS\$1AES\$1256\$1GCM\$1SHA384 암호 제품군을 포함하여 TLS 버전 1.3에 대한 지원이 추가되었습니다. TLS 1.3은 옵션입니다. TLS 1.2는 여전히 최소값입니다.
**Gremlin 개선 사항**
+ TinkerPop 3.7.x 업그레이드
+ Gremlin 언어의 대규모 확장을 제공합니다.
+ 문자열, 목록 및 날짜를 처리하는 새로운 단계입니다.
+ `mergeV()` 단계를 사용하여 카디널리티를 지정하는 새로운 구문입니다.
+ 이제 `union()` 함수를 시작 단계로 사용할 수 있습니다.
+ 3.7.x의 변경 사항에 대한 자세한 내용은 [TinkerPop 업그레이드 설명서](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_tinkerpop_3_7_1)를 참조하세요.
+ Java용 클라이언트 Gremlin 언어 드라이버를 업그레이드할 때 serializer 클래스의 [이름 바꾸기](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming)가 취소되었습니다. 지정된 경우 구성 파일 및 코드에서 패키지 및 클래스 이름을 업데이트해야 합니다.
+ `StrictTimeoutValidation`(랩모드 `StrictTimeoutValidation`을 통해 `StrictTimeoutValidation=enabled`를 포함하여 활성화된 경우에만 해당): `StrictTimeoutValidation` 파라미터의 값이 `enabled`인 경우, 요청 옵션 또는 쿼리 힌트로 지정된 쿼리별 제한 시간 값은 파라미터 그룹에서 전역으로 설정된 값을 초과할 수 없습니다. 이 경우 Neptune은 `InvalidParameterException`을 발생시킵니다. 값이 `disabled`인 경우 `/status` 엔드포인트의 응답에서이 설정을 확인할 수 있으며, Neptune 버전 1.3.2.0에서이 파라미터의 기본값은 `Disabled`입니다.
**openCypher 개선 사항**
+ Amazon Neptune 엔진 버전 1.3.2.0은 이전 엔진 릴리스에 비해 openCypher 쿼리 성능에 대해 최대 9배 더 빠른 처리량과 10배 더 높은 처리량을 제공합니다.
+ 지연 시간이 짧은 쿼리 및 처리량 성능 개선: 지연 시간이 짧은 openCypher 쿼리에 대한 전반적인 성능 개선. 또한 새 버전은 이러한 쿼리의 처리량을 개선합니다. 파라미터화된 쿼리를 사용할 때 개선 사항이 더 중요합니다.
+ 쿼리 계획 캐시 지원: 쿼리가 Neptune에 제출되면 쿼리 문자열이 구문 분석, 최적화 및 쿼리 계획으로 변환된 다음 엔진에서 실행됩니다. 애플리케이션은 종종 서로 다른 값으로 인스턴스화되는 일반적인 쿼리 패턴에 의해 지원됩니다. 쿼리 계획 캐시는 쿼리 계획을 캐싱하여 반복되는 패턴에 대한 구문 분석 및 최적화를 방지함으로써 전체 지연 시간을 줄일 수 있습니다.
+ DISTINCT 집계 쿼리의 성능이 개선되었습니다.
+ null 가능한 변수와 관련된 조인의 성능이 개선되었습니다.
+ id(노드/관계) 조건자와 같지 않은가 포함된 쿼리의 성능이 개선되었습니다.
+ 날짜/시간 기능에 대한 지원이 확대되었습니다(`DatetimeMillisecond=enabled`를 포함하여 랩 모드 `DatetimeMillisecond`를 통해서 활성화된 경우에만 해당). 자세한 내용은 [Neptune openCypher 구현의 일시적인 지원(Neptune Analytics 및 Neptune Database 1.3.2.0 이상)](feature-opencypher-compliance.md#opencypher-compliance-time-na) 섹션을 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
**일반적인 개선 사항**
+ Graphlytics 버킷에 대한 액세스를 검증할 때 NeptuneML 오류 메시지가 업데이트되었습니다.
**Gremlin 수정 사항**
+ 경로가 아닌 기여 단계에 레이블이 포함된 시나리오의 경우 DFE 쿼리 번역에서 누락된 레이블 정보를 수정했습니다. 예:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'marko').
has("name", TextP.regex("mark.*")).as("p1").
not(out().has("name", P.within("peter"))).
out().as('p2').
dedup('p1', 'p2')
```
+ 두 개의 DFE 조각에서 쿼리가 실행되고 첫 번째 조각이 만족스럽지 않은 노드에 최적화될 때 발생하는 DFE 쿼리 변환의 `NullPointerException` 버그를 수정했습니다. 예:
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'doesNotExists').
has("name", TextP.regex("mark.*")).
inject(1).
V().
out().
has('name', 'vadas')
```
+ by() 모듈레이터 내부에 ValueTraversal이 포함된 쿼리의 입력값이 Map일 때 Neptune이 `InternalFailureException`을 발생시킬 수 있는 버그를 수정했습니다. 예:
```
g.V().
hasLabel("person").
project("age", "name").by("age").by("name").
order().by("age")
```
**openCypher 수정 사항**
+ 메모리 부족(OOM) 상황을 방지하기 위해 UNWIND 작업(예: 값 목록을 개별 값으로 확장)을 개선했습니다. 예:
```
MATCH (n)-->(m)
WITH collect(m) AS list
UNWIND list AS m
RETURN m, list
```
+ UNWIND를 통해 ID가 주입되는 여러 MERGE 작업의 경우 사용자 지정 ID 최적화가 수정되었습니다. 예:
```
UNWIND [{nid: 'nid1', mid: 'mid1'}, {nid: 'nid2', mid: 'mid2'}] as ids
MERGE (n:N {`~id`: ids.nid})
MERGE (m:M {`~id`: ids.mid})
```
+ 속성 액세스를 사용하는 복잡한 쿼리와 양방향 관계를 사용하는 여러 홉을 계획하는 동안 메모리 폭발을 수정했습니다. 예:
```
MATCH (person1:person)-[:likes]->(res)-[:partOf]->(group)-[:knows]-(:entity {name: 'foo'}),
(person1)-[:knows]->(person2)-[:likes]-(res2), (comment)-[:presentIn]->(:Group {name: 'barGroup'}),
(person1)-[:commented]->(comment2:comment)-[:partOf]->(post:Post), (comment2)-[:presentIn]->(:Group {name: 'fooGroup'}),
(comment)-[:contains]->(info:Details)-[:CommentType]->(:CommentType {name: 'Positive'}),
(comment2)-[:contains]->(info2:Details)-[:CommentType]->(:CommentType {name: 'Positive'})
WHERE datetime('2020-01-01T00:00') <= person1.addedAfter <= datetime('2023-01-01T23:59') AND comment.approvedBy = comment2.approvedBy
MATCH (comment)-[:contains]->(info3:Details)-[:CommentType]->(:CommentType {name: 'Neutral'})
RETURN person1, group.name, info1.value, post.ranking, info3.value
```
+ null을 변수별로 그룹화하여 집계 쿼리를 수정했습니다. 예:
```
MATCH (n)
RETURN null AS group, sum(n.num) AS result
```
**SPARQL 수정 사항**
+ 많은 트리플과 큰 토큰이 포함된 INSERT DATA와 같은 대규모 쿼리의 구문 분석 시간을 개선하기 위해 SPARQL 구문 분석기를 수정했습니다.
## 릴리스 1.3.2.0의 문제 완화
+ 버전 1.3.2.0의 경우 `skip` 또는 `limit`가 내부 `WITH` 절에서 사용되고 파라미터가 지정될 때 쿼리 계획 캐시에서 문제를 감지했습니다. 예:
```
MATCH (n:Person)
WHERE n.age > $age
WITH n skip $skip LIMIT $limit
RETURN n.name, n.age
parameters={"age": 21, "skip": 2, "limit": 3}
```
이 경우 첫 번째 계획의 건너뛰기 및 제한에 대한 파라미터 값이 후속 쿼리에도 적용되어 예기치 않은 결과가 발생합니다.
**완화**
이 문제를 방지하려면 파라미터화된 건너뛰기 및/또는 제한 하위 섹션이 포함된 쿼리를 제출할 때 쿼리 힌트 `QUERY:PLANCACHE "disabled"`를 추가합니다. 또는 값을 쿼리로 하드 코딩할 수 있습니다.
**옵션 1:** 쿼리 힌트를 사용하여 계획 캐시 비활성화:
```
Using QUERY:PLANCACHE "disabled"
MATCH (n:Person) WHERE n.age > $age
WITH n skip $skip LIMIT $limit
RETURN n.name, n.age
parameters={"age": 21, "skip": 2, "limit": 3}
```
**옵션 2:** 건너뛰기 및 제한에 하드 코딩된 값 사용:
```
MATCH (n:Person)
WHERE n.age > $age
WITH n skip 2 LIMIT 3
RETURN n.name, n.age
parameters={"age": 21}
```
+ 숫자 필터 값을 사용하는 쿼리는 쿼리 계획 캐시를 사용할 때 잘못된 결과를 반환할 수 있습니다. 문제를 방지하려면 쿼리 힌트 `QUERY:PLANCACHE "disabled"`를 사용하여 쿼리 계획 캐시를 건너뜁니다. 예를 들어, 다음을 사용합니다.
```
USING QUERY:PLANCACHE "disabled"
MATCH (n:person)
WHERE n.yearOfBirth > $year
RETURN n
parameters={"year":1950}
```
+ 동일한 파라미터 이름을 여러 번 사용하는 쿼리는 다음 오류가 발생하여 실패할 수 있습니다. `Parameter name should not be a number and/or contain _internal_ or _modified_user_ string within it. These are reserved for planCache. Otherwise, rerun with HTTP parameter planCache=disabled` 이러한 경우 위와 같은 쿼리 계획 캐시를 건너뛰거나이 예제와 같이 파라미터를 복제합니다.
```
MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$minutes RETURN n
parameters={"minutes":130}
```
힌트 `QUERY:PLANCACHE "disabled"`를 사용하거나 파라미터를 수정합니다.
```
MATCH (n:movie) WHERE n.runtime>=$rt_min RETURN n
UNION
MATCH (n:show) WHERE n.duration>=$dur_min RETURN n
parameters={"rt_min":130, "dur_min":130}
```
+ Bolt 프로토콜로 실행된 쿼리는 쿼리가 UNION 또는 UNION ALL 쿼리인 경우 잘못된 결과를 생성할 수 있습니다. 문제를 방지하려면 HTTP 엔드포인트를 사용하여 특정 쿼리를 실행하는 것이 좋습니다. 또는 Bolt 프로토콜을 사용할 때 유니언의 각 부분을 개별적으로 실행합니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.3.2.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.7.1`
+ *Gremlin 최신 버전 지원:* `3.7.1`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.3.2.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.3.2.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.2.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.3.1.0(2024년 3월 6일)
2024년 3월 6일부터 엔진 버전 1.3.1.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
[엔진 릴리스 1.3.0.0](engine-releases-1.3.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.3.0.0 이전 엔진 버전에서 엔진 버전 1.3.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.3`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1` 또는 `neptune1.2`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.3.0.0 이상에서는 작동하지 않습니다. 마찬가지로 엔진 버전 1.4.0.0 이상에는 1.4.0.0 클러스터 파라미터 그룹을 사용해야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
## 이 엔진 릴리스의 개선 사항
**일반적인 개선 사항**
+ Neptune은 프로필/설명에 표시된 경고를 개선했습니다.
+ TLS 협상 중에 사용되는 기본 명명된 그룹에서 더 이상 사용되지 않는 NIST EC 곡선을 제거했습니다. 제거된 곡선은 sect409k1, sect409r1 및 sect571k1입니다.
**Gremlin 개선 사항**
+ Serverless 인스턴스의 NCU가 매우 높지 않도록 DFE 통계 계산을 개선했습니다.
+ WITHIN에 대한 Gremlin 성능 개선
## 이 엔진 릴리스에서 수정된 결함
**Gremlin 수정 사항**
+ Gremlin DFE 쿼리 계획에 대한 기타 개선 사항
+ 예를 들어 친구 엣지가 없는 사람이 그룹화되지 않은 `g.V().hasLabel('person').group().by(id()).by(\$1\$1.in(' friend').id().fold())` 형식의 쿼리에 대한 선택적 순회가 있는 Gremlin 쿼리에 대한 버그가 수정되었습니다.
+ `by` DFE 엔진을 사용하여 실행할 경우 모듈레이터 내의 병합 단계가 포함된 Gremlin 쿼리로 인해 오류가 반환되는 버그를 수정했습니다.
+ 읽기 전용 복제본에 연결할 때 Gremlin 세션에서 실행 중인 읽기 전용 쿼리가 작동하지 않는 버그를 수정했습니다.
+ Gremlin에 대한 성공적인 초기 웹 소켓 연결 요청에 대한 감사 로그에 IAM ARN이 없는 버그가 수정되었습니다.
+ 단계 병합, DFE로 단계 적용 범위 식별
+ 전체 DFE 계획에 대한 특성 집합 최적화
**openCypher 수정 사항**
+ 변형 불가능한 표현식(예: match(n:TEST) set(case when n.prop = 2 then n end).prop = 3 return n.prop)에 대한 설정이 가능하도록 openCypher SET 절의 버그가 수정되었습니다.
+ 집계 및 순서와 관련된 openCypher 쿼리 실패에 대한 버그가 수정되었습니다.
+ 정적 맵이 포함된 큰 목록의 UNWIND가 개선되었습니다.
+ 값이 중복된 사용자 지정 ID를 사용하는 openCypher MERGE 쿼리에 대한 버그가 수정되었습니다.
**SPARQL 수정 사항**
+ 선택적 패턴의 변수 범위에 대한 SPARQL 버그를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.3.1.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.5`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.3.1.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.3.1.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.1.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.3.0.0(2023년 11월 15일)
2023년 11월 15일부터 엔진 버전 1.3.0.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
[엔진 릴리스 1.3.0.0](#engine-releases-1.3.0.0)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.3.0.0 이전 엔진 버전에서 엔진 버전 1.3.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.3`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1` 또는 `neptune1.2`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.3.0.0 이상에서는 작동하지 않습니다. 마찬가지로 엔진 버전 1.4.0.0 이상에는 1.4.0.0 클러스터 파라미터 그룹을 사용해야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
## 이 엔진 릴리스의 새로운 기능
+ [Neptune 데이터 API](data-api.md)가 릴리스되었습니다.
Amazon Neptune 데이터 API는 데이터 로드, 쿼리 실행, 데이터 조회, 기계 학습을 포함하여 Neptune의 데이터 작업 40개 이상에 대한 SDK 지원을 제공합니다. 세 가지 Neptune 쿼리 언어(Gremlin, openCypher, SPARQL)를 모두 지원하며 모든 SDK 언어로 사용할 수 있습니다. API 요청에 자동으로 서명하면 Neptune을 애플리케이션에 매우 간편하게 통합할 수 있습니다.
+ [OpenSearch Serverless](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html)를 Neptune과 통합할 수 있도록 지원을 추가했습니다.
## 이 엔진 릴리스의 개선 사항
**Neptune 엔진 업데이트 개선**
업데이트 프로세스를 더 효과적으로 제어할 수 있도록 Neptune에서 엔진 업데이트를 릴리스하는 방식이 변경되었습니다. 이제 Neptune에서 비 주요 변경 사항에 대한 패치가 릴리스되는 대신 [`AutoMinorVersionUpgrade` 인스턴스 필드를 사용](engine-maintenance-management.md#using-amvu)하여 제어할 수 있고 [`RDS-EVENT-0156`](event-lists.md#RDS-EVENT-0156) 이벤트를 [구독](events-subscribing.md)하여 알림을 받을 수 있는 마이너 버전이 릴리스됩니다.
이러한 변경 사항에 대한 자세한 내용은 [Amazon Neptune DB 클러스터 유지 관리](cluster-maintenance.md)를 참조하세요.
**전송 중 암호화 개선**
Neptune은 더 이상 다음 암호 그룹을 지원하지 않습니다.
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA`
Neptune은 TLS 1.2에서 다음과 같은 강력한 암호 그룹만 지원합니다.
+ `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256`
**Gremlin 개선 사항**
+ DFE 엔진에 다음 Gremlin 단계에 대한 지원이 추가되었습니다.
+ `FoldStep`
+ `GroupStep`
+ `GroupCountStep`
+ `TraversalMapStep `
+ `UnfoldStep`
+ `LabelStep`
+ `PropertyKeyStep`
+ `PropertyValueStep`
+ `AndStep`
+ `OrStep`
+ `ConstantStep`
+ `CountGlobalStep`
+ `by()` 변조를 사용할 때 전체 버텍스 스캔이 발생하지 않도록 Gremlin DFE 쿼리 계획이 최적화되었습니다.
+ 카디널리티가 낮고 지연 시간이 짧은 쿼리의 성능이 크게 개선되었습니다.
+ TinkerPop `Or` 필터 조건자에 대한 DFE 지원이 추가되었습니다.
+ 다음과 같은 쿼리에서 동일한 키의 필터 순회에 대한 DFE 지원이 개선되었습니다.
```
g.withSideEffect("Neptune#useDFE", true)
.V()
.has('name', 'marko')
.and(
or(
has('name', eq("marko")),
has('name', eq("vardas"))
)
)
```
+ `fail()` 단계에 대한 오류 처리가 개선되었습니다.
**openCypher 개선 사항**
+ 카디널리티가 낮고 지연 시간이 짧은 쿼리의 성능이 크게 개선되었습니다.
+ 쿼리에 많은 노드 유형이 포함된 경우 쿼리 계획 성능이 개선되었습니다.
+ 모든 VLP 쿼리의 지연 시간이 단축되었습니다.
+ 단일 노드 패턴 쿼리에 대한 중복 파이프라인 조인을 제거하여 성능이 개선되었습니다.
+ 다음과 같이 주기가 있는 멀티홉 패턴이 포함된 쿼리의 성능이 개선되었습니다.
```
MATCH (n)-->()-->()-->(m)
RETURN n m
```
**SPARQL 개선 사항**
+ 새로운 SPARQL 연산자 `PipelineHashIndexJoin`이 도입되었습니다.
+ SPARQL 쿼리의 URI 검증 성능이 개선되었습니다.
+ 사전 용어를 배치 확인하여 SPARQL 전체 텍스트 검색 쿼리의 성능이 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
**Gremlin 수정 사항**
+ DFE 엔진에서 기본적으로 처리되지 않는 단계에 대한 하위 순회 조건자가 있는 쿼리를 Gremlin 쿼리 상태 엔드포인트에서 검사할 때 트랜잭션 누수가 발생하는 Gremlin 버그가 수정되었습니다.
+ DFE 엔진에서 `by()` 순회의 `valueMap()`이 최적화되지 않는 Gremlin 버그가 수정되었습니다.
+ `UnionStep`에 연결된 단계 레이블이 각각 하위 순회의 마지막 경로 요소로 전파되지 않던 Gremlin 버그가 수정되었습니다.
+ TinkerPop 단계가 너무 많아서 쿼리가 실패하고 정리되지 않는 Gremlin 버그가 수정되었습니다.
+ `mergeV` 및 `mergeE` 단계에서 `NullPointerException`이 발생하는 Gremlin 버그가 수정되었습니다.
+ 문자열 출력 중 일부에 공백 문자가 포함된 경우 `order()`가 적절하게 정렬되지 않는 Gremlin 버그가 수정되었습니다.
+ DFE 엔진에서 `valueMap` 단계를 처리할 때 발생하는 Gremlin 정확성 문제가 해결되었습니다.
+ `GroupStep` 또는 `GroupCountStep`이 키 순회에 중첩될 때 발생하는 Gremlin 정확성 문제가 해결되었습니다.
**openCypher 수정 사항**
+ NULL 문자에 대한 오류 처리와 관련된 OpenCypher 버그가 수정되었습니다.
+ openCypher Bolt 트랜잭션 처리에서 발생하는 버그가 수정되었습니다.
**SPARQL 수정 사항**
+ 재귀 함수 내의 값이 제대로 확인되지 않는 SPARQL 버그가 수정되었습니다.
+ `VALUES` 절을 통해 많은 값을 삽입하면 성능이 저하될 수 있는 SPARQL 버그가 수정되었습니다.
+ 언어 태그가 지정된 리터럴에서 `REGEX` 연산자를 직접적으로 호출할 때 실패하는 SPARQL 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.3.0.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.3.0.0에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.3.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.3.0.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.2.1.2(2024년 8월 5일)
2024년 8월 5일부터 엔진 버전 1.2.1.2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
**주의**
SPARQL 1.1 Graph Store HTTP 프로토콜(GSP)에서 특정 조건 하에 GSP를 작업 기반 권한 부여 정책과 함께 사용할 때 발생할 수 있는 문제가 감지되었습니다. SPARQL 1.1 Graph Store HTTP 프로토콜을 사용 중이며 작업 기반 권한 부여 정책을 적용하고 있다면, 이 문제에 대한 수정 사항이 포함된 최신 Neptune 엔진 소수 버전(최소 1.2.1.2)으로 업그레이드하는 것이 좋습니다.
## 이 엔진 릴리스에서 수정된 결함
**SPARQL 수정 사항**
+ 작업 기반 권한 부여 정책과 함께 GSP를 사용할 때 특정 조건에서 존재할 수 있는 SPARQL 1.1 Graph Store HTTP 프로토콜(GSP) 문제를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.1.2에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.2.1.2 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.2 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.2.1.1(2024년 3월 11일)
2024년 3월 11일부터 엔진 버전 1.2.1.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
**일반적인 개선 사항**
Neptune은 프로필/설명에 표시된 경고를 개선했습니다.
**Gremlin 개선 사항**
+ Serverless 인스턴스의 NCU가 매우 높지 않도록 DFE 통계 계산을 개선했습니다.
+ WITHIN에 대한 Gremlin 성능 개선
## 이 엔진 릴리스에서 수정된 결함
**Gremlin 수정 사항**
+ Gremlin DFE 엔진 쿼리 계획의 순서에 따른 버그가 수정되었습니다.
+ 원래 InternalFailureException으로 보고되었을 때 Gremlin out-of-memory 오류가 있는 버그가 수정되었습니다.
+ 성공적인 초기 웹 소켓 연결 요청에 대한 감사 로그에 IAM ARN이 없는 버그가 수정되었습니다.
+ 세션의 쿼리가 모두 읽기 전용이고 리더 인스턴스에 연결되더라도 실패할 때 TinkerPop 세션이 활성화된 Gremlin 쿼리에 대한 버그가 수정되었습니다.
**openCypher 수정 사항**
+ 변형 불가능한 표현식(예: match(n:TEST) set(case when n.prop = 2 then n end).prop = 3 return n.prop)에 대한 설정이 가능하도록 openCypher SET 절의 버그가 수정되었습니다.
+ 집계 및 순서와 관련된 openCypher 쿼리 실패에 대한 버그가 수정되었습니다.
+ 정적 맵이 포함된 큰 목록의 UNWIND가 개선되었습니다.
+ 값이 중복된 사용자 지정 ID를 사용하는 openCypher MERGE 쿼리에 대한 버그가 수정되었습니다.
**SPARQL 수정 사항**
+ SPARQL DFE 쿼리 플래너의 버그가 수정되었습니다.
+ BIND 및 OPTIONAL 키워드와 함께 사용할 때 SPARQL에 대한 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.1.1에 대한 업그레이드 경로
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md) 이상에서 이 릴리스로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
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.2.1.1 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.1 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.2.1.0(2023년 3월 8일)
2023년 3월 8일부터 엔진 버전 1.2.1.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.2.1.0.R2(2023년 5월 2일)](engine-releases-1.2.1.0.R2.md)
+ [릴리스: 1.2.1.0.R3(2023년 6월 13일)](engine-releases-1.2.1.0.R3.md)
+ [릴리스: 1.2.1.0.R4(2023년 8월 10일)](engine-releases-1.2.1.0.R4.md)
+ [릴리스: 1.2.1.0.R5(2023년 9월 2일)](engine-releases-1.2.1.0.R5.md)
+ [릴리스: 1.2.1.0.R6(2023년 9월 12일)](engine-releases-1.2.1.0.R6.md)
+ [릴리스: 1.2.1.0.R7(2023년 10월 6일)](engine-releases-1.2.1.0.R7.md)
## 이 엔진 릴리스의 새로운 기능
+ [TinkerPop 3.6.2](https://tinkerpop.apache.org/docs/3.6.2-SNAPSHOT/dev/provider/)에 대한 지원이 추가되어 새로운 `mergeV()`, `mergeE()`, `element()`, `fail()` 단계와 같은 많은 새로운 Gremlin 기능이 추가되었습니다. `mergeV()` 및 `mergeE()` 단계는 업서트와 유사한 작업을 수행할 수 있도록 오랫동안 기다려온 선언적 옵션을 제공한다는 점에서 특히 주목할 만합니다. 이 옵션을 사용하면 기존 코드 패턴을 크게 단순화하고 Gremlin을 더 쉽게 읽을 수 있습니다. 또한 3.6.x 버전에는 regex 조건자가 추가되어 `Map`을 사용하는 `property()` 단계에 새로운 오버로드가 적용되었으며, 이를 사용하는 모든 단계에서 훨씬 더 일관된 `by()` 변조 동작이 주요한 수정 사항입니다.
버전 3.6의 변경 사항 및 업그레이드 시 고려해야 할 사항에 대한 정보는 [TinkerPop 변경 로그](https://github.com/apache/tinkerpop/blob/3.6.0/CHANGELOG.asciidoc#release-3-6-0) 및 [업그레이드 페이지](https://tinkerpop.apache.org/docs/current/upgrade/)를 참조하시기 바랍니다.
조건부 삽입에 `fold().coalesce(unfold(), )`를 사용하는 경우 [여기](https://tinkerpop.apache.org/docs/3.6.0/reference/#mergevertex-step) 및 [여기](https://tinkerpop.apache.org/docs/3.6.0/reference/#mergeedge-step)에 설명된 새 `mergeV/E()` 구문으로 마이그레이션하는 것이 좋습니다. Neptune은 `Coalesce`보다 `Merge`에서 더 제한된 잠금 패턴을 사용하므로 동시 수정 예외(CME)를 줄일 수 있습니다.
이번 TinkerPop 릴리스에서 사용할 수 있는 새로운 기능에 대한 자세한 내용은 Stephen Mallette의 블로그의 [Amazon Neptune에서 제공되는 Apache TinkerPop 3.6.x의 새로운 기능 살펴보기](https://aws.amazon.com/blogs/database/exploring-new-features-of-apache-tinkerpop-3-6-x-in-amazon-neptune/)를 참조하시기 바랍니다.
+ 3세대 Intel Xeon 스케일러블 프로세서 기반 [R6i 인스턴스 유형](https://aws.amazon.com/ec2/instance-types/r6i/)에 대한 지원이 추가되었습니다. 메모리 집약적인 워크로드에 적합하며, 동급 R5 인스턴스 유형보다 최대 15% 더 우수한 가격 대비 컴퓨팅 성능과 vCPU당 최대 20% 더 높은 메모리 대역폭을 제공합니다.
+ 속성 그래프와 RDF 그래프 모두에 [그래프 요약 API](neptune-graph-summary.md) 엔드포인트가 추가되어 그래프에 대한 간단한 요약 보고서를 확인할 수 있습니다.
속성(PG) 그래프의 경우 그래프 요약 API는 노드, 엣지, 속성의 개수와 함께 노드 및 엣지 레이블과 속성 키의 읽기 전용 목록을 제공합니다. RDF 그래프의 경우 쿼드, 주제, 조건자와 함께 클래스 및 조건자 키 목록을 제공합니다.
새 그래프 요약 API와 함께 다음과 같은 변경 사항이 적용되었습니다.
+ [GetGraphSummary](iam-dp-actions.md#getgraphsummary) 데이터 영역 작업이 새로 추가되었습니다.
+ 더 이상 지원되지 않는 `sparql/statistics` 엔드포인트를 대체할 새 `rdf/statistics` 엔드포인트가 추가되었습니다.
+ 통계 상태 응답의 `summary` 필드 이름을 `signatureInfo`로 변경하여 그래프 요약 정보와 혼동하지 않도록 했습니다. 이전 엔진 버전은 JSON 응답에서 `summary`를 계속 사용합니다.
+ 통계 상태 응답의 `date` 필드 정밀도가 분에서 밀리초로 변경되었습니다. 이전은 `2020-05-07T23:13Z`(분 정밀도) 형식이고 이제 `2023-01-24T00:47:43.319Z`(밀리초 정밀도) 형식으로 변경되었습니다. 둘 다 ISO 8601을 준수하지만 이 변경으로 인해 날짜가 구문 분석되는 방식에 따라 기존 코드가 손상될 수 있습니다.
+ Workbench에 DFE 엔진 통계를 가져올 수 있는 새로운 [`%statistics`](notebooks-magics.md#notebooks-line-magics-statistics) 라인 매직이 추가되었습니다.
+ Workbench에 그래프 요약 정보를 가져올 수 있는 새로운 [`%summary`](notebooks-magics.md#notebooks-line-magics-summary) 라인 매직이 추가되었습니다.
+ 지정된 기준값보다 실행 시간이 오래 걸리는 로그 쿼리에 [슬로우 쿼리 로깅](slow-query-logs.md)이 추가되었습니다. 두 개의 새로운 동적 파라미터, 즉 [neptune\$1enable\$1slow\$1query\$1log](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log) 및 [neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold)를 사용하여 슬로우 쿼리 로깅을 사용하고 제어할 수 있습니다.
+ 두 개의 [동적 파라미터](parameter-groups.md), 즉 새 클러스터 파라미터인 [neptune\$1enable\$1slow\$1query\$1log](parameters.md#parameters-db-cluster-parameters-neptune_enable_slow_query_log) 및 [neptune\$1slow\$1query\$1log\$1threshold](parameters.md#parameters-db-cluster-parameters-neptune_slow_query_log_threshold)에 대한 지원이 추가되었습니다. 동적 파라미터를 변경하면 인스턴스가 재부팅 없이 즉시 적용됩니다.
+ 맵에서 지정된 키를 제거하고 결과로 생성되는 새 맵을 반환하는 Neptune 전용 openCypher [removeKeyFromMap()](access-graph-opencypher-extensions.md#opencypher-compliance-removeKeyFromMap-function) 함수가 추가되었습니다.
## 이 엔진 릴리스의 개선 사항
+ 로컬 범위가 있는 `limit` 단계에 대한 Gremlin DFE 지원으로 확대되었습니다.
+ DFE 엔진의 Gremlin `DedupGlobalStep`에 대한 `by()` 변조 지원이 추가되었습니다.
+ Gremlin `SelectStep` 및 `SelectOneStep`에 대한 DFE 지원이 추가되었습니다.
+ `repeat`, `coalesce`, `store`, `aggregate` 등 다양한 Gremlin 연산자의 성능이 개선되고 정확성이 수정되었습니다.
+ `MERGE` 및 `OPTIONAL MATCH`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ 리터럴 값의 맵 목록에 있는 `UNWIND`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ `id`에 `IN` 필터가 있는 openCypher 쿼리의 성능이 개선되었습니다. 예:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ BASE 문을 사용하여 SPARQL 쿼리의 기본 IRI를 지정하는 기능이 추가되었습니다([쿼리 및 업데이트를 위한 기본 IRI](feature-sparql-compliance.md#opencypher-compliance-default-iri) 참조).
+ Gremlin 및 openCypher 엣지 전용 대량 로드의 로드 처리 대기 시간이 단축되었습니다.
+ 재개 시도가 실패하기 전에 Amazon S3 연결 문제로 인한 긴 대기 시간을 피하기 위해 Neptune이 다시 시작될 때 대량 로드가 비동기적으로 재개되도록 했습니다.
+ [describeMode](sparql-query-hints-for-describe.md#sparql-query-hints-describeMode) 쿼리 힌트가 `"CBD"`(간결하고 제한된 설명)로 설정되어 있고 많은 수의 빈 노드가 포함되는 SPARQL DESCRIBE 쿼리의 처리가 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ Bolt 및 SPARQL-JSON에서 쿼리가 null 값 대신 `"null"` 문자열을 반환하는 openCypher 버그가 수정되었습니다.
+ 목록 요소에 제공된 값이 아닌 null 값을 생성하는 목록 이해 도구의 openCypher 버그가 수정되었습니다.
+ 바이트 값이 올바르게 직렬화되지 않는 openCypher 버그가 수정되었습니다.
+ 하위 순회 내에서 입력이 엣지 순회일 때 발생하는 `UnionStep`의 Gremlin 버그가 수정되었습니다.
+ `UnionStep`과 관련된 단계 레이블이 각 하위 순회의 마지막 단계로 제대로 전파되지 않던 Gremlin 버그가 수정되었습니다.
+ `repeat` 단계 뒤에 레이블이 있는 `dedup` 단계에서 `dedup` 단계에 연결된 레이블을 더 이상 쿼리에 사용할 수 없던 Gremlin 버그가 수정되었습니다.
+ 내부 오류로 인해 `union` 단계 내에서 `repeat` 단계를 변환하지 못하는 Gremlin 버그가 수정되었습니다.
+ TinkerPop으로 폴백하여 비통합 단계의 하위 순회로 `limit`를 사용하는 DFE 쿼리의 Gremlin 정확성 문제가 수정되었습니다. 영향을 받는 양식의 쿼리는 다음과 같습니다.
```
g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
```
+ `SPARQL GRAPH` 패턴이 `FROM NAMED` 절에서 제공하는 데이터 세트 고려하지 않는 SPARQL 버그가 수정되었습니다.
+ 일부 `FROM` 또는 `FROM NAMED` 절을 포함하는 SPARQL `DESCRIBE`가 기본 그래프의 데이터를 항상 올바르게 사용하지 않고 예외를 발생시키는 SPARQL 버그가 수정되었습니다. [기본 그래프와 관련된 SPARQL DESCRIBE 동작](sparql-default-describe.md)을(를) 참조하세요.
+ null 문자가 거부될 때 올바른 예외 메시지가 반환되도록 SPARQL 버그가 수정되었습니다.
+ [PipelinedHashIndexJoin](sparql-explain-operators.md#sparql-explain-operator-pipeline-hash-index-join) 연산자가 포함된 플랜에 영향을 주던 SPARQL [설명](sparql-explain.md) 버그가 수정되었습니다.
+ 상수 값을 반환하는 쿼리를 반환할 때 내부 오류가 발생할 수 있는 버그가 수정되었습니다.
+ 가끔 엔진이 응답하지 않던 교착 상태 탐지기 로직 관련 문제가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.1.0에 대한 업그레이드 경로
버전 1.1.0.0 이상의 모든 이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
**참고**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)부터 `1.2.0.0` 이전 엔진 버전에서 사용하던 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹은 이제 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 다시 만들어야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`이 사용되었으며, 이러한 파라미터 그룹은 `1.2.0.0` 이후 릴리즈에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
이 메이저 버전 릴리스로 자동으로 업그레이드되지 않습니다.
## 이 릴리스로 업그레이드
이제 Amazon Neptune 1.2.1.0을 정식 버전으로 이용할 수 있습니다.
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.2.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
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.2.1.0.R7(2023년 10월 6일)
2023년 10월 6일부터 엔진 버전 1.2.1.0.R7이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
+ 경우에 따라 실패한 트랜잭션이 제대로 종료되지 않는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.0.R7로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.1.0.R7을 이제 정식 버전으로 사용할 수 있습니다.
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.2.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
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.2.1.0.R6(2023년 9월 12일)
2023년 9월 12일부터 엔진 버전 1.2.1.0.R6이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 새로운 기능
+ [Neptune 데이터 API](data-api.md)가 릴리스되었습니다.
Amazon Neptune 데이터 API는 데이터 로드, 쿼리 실행, 데이터 정보 가져오기, 기계 학습 작업 실행을 위한 SDK 지원을 제공합니다. Neptune의 Gremlin 및 openCypher 쿼리 언어를 지원하며 모든 SDK 언어로 사용할 수 있습니다. API 요청에 자동으로 서명하면 Neptune을 애플리케이션에 매우 간편하게 통합할 수 있습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 슬로우 쿼리 로그를 사용 설정하여 부하가 높을 때 CPU 정점이 발생할 수 있는 버그가 수정되었습니다.
+ 엣지와 해당 속성을 추가하면 `inV()` 또는 `outV()`에 이어 `InternalFailureException`이 발생하는 Gremlin 버그가 수정되었습니다.
+ 경우에 따라 대량 로더 성능이 저하되는 IAM 역할 체인 관련 몇 가지 문제가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.0.R6으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.1.0.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.2.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
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.2.1.0.R5(2023년 9월 2일)
2023년 9월 2일부터 엔진 버전 1.2.1.0.R5가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 새로운 기능
+ [Neptune 데이터 API](data-api.md)가 릴리스되었습니다.
Amazon Neptune 데이터 API는 데이터 로드, 쿼리 실행, 데이터 정보 가져오기, 기계 학습 작업 실행을 위한 SDK 지원을 제공합니다. Neptune의 Gremlin 및 openCypher 쿼리 언어를 지원하며 모든 SDK 언어로 사용할 수 있습니다. API 요청에 자동으로 서명하면 Neptune을 애플리케이션에 매우 간편하게 통합할 수 있습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 엣지와 해당 속성을 추가하면 `inV()` 또는 `outV()`에 이어 `InternalFailureException`이 발생하는 Gremlin 버그가 수정되었습니다.
+ 경우에 따라 대량 로더 성능이 저하되는 IAM 역할 체인 관련 몇 가지 문제가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.0.R5로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.1.0.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.2.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
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.2.1.0.R4(2023년 8월 10일)
2023년 8월 10일부터 엔진 버전 1.2.1.0.R4가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
이 엔진 릴리스에 도입된 변경 사항으로 인해 경우에 따라 대량 부하 성능이 저하될 수 있습니다. 따라서 문제가 해결될 때까지 이 릴리스에 대한 업그레이드가 일시적으로 중단되었습니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ Gremlin용 [GraphSON-1.0](https://tinkerpop.apache.org/docs/3.4.1/dev/io/#graphson) 지원이 추가되었습니다. Graphson-1.0을 사용하려면 다음 값으로 `Accept header`를 전달합니다.
```
application/vnd.gremlin-v1.0+json;types=false
```
## 이 엔진 릴리스에서 수정된 결함
+ Gremlin 쿼리 상태 엔드포인트에서 기본적으로 처리되지 않는 단계에 대한 하위 순회 조건자가 있는 쿼리를 검사할 때 트랜잭션 누수가 발생하는 Gremlin 버그가 수정되었습니다.
+ Bolt 트랜잭션 처리에서 openCypher 버그가 수정되었습니다.
+ 스토리지 계층에서 충돌을 일으킬 수 있는 동시성 문제가 수정되었습니다.
+ 슬로우 쿼리 로그가 사용 해제되었을 때 활성화되지 않도록 하는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.0.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.5`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.1.0.R4에 대한 업그레이드 경로
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.1.0.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.2.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
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.2.1.0.R3(2023년 6월 13일)
2023년 6월 13일부터 엔진 버전 1.2.1.0.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
이 엔진 릴리스에 도입된 변경 사항으로 인해 경우에 따라 대량 부하 성능이 저하될 수 있습니다. 따라서 문제가 해결될 때까지 이 릴리스에 대한 업그레이드가 일시적으로 중단되었습니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 새로운 기능
+ [IAM 역할 체인](bulk-load-tutorial-chain-roles.md)을 사용한 계정 간 대량 로딩에 대한 지원이 추가되었습니다.
## 이 엔진 릴리스의 개선 사항
+ 생성된 예외를 일반 `InternalFailureException`과 구별하고 제공된 사용자 제공 메시지가 호출자에게 다시 전파되도록 Gremlin의 `fail()` 단계가 개선되었습니다.
+ `store`, `aggregate`, `cap`, `limit`, `hasLabel`에 대한 Gremlin 쿼리 엔진 최적화가 개선되었습니다.
+ openCypher 삼각 함수에 대한 지원이 다음과 같이 추가되었습니다.
+ `acos()`
+ `asin()`
+ `atan()`
+ `atan2()`
+ `cos()`
+ `cot()`
+ `degrees()`
+ `pi()`
+ `radians()`
+ `sin()`
+ `tan()`
+ 여러 openCypher 집계 함수에 대한 지원이 다음과 같이 추가되었습니다.
+ `percentileDisc()`
+ `stDev()`
+ `datetime`을 `epochmillis`로 변환하는 openCypher `epochmillis()` 함수에 대한 지원이 추가되었습니다. 예:
```
MATCH (n) RETURN epochMillis(n.someDateTime)
1698972364782
```
+ openCypher 모듈로 (`%`) 연산자에 대한 지원이 추가되었습니다.
+ openCypher 정적 디버그 설명 도구에 대한 지원이 추가되었습니다.
+ openCypher에 `randomUUID()` 함수에 대한 지원이 추가되었습니다.
+ openCypher 성능이 다음과 같이 개선되었습니다.
+ 구문 분석 및 쿼리 플래너가 개선되었습니다.
+ DFE 엔진의 CPU 사용률이 개선되었습니다.
+ 동일한 변수를 재사용하는 여러 업데이트 절이 포함된 쿼리의 성능이 개선되었습니다. 예:
```
MERGE (n {name: 'John'})
or
MERGE (m {name: 'Jim'})
or
MERGE (n)-[:knows {since: 2023}]→(m)
```
+ 다음과 같은 멀티 홉 쿼리 패턴용 쿼리 계획이 최적화되었습니다.
```
MATCH (n)-->()-->()-->(m)
RETURN n m
```
+ 파라미터화된 쿼리를 통해 목록 및 맵 삽입 성능이 개선되었습니다. 예:
```
UNWIND $idList as id MATCH (n {`~id`: id})
RETURN n.name
```
+ 적절한 방해 요소를 만들어 `WITH`가 포함되어 있는 쿼리 실행이 개선되었습니다.
+ `Unfold` 및 집계 함수 내 값의 중복 구체화를 방지하도록 최적화되었습니다.
+ 다음과 같이 `VALUES` 절에 많은 수의 정적 입력이 포함된 SPARQL 쿼리의 성능이 개선되었습니다.
```
SELECT ?n WHERE { VALUES (?name) { ("John") ("Jim") ... many values ... } ?n a ?n_type . ?n ?name . }
```
+ SPARQL CBD 쿼리 성능이 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 딥 중첩이 포함된 긴 쿼리로 인해 쿼리 계획 단계에서 CPU 사용량이 높아지고 쿼리 제한 시간이 발생하는 Gremlin 버그가 수정되었습니다.
+ `mergeV` 또는 `mergeE` 사용 시 유효하지 않은 `NullPointerException` 오류가 발생할 수 있는 Gremlin 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.0.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.1.0.R3에 대한 업그레이드 경로
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.1.0.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.2.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
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.2.1.0.R2(2023년 5월 2일)
2023년 5월 2일부터 엔진 버전 1.2.1.0.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 훈련 또는 하이퍼 파라미터 튜닝 작업에서 컨테이너 간 트래픽 암호화를 사용 및 사용 해제하는 데 사용할 수 있는 `enableInterContainerTrafficEncryption` 파라미터가 모든 [Neptune ML API](machine-learning-api-reference.md)에 추가되었습니다.
+ Gremlin `mergeV()` 및 `mergeE()`에 대한 다중 레이블 지원이 추가되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 업데이트 및 반환 쿼리가 `orderBy`, `limit`, `skip`을 제대로 처리하지 않는 openCypher 버그가 수정되었습니다.
+ 한 요청에 포함된 파라미터를 다른 동시 요청에 포함된 파라미터로 재정의할 수 있었던 openCypher 버그가 수정되었습니다.
+ 슬로우 쿼리 로그에 정확한 쿼리 시각이 포함되지 않던 openCypher 버그가 수정되었습니다.
+ `GroupCountStep`이 포함된 쿼리가 문자열로 제출되어 트랜잭션 누수가 발생할 수 있는 Gremlin 버그가 수정되었습니다.
+ 슬로우 쿼리 로그가 사용되는 경우 WebSocket 쿼리가 실패하던 Gremlin 버그가 수정되었습니다.
+ WebSocket 요청에 대한 슬로우 쿼리 로그에서 스토리지 카운터 디버그 로그가 누락되는 Gremlin 버그가 수정되었습니다.
+ `mergeV()` 및 `mergeE()`와 관련된 몇 가지 Gremlin 버그가 수정되었습니다.
+ 명명된 그래프 쿼리 비용이 잘못 추정되어 쿼리 계획이 최적화되지 않고 메모리 부족 오류가 발생하는 SPARQL 버그가 수정되었습니다.
+ IAM 지원 클러스터의 Gremlin 및 openCypher 쿼리의 인증에 영향을 주는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.1.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.6.2`
+ *Gremlin 최신 버전 지원:* `3.6.2`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.1.0.R2에 대한 업그레이드 경로
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.1.0.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.2.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.1.0 ^
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.2.0.2(2022년 11월 20일)
2022년 11월 20일부터 엔진 버전 1.2.0.2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.2.0.2.R2(2022년 12월 15일)](engine-releases-1.2.0.2.R2.md)
+ [릴리스: 1.2.0.2.R3(2023년 3월 27일)](engine-releases-1.2.0.2.R3.md)
+ [릴리스: 1.2.0.2.R4(2023년 5월 8일)](engine-releases-1.2.0.2.R4.md)
+ [릴리스: 1.2.0.2.R5(2023년 8월 16일)](engine-releases-1.2.0.2.R5.md)
+ [릴리스: 1.2.0.2.R6(2023년 9월 12일)](engine-releases-1.2.0.2.R6.md)
## 이 엔진 릴리스의 새로운 기능
+ Neptune ML에 Gremlin에 대한 [실시간 유도 추론](machine-learning-overview-evolving-data.md#inductive-vs-transductive-inference) 기능이 도입되었습니다.
+ Neptune이 생성하는 UUID 대신 [엔터티에 대한 사용자 지정 ID 값](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids) 지정을 지원하는 openCypher 확장 프로그램이 도입되었습니다. 사용자 지정 ID를 할당하는 기능을 사용하여 Neo4j에서 Neptune으로 쉽게 마이그레이션할 수 있습니다.
**주의**
openCypher 사양에 대한 이 확장 프로그램에서는 이제 `~id`를 예약된 속성 이름으로 간주하므로 이전 버전과는 호환되지 않습니다. 이미 데이터 및 쿼리의 속성으로 `~id`를 사용하고 있는 경우 이번 릴리스로 업그레이드하기 전에 [`~id` 속성을 새 속성 키로 마이그레이션](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids-migrating)해야 합니다.
+ 이를 구성하기 위한 쿼리 힌트와 함께 [몇 가지 새 SPARQL `DESCRIBE` 모드](sparql-query-hints-for-describe.md)가 추가되었습니다.
## 이 엔진 릴리스의 개선 사항
+ 특히 VLP 쿼리의 openCypher 성능이 개선되었습니다.
+ 다음과 같이 터미널이 아닌 제한이 있는 Gremlin 쿼리의 DFE 성능이 개선되었습니다.
```
g.withSideEffect('Neptune#useDFE',true).V().hasLabel('Student').limit(5).out('takesCourse')
```
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.2에 대한 업그레이드 경로
## 이 릴리스로 업그레이드
이제 Amazon Neptune 1.2.0.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.2.0.2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.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.2.0.2.R6(2023년 9월 12일)
2023년 9월 12일부터 엔진 버전 1.2.0.2.R6이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
+ 언어 태그가 지정된 리터럴에서 `REGEX` 연산자가 호출할 때 이를 수행할 수 없는 SPARQL 버그가 수정되었습니다.
+ 대량 로드 성능이 저하되는 문제가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.2.R6으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.5`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.2.R6에 대한 업그레이드 경로
엔진 버전 `1.2.0.2`를 실행하는 경우 다음 유지 관리 기간 동안 Neptune DB 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.0.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.2.0.2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.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.2.0.2.R5(2023년 8월 16일)
2023년 8월 16일부터 엔진 버전 1.2.0.2.R5가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
이 엔진 릴리스에 도입된 변경 사항으로 인해 경우에 따라 대량 부하 성능이 저하될 수 있습니다. 따라서 문제가 해결될 때까지 이 릴리스에 대한 업그레이드가 일시적으로 중단되었습니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
+ 문자열 출력 중 일부에 공백 문자가 포함된 경우 `order()`가 적절하게 정렬되지 않는 Gremlin 버그가 수정되었습니다.
+ Gremlin 쿼리 상태 엔드포인트에서 기본적으로 처리되지 않는 단계에 대한 하위 순회 조건자가 있는 쿼리를 검사할 때 트랜잭션 누수가 발생하는 Gremlin 버그가 수정되었습니다.
+ Bolt 트랜잭션 처리에서 openCypher 버그가 수정되었습니다.
+ 스토리지 계층에서 충돌을 일으킬 수 있는 동시성 문제가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.2.R5로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.5`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.2.R5에 대한 업그레이드 경로
엔진 버전 `1.2.0.2`를 실행하는 경우 다음 유지 관리 기간 동안 Neptune DB 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.0.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.2.0.2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.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.2.0.2.R4(2023년 5월 8일)
2023년 5월 8일부터 엔진 버전 1.2.0.2.R4가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
+ `VALUES` 절을 통해 많은 값을 삽입하면 성능이 저하될 수 있는 SPARQL 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.2.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.6`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.2.R4에 대한 업그레이드 경로
엔진 버전 `1.2.0.2`를 실행하는 경우 다음 유지 관리 기간 동안 Neptune DB 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.0.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.2.0.2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.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.2.0.2.R3(2023년 3월 27일)
2023년 3월 27일부터 엔진 버전 1.2.0.2.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 서버리스 DB 클러스터의 경우 최소 용량 설정을 1.0NCU로, 최소 유효 최대 설정을 2.5NCU로 변경했습니다. [Neptune Serverless DB 클러스터의 용량 규모 조정](neptune-serverless-capacity-scaling.md) 섹션을 참조하세요
+ 훈련 또는 하이퍼 파라미터 튜닝 작업에서 컨테이너 간 트래픽 암호화를 사용 및 사용 해제하는 데 사용할 수 있는 `enableInterContainerTrafficEncryption` 파라미터가 모든 [Neptune ML API](machine-learning-api-reference.md)에 추가되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ `option(Predicate)`에서 유효한 Gremlin 구문으로 인식되지 않던 Gremlin 버그가 수정되었습니다.
+ 쿼리에 단계가 너무 많아서 쿼리가 실패할 경우 제대로 정리되지 않던 Gremlin 버그가 수정되었습니다.
+ TinkerPop으로 폴백하여 비통합 단계의 하위 순회로 `limit`를 사용하는 DFE 쿼리에 영향을 주는 Gremlin 정확성 문제가 수정되었습니다. 이러한 쿼리의 예는 다음과 같습니다.
```
g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
```
+ `GroupCountStep`을 포함한 String으로 쿼리가 제출되면 발생할 수 있는 잠재적 Gremlin 트랜잭션 누수 문제가 수정되었습니다.
+ 목록 또는 맵 목록에 대해 파라미터 값 유형이 올바르게 추론되지 않는 openCypher 버그가 수정되었습니다.
+ 업데이트 및 반환 쿼리가 `orderBy`, `limit`, `skip`을 제대로 처리하지 않는 openCypher 버그가 수정되었습니다.
+ 한 요청에 포함된 파라미터를 다른 동시 요청에 포함된 파라미터로 재정의할 수 있었던 openCypher 버그가 수정되었습니다.
+ `VALUES` 절에 많은 값을 삽입하면 성능이 저하될 수 있는 SPARQL 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.2.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.6`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.2.R3에 대한 업그레이드 경로
엔진 버전 `1.2.0.2`를 실행하는 경우 다음 유지 관리 기간 동안 Neptune DB 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.0.2.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.2.0.2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.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.2.0.2.R2(2022년 12월 15일)
2022년 12월 15일부터 엔진 버전 1.2.0.2.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ `MERGE` 및 `OPTIONAL MATCH`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ 리터럴 값의 맵 목록에 있는 `UNWIND`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ `id`에 `IN` 필터가 있는 openCypher 쿼리의 성능이 개선되었습니다. 예:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ `repeat`, `coalesce`, `store`, `aggregate` 등 다양한 Gremlin 연산자의 성능이 개선되고 정확성이 수정되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ Bolt 및 SPARQL-JSON에서 쿼리가 null 값 대신 `"null"` 문자열을 반환하는 openCypher 버그가 수정되었습니다.
+ `UnionStep`에 연결된 단계 레이블이 하위 순회의 마지막 경로 요소로 전파되지 않던 Gremlin 버그가 수정되었습니다.
+ DFE 엔진의 `by()` 순회에서 `valueMap()`이 최적화되지 않는 Gremlin 버그가 수정되었습니다.
+ 더 긴 Gremlin 트랜잭션의 일부로 실행되는 읽기 쿼리가 행을 잠그지 않는 Gremlin 버그가 수정되었습니다.
+ 불필요한 정보가 기록되고 로그에서 특정 필드가 누락되는 감사 로그 버그가 수정되었습니다.
+ IAM 지원 DB 클러스터에 대한 HTTP 요청의 IAM ARN이 기록되지 않는 감사 로그 버그가 수정되었습니다.
+ 캐시 쓰기에 사용되는 증분 메모리를 제한하도록 조회 캐시 버그가 수정되었습니다.
+ 쓰기 실패 시 조회 캐시에 읽기 전용 모드를 설정하는 것과 관련된 조회 캐시 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.2.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.2.R2에 대한 업그레이드 경로
엔진 버전 `1.2.0.2`를 실행하는 경우 다음 유지 관리 기간 동안 Neptune DB 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.0.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.2.0.2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.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.2.0.1(2022년 10월 26일)
2022년 10월 26일부터 엔진 버전 1.2.0.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 릴리스의 후속 패치 릴리스
+ [유지 관리 릴리스: 1.2.0.1.R2(2022년 12월 13일)](engine-releases-1.2.0.1.R2.md)
+ [유지 관리 릴리스: 1.2.0.1.R3(2023년 9월 27일)](engine-releases-1.2.0.1.R3.md)
## 이 엔진 릴리스의 새로운 기능
+ [Amazon Neptune Serverless](neptune-serverless.md)에는 증가하는 처리 수요를 충족하기 위해 DB 클러스터의 규모를 조정한 다음 수요가 감소하면 다시 스케일 다운하는 온디맨드 자동 크기 조정 구성이 도입되었습니다.
## 이 엔진 릴리스의 개선 사항
+ Gremlin `order-by` 쿼리의 성능이 개선되었습니다. 이제 끝에 `NeptuneGraphQueryStep`이 있는 `order-by`에서 Gremlin 쿼리는 성능 향상을 위해 더 큰 청크 크기를 사용합니다. 이는 쿼리 계획의 내부(루트가 아닌) 노드에 있는 `order-by`에는 적용되지 않습니다.
+ Gremlin 업데이트 쿼리의 성능이 개선되었습니다. 이제 엣지나 속성을 추가할 때 버텍스와 엣지가 삭제되지 않도록 잠금 처리해야 합니다. 이 변경으로 트랜잭션 내 중복 잠금이 제거되어 성능이 향상됩니다.
+ `repeat()` 하위 쿼리 내에서 `dedup()`를 사용하는 Gremlin 쿼리를 기본 실행 계층으로 `dedup` 푸시하여 성능이 개선되었습니다.
+ IAM 인증 오류에 대한 사용자 중심의 오류 메시지가 추가되었습니다. 이제 이러한 메시지에는 IAM 사용자 또는 역할 ARN, 리소스 ARN, 요청에 대한 비승인 작업 목록이 표시됩니다. 비승인 작업 목록을 통해 사용 중인 IAM 정책에서 누락되거나 명시적으로 거부될 수 있는 항목을 확인할 수 있습니다.
## 이 엔진 릴리스에서 수정된 결함
+ TinkerPop 3.5로 업그레이드한 후 `PartitionStrategy`를 사용하면 “PartitionStrategy는 익명 순회와 함께 작동하지 않습니다”라는 오류 메시지가 잘못 표시되어 순회가 실행되지 않던 Gremlin 버그가 수정되었습니다.
+ Neptune의 쿼리 엔진이 사용하는 `where(P.neq('x'))` 및 이를 변형한 쿼리에 대해 잘못된 결과를 생성하는 `WherePredicateStep` 번역과 관련된 Gremlin 정확성 버그가 수정되었습니다.
+ 경우에 따라 중복 노드 및 엣지 생성을 야기했던 `MERGE` 절의 openCypher 버그가 수정되었습니다.
+ `OPTIONAL` 절 내의 `(NOT) EXISTS`에 포함된 쿼리를 처리할 때 쿼리 결과가 누락되는 SPARQL 버그가 수정되었습니다.
+ 삽입 부하가 심할 경우 성능 회귀가 야기되는 대량 로더 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.1에 대한 업그레이드 경로
## 이 릴리스로 업그레이드
이제 Amazon Neptune 1.2.0.1을 정식 버전으로 이용할 수 있습니다.
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.2.0.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.1 ^
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.2.0.1.R3(2023년 9월 27일)
2023년 9월 27일부터 엔진 버전 1.2.0.1.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 훈련 또는 하이퍼 파라미터 튜닝 작업에서 컨테이너 간 트래픽 암호화를 사용 및 사용 해제하는 데 사용할 수 있는 `enableInterContainerTrafficEncryption` 파라미터가 모든 [Neptune ML API](machine-learning-api-reference.md)에 추가되었습니다.
+ 서버리스 DB 클러스터의 경우 최소 용량 설정을 1.0NCU로, 최소 유효 최대 설정을 2.5NCU로 변경했습니다. *릴리스 전에 이 변경 사항이 서버리스 페이지에도 반영되어야 하는* [Neptune Serverless DB 클러스터의 용량 규모 조정](neptune-serverless-capacity-scaling.md)의 내용을 참고하세요.
## 이 엔진 릴리스에서 수정된 결함
+ 업데이트 및 반환 쿼리가 제대로 처리되지 않거나 `orderBy`, `limit`, `skip`이 제대로 처리되지 않는 openCypher 버그가 수정되었습니다.
+ 한 요청에 포함된 파라미터를 다른 동시 요청에 포함된 파라미터로 재정의할 수 있었던 openCypher 버그가 수정되었습니다.
+ Bolt 트랜잭션 처리에서 openCypher 버그가 수정되었습니다.
+ TinkerPop으로 폴백하여 비통합 단계의 하위 순회로 `limit`를 사용하는 DFE 쿼리의 Gremlin 정확성 문제가 수정되었습니다. 예를 들어 해당 쿼리의 예제는 다음과 같습니다.
```
g.withSideEffect('Neptune#useDFE', true)
.V()
.as("a")
.select("a")
.by(out()
.limit(1))
```
+ TinkerPop 단계가 너무 많아서 쿼리가 실패하고 정리되지 않는 Gremlin 버그가 수정되었습니다.
+ 문자열 출력 중 일부에 공백 문자가 포함된 경우 `order()`가 적절하게 정렬되지 않는 Gremlin 버그가 수정되었습니다.
+ 쿼리가 문자열로 제출되고 `GroupCountStep`에 포함된 경우 트랜잭션 누수가 발생할 수 있는 Gremlin 버그가 수정되었습니다.
+ Gremlin 쿼리 상태 엔드포인트에서 기본적으로 처리되지 않는 단계에 대한 하위 순회 조건자가 있는 쿼리를 검사할 때 트랜잭션 누수가 발생하는 Gremlin 버그가 수정되었습니다.
+ 엣지와 해당 속성을 추가하면 `inV()` 또는 `outV()`에 이어 `InternalFailureException`이 발생하는 Gremlin 버그가 수정되었습니다.
+ 스토리지 계층의 동시성 문제가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.1.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.6`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.1.R3에 대한 업그레이드 경로
[엔진 버전 1.2.0.1](engine-releases-1.2.0.1.md)을 실행하는 경우 다음 유지 관리 기간 동안 Neptune DB 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.0.1.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.2.0.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.1 ^
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.2.0.1.R2(2022년 12월 13일)
2022년 12월 13일부터 엔진 버전 1.2.0.1.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 리터럴 값의 맵 목록에 있는 `UNWIND`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ `repeat`, `coalesce`, `store`, `aggregate` 등 다양한 Gremlin 연산자의 성능이 개선되고 정확성이 수정되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ Bolt 및 SPARQL-JSON에서 쿼리가 null 값 대신 `"null"` 문자열을 반환하는 openCypher 버그가 수정되었습니다.
+ 불필요한 정보가 기록되고 로그에서 특정 필드가 누락되는 감사 로그 버그가 수정되었습니다.
+ 캐시 쓰기에 사용되는 증분 메모리를 제한하도록 조회 캐시 버그가 수정되었습니다.
+ 쓰기 실패 시 조회 캐시에 읽기 전용 모드를 설정하는 것과 관련된 조회 캐시 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.1.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.1.R2에 대한 업그레이드 경로
[엔진 버전 1.2.0.1](engine-releases-1.2.0.1.md)을 실행하는 경우 다음 유지 관리 기간 동안 Neptune DB 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.2.0.1.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.2.0.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.1 ^
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.2.0.0(2022년 7월 21일)
2022년 7월 21일부터 엔진 버전 1.2.0.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](#engine-releases-1.2.0.0)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.2.0.0.R2(2022년 10월 14일)](engine-releases-1.2.0.0.R2.md)
+ [릴리스: 1.2.0.0.R3(2022년 12월 15일)](engine-releases-1.2.0.0.R3.md)
+ [릴리스: 1.2.0.0.R4(2023년 9월 29일)](engine-releases-1.2.0.0.R4.md)
## 이 엔진 릴리스의 새로운 기능
+ [글로벌 데이터베이스](neptune-global-database.md)에 대한 지원이 추가되었습니다. Neptune 글로벌 데이터베이스는 여러 AWS 리전에 걸쳐 있으며, 하나의 리전에 있는 기본 DB 클러스터와 다른 리전에 있는 최대 5개의 보조 DB 클러스터로 구성됩니다.
+ 데이터 영역 작업을 기반으로 Neptune IAM 정책에 이전보다 더 세분화된 액세스 제어에 대한 지원이 추가되었습니다. 이는 더 이상 지원되지 않는 `connect` 작업을 기반으로 하는 기존 IAM 정책을 보다 세분화된 데이터 영역 작업을 사용하도록 조정해야 한다는 점에서 획기적인 변화입니다. [IAM 정책 유형](security-iam-access-manage.md#iam-auth-policy)을(를) 참조하세요.
+ 리더 인스턴스 가용성이 개선되었습니다. 이전에는 라이터 인스턴스가 다시 시작될 때 Neptune 클러스터의 모든 리더 인스턴스도 다시 시작되었습니다. 엔진 릴리스 1.2.0.0부터 라이터 재시작 후에도 리더 인스턴스가 활성 상태를 유지하므로 리더 가용성이 향상됩니다. 리더 인스턴스를 별도로 다시 시작하여 파라미터 그룹 변경 내용을 적용할 수 있습니다. [Amazon Neptune에서 DB 인스턴스 재부팅](manage-console-instances-reboot.md)을(를) 참조하세요.
+ 스트림 레코드가 삭제되기 전에 서버에 보관되는 일수를 설정할 수 있는 새로운 [neptune\$1streams\$1expiry\$1days](parameters.md#parameters-db-cluster-parameters-neptune_streams_expiry_days) DB 클러스터 파라미터가 추가되었습니다. 범위는 1\$190이고, 기본값은 7입니다.
## 이 엔진 릴리스의 개선 사항
+ ByteCode 쿼리에 대한 Gremlin 직렬화 성능이 개선되었습니다.
+ Neptune은 이제 DFE 엔진을 사용하여 텍스트 조건자를 처리하므로 성능이 향상됩니다.
+ Neptune은 이제 DFE 엔진을 사용하여 비터미널 및 하위 순회 제한을 포함하여 `limit()` Gremlin 단계를 처리합니다.
+ Gremlin `union()` 단계의 DFE 처리가 다른 새 기능과 함께 작동하도록 변경되었습니다. 즉, 참조 노드가 예상대로 쿼리 프로필에 표시됩니다.
+ DFE 내에서 비용이 많이 드는 일부 조인 작업을 병렬화하여 성능이 최대 5배까지 개선되었습니다.
+ Gremlin DFE 엔진의 `OrderGlobalStep order(global)`에 대한 `by()` 변조 지원이 추가되었습니다.
+ DFE의 세부 정보 설명에 주입된 정적 값 표시가 추가되었습니다.
+ 중복 패턴 프루닝 시 성능이 개선되었습니다.
+ Gremlin DFE 엔진에 순서 보존 지원이 추가되었습니다.
+ 다음과 같이 빈 필터가 있는 Gremlin 쿼리의 성능이 개선되었습니다.
```
g.V().hasId(P.within([]))
```
```
g.V().hasId([])
```
+ SPARQL 쿼리가 Neptune이 내부적으로 표현하기에는 너무 큰 숫자 값을 사용할 때 발생하는 오류 메시지가 개선되었습니다.
+ 스트림이 사용 해제된 경우 인덱스 검색을 줄여 연결된 엣지가 있는 버텍스를 삭제하는 성능이 개선되었습니다.
+ DFE 지원을 더 많은 `has()` 단계 변형, 특히 `hasKey()`, `hasLabel()` 그리고 `has()` 내에서 문자열/URI에 대한 범위 조건자로 확대했습니다. 이렇게 하면 다음과 같은 쿼리에 영향을 줍니다.
```
// hasKey() on properties
g.V().properties().hasKey("name")
g.V().properties().has(T.key, TextP.startingWith("a"))
g.E().properties().hasKey("weight")
g.E().properties().hasKey(TextP.containing("t"))
// hasLabel() on vertex properties
g.V().properties().hasLabel("name")
// range predicates on ID and Label fields
g.V().has(T.label, gt("person"))
g.E().has(T.id, lte("(an ID value)"))
```
+ 목록의 문자열을 단일 문자열로 연결하는 Neptune 전용 openCypher [`join()`](access-graph-opencypher-extensions.md#opencypher-compliance-join-function) 함수가 추가되었습니다.
+ 새 글로벌 데이터베이스 API에 대한 데이터 액세스 권한 및 권한을 포함하도록 [Neptune 관리형 정책](security-iam-access-managed-policies.md)이 업데이트되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 콘텐츠 유형이 지정되지 않은 HTTP 요청이 자동으로 실패하는 버그가 수정되었습니다.
+ 쿼리 최적화 도구에서 쿼리 내 서비스 호출을 사용할 수 없었던 SPARQL 버그가 수정되었습니다.
+ Turtle RDF 구문 분석에서 Unicode 데이터의 특정 조합으로 인해 오류가 발생하던 SPARQL 버그가 수정되었습니다.
+ `GRAPH` 및 `SELECT` 절의 특정 조합으로 인해 잘못된 쿼리 결과가 생성되는 SPARQL 버그가 수정되었습니다.
+ 다음과 같이 통합 단계 내에서 모든 필터 단계를 사용하는 쿼리의 정확성 문제를 일으킨 Gremlin 버그가 수정되었습니다.
```
g.V("1").union(hasLabel("person"), out())
```
+ `count()`를 사용하지 않으면 반환되는 실제 결과에 `both().simplePath()`의 `count()`가 2배로 나타나는 Gremlin 버그가 수정되었습니다.
+ IAM 인증이 사용 설정된 클러스터에 대한 Bolt 요청에 대해 서버에서 잘못된 서명 불일치 예외가 생성되는 openCypher 버그가 수정되었습니다.
+ HTTP keep-alive를 사용하는 요청이 실패한 후 제출된 경우 쿼리가 잘못 종료될 수 있는 openCypher 버그가 수정되었습니다.
+ 상수 값을 반환하는 쿼리를 제출할 때 내부 오류가 발생할 수 있는 openCypher 버그가 수정되었습니다.
+ DFE 하위 쿼리 `Time(ms)`이 이제 DFE 하위 쿼리 내 연산자의 CPU 시간을 올바르게 합산하도록 세부 정보 설명의 버그가 수정되었습니다. 설명 출력의 다음 발췌문을 예제로 들 수 있습니다.
```
subQuery1
╔════╤════════╤════════╤═══════════════════════╤═══════════════════════════════════╤══════╤══════════╤═══════════╤═══════╤═══════════╗
║ ID │ Out #1 │ Out #2 │ Name │ Arguments │ Mode │ Units In │ Units Out │ Ratio │ Time (ms) ║
╠════╪════════╪════════╪═══════════════════════╪═══════════════════════════════════╪══════╪══════════╪═══════════╪═══════╪═══════════╣
...
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 1 │ 2 │ - │ DFEChunkLocalSubQuery │ subQuery=...graph#336e.../graph_1 │ - │ 1 │ 1 │ 1.00 │ 0.38 ║
║ │ │ │ │ coordinationTime(ms)=0.026 │ │ │ │ │ ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
...
subQuery=...graph#336e.../graph_1
╔════╤════════╤════════╤═══════════════════════╤═══════════════════════════════════╤══════╤══════════╤═══════════╤═══════╤═══════════╗
║ ID │ Out #1 │ Out #2 │ Name │ Arguments │ Mode │ Units In │ Units Out │ Ratio │ Time (ms) ║
╠════╪════════╪════════╪═══════════════════════╪═══════════════════════════════════╪══════╪══════════╪═══════════╪═══════╪═══════════╣
║ 0 │ 1 │ - │ DFESolutionInjection │ solutions=[?100 -> [-10^^]] │ - │ 0 │ 1 │ 0.00 │ 0.04 ║
║ │ │ │ │ outSchema=[?100] │ │ │ │ │ ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 1 │ 3 │ - │ DFERelationalJoin │ joinVars=[] │ - │ 2 │ 1 │ 0.50 │ 0.29 ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 2 │ 1 │ - │ DFESolutionInjection │ outSchema=[] │ - │ 0 │ 1 │ 0.00 │ 0.01 ║
╟────┼────────┼────────┼───────────────────────┼───────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 3 │ - │ - │ DFEDrain │ - │ - │ 1 │ 0 │ 0.00 │ 0.02 ║
╚════╧════════╧════════╧═══════════════════════╧═══════════════════════════════════╧══════╧══════════╧═══════════╧═══════╧═══════════╝
```
하단 테이블의 마지막 열에 있는 subQuery 시간을 합하면 최대 0.36ms(`.04 + .29 + .01 + .02 = .36`)입니다. 해당 하위 쿼리의 조정 시간(`.36 + .026 = .386`)을 더하면 위쪽 테이블의 마지막 열에 기록된 하위 subQuery의 시간, 즉 `0.38`ms에 가까운 결과를 얻을 수 있습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.0에 대한 업그레이드 경로
이 버전은 메이저 엔진 릴리스이므로 자동 업그레이드는 없습니다.
[엔진 릴리스 1.1.1.0](engine-releases-1.1.1.0.md)의 최신 패치 릴리스에서 릴리스 `1.2.0.0`으로 수동으로만 업그레이드할 수 있습니다. 이전 엔진 릴리스를 먼저 최신 릴리스 `1.1.1.0`으로 업그레이드해야 `1.2.0.0`으로 업그레이드할 수 있습니다.
따라서 이 릴리스로 업그레이드하기 전에 현재 릴리스 `1.1.1.0`의 최신 패치 릴리스를 실행하고 있는지 확인합니다. 그렇지 않은 경우 먼저 `1.1.1.0`의 최신 패치 릴리스로 먼저 업그레이드합니다.
업그레이드하기 전에 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 이전 버전에서 사용하던 사용자 지정 DB 클러스터 파라미터 그룹도 다시 만들어야 합니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
먼저 릴리스 `1.1.1.0`으로 업그레이드한 다음 바로 릴리스 `1.2.0.0`으로 업그레이드하는 경우 다음과 같은 오류가 발생할 수 있습니다.
```
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) 참조).
## 이 릴리스로 업그레이드
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.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.2.0.0.R4(2023년 9월 29일)
2023년 9월 29일부터 엔진 버전 1.2.0.0.R4가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 훈련 또는 하이퍼 파라미터 튜닝 작업에서 컨테이너 간 트래픽 암호화를 사용 및 사용 해제하는 데 사용할 수 있는 `enableInterContainerTrafficEncryption` 파라미터가 모든 [Neptune ML API](machine-learning-api-reference.md)에 추가되었습니다.
+ 서버리스 DB 클러스터의 경우 최소 용량 설정을 1.0NCU로, 최소 유효 최대 설정을 2.5NCU로 변경했습니다. *릴리스 전에 이 변경 사항이 서버리스 페이지에도 반영되어야 하는* [Neptune Serverless DB 클러스터의 용량 규모 조정](neptune-serverless-capacity-scaling.md)의 내용을 참고하세요.
## 이 엔진 릴리스에서 수정된 결함
+ 업데이트 및 반환 쿼리가 제대로 처리되지 않거나 `orderBy`, `limit`, `skip`이 제대로 처리되지 않는 openCypher 버그가 수정되었습니다.
+ 한 요청에 포함된 파라미터를 다른 동시 요청에 포함된 파라미터로 재정의할 수 있었던 openCypher 버그가 수정되었습니다.
+ Bolt 트랜잭션 처리에서 openCypher 버그가 수정되었습니다.
+ TinkerPop으로 폴백하여 비통합 단계의 하위 순회로 `limit`를 사용하는 DFE 쿼리의 Gremlin 정확성 문제가 수정되었습니다. 예를 들어 해당 쿼리의 예제는 다음과 같습니다.
```
g.withSideEffect('Neptune#useDFE', true)
.V()
.as("a")
.select("a")
.by(out()
.limit(1))
```
+ TinkerPop 단계가 너무 많아서 쿼리가 실패하고 정리되지 않는 Gremlin 버그가 수정되었습니다.
+ 문자열 출력 중 일부에 공백 문자가 포함된 경우 `order()`가 적절하게 정렬되지 않는 Gremlin 버그가 수정되었습니다.
+ 쿼리가 문자열로 제출되고 `GroupCountStep`에 포함된 경우 트랜잭션 누수가 발생할 수 있는 Gremlin 버그가 수정되었습니다.
+ Gremlin 쿼리 상태 엔드포인트에서 기본적으로 처리되지 않는 단계에 대한 하위 순회 조건자가 있는 쿼리를 검사할 때 트랜잭션 누수가 발생하는 Gremlin 버그가 수정되었습니다.
+ 엣지와 해당 속성을 추가하면 `inV()` 또는 `outV()`에 이어 `InternalFailureException`이 발생하는 Gremlin 버그가 수정되었습니다.
+ 스토리지 계층의 동시성 문제가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.0.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.6`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.0.R4에 대한 업그레이드 경로
엔진 버전 `1.2.0.0`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
[엔진 릴리스 1.1.1.0](engine-releases-1.1.1.0.md)의 최신 패치 릴리스에서 릴리스 `1.2.0.0`으로 수동으로만 업그레이드할 수 있습니다. 이전 엔진 릴리스를 먼저 최신 릴리스 `1.1.1.0`으로 업그레이드해야 `1.2.0.0`으로 업그레이드할 수 있습니다.
먼저 릴리스 `1.1.1.0`으로 업그레이드한 다음 바로 릴리스 `1.2.0.0`으로 업그레이드하는 경우 다음과 같은 오류가 발생할 수 있습니다.
```
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.
```
이 오류가 발생하면 보류 중인 작업이 완료될 때까지 기다리거나, 유지 관리 기간을 즉시 실행하여 이전의 업그레이드를 완료합니다.
## 이 릴리스로 업그레이드
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.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.2.0.0.R3(2022년 12월 15일)
2022년 12월 15일부터 엔진 버전 1.2.0.0.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ `MERGE` 및 `OPTIONAL MATCH`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ 리터럴 값의 맵 목록에 있는 `UNWIND`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ `id`에 `IN` 필터가 있는 openCypher 쿼리의 성능이 개선되었습니다. 예:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ `repeat`, `coalesce`, `store`, `aggregate` 등 다양한 Gremlin 연산자의 성능이 개선되고 정확성이 수정되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ Bolt 및 SPARQL-JSON에서 쿼리가 null 값 대신 `"null"` 문자열을 반환하는 openCypher 버그가 수정되었습니다.
+ 값이 목록 또는 맵 목록일 때 파라미터 유형을 올바르게 해석할 수 있도록 openCypher 버그가 수정되었습니다.
+ 불필요한 정보가 기록되고 로그에서 특정 필드가 누락되는 감사 로그 버그가 수정되었습니다.
+ IAM 지원 DB 클러스터에 대한 HTTP 요청의 IAM ARN이 기록되지 않는 감사 로그 버그가 수정되었습니다.
+ 캐시 쓰기에 사용되는 증분 메모리를 제한하도록 조회 캐시 버그가 수정되었습니다.
+ 쓰기 실패 시 조회 캐시에 읽기 전용 모드를 설정하는 것과 관련된 조회 캐시 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.0.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.0.R3에 대한 업그레이드 경로
엔진 버전 `1.2.0.0`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
[엔진 릴리스 1.1.1.0](engine-releases-1.1.1.0.md)의 최신 패치 릴리스에서 릴리스 `1.2.0.0`으로 수동으로만 업그레이드할 수 있습니다. 이전 엔진 릴리스를 먼저 최신 릴리스 `1.1.1.0`으로 업그레이드해야 `1.2.0.0`으로 업그레이드할 수 있습니다.
먼저 릴리스 `1.1.1.0`으로 업그레이드한 다음 바로 릴리스 `1.2.0.0`으로 업그레이드하는 경우 다음과 같은 오류가 발생할 수 있습니다.
```
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.
```
이 오류가 발생하면 보류 중인 작업이 완료될 때까지 기다리거나, 유지 관리 기간을 즉시 실행하여 이전의 업그레이드를 완료합니다.
## 이 릴리스로 업그레이드
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.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.2.0.0.R2(2022년 10월 14일)
2022년 10월 14일부터 엔진 버전 1.2.0.0.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**참고**
**1.2.0.0 이전 엔진 버전에서 업그레이드하는 경우**
[엔진 릴리스 1.2.0.0](engine-releases-1.2.0.0.md)에서는 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 위한 새로운 형식을 도입했습니다. 따라서 1.2.0.0 이전 엔진 버전에서 엔진 버전 1.2.0.0 이상으로 업그레이드하는 경우 파라미터 그룹 패밀리 `neptune1.2`를 사용하여 기존의 모든 사용자 지정 파라미터 그룹과 사용자 지정 클러스터 파라미터 그룹을 다시 생성해야 합니다. 이전 릴리스에서는 파라미터 그룹 패밀리 `neptune1`을 사용했으며, 이러한 파라미터 그룹은 릴리스 1.2.0.0 이상에서는 작동하지 않습니다. 자세한 정보는 [Amazon Neptune 파라미터 그룹](parameter-groups.md)을 참조하세요.
엔진 릴리스 1.2.0.0에는 실행 취소 로그에 대한 새로운 형식도 도입되었습니다. 따라서 이전 엔진 버전에서 생성된 모든 실행 취소 로그를 삭제하고 [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) CloudWatch 지표가 0으로 떨어져야 1.2.0.0 이전 버전에서 업그레이드를 시작할 수 있습니다. 업데이트를 시작하려고 할 때 실행 취소 로그 기록이 너무 많으면(20만 개 이상), 실행 취소 로그 제거가 완료될 때까지 기다리는 동안 업그레이드를 시도하는 제한 시간이 초과될 수 있습니다.
제거가 이루어지는 클러스터의 라이터 인스턴스를 업그레이드하여 제거 속도를 높일 수 있습니다. 업그레이드를 시도하기 전에 이렇게 하면 시작하기 전에 실행 취소 로그의 수가 줄어들 수 있습니다. 라이터의 크기를 24XL 인스턴스 유형으로 늘리면 제거 속도가 시간당 백만 개 이상으로 증가할 수 있습니다.
`UndoLogsListSize` CloudWatch 지표가 매우 큰 경우 지원 사례를 열면 이를 줄이기 위한 추가 전략을 모색하는 데 도움이 될 수 있습니다.
마지막으로, 릴리스 1.2.0.0에는 IAM 인증과 함께 Bolt 프로토콜을 사용하던 이전 코드에 영향을 미치는 주요 변경 사항이 적용되었습니다. 릴리스 1.2.0.0부터 Bolt는 IAM 서명을 위한 리소스 경로가 필요합니다. Java에서 리소스 경로를 설정하면 `request.setResourcePath("/openCypher"));`처럼 보일 수 있습니다. 다른 언어에서는 엔드포인트 URI에 `/openCypher`를 추가할 수 있습니다. [Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ Gremlin `order-by` 쿼리의 성능이 개선되었습니다. 이제 끝에 `NeptuneGraphQueryStep`이 있는 `order-by`에서 Gremlin 쿼리는 성능 향상을 위해 더 큰 청크 크기를 사용합니다. 이는 쿼리 계획의 내부(루트가 아닌) 노드에 있는 `order-by`에는 적용되지 않습니다.
+ Gremlin 업데이트 쿼리의 성능이 개선되었습니다. 이제 엣지나 속성을 추가할 때 버텍스와 엣지가 삭제되지 않도록 잠금 처리해야 합니다. 이 변경으로 트랜잭션 내 중복 잠금이 제거되어 성능이 향상됩니다.
+ `repeat()` 하위 쿼리 내에서 `dedup()`를 사용하는 Gremlin 쿼리를 기본 실행 계층으로 `dedup` 푸시하여 성능이 개선되었습니다.
+ Gremlin `Neptune#cardinalityEstimates` 쿼리 힌트가 추가되었습니다. `false`로 설정하면 카디널리티 추정치가 사용 해제됩니다.
+ IAM 인증 오류에 대한 사용자 중심의 오류 메시지가 추가되었습니다. 이제 이러한 메시지에는 IAM 사용자 또는 역할 ARN, 리소스 ARN, 요청에 대한 비승인 작업 목록이 표시됩니다. 비승인 작업 목록을 통해 사용 중인 IAM 정책에서 누락되거나 명시적으로 거부될 수 있는 항목을 확인할 수 있습니다.
## 이 엔진 릴리스에서 수정된 결함
+ Neptune의 쿼리 엔진이 사용하는 `where(P.neq('x'))` 및 이를 변형한 쿼리에 대해 잘못된 결과를 생성하는 `WherePredicateStep` 번역과 관련된 Gremlin 정확성 버그가 수정되었습니다.
+ TinkerPop 3.5로 업그레이드한 후 `PartitionStrategy`를 사용하면 “PartitionStrategy는 익명 순회와 함께 작동하지 않습니다”라는 오류 메시지가 잘못 표시되어 순회가 실행되지 않던 Gremlin 버그가 수정되었습니다.
+ 최종 조인의 `joinTime` 및 `Project.ASK` 하위 그룹 내 통계와 관련된 다양한 Gremlin 버그가 수정되었습니다.
+ 경우에 따라 중복 노드 및 엣지 생성을 야기했던 `MERGE` 절의 openCypher 버그가 수정되었습니다.
+ 해당하는 동시 딕셔너리 삽입이 롤백된 경우에도 세션에서 그래프 데이터를 삽입하고 커밋할 수 있는 트랜잭션 버그가 수정되었습니다.
+ 삽입 부하가 심할 경우 성능 회귀가 야기되는 대량 로더 버그가 수정되었습니다.
+ `OPTIONAL` 절 내의 `(NOT) EXISTS`에 포함된 쿼리를 처리할 때 쿼리 결과가 누락되는 SPARQL 버그가 수정되었습니다.
+ 평가 시작 전 제한 시간으로 인해 요청이 취소된 경우 드라이버가 정지되는 것처럼 보이는 버그가 수정되었습니다. 요청 대기열의 항목에 제한 시간이 발생한 상태에서 서버의 모든 쿼리 처리 스레드가 소비되면 이 상태가 반환될 수 있었습니다. 요청 대기열의 제한 시간이 초과되어도 메시지가 즉시 전송되지 않았기 때문에 클라이언트에 응답이 보류 중인 것으로 표시되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.2.0.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.2.0.0.R2에 대한 업그레이드 경로
엔진 버전 `1.2.0.0`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
[엔진 릴리스 1.1.1.0](engine-releases-1.1.1.0.md)의 최신 패치 릴리스에서 릴리스 `1.2.0.0`으로 수동으로만 업그레이드할 수 있습니다. 이전 엔진 릴리스를 먼저 최신 릴리스 `1.1.1.0`으로 업그레이드해야 `1.2.0.0`으로 업그레이드할 수 있습니다.
먼저 릴리스 `1.1.1.0`으로 업그레이드한 다음 바로 릴리스 `1.2.0.0`으로 업그레이드하는 경우 다음과 같은 오류가 발생할 수 있습니다.
```
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.
```
이 오류가 발생하면 보류 중인 작업이 완료될 때까지 기다리거나, 유지 관리 기간을 즉시 실행하여 이전의 업그레이드를 완료합니다.
## 이 릴리스로 업그레이드
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.2.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.2.0.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.1.1.0(2022년 4월 19일)
2022년 4월 19일부터 엔진 버전 1.1.1.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## 이 릴리스의 후속 패치 릴리스
+ [유지 관리 릴리스: 1.1.1.0.R2(2022년 5월 16일)](engine-releases-1.1.1.0.R2.md)
+ [릴리스: 1.1.1.0.R3(2022년 6월 7일)](engine-releases-1.1.1.0.R3.md)
+ [릴리스: 1.1.1.0.R4(2022년 6월 23일)](engine-releases-1.1.1.0.R4.md)
+ [릴리스: 1.1.1.0.R5(2022년 7월 21일)](engine-releases-1.1.1.0.R5.md)
+ [릴리스: 1.1.1.0.R6(2022년 9월 23일)](engine-releases-1.1.1.0.R6.md)
+ [릴리스: 1.1.1.0.R7(2023년 1월 23일)](engine-releases-1.1.1.0.R7.md)
## 이 엔진 릴리스의 새로운 기능
+ [openCypher 쿼리 언어](access-graph-opencypher.md)는 프로덕션 용도의 상용 버전으로 사용할 수 있습니다.
**주의**
이번 릴리스에는 IAM 인증과 함께 openCypher를 사용하는 코드에 대한 주요 변경 사항이 포함되어 있습니다. openCypher의 Neptune 미리 보기에 있는 IAM 서명의 호스트 문자열에는 `bolt://` 등 다음과 같은 프로토콜이 포함되어 있습니다.
```
"Host":"bolt://(host URL):(port)"
```
이번 엔진 릴리스부터는 다음 프로토콜을 생략해야 합니다.
```
"Host":"(host URL):(port)"
```
[Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
+ TinkerPop `3.5.2`에 대한 지원이 추가되었습니다. [이번 릴리스의 변경 사항](https://github.com/apache/tinkerpop/blob/3.5.2/CHANGELOG.asciidoc#release-3-5-2)에는 원격 트랜잭션 지원 및 세션([https://tinkerpop.apache.org/docs/current/reference/#transactions](https://tinkerpop.apache.org/docs/current/reference/#transactions) 사용)에 대한 bytecode 지원, Gremlin 언어에 `datetime()` 함수 추가 등이 포함되어 있습니다.
**주의**
TinkerPop 3.5.0, 3.5.1 및 3.5.2에는 Gremlin 코드에 영향을 미칠 수 있는 몇 가지 주요 변경 사항이 도입되었습니다. 예를 들어 다음과 같이 [GraphTraversalSource에서 생성된 순회를 하위 요소처럼 사용](https://issues.apache.org/jira/browse/TINKERPOP-2361)하면 `g.V().union(identity(), g.V())`는 더 이상 작동하지 않습니다.
이제 대신 다음과 같은 `g.V().union(identity(), __.V())` 익명 순회를 사용하세요.
+ Neptune DB 클러스터 Neptune에 저장된 데이터에 대한 액세스를 제어하는 [IAM 데이터 액세스 정책](iam-admin-policies.md)에서 사용할 수 있는 [AWS 글로벌 조건 키](iam-data-condition-keys.md#iam-data-global-condition-keys)에 대한 지원이 추가되었습니다.
+ 이제 [Neptune DFE 쿼리 엔진](neptune-dfe-engine.md)은 일반적으로 openCypher 쿼리 언어와 함께 프로덕션 용도로 사용할 수 있지만 Gremlin 및 SPARQL 쿼리에는 아직 사용할 수 없습니다. 이제 lab-mode 파라미터 대신 자체 [neptune\$1dfe\$1query\$1engine](parameters.md#parameters-instance-parameters-neptune_dfe_query_engine) 인스턴스 파라미터로 사용할 수 있습니다.
## 이 엔진 릴리스의 개선 사항
+ [openCypher](access-graph-opencypher.md)에 파라미터화된 쿼리 지원, 파라미터화된 쿼리의 추상 구문 트리(AST) 캐싱, 가변 길이 경로(VLP) 개선, 새로운 연산자 및 절과 같은 새로운 기능이 추가되었습니다. 현재 언어 지원 수준은 [Amazon Neptune에 적용되는 openCypher 사양 규정 준수](feature-opencypher-compliance.md)의 내용을 참조하세요.
+ 간단한 읽기 및 쓰기 워크로드에 대한 openCypher의 성능을 크게 개선하여 릴리스 1.1.0.0에 비해 처리량이 더 높아졌습니다.
+ 가변 길이 경로를 처리하는 openCypher 양방향 및 깊이 제한 사항이 제거되었습니다.
+ 다른 조건자 연산자와 조합되는 경우를 포함하여 Gremlin `within` 및 `without` 조건자에 대한 DFE 엔진 지원이 완료되었습니다. 예:
```
g.V().has('age', within(12, 15, 18).or(gt(30)))
```
+ 범위가 글로벌인 경우(즉, 그렇지 않은 경우 `order(local)`) 및 `by()` 변조기를 사용하지 않는 경우 Gremlin `order` 단계에 대한 DFE 엔진 지원이 확대되었습니다. 예를 들어 이제 다음 쿼리는 DFE를 지원합니다.
```
g.V().values("age").order()
```
+ 레코드가 트랜잭션의 마지막 작업임을 나타내기 위해 `isLastOp` 필드를 [Neptune 스트림 변경 로그](streams-using-api-reponse.md) 응답 형식에 추가했습니다.
+ 감사 로깅의 성능을 대폭 개선하고 감사 로깅이 사용 설정된 경우 지연 시간을 줄였습니다.
+ Gremlin WebSocket bytecode 및 HTTP 쿼리를 감사 로그에서 사용자가 읽을 수 있는 형식으로 변환했습니다. 이제 감사 로그에서 직접 쿼리를 복사하여 Neptune 노트북 및 다른 곳에서 실행할 수 있습니다. 현재 감사 로그 형식에 대한 이번 변경 사항은 주요한 사항이라는 점을 참고하시기 바랍니다.
## 이 엔진 릴리스에서 수정된 결함
+ 다음 쿼리에서처럼 중첩된 `filter()` 및 `count()` 단계를 조합하여 사용할 경우 결과가 반환되지 않는 드문 경우의 Gremlin 버그가 수정되었습니다.
```
g.V("1").filter(out("knows")
.filter(in("knows")
.hasId("notExists"))
.count())
```
+ `to()` 또는 `from()` 순회의 조합 중 하나에서 집계 단계로 저장된 버텍스를 `addE` 단계와 함께 사용할 때 오류가 반환되는 Gremlin 버그가 수정되었습니다. 이러한 쿼리의 예는 다음과 같습니다.
```
g.V("id").aggregate("v").out().addE().to(select("v").unfold()))
```
+ DFE 엔진을 사용할 때 엣지 케이스에서 `not` 단계가 실패하는 Gremlin 버그가 수정되었습니다. 예:
```
g.V().not(V())
```
+ `to()` 및 `from()` 순회 내에서 `sideEffect` 값을 사용할 수 없는 Gremlin 버그가 수정되었습니다.
+ 간혹 빠른 재설정에서 인스턴스 장애 조치가 트리거되는 버그가 수정되었습니다.
+ 실패한 트랜잭션이 다음 로드 작업을 시작하기 전에 닫히지 않는 대량 로더 버그가 수정되었습니다.
+ 메모리 부족 상태로 인해 시스템 충돌이 발생할 수 있는 대량 로더 버그가 수정되었습니다.
+ 장애 조치 후 로더가 IAM 보안 인증을 사용할 수 있을 때까지 충분히 기다리지 않는 대량 로더 버그를 수정하기 위한 재시도가 추가되었습니다.
+ `status` 엔드포인트와 같은 쿼리가 아닌 엔드포인트의 내부 보안 인증 캐시가 제대로 지워지지 않는 버그가 수정되었습니다.
+ 스트림 커밋 시퀀스 번호가 올바르게 정렬되도록 스트림 버그가 수정되었습니다.
+ IAM 지원 클러스터에서 장기 실행 연결이 10일 이내에 종료되는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.1.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.1.0에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다. 메이저 버전 엔진(1.1.0.0) 이전 버전은 이번 릴리스로 업그레이드하는 데 시간이 더 오래 걸린다는 점을 참고하시기 바랍니다.
이 릴리스로 자동으로 업그레이드되지 않습니다.
## 이 릴리스로 업그레이드
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
DB 클러스터가 이 릴리스에 대한 업그레이드 경로가 있는 엔진 버전을 실행하는 경우 지금 업그레이드할 수 있습니다. 콘솔에서 DB 클러스터 작업을 사용하여 또는 SDK를 사용하여 적격 클러스터를 업그레이드할 수 있습니다. 다음 CLI 명령은 적격 클러스터를 즉시 업그레이드합니다.
Linux, OS X, Unix의 경우:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine neptune \
4. --engine-version 1.1.1.0 \
5. --allow-major-version-upgrade \
6. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine neptune ^
4. --engine-version 1.1.1.0 ^
5. --allow-major-version-upgrade ^
6. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.1.1.0.R7(2023년 1월 23일)
2023년 1월 23일부터 엔진 버전 1.1.1.0.R7이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## 이 엔진 릴리스의 개선 사항
+ `MERGE` 및 `OPTIONAL MATCH`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ 리터럴 값의 맵 목록에 있는 `UNWIND`와 관련된 openCypher 쿼리의 성능이 개선되었습니다.
+ `id`에 `IN` 필터가 있는 openCypher 쿼리의 성능이 개선되었습니다. 예:
```
MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
```
+ `repeat`, `coalesce`, `store`, `aggregate` 등 다양한 Gremlin 연산자의 성능이 개선되고 정확성이 수정되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ HTTP keep-alive를 사용하는 요청이 실패한 후 제출된 경우 요청이 잘못 종료될 수 있는 openCypher 버그가 수정되었습니다.
+ 목록 또는 맵 목록에 대해 파라미터 유형이 항상 올바르게 해석되지 않는 openCypher 버그가 수정되었습니다.
+ Bolt 및 SPARQL-JSON에서 쿼리가 null 값 대신 `"null"` 문자열을 반환하는 openCypher 버그가 수정되었습니다.
+ 쿼리 제한 시간 실패 및 메모리 부족 오류에 대한 openCypher 오류 코드 및 오류 메시지가 수정되었습니다.
+ DFE 엔진의 `by()` 순회에서 `valueMap()`이 최적화되지 않는 Gremlin 버그가 수정되었습니다.
+ 가끔 엔진이 응답하지 않던 교착 상태 탐지기 로직 관련 문제가 수정되었습니다.
+ 불필요한 정보가 기록되고 로그에서 특정 필드가 누락되는 감사 로그 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.1.0.R7로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.3`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.1.0.R7에 대한 업그레이드 경로
엔진 버전 `1.1.1.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
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.1.1.0.R6(2022년 9월 23일)
2022년 9월 23일부터 엔진 버전 1.1.1.0.R6이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 릴리스에는 IAM 인증과 함께 openCypher를 사용하는 코드에 대한 주요 변경 사항이 포함되어 있습니다. 지금까지 IAM 서명의 호스트 문자열에는 `bolt://` 등 다음과 같은 프로토콜이 포함되었습니다.
```
"Host":"bolt://(host URL):(port)"
```
엔진 릴리스 `1.1.1.0`부터는 다음 프로토콜을 생략해야 합니다.
```
"Host":"(host URL):(port)"
```
[Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ Gremlin `order-by` 쿼리의 성능이 개선되었습니다. 이제 끝에 `NeptuneGraphQueryStep`이 있는 `order-by`에서 Gremlin 쿼리는 성능 향상을 위해 더 큰 청크 크기를 사용합니다. 이는 쿼리 계획의 내부(루트가 아닌) 노드에 있는 `order-by`에는 적용되지 않습니다.
+ Gremlin 업데이트 쿼리의 성능이 개선되었습니다. 이제 엣지나 속성을 추가할 때 버텍스와 엣지가 삭제되지 않도록 잠금 처리해야 합니다. 이 변경으로 트랜잭션 내 중복 잠금이 제거되어 성능이 향상됩니다.
## 이 엔진 릴리스에서 수정된 결함
+ 경우에 따라 중복 노드 및 엣지 생성을 야기했던 `MERGE` 절의 openCypher 버그가 수정되었습니다.
+ `OPTIONAL` 절 내의 `(NOT) EXISTS`에 포함된 SPARQL 쿼리를 처리할 때 쿼리 결과가 누락되는 버그가 수정되었습니다.
+ 대량 로드가 진행 중일 때 서버 재시작이 지연되는 버그가 수정되었습니다.
+ 관계 속성에 필터가 있는 openCypher 가변 길이 패턴 양방향 순회 시 오류가 발생하는 버그가 수정되었습니다. 이러한 가변 길이 패턴의 예제는 `(n)-[r*1..2]->(m)`입니다.
+ 캐시 데이터가 클라이언트로 다시 전송되는 방식과 관련된 버그가 수정되었습니다. 이 경우 지연 시간이 예기치 않게 길어지는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.1.0.R6으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.1.0.R6에 대한 업그레이드 경로
엔진 버전 `1.1.1.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
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.1.1.0.R5(2022년 7월 21일)
2022년 7월 21일부터 엔진 버전 1.1.1.0.R5가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 릴리스에는 IAM 인증과 함께 openCypher를 사용하는 코드에 대한 주요 변경 사항이 포함되어 있습니다. 지금까지 IAM 서명의 호스트 문자열에는 `bolt://` 등 다음과 같은 프로토콜이 포함되었습니다.
```
"Host":"bolt://(host URL):(port)"
```
엔진 릴리스 `1.1.1.0`부터는 다음 프로토콜을 생략해야 합니다.
```
"Host":"(host URL):(port)"
```
[Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 교착 발생 감지를 지원하도록 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 특정 조건에서 DB 클러스터가 완전히 종료되지 않는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.1.0.R5로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.1.0.R5에 대한 업그레이드 경로
엔진 버전 `1.1.1.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
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.1.1.0.R4(2022년 6월 23일)
2022년 6월 23일부터 엔진 버전 1.1.1.0.R4가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 릴리스에는 IAM 인증과 함께 openCypher를 사용하는 코드에 대한 주요 변경 사항이 포함되어 있습니다. 지금까지 IAM 서명의 호스트 문자열에는 `bolt://` 등 다음과 같은 프로토콜이 포함되었습니다.
```
"Host":"bolt://(host URL):(port)"
```
엔진 릴리스 `1.1.1.0`부터는 다음 프로토콜을 생략해야 합니다.
```
"Host":"(host URL):(port)"
```
[Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ `x2g` 인스턴스 유형의 인스턴스 구성이 업데이트되었습니다.
+ 버텍스 드롭 성능이 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 특정 종류의 ASK 조인에서 여러 번 또는 여러 리더에서 호출되는 쿼리에 대해 솔루션이 안정적인 순서를 유지하지 않던 Gremlin 버그가 수정되었습니다.
+ 또한 Gremlin에서 특정 종류의 ASK 조인에 대해 성능 회귀를 유발하던 이전 릴리스의 변경 범위가 제한되었습니다.
+ 하위 순회 내에서 엣지 입력과 버텍스로의 순회가 있을 때 발생하던 `union()` 단계의 Gremlin 버그가 수정되었습니다.
+ 일부 단계가 실제로 최적화되었을 때 최적화되지 않은 것으로 보고되는 Gremlin 프로필 버그가 수정되었습니다.
+ `UNION` 절에 중첩된 `FILTER` 표현식 내에서 사용된 변수에 유효하지 않은 범위 정보가 할당되는 SPARQL 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.1.0.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.1.0.R4에 대한 업그레이드 경로
엔진 버전 `1.1.1.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
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.1.1.0.R3(2022년 6월 7일)
2022년 6월 7일부터 엔진 버전 1.1.1.0.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 릴리스에는 IAM 인증과 함께 openCypher를 사용하는 코드에 대한 주요 변경 사항이 포함되어 있습니다. 지금까지 IAM 서명의 호스트 문자열에는 `bolt://` 등 다음과 같은 프로토콜이 포함되었습니다.
```
"Host":"bolt://(host URL):(port)"
```
엔진 릴리스 `1.1.1.0`부터는 다음 프로토콜을 생략해야 합니다.
```
"Host":"(host URL):(port)"
```
[Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 메모리 집약적인 워크로드에 최적화된 Graviton2 기반 `x2g` 인스턴스 유형에 대한 지원이 추가되었습니다. 초기에는 다음 4가지 AWS 리전에서만 사용할 수 있습니다.
+ 미국 동부 (버지니아 북부) (`us-east-1`)
+ 미국 동부 (오하이오)(`us-east-2`)
+ 미국 서부(오레곤) (`us-west-2`)
+ 유럽(아일랜드) (`eu-west-1`)
자세한 내용은 [Neptune 요금 페이지](https://aws.amazon.com/neptune/pricing/)를 참조하세요.
+ 다중 엣지 또는 버텍스 순회, 속성 조회 또는 레이블 검색이 수반되는 Gremlin 단계의 성능이 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 하위 순회 내에서 `otherV()` 단계를 처리할 때 발생하는 Gremlin 버그가 수정되었습니다.
+ 하위 항목일 때 필터 단계만 있는 `union`이 포함된 쿼리의 Gremlin 버그가 수정되었습니다. 예:
```
g.V().union(has("name"), out("knows")).out()
```
+ `UNION` 절에 중첩된 `FILTER` 표현식 내에서 사용된 변수에 유효하지 않은 범위 정보가 할당되는 SPARQL 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.1.0.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.1.0.R3에 대한 업그레이드 경로
엔진 버전 `1.1.1.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
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.1.1.0.R2(2022년 5월 16일)
2022년 5월 16일부터 엔진 버전 1.1.1.0.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 릴리스에는 IAM 인증과 함께 openCypher를 사용하는 코드에 대한 주요 변경 사항이 포함되어 있습니다. 지금까지 IAM 서명의 호스트 문자열에는 `bolt://` 등 다음과 같은 프로토콜이 포함되었습니다.
```
"Host":"bolt://(host URL):(port)"
```
엔진 릴리스 `1.1.1.0`부터는 다음 프로토콜을 생략해야 합니다.
```
"Host":"(host URL):(port)"
```
[Bolt 프로토콜 사용](access-graph-opencypher-bolt.md)의 예제를 참조하세요.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.1.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 초기 버전 지원:* `3.5.2`
+ *Gremlin 최신 버전 지원:* `3.5.4`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.1.0.R2에 대한 업그레이드 경로
엔진 버전 `1.1.1.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
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.1.1.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.1.0 ^
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.1.0.0(2021년 11월 19일)
2021년 11월 19일부터 엔진 버전 1.1.0.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 엔진 릴리스부터 Neptune은 [더 이상 `R4` 인스턴스 유형을 지원하지 않습니다](instance-types.md#instance-type-r4). DB 클러스터에서 `R4` 인스턴스를 사용하는 경우 이번 릴리스로 업그레이드하기 전에 수동으로 다른 인스턴스 유형으로 교체해야 합니다. 작성자 인스턴스가 `R4`인 경우 [다음 지침](best-practices-general-basic.md#best-practices-resize-instance)에 따라 진행합니다.
## 이 릴리스의 후속 패치 릴리스
+ [유지 관리 릴리스: 1.1.0.0.R2(2022년 5월 16일)](engine-releases-1.1.0.0.R2.md)
+ [유지 관리 릴리스: 1.1.0.0.R3(2022년 12월 23일)](engine-releases-1.1.0.0.R3.md)
## 이 엔진 릴리스의 새로운 기능
+ [AWS Graviton2 프로세서](https://aws.amazon.com/ec2/graviton/)로 구동되는 범용 `T4g` 및 메모리 최적화 `R6g` 데이터베이스 인스턴스를 도입했습니다. Graviton2 기반 인스턴스는 다양한 워크로드에 대해 동급의 현재 세대 x86 기반 인스턴스보다 훨씬 더 나은 요금 및 성능을 제공합니다. 이러한 새 인스턴스 유형에서는 애플리케이션이 정상적으로 작동하므로 업그레이드할 때 애플리케이션 코드를 이식할 필요가 없습니다.
요금과 리전 가용성에 대한 자세한 내용은 [Amazon Neptune 요금 페이지](https://aws.amazon.com/neptune/pricing/)를 참조하세요.
+ Neptune ML에 [사용자 지정 모델](machine-learning-custom-models.md)을 도입했습니다.
+ Neptune ML에 [SPARQL 추론 쿼리](machine-learning-sparql-inference-queries.md)에 대한 지원이 추가되었습니다.
+ 속성 그래프 데이터에 대한 [새 스트림 엔드포인트](streams-using-api-call.md)를 추가했습니다. 즉, 다음 내용을 참조합니다.
```
https://Neptune-DNS:8182/propertygraph/stream
```
이름이 `PG_JSON`인 이 엔드포인트의 출력 형식은 기존 `gremlin/stream`의 `GREMLIN_JSON` 출력 형식과 완전히 동일합니다.
새 `propertygraph/stream` 엔드포인트는 Neptune 스트림 지원을 openCypher로 확장하고 `gremlin/stream` 엔드포인트를 관련 `GREMLIN_JSON` 출력 형식으로 대체합니다.
## 이 엔진 릴리스의 개선 사항
+ Neptune 스트림이 다음과 같이 개선되었습니다.
+ 변경 로그 스트림의 각 레코드에 대한 타임스탬프를 제공하기 위해 [Neptune 스트림 변경 로그 응답 형식](streams-using-api-reponse.md)의 `commitTimestamp` 필드를 `records` 객체에 추가했습니다.
+ 스트림에서 유효한 마지막 eventId를 검색할 수 있도록 `iteratorType` 파라미터에 `LATEST` 값이 추가되었습니다. [스트림 API 호출](streams-using-api-call.md) 섹션을 참조하세요.
+ Gremlin 노드 분류 및 회귀 쿼리에서 [추론 신뢰도 점수](machine-learning-gremlin-inference-query-predicates.md#machine-learning-gremlin-inference-neptune-ml-score-predicate)를 가져올 수 있는 지원이 추가되었습니다.
+ openCypher에 `OPTIONAL MATCH` 절에 대한 지원이 추가되었습니다.
+ openCypher에 `MERGE` 절에 대한 지원이 추가되었습니다.
+ openCypher의 `WITH` 절에 `ORDER BY`를 사용하는 지원이 추가되었습니다.
+ openCypher에 패턴 이해에 대한 지원이 추가되었고, 존재 확인 외에도 패턴 표현식에 대한 지원이 확장되었습니다.
+ openCypher의 `DELETE` 및 `DELETE DETACH` 절에 대한 지원이 확장되어 이제 다른 업데이트 절과 함께 사용할 수 있습니다.
+ openCypher에서 `RETURN`과 함께 사용되는 `CREATE` 및 `UPDATE` 절에 대한 지원이 확장되었습니다.
+ DFE 엔진에 Gremlin `limit`, `range`, `skip` 단계에 대한 지원이 추가되었습니다.
+ `explain`과 `profile` 중 어느 쪽도 요청되지 않은 경우 DFE 엔진의 쿼리 실행이 개선되었습니다.
+ `value` 표현식에 대한 DFE 엔진의 쿼리 실행이 개선되었습니다.
+ 동시 수정 예외를 방지하고 다음과 같은 쿼리 패턴을 체인으로 연결할 수 있도록 여러 개의 연결된 Gremlin 조건부 삽입 패턴이 개선되었습니다.
+ ID별 조건부 버텍스 삽입(예:
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID))
```
+ 여러 레이블이 포함된 조건부 버텍스 삽입. 예:
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1::L2").property(id,ID))
```
+ ID별 조건부 엣지 삽입. 예:
```
g.E(ID).fold().coalesce(unfold(), V(from).addE(label).to(V(to)).property(id, ID))
```
+ 여러 레이블이 포함된 조건부 엣지 삽입. 예:
```
g.E(ID).fold().coalesce(unfold(), g.addE(label).from(V(from)).to(V(to)).property(id, ID))
```
+ 조건부 삽입 후 쿼리 실행. 예:
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID)).project("myvalues").by(valueMap())
```
+ 추가된 속성으로 조건부 삽입. 예:
```
g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID).property("name","pumba"))
```
## 이 엔진 릴리스에서 수정된 결함
+ 지원할 수 없었던 `T3.medium` 인스턴스 유형에 대한 [통계](neptune-dfe-statistics.md) 기능이 사용 해제되었습니다.
+ `explain`에서 상수가 아닌 값을 취하는 `IN` 함수의 SPARQL 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.0.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.0.0에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
이 릴리스로 자동으로 업그레이드되지 않습니다.
## 이 릴리스로 업그레이드
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.1.0.0 \
4. --allow-major-version-upgrade \
5. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.0.0 ^
4. --allow-major-version-upgrade ^
5. --apply-immediately
```
`--apply-immediately` 대신 `--no-apply-immediately`를 지정할 수 있습니다. 메이저 버전 업그레이드를 수행하려면 allow-major-version-upgrade 파라미터가 필요합니다. 또한 엔진 버전을 반드시 포함해야 합니다. 그렇지 않으면 엔진이 다른 버전으로 업그레이드될 수 있습니다.
클러스터에서 사용자 지정 클러스터 파라미터 그룹을 사용하는 경우 다음 파라미터를 포함하여 지정해야 합니다.
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
마찬가지로 클러스터의 인스턴스가 사용자 지정 DB 파라미터 그룹을 사용하는 경우 이 파라미터를 포함하여 지정해야 합니다.
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 업그레이드하기 전에 항상 테스트 수행
새로운 메이저 또는 마이너 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.1.0.0.R3(2022년 12월 23일)
2022년 12월 23일부터 엔진 버전 1.1.0.0.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드를 성공적으로 완료하려면 모든 가용 영역(AZ)의 각 서브넷에 Neptune 인스턴스당 하나 이상의 IP 주소를 사용할 수 있어야 합니다. 예를 들어 서브넷 1에 작성기 인스턴스 하나와 리더 인스턴스 2개가 있고 서브넷 2에 리더 인스턴스가 2개 있는 경우, 업그레이드를 시작하기 전에 서브넷 1에는 적어도 3개 이상의 IP 주소가 비어 있어야 하고 서브넷 2에는 적어도 2개 이상의 IP 주소가 비어 있어야 합니다.
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## 이 엔진 릴리스의 개선 사항
+ `repeat`, `coalesce`, `store`, `aggregate` 등 다양한 Gremlin 연산자의 성능이 개선되고 정확성이 수정되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ CPU 스파이크 문제가 해결되었습니다.
+ Bolt 및 SPARQL-JSON에서 쿼리가 null 값 대신 `"null"` 문자열을 반환하는 openCypher 버그가 수정되었습니다.
+ 불필요한 정보가 기록되고 로그에서 특정 필드가 누락되는 감사 로그 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.0.0.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.0.0.R3에 대한 업그레이드 경로
엔진 버전 `1.1.0.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 엔진 릴리스부터 Neptune은 [더 이상 `R4` 인스턴스 유형을 지원하지 않습니다](instance-types.md#instance-type-r4). DB 클러스터에서 `R4` 인스턴스를 사용하는 경우 이번 릴리스로 업그레이드하기 전에 수동으로 다른 인스턴스 유형으로 교체해야 합니다. 작성자 인스턴스가 `R4`인 경우 [다음 지침](best-practices-general-basic.md#best-practices-resize-instance)에 따라 진행합니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.1.0.0.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.1.0.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.0.0 ^
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.1.0.0.R2(2022년 5월 16일)
2022년 5월 16일부터 엔진 버전 1.1.0.0.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
**중요**
**`1.1.0.0`보다 이전 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 몇 분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
## 이 엔진 릴리스에서 수정된 결함
+ 상태 엔드포인트와 같은 쿼리가 아닌 엔드포인트의 내부 보안 인증 캐시가 제대로 지워지지 않는 버그가 수정되었습니다.
+ 엔진 업그레이드 후 복제 지연이 증가하는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.1.0.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *openCypher 버전:* `Neptune-9.0.20190305-1.0`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.1.0.0.R2에 대한 업그레이드 경로
엔진 버전 `1.1.0.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
**중요**
**`1.1.0.0`보다 이전인 모든 버전에서 이 엔진 릴리스로 업그레이드하면 DB 클러스터의 모든 인스턴스에서 운영 체제 업그레이드도 트리거됩니다. 운영 체제 업그레이드 중에 발생하는 활성 쓰기 요청은 처리되지 않으므로 업그레이드를 시작하기 전에 대량 데이터 로드를 포함하여 업그레이드 중인 클러스터에 대한 모든 쓰기 워크로드를 일시 중지해야 합니다.**
업그레이드 시작 시 Neptune은 DB 클러스터 정보를 기반으로 이름 뒤에 자동 생성된 식별자 뒤에 `preupgrade`로 구성된 스냅샷을 생성합니다. 이 스냅샷에는 요금이 부과되지 않으며 업그레이드 프로세스 중에 문제가 발생할 경우 이를 사용하여 DB 클러스터를 복원할 수 있습니다.
엔진 업그레이드 자체가 완료되면 기존 운영 체제에서 새 엔진 버전을 잠시 사용할 수 있지만 5분 이내에 클러스터의 모든 인스턴스가 동시에 운영 체제 업그레이드를 시작합니다. 이 시점에서 약 6분 동안은 DB 클러스터를 사용할 수 없습니다. 업그레이드가 완료된 후 쓰기 워크로드를 재개할 수 있습니다.
이 프로세스에서는 다음과 같은 이벤트가 생성됩니다.
클러스터별 이벤트 메시지:
`Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]`
`Database cluster major version has been upgraded`
인스턴스별 이벤트 메시지:
`Applying off-line patches to DB instance`
`DB instance shutdown`
`Finished applying off-line patches to DB instance`
`DB instance restarted`
**참고**
이번 엔진 릴리스부터 Neptune은 [더 이상 `R4` 인스턴스 유형을 지원하지 않습니다](instance-types.md#instance-type-r4). DB 클러스터에서 `R4` 인스턴스를 사용하는 경우 이번 릴리스로 업그레이드하기 전에 수동으로 다른 인스턴스 유형으로 교체해야 합니다. 작성자 인스턴스가 `R4`인 경우 [다음 지침](best-practices-general-basic.md#best-practices-resize-instance)에 따라 진행합니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.1.0.0.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.1.0.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.1.0.0 ^
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.5.1(2021년 10월 1일)
2021년 10월 1일부터 엔진 버전 1.0.5.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.5.1.R2(2021년 10월 26일)](engine-releases-1.0.5.1.R2.md)
+ [릴리스: 1.0.5.1.R3(2022년 1월 13일)](engine-releases-1.0.5.1.R3.md)
+ [유지 관리 릴리스: 1.0.5.1.R4(2022년 5월 16일)](engine-releases-1.0.5.1.R4.md)
## 이 엔진 릴리스의 새로운 기능
+ 지정된 쿼리의 결과를 캐싱하기 위한 [결과 캐시](gremlin-results-cache.md)가 추가되었습니다.
+ Neptune openCypher에 날짜/시각 지원이 추가되었습니다.
+ Neptune openCypher의 요소에 대한 `List` 및 `Map` 액세스가 추가되었습니다.
## 이 엔진 릴리스의 개선 사항
+ Neptune openCypher 엔드포인트 이름에서 대소문자를 구분하지 않도록 했습니다.
+ openCypher 설명이 개선되었습니다.
+ `iterate()` 및 `profile()` 단계로 종료되는 Gremlin 단일 업서트 쿼리 패턴이 개선되었습니다.
+ Gremlin `keys()` 및 `property()` 함수의 성능이 개선되었습니다.
+ Gremlin `dedup()` 단계는 글로벌 범위와 함께 사용되는 경우 DFE에서 실행됩니다.
+ DFE 엔진이 사용되면 DFE 엔진에서 다음과 같은 Gremlin `HAS` 조건자가 실행됩니다.
+ `EQ`
+ `NEQ`
+ `LT`
+ `LTE`
+ `GT`
+ `GTE`
+ `BETWEEN`
+ `INSIDE`
+ `OUTSIDE`
+ `WITHIN`
+ `AND (connectives)`
+ `OR (connectives)`
+ LIMIT 쿼리 성능이 개선되었습니다.
+ openCypher 일반 집계 쿼리의 성능이 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 엣지를 다른 엣지에 연결할 수 있었던 Gremlin 버그가 수정되었습니다.
+ 최적화되지 않은 조인 전략이 선택되던 Gremlin 버그가 수정되었습니다.
+ 100개 이상의 속성이 존재할 때 노드 및 관계의 직렬화가 중단되는 Gremlin 버그가 수정되었습니다.
+ 그래프 패턴이 큰 쿼리의 쿼리 계획 실행 속도가 느려지는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.1에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
이 릴리스로 자동으로 업그레이드하지 않습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.1을 이제 정식 버전으로 사용할 수 있습니다.
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.5.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
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.5.1.R4(2022년 5월 16일)
2022년 5월 16일부터 엔진 버전 1.0.5.1.R4가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.1.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.1.R4에 대한 업그레이드 경로
엔진 버전 `1.0.5.1`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.1.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.5.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
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.5.1.R3(2022년 1월 13일)
2022년 1월 13일부터 엔진 버전 1.0.5.1.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ 쿼리가 필요한 리소스를 모두 확보하지 못할 경우 리소스 누수가 발생할 수 있는 버그가 수정되었습니다.
+ 쿼리 실행 중에 요청되지 않은 메모리 할당으로 인해 발생하는 작은 메모리 누수가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.1.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.1.R3에 대한 업그레이드 경로
엔진 버전 `1.0.5.1`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.1.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.5.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
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.5.1.R2(2021년 10월 26일)
2021년 10월 26일부터 엔진 버전 1.0.5.1.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ 반복 가능한 읽기 격리 상태에서 이전 버전의 그래프 요소를 만드는 동안 일시적인 오류가 발생하여 서버가 다시 시작되던 버그가 수정되었습니다. 이제 Neptune이 대신 오류를 반환하므로 클라이언트가 재시도할 수 있습니다.
+ 단일 카디널리티 업데이트 중에 일시적인 오류가 발생하여 서버가 다시 시작되던 버그가 수정되었습니다. 이제 Neptune이 대신 오류를 반환하므로 클라이언트가 재시도할 수 있습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.1.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.1.R2에 대한 업그레이드 경로
엔진 버전 `1.0.5.1`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.1.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.5.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.1 ^
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.5.0(2021년 7월 27일)
2021년 7월 27일부터 엔진 버전 1.0.5.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.5.0.R2(2021년 8월 16일)](engine-releases-1.0.5.0.R2.md)
+ [릴리스: 1.0.5.0.R3(2021년 9월 15일)](engine-releases-1.0.5.0.R3.md)
+ [유지 관리 릴리스: 1.0.5.0.R5(2022년 5월 16일)](engine-releases-1.0.5.0.R5.md)
## 이 엔진 릴리스의 새로운 기능
+ [Neptune ML](machine-learning.md)은 많은 새로운 기능을 갖추고 프로덕션용으로 출시되었으며 더 이상 랩 모드가 아닙니다.
+ 랩 모드에서 [openCypher](access-graph-opencypher.md) 쿼리 언어에 대한 초기 지원이 추가되었습니다. **openCypher**는 Cypher 쿼리 언어의 오픈 소스 표준입니다. 이 구문은 [Cypher 쿼리 언어 참조(버전 9)](https://s3.amazonaws.com/artifacts.opencypher.org/openCypher9.pdf)에 명시되어 있으며 [openCypher](http://www.opencypher.org/) 프로젝트에서 유지 관리됩니다.
Neptune 언어 구현에 대한 자세한 내용은 [openCypher를 사용하여 Neptune 그래프에 액세스](access-graph-opencypher.md)에서 참조하세요.
Neptune 클라이언트가 openCypher 쿼리에 사용하는 [Bolt 프로토콜](https://neo4j.com/docs/bolt/current/bolt/)에 대한 지원도 이용 가능합니다. [Bolt 프로토콜을 사용하여 Neptune에 대한 openCypher 쿼리 생성](access-graph-opencypher-bolt.md)을(를) 참조하세요.
이제 openCypher에 대한 지원이 자동으로 사용 설정되지만, 현재는 [랩 모드](features-lab-mode.md)에서만 사용할 수 있는 [Neptune DFE 엔진](neptune-dfe-engine.md)에 따라 달라질 수 있습니다. 이제 `neptune_lab_mode` DB 클러스터 파라미터의 기본 `DFEQueryEngine` 설정은 `DFEQueryEngine=viaQueryHint`입니다. 즉 엔진은 사용 설정되지만 `useDFE` 쿼리 힌트가 존재하고 `true`로 설정된 쿼리에만 사용됩니다. `DFEQueryEngine=disabled` 설정을 통해 DFE 엔진을 사용 해제하면 openCypher를 사용할 수 없게 됩니다.
+ [SPARQL 1.1 그래프 스토어 HTTP 프로토콜](https://www.w3.org/TR/sparql11-http-rdf-update/)에 대한 지원이 추가되었습니다. [Amazon Neptune에서 SPARQL 1.1 그래프 스토어 HTTP 프로토콜(GSP) 사용](sparql-graph-store-protocol.md)을(를) 참조하세요.
+ 이제 [Neptune DFE 엔진](neptune-dfe-engine.md)의 기본 랩 모드 설정값은 `viaQueryHint`입니다. 즉 이제 DFE 엔진은 기본적으로 사용 설정되지만 `useDFE` 쿼리 힌트가 존재하고 `true`로 설정된 쿼리에만 사용됩니다.
+ Neptune DFE 엔진의 통계 계산을 모니터링하기 위한 `StatsNumStatementsScanned`가 새로운 Amazon CloudWatch 지표로 추가되었습니다. [`StatsNumStatementsScanned` CloudWatch 지표를 사용하여 통계 계산 모니터링](neptune-dfe-statistics.md#neptune-dfe-statistics-monitoring)을(를) 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ TinkerPop 3.4.11에 대한 지원이 추가되었습니다.
**중요**
TinkerPop 버전 3.4.11에서 쿼리 처리 방식의 정확성을 향상시키는 변경 사항이 적용되었지만, 현재로서는 쿼리 성능에 간혹 심각한 영향을 미칠 수 있습니다.
예를 들어 다음과 같은 쿼리는 실행 속도가 상당히 느릴 수 있습니다.
```
g.V().hasLabel('airport').
order().
by(out().count(),desc).
limit(10).
out()
```
이제 TinkerPop 3.4.11의 변경 사항으로 인해 제한 단계 이후의 버텍스를 최적화하지 않은 방식으로 가져옵니다. 이를 방지하려면 `order().by()` 이후 언제든지 barrier() 단계를 추가하여 쿼리를 수정할 수 있습니다. 예:
```
g.V().hasLabel('airport').
order().
by(out().count(),desc).
limit(10).
barrier().
out()
```
+ 이제 [SPARQL `joinOrder` 쿼리 힌트](sparql-query-hints-joinOrder.md)가 Neptune DFE 대체 쿼리 엔진에서 지원됩니다.
+ [Neptune 상태 API](access-graph-status.md)의 출력이 확장 및 재구성되어 DB 클러스터의 설정 및 기능을 보다 명확하게 파악할 수 있습니다.
새 출력에는 DB 클러스터 기능에 대한 상태 정보가 포함된 최상위 `features` 객체와 설정 정보가 포함된 최상위 `settings` 객체가 있습니다. 새 형식을 검토하려면 [instance status 명령의 출력 예제](access-graph-status.md#access-graph-status-sample-output)에서 내용을 참조하세요.
+ 서버의 마지막 이벤트 ID로 `AFTER_SEQUENCE_NUMBER` 스트림을 요청하고 해당 이벤트 ID가 이미 만료된 경우 스트리밍 변경 로그를 처리합니다. 요청된 이벤트 ID가 서버에서 가장 최근에 제거된 이벤트 ID인 경우 서버에서 만료된 이벤트 ID 오류가 더 이상 발생하지 않습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 숫자 값 순서와 관련된 Gremlin 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.0에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
이 릴리스로 자동으로 업그레이드하지 않습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.0을 이제 정식 버전으로 사용할 수 있습니다.
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.5.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
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.5.0.R5(2022년 5월 16일)
2022년 5월 16일부터 엔진 버전 1.0.5.0.R5가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.0.R5로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.0.R5에 대한 업그레이드 경로
엔진 버전 1.0.5.0을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 유지 관리 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.0.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.5.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
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.5.0.R3(2021년 9월 15일)
2021년 9월 15일부터 엔진 버전 1.0.5.0.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ 다음 상황 중 하나에서 엔진이 응답하지 않는 버그가 수정되었습니다.
+ 자동 통계 계산이 수행되는 동시에 대량 로드가 발생합니다.
+ 통계 계산이 이미 수행되고 있는 동시에 수동으로 통계 계산이 요청되었습니다.
+ 엔진 충돌을 일으킬 수 있는 교착 발생 감지 및 잠금 획득 버그가 수정되었습니다.
+ Gremlin 추론 쿼리의 원격 ML 엔드포인트에서 알 수 없는 데이터를 발견했을 때 엔진에서 오류가 발생하는 Gremlin 버그가 수정되었습니다.
+ 모델 변환 작업 및 인스턴스 권장 사항과 관련된 ML 모델 관리 API의 여러 버그가 수정되었습니다.
+ 노드 및 엣지 ID를 생성할 때 발생하는 충돌의 원인일 수 있는 버그가 수정되었습니다.
+ 그래프 패턴이 큰 쿼리의 쿼리 계획 생성 속도가 느려지는 버그가 수정되었습니다.
+ 속성이 100개가 넘는 노드를 검색할 때 쿼리가 중단될 수 있는 openCypher 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.0.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.0.R3에 대한 업그레이드 경로
엔진 버전 1.0.5.0을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.0.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.5.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
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.5.0.R2(2021년 8월 16일)
2021년 8월 16일부터 엔진 버전 1.0.5.0.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ [엔진 릴리스 `1.0.5.0`](engine-releases-1.0.5.0.md)에서 [Neptune 조회 캐시](feature-overview-lookup-cache.md)가 복제본에서 엔진 재시작 후에도 유지되도록 하는 최적화를 사용 해제했습니다. 이제 복제본을 다시 시작하면 조회 캐시가 지워집니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.5.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.11`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.5.0.R2에 대한 업그레이드 경로
엔진 버전 `1.0.5.0`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.5.0.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.5.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.5.0 ^
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.4.2(2021년 6월 1일)
**참고**
엔진 릴리스 버전 1.0.4.2.R2는 실제로 릴리스된 1.0.4.2의 첫 번째 버전입니다.
**Topics**
+ [Amazon Neptune 엔진 버전 1.0.4.2.R5(2021년 8월 16일)](engine-releases-1.0.4.2.R5.md)
+ [Amazon Neptune 엔진 버전 1.0.4.2.R4(2021년 7월 23일)](engine-releases-1.0.4.2.R4.md)
+ [Amazon Neptune 엔진 버전 1.0.4.2.R3(2021년 6월 28일)](engine-releases-1.0.4.2.R3.md)
+ [Amazon Neptune 엔진 버전 1.0.4.2.R2(2021년 6월 1일)](engine-releases-1.0.4.2.R2.md)
+ [Amazon Neptune 엔진 버전 1.0.4.2.R1(2021년 5월 27일)](engine-releases-1.0.4.2.R1.md)
# Amazon Neptune 엔진 버전 1.0.4.2.R5(2021년 8월 16일)
2021년 8월 16일부터 엔진 버전 1.0.4.2.R5가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ [엔진 릴리스 `1.0.4.2.R4`](engine-releases-1.0.4.2.R4.md)에서 [Neptune 조회 캐시](feature-overview-lookup-cache.md)가 복제본에서 엔진 재시작 후에도 유지되도록 하는 최적화를 사용 해제했습니다. 이제 복제본을 다시 시작하면 조회 캐시가 지워집니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.2.R5로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.10`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.2.R5에 대한 업그레이드 경로
엔진 버전 `1.0.4.2`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
# Amazon Neptune 엔진 버전 1.0.4.2.R4(2021년 7월 23일)
2021년 7월 23일부터 엔진 버전 1.0.4.2.R4가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스의 개선 사항
+ 복제본에서 빠른 재설정을 실행한 후 중복 캐시가 지워지지 않도록 조회 캐시의 동작이 개선되었습니다.
+ 서버의 마지막 이벤트 ID로 `AFTER_SEQUENCE_NUMBER` 스트림을 요청하고 해당 이벤트 ID가 이미 만료된 경우 스트리밍 변경 로그를 처리하는 프로세스가 개선되었습니다. 요청된 이벤트 ID가 서버에서 가장 최근에 제거된 이벤트 ID인 경우 서버에서 만료된 이벤트 ID 오류가 더 이상 발생하지 않습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 1.0.4.0.R1에 도입된 후 쿼리가 760자보다 큰 문자열 값 전체를 반환하지 않는 버그가 수정되었습니다. 이 버그의 영향을 받은 용어는 RDF 리터럴 및 URI 또는 Gremlin ID, 키, 문자열 값이었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.2.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.10`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.2.R4에 대한 업그레이드 경로
엔진 버전 `1.0.4.2`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
# Amazon Neptune 엔진 버전 1.0.4.2.R3(2021년 6월 28일)
2021년 6월 28일부터 엔진 버전 1.0.4.2.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이번 엔진 릴리스에서 알려진 문제
**문제:**
공백이 있는 경우 `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"
```
## 이 엔진 릴리스에서 수정된 결함
+ 빠른 재설정 후 복제본의 조회 캐시를 지우는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.2.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.10`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.2.R3에 대한 업그레이드 경로
DB 클러스터에서 하나 이상의 `R5d` 인스턴스를 사용하지 않으면 이 패치 릴리스는 선택 사항입니다. 클러스터에 `R5d` 인스턴스가 있으면 다음 유지 관리 기간에 자동으로 업그레이드됩니다. 인스턴스가 없으면 이 패치 릴리스로 자동 업그레이드되지 않습니다.
AWS CLI [apply-pending-maintenance-action](https://docs.aws.amazon.com/cli/latest/reference/neptune/apply-pending-maintenance-action.html) 명령([ApplyPendingMaintenanceAction](api-other-apis.md#ApplyPendingMaintenanceAction) API)을 사용하여 `1.0.4.2.R2` 릴리스를 이 `1.0.4.2.R3` 릴리스로 수동 업그레이드할 수 있습니다.
# Amazon Neptune 엔진 버전 1.0.4.2.R2(2021년 6월 1일)
2021년 6월 1일부터 엔진 버전 1.0.4.2.R2가 일반적으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.4.2.R3(2021년 6월 28일)](engine-releases-1.0.4.2.R3.md)
## 이번 엔진 릴리스에서 알려진 문제
**문제:**
공백이 있는 경우 `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 조회 캐시](feature-overview-lookup-cache.md)의 내용을 참조하세요.
+ 새로운 lab-mode 파라미터가 추가되었으며, 이를 통해 실험용 DFE 엔진을 `useDFE` 쿼리 힌트와 함께 쿼리별로만 호출할 수 있습니다.
## 이 엔진 릴리스의 개선 사항
+ TinkerPop 3.4.10에 대한 지원이 추가되었습니다.
+ Gremlin 스크립트 요청을 보낼 때 `withStrategies( )` 구성 단계를 사용하기 위한 지원이 추가되었습니다. 특히 `SubgraphStrategy`, `PartitionStrategy`, `ReadOnlyStrategy`, `EdgeLabelVerificationStrategy`, `ReservedKeysVerificationStrategy`가 모두 지원됩니다.
+ 쿼리 도중의 `V()` 순회 최적화가 추가되었습니다. 이전에는 Neptune에서 이러한 순회가 최적화되지 않았습니다.
+ [RFC 2141 URN](https://tools.ietf.org/html/rfc2141)을 대량 로드의 `baseUri` 및 `namedGraphUri` 파라미터로 사용할 수 있도록 지원이 추가되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 구문 분석기에서 잘못된 쿼리가 유효한 것으로 처리되는 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의 경우:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.4.2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.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.4.2.R1(2021년 5월 27일)
엔진 릴리스 1.0.4.2.R1은 배포된 적이 없습니다.
# Amazon Neptune 엔진 버전 1.0.4.1(2020년 12월 8일)
2020년 12월 8일부터 엔진 버전 1.0.4.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.4.1.R1.1(2021년 3월 22일)](engine-releases-1.0.4.1.R1.1.md)
+ [릴리스: 1.0.4.1.R2(2021년 2월 24일)](engine-releases-1.0.4.1.R2.md)
**중요**
[릴리스: 1.0.4.0(2020년 10월 12일)](engine-releases-1.0.4.0.md)은 Amazon Neptune에 대한 모든 연결에 TLS 1.2 및 HTTPS를 필수로 설정했습니다. 하지만 이 릴리스의 버그를 통해, 이전에 DB 클러스터 파라미터를 설정한 고객도 HTTP 연결 또는 기존 TLS 연결이 계속 작동할 수 있도록 하여 이전의 HTTPS 연결 적용을 방지합니다.
이 버그는 패치 릴리스 [1.0.4.0.R2](engine-releases-1.0.4.0.R2.md) 및 [1.0.4.1.R2](engine-releases-1.0.4.1.R2.md)에서 수정되었지만 이 수정으로 인해 패치가 자동으로 설치될 때 예상치 못한 연결 장애가 발생했습니다. 이러한 이유로 두 패치 모두 되돌려졌으며, 수동으로만 설치하여 TLS 1.2의 설정을 업데이트할 수 있습니다.
Neptune에 대한 모든 연결에 SSL/TLS를 사용하면 Gremlin 콘솔, Gremlin 드라이버, Gremlin Python, .NET, nodeJs, REST API와의 연결 및 로드 밸런서 연결에 영향을 줍니다. 지금까지 이들 중 일부 또는 전부에 대해 HTTP 또는 이전 TLS 버전을 사용하고 있다면 이 최신 패치를 시스템에 업데이트하기 전에 관련 클라이언트와 드라이버를 업데이트하고 HTTPS만 사용하도록 코드를 변경해야 합니다.
## 이 엔진 릴리스의 새로운 기능
+ Amazon Neptune에 강력한 기계 학습 기능을 제공하는 Neptune ML 기능이 도입되었습니다. [그래프에 대한 기계 학습을 위한 Amazon Neptune ML](machine-learning.md)을(를) 참조하세요.
+ 원격 소스에서 가져온 데이터를 제거하기 위한 사용자 지정 SPARQL `UNLOAD` 작업이 추가되었습니다. [SPARQL UPDATE UNLOAD](sparql-api-reference-unload.md)을(를) 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 동시 수정 예외가 발생하지 않도록 일부 Gremlin 조건부 삽입 패턴이 최적화되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ `as()` 단계를 사용하는 특정 패턴의 쿼리에서 결과가 누락될 수 있는 Gremlin 버그가 수정되었습니다.
+ `union()` 등의 `project()` 단계 내에 중첩된 단계를 사용할 때 오류가 발생할 수 있는 Gremlin 버그가 수정되었습니다.
+ `project()` 단계의 Gremlin 버그가 수정되었습니다.
+ 문자열 기반 순회에서 `none()` 단계가 작동하지 않는 Gremlin 버그가 수정되었습니다.
+ 문자열 기반 순회에서 빈 맵이 `inject()` 단계의 인수로 지원되지 않던 Gremlin 버그가 수정되었습니다.
+ DFE 엔진의 문자열 기반 순회 실행에서 `toList()` 등의 터미널 메서드가 제대로 작동하지 않던 Gremlin 버그가 수정되었습니다.
+ 문자열 쿼리의 `iterate()` 단계를 사용할 때 트랜잭션을 닫지 못하는 Gremlin 버그가 수정되었습니다.
+ `is(P.gte(0))` 패턴을 사용하는 쿼리가 특정 조건에서 예외를 발생시킬 수 있는 Gremlin 버그가 수정되었습니다.
+ `order().by(T.id)` 패턴을 사용하는 쿼리가 특정 조건에서 예외를 발생시킬 수 있는 Gremlin 버그가 수정되었습니다.
+ `addV().aggregate()` 패턴을 사용하는 쿼리가 특정 조건에서 잘못된 결과를 제공할 수 있는 Gremlin 버그가 수정되었습니다.
+ `path()` 단계에 이어 `project()` 단계 패턴을 사용하는 쿼리가 특정 조건에서 예외를 발생시킬 수 있는 Gremlin 버그가 수정되었습니다.
+ `SUBSTR` 함수가 빈 문자열을 반환하는 대신 오류 신호를 보내는 SPARQL 버그가 수정되었습니다.
+ 바인딩되지 않은 변수가 있는 경우 차단하지 않는 쿼리 계획의 조인 작업이 잘못된 결과를 생성하도록 할 수 있는 DFE 엔진 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.8`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.1에 대한 업그레이드 경로
엔진 버전 `1.0.4.1`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.4.1을 이제 정식 버전으로 사용할 수 있습니다.
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.4.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1 ^
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.4.1.R1.1(2021년 3월 22일)
2021년 3월 22일부터 엔진 버전 1.0.4.1.R1.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ 기존 레이블 및 속성을 추가하거나 첨부할 수 있는 Gremlin 조건부 삽입 패턴에 대한 최적화가 사용 해제되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.1.R1.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.8`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.1.R1.1에 대한 업그레이드 경로
엔진 버전 `1.0.4.1`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.4.1.R1.1을 이제 정식 버전으로 사용할 수 있습니다.
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.4.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1 ^
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.4.1.R2(2021년 2월 24일)
2021년 2월 24일부터 엔진 버전 1.0.4.1.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.4.1.R2.1(2021년 3월 11일)](engine-releases-1.0.4.1.R2.1.md)
## 이 엔진 릴리스의 새로운 기능
+ 이제 Neptune은 단일 파일 압축을 `bzip2` 형식으로 실행하여 대량 로드를 지원합니다. [로드 데이터 형식](bulk-load-tutorial-format.md)을(를) 참조하세요.
## 이 엔진 릴리스에서 수정된 결함
+ [릴리스: 1.0.4.0(2020년 10월 12일)](engine-releases-1.0.4.0.md)이 `HTTPS` 및 TLS 1.2가 아닌 `HTTP` 또는 이전 버전의 TLS를 사용하여 Neptune에 연결하도록 하는 버그가 수정되었습니다.
**중요**
**Neptune을 대상으로 한 모든 연결에 SSL/TLS가 필요하다는 점은 획기적인 변경 사항일 수 있습니다.** 이는 Gremlin 콘솔, Gremlin 드라이버, Gremlin Python, .NET, nodeJs, REST API와의 연결 및 로드 밸런서 연결에 영향을 줍니다. 지금까지 이들 중 일부 또는 전부에 대해 HTTP 또는 이전 TLS 버전을 사용하고 있다면 이 패치를 설치하기 전에 관련 클라이언트와 드라이버를 업데이트하고 HTTPS만 사용하도록 코드를 변경해야 합니다.
+ `ConcurrentModificationException`이 발생했을 때 특정 상황에서 응답 코드로 `InternalFailureException`이 설정되었던 Gremlin 버그가 수정되었습니다.
+ 특정 상황에서 엣지나 버텍스를 업데이트하면 일시적으로 `InternalFailureException`이 발생할 수 있는 Gremlin 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.1.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.8`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.1.R2에 대한 업그레이드 경로
엔진 버전 `1.0.4.1`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.4.1.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.4.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1 ^
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.4.1.R2.1(2021년 3월 11일)
2021년 3월 11일부터 엔진 버전 1.0.4.1.R2.1이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ 기존 레이블 및 속성을 추가하거나 첨부할 수 있는 Gremlin 조건부 삽입 패턴에 대한 최적화가 사용 해제되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.1.R2.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.8`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.1.R2.1에 대한 업그레이드 경로
엔진 버전 `1.0.4.1.R2`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.4.1.R2.1을 이제 정식 버전으로 사용할 수 있습니다.
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.4.1.R2 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.1.R2 ^
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.4.0(2020년 10월 12일)
2020년 10월 12일부터 엔진 버전 1.0.4.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.4.0.R2(2021년 2월 24일)](engine-releases-1.0.4.0.R2.md)
## 이 엔진 릴리스의 새로운 기능
+ Gremlin에 프레임 수준 압축이 추가되었습니다.
## 이 엔진 릴리스의 개선 사항
+ 이제 Amazon Neptune은 다음과 같은 강력한 암호 제품군을 사용하여 모든 리전의 Neptune을 대상으로 한 모든 연결에 대해 TLSv1.2 프로토콜과 함께 SSL(보안 소켓 계층)을 사용해야 합니다.
+ `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA`
이는 Neptune에 대한 REST 및 WebSocket 연결 모두에 해당되며, 모든 리전에서 Neptune에 연결할 때는 HTTP 대신 HTTPS를 사용해야 합니다.
HTTP 또는 TLS 1.1을 사용하는 클라이언트 연결은 더 이상 어디에서도 지원되지 않으므로 이 엔진 릴리스로 업그레이드하기 전에 클라이언트와 코드가 TLS 1.2 및 HTTPS를 사용하도록 업데이트되었는지 확인합니다.
**중요**
**Neptune을 대상으로 한 모든 연결에 SSL/TLS가 필요하다는 점은 획기적인 변경 사항일 수 있습니다.** 이는 Gremlin 콘솔, Gremlin 드라이버, Gremlin Python, .NET, nodeJs, REST API와의 연결 및 로드 밸런서 연결에 영향을 줍니다. 이들 중 일부 또는 전부에 HTTP를 사용하고 있다면 이제 관련 클라이언트와 드라이버를 업데이트하고 코드에서 HTTPS를 사용하도록 변경해야 합니다. 그렇지 않으면 연결이 실패합니다.
이 릴리스의 버그를 통해, 이전에 DB 클러스터 파라미터를 설정한 고객도 HTTP 연결 또는 기존 TLS 연결이 계속 작동할 수 있도록 하여 이전의 HTTPS 연결 적용을 방지합니다. 이 버그는 패치 릴리스 [1.0.4.0.R2](engine-releases-1.0.4.0.R2.md) 및 [1.0.4.1.R2](engine-releases-1.0.4.1.R2.md)에서 수정되었지만 이 수정으로 인해 패치가 자동으로 설치될 때 예상치 못한 연결 장애가 발생했습니다.
이러한 이유로 두 패치 모두 되돌려졌으며, 수동으로만 설치하여 TLS 1.2의 설정을 업데이트할 수 있습니다.
+ TinkerPop의 버전 3.4.8로 업그레이드되었습니다. 이 업그레이드는 이전 버전과 호환됩니다. 새로운 소식은 [TinkerPop 변경 로그](https://github.com/apache/tinkerpop/blob/master/CHANGELOG.asciidoc#tinkerpop-348-release-date-august-3-2020)를 참조하시기 바랍니다.
+ Gremlin `properties()` 단계의 성능이 향상되었습니다.
+ 설명 및 프로필 보고서에 `BindOp` 및 `MultiplexerOp`에 관한 세부 정보가 추가되었습니다.
+ 캐시 누락 시 성능을 개선하기 위해 데이터 미리 가져오기가 추가되었습니다.
+ CSV 로드 시 빈 문자열을 유효한 속성 값으로 처리할 수 있는 새 `allowEmptyStrings` 설정을 대량 로더의 `parserConfiguration` 파라미터에 추가했습니다([Neptune 로더 요청 파라미터](load-api-reference-load.md#load-api-reference-load-parameters) 참조).
+ 이제 로더는 다중값 CSV 열에서 이스케이프된 세미콜론을 사용하도록 허용합니다.
## 이 엔진 릴리스에서 수정된 결함
+ `both()` 단계와 관련된 잠재적인 Gremlin 메모리 누수가 수정되었습니다.
+ '/' 기호로 끝나는 엔드포인트가 제대로 처리되지 않아 요청 지표가 누락되는 버그가 수정되었습니다.
+ DFE 엔진이 랩 모드에서 사용 설정된 경우 부하가 심한 상태에서 복제본이 지연되고 재시작되던 버그가 수정되었습니다.
+ 메모리 부족 상태로 인해 대량 로드에 실패했을 때 올바른 오류 메시지가 보고되지 않던 버그가 수정되었습니다.
+ SPARQL 쿼리 응답의 콘텐츠 인코딩 헤더에 문자 인코딩이 배치되는 SPARQL 버그가 수정되었습니다. 이제 Content-Type 헤더에 대신 `charset`이 배치되어 HTTP 클라이언트가 사용 중인 문자 집합을 자동으로 인식할 수 있습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.8`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.0에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
이 릴리스로 자동으로 업그레이드하지 않습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.4.0을 이제 정식 버전으로 사용할 수 있습니다.
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.4.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.0 ^
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.4.0.R2(2021년 2월 24일)
2021년 2월 24일부터 엔진 버전 1.0.4.0.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ [릴리스: 1.0.4.0(2020년 10월 12일)](engine-releases-1.0.4.0.md)이 `HTTPS` 및 TLS 1.2가 아닌 `HTTP` 또는 이전 버전의 TLS를 사용하여 Neptune에 연결하도록 하는 버그가 수정되었습니다.
**중요**
**Neptune을 대상으로 한 모든 연결에 SSL/TLS가 필요하다는 점은 획기적인 변경 사항일 수 있습니다.** 이는 Gremlin 콘솔, Gremlin 드라이버, Gremlin Python, .NET, nodeJs, REST API와의 연결 및 로드 밸런서 연결에 영향을 줍니다. 지금까지 이들 중 일부 또는 전부에 대해 HTTP 또는 이전 TLS 버전을 사용하고 있다면 이 패치를 설치하기 전에 관련 클라이언트와 드라이버를 업데이트하고 HTTPS만 사용하도록 코드를 변경해야 합니다.
+ `#`으로 끝나는 레이블과 관련된 CSV 대량 로드의 버그가 수정되었습니다.
+ `ConcurrentModificationException`이 발생했을 때 특정 상황에서 응답 코드로 `InternalFailureException`이 설정되었던 Gremlin 버그가 수정되었습니다.
+ 특정 상황에서 엣지나 버텍스를 업데이트하면 일시적으로 `InternalFailureException`이 발생할 수 있는 Gremlin 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.4.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.8`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.4.0.R2에 대한 업그레이드 경로
엔진 버전 `1.0.4.0`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.4.0.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.4.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.0 ^
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.3.0(2020년 8월 3일)
2020년 8월 3일부터 엔진 버전 1.0.3.0이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.3.0.R2(2020년 10월 12일)](engine-releases-1.0.3.0.R2.md)
+ [릴리스: 1.0.3.0.R3(2021년 2월 19일)](engine-releases-1.0.3.0.R3.md)
## 이 엔진 릴리스의 새로운 기능
+ Neptune에 쿼리 실행 속도를 크게 높일 수 있는 새로운 대체 쿼리 엔진(DFE)이 도입되었습니다. [Amazon Neptune 대체 쿼리 엔진(DFE)](neptune-dfe-engine.md)을(를) 참조하세요.
+ DFE는 새로운 통계 엔드포인트를 통해 관리되는 Neptune 그래프 데이터에 대해 사전 생성된 통계를 사용합니다. [DFE 통계](neptune-dfe-statistics.md)을(를) 참조하세요.
+ 이제 새 `includeQueuedLoads` 파라미터를 FALSE로 설정하여 로더 Get-Status API에서 반환한 로드 ID 목록에서 대기 중인 로드 작업을 제외할 수 있습니다. [Neptune 로더 Get-Status 요청 파라미터](load-api-reference-status-requests.md#load-api-reference-status-parameters)을(를) 참조하세요.
+ Neptune은 이제 SPARQL 쿼리 응답의 후행 헤더를 지원합니다. 이 헤더에는 응답 청크를 반환하기 시작한 후 요청이 실패할 경우 오류 코드와 메시지가 포함될 수 있습니다. [멀티파트 SPARQL 응답을 위한 선택적 HTTP 후행 헤더](access-graph-sparql-http-trailing-headers.md)을(를) 참조하세요.
+ 또한 이제 Neptune에서는 Gremlin 쿼리에 청크 응답 인코딩을 사용할 수 있습니다. SPARQL의 경우와 마찬가지로 응답 청크에는 쿼리가 응답 청크를 반환하기 시작한 후 오류가 발생할 경우 오류 코드와 메시지를 포함할 수 있는 후행 헤더가 있습니다. [선택적 HTTP 후행 헤더를 사용하여 여러 부분으로 구성된 Gremlin 응답 활성화](access-graph-gremlin-rest-trailing-headers.md)을(를) 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 이제 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\$13주 후에 클러스터가 자동으로 이 엔진 릴리스로 업그레이드 됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.3.0을 이제 정식 버전으로 사용할 수 있습니다.
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.3.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.3.0 ^
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.3.0.R3(2021년 2월 19일)
2021년 2월 19일부터 엔진 버전 1.0.3.0.R3이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ `#`으로 끝나는 레이블과 관련된 CSV 대량 로드의 버그가 수정되었습니다.
+ `as()` 단계를 사용하는 특정 패턴의 쿼리에서 결과가 누락될 수 있는 Gremlin 버그가 수정되었습니다.
+ `union()` 등의 `project()` 단계 내에 중첩된 단계를 사용할 때 오류가 발생할 수 있는 Gremlin 버그가 수정되었습니다.
+ `toList()`와 같은 터미널 메서드를 사용할 때 실험용 DFE 엔진의 문자열 순회 실행에서 발생하는 Gremlin 버그가 수정되었습니다.
+ 문자열 쿼리의 `iterate()` 단계를 사용할 때 트랜잭션을 닫지 못하는 Gremlin 버그가 수정되었습니다.
+ `is(P.gte(0))` 패턴을 사용하는 쿼리가 특정 조건에서 예외를 발생시킬 수 있는 Gremlin 버그가 수정되었습니다.
+ `ConcurrentModificationException`이 발생했을 때 특정 상황에서 응답 코드로 `InternalFailureException`이 설정되었던 Gremlin 버그가 수정되었습니다.
+ 특정 상황에서 엣지나 버텍스를 업데이트하면 일시적으로 `InternalFailureException`이 발생할 수 있는 Gremlin 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.3.0.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.8`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.3.0.R3에 대한 업그레이드 경로
엔진 버전 `1.0.3.0`을 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.3.0.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.3.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.3.0 ^
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.3.0.R2(2020년 10월 12일)
2020년 10월 12일부터 엔진 버전 1.0.3.0.R2가 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스의 개선 사항
+ 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.3.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.3`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.3.0.R2에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
클러스터의 `AutoMinorVersionUpgrade` 파라미터가 `True`로 설정되어 있으면 유지 관리 기간 동안 이 릴리스 날짜로부터 2\$13주 후에 클러스터가 자동으로 이 엔진 릴리스로 업그레이드 됩니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.3.0.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.3.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.3.0 ^
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(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 팀에 도움을 요청할 수 있습니다.
# Amazon Neptune 엔진 버전 1.0.2.1(2019년 11월 22일)
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.2.1.R6(2020년 4월 22일)](engine-releases-1.0.2.1.R6.md)
+ [릴리스: 1.0.2.1.R5(2020년 4월 22일)](engine-releases-1.0.2.1.R5.md) *이 패치 릴리스는 배포되지 않았습니다.*
+ [릴리스: 1.0.2.1.R4(2019년 12월 20일)](engine-releases-1.0.2.1.R4.md)
+ [릴리스: 1.0.2.1.R3(2019년 12월 12일)](engine-releases-1.0.2.1.R3.md)
+ [릴리스: 1.0.2.1.R2(2019년 11월 25일)](engine-releases-1.0.2.1.R2.md)
## 이 엔진 릴리스의 새로운 기능
+ Amazon OpenSearch Service와의 통합을 통해 전체 텍스트 검색 기능이 추가되었습니다. [Neptune 전체 텍스트 검색](full-text-search.md) 섹션을 참조하세요
+ 랩 모드를 사용하여 많은 수의 조건자에 대한 네 번째 인덱스(OSGP 인덱스)를 생성하는 옵션이 추가되었습니다. [OSGP 인덱스](features-lab-mode.md#features-lab-mode-features-osgp-index)을(를) 참조하세요.
+ SPARQL Explain에 *세부* 모드가 추가되었습니다. 자세한 내용은 [SPARQL `explain` 사용](sparql-explain-using.md) 및 [세부 모드 출력](sparql-explain-examples.md#sparql-explain-example-details) 단원을 참조하십시오.
+ 엔진 상태 보고서에 랩 모드 정보가 추가되었습니다. 세부 정보는 [인스턴스 상태](access-graph-status.md) 섹션을 참조하세요.
+ 이제 DB 클러스터 스냅샷을 AWS 리전 간에 복사할 수 있습니다. [스냅샷 복사](backup-restore-copy-snapshot.md)을(를) 참조하세요.
## 이 엔진 릴리스의 개선 사항
+ 많은 수의 조건자를 처리할 때 성능이 향상되었습니다.
+ 쿼리 최적화가 향상되었습니다. 이는 고객에게 전혀 영향을 미치지 않지만 업그레이드하기 전에 애플리케이션을 테스트하여 예상대로 작동하는지 확인하는 것이 좋습니다.
+ 오류 보고 기능이 약간 향상되었습니다.
+ Gremlin `.project()` 및 `.identity()` 단계에 대한 최적화가 추가되었습니다.
+ 터미널이 아닌 Gremlin `.union()` 케이스에 대한 최적화가 추가되었습니다.
+ Gremlin `.path().by()` 순회에 대한 기본 지원이 추가되었습니다.
+ Gremlin `.coalesce()`에 대한 기본 지원이 추가되었습니다.
+ 대량 쓰기가 더욱 최적화되었습니다.
+ 이제 HTTPS 연결 시 오래된/안전하지 않은 암호가 사용되는 것을 방지하기 위해 적어도 TLS 버전 1.2 이상을 사용해야 합니다.
## 이 엔진 릴리스에서 수정된 결함
+ Gremlin `addE()` 내부 순회 처리 버그가 수정되었습니다.
+ 하위 순회에서 상위 순회로 누출되어 AST 주석에서 발생한 Gremlin 버그가 수정되었습니다.
+ `.otherV()` 이후에 `select()`이 호출되었을 때 Gremlin에서 발생한 버그가 수정되었습니다.
+ `.hasLabel()` 단계 후에 몇몇 `bothE()` 단계가 나타나는 경우 이 몇몇 단계를 실패하게 하는 Gemlin 버그가 수정되었습니다.
+ Gremlin .sum() 및 .project()에 대한 사소한 사항이 수정되었습니다.
+ 닫는 중괄호가 없는 SPARQL 쿼리 처리 버그가 수정되었습니다.
+ SPARQL Explain에서 몇 가지 사소한 버그가 수정되었습니다.
+ 동시 가져오기 로드 상태 요청 처리 버그가 수정되었습니다.
+ `.project()` 단계를 사용하여 일부 Gremlin 순회를 실행하는 데 사용되는 메모리가 감소했습니다.
+ SPARQL에서 특수 값의 숫자 비교가 수정되었습니다. [표준 규정 준수](feature-overview-standards-compliance.md)을(를) 참조하세요.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.1에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
이 릴리스로 자동으로 업그레이드하지 않습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.1을 이제 정식 버전으로 사용할 수 있습니다.
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.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
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.1.R6(2020년 4월 22일)
2020년 4월 22일부터 엔진 버전 1.0.2.1.R6이 정식으로 배포되고 있습니다. 모든 리전에서 새 릴리스를 사용할 수 있게 되려면 며칠이 걸립니다.
## 이 엔진 릴리스에서 수정된 결함
+ `ConcurrentModificationConflictException` 및 `TransactionException`이 `NeptuneGremlinException`으로 변환되지 않아 `InternalFailureException`이 고객에게 반환되는 버그를 수정했습니다.
+ 서버가 완전히 준비되기 전에 Neptune에서 상태를 정상으로 보고하는 버그를 수정했습니다.
+ 두 개의 `value->id` 매핑이 동시에 삽입될 때 사전 및 사용자 트랜잭션 커밋이 순서가 잘못되는 버그를 수정했습니다.
+ 로드 상태 직렬화의 버그를 수정했습니다.
+ Gremlin 세션 버그를 수정했습니다.
+ 서버를 시작하지 못했을 때 Neptune에서 예외를 발생시키지 못하는 버그를 수정했습니다.
+ 채널을 닫기 전에 Neptune에서 WebSocket 닫기 프레임을 전송하지 못하는 버그를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.1.R6으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.1.R6에 대한 업그레이드 경로
엔진 버전 `1.0.2.1`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.1.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.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
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.1.R5(2020년 4월 22일)
엔진 릴리스 1.0.2.1.R5는 배포된 적이 없습니다.
# Amazon Neptune 엔진 버전 1.0.2.1.R4(2019년 12월 20일)
## 이 엔진 릴리스의 개선 사항
+ 이제 Neptune은 이 실행 파이프라인에서 항상 전체 텍스트 검색 호출을 먼저 시도합니다. 이렇게 하면 OpenSearch에 대한 호출량이 줄어들어 성능이 크게 향상됩니다. [전체 텍스트 검색 쿼리 실행](full-text-search-query-execution.md)을(를) 참조하세요.
+ 이제부터 Neptune은 존재하지 않는 속성, 버텍스 또는 엣지에 대한 액세스를 시도할 경우 `IllegalArgumentException`을 발생시킵니다. 이전에는 이런 상황에서 Neptune이 `UnsupportedOperationException`을 발생시켰습니다.
예를 들어, 존재하지 않는 버텍스를 참조하는 엣지를 추가하려고 할 경우 이제부터는 `IllegalArgumentException`이 발생합니다.
## 이 엔진 릴리스에서 수정된 결함
+ `union` 내부의 `project-by` 순회로 결과가 반환되지 않거나 부정확한 결과가 반환되는 Gremlin 버그 문제가 해결되었습니다.
+ 중첩된 `.project().by()` 단계에서 부정확한 결과를 반환하게 했던 Gremlin 버그 문제가 해결되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.1.R4로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.1.R4에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
그러나 **이 릴리스에 대한 자동 업데이트는 지원되지 않습니다**.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.1.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.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
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.1.R3(2019년 12월 12일)
## 이 엔진 릴리스에서 수정된 결함
+ `OSGP` 파라미터의 [랩 모드](features-lab-mode.md) 값을 사용하여 `ObjectIndex`에서 기능을 정확히 활성화했어도 `neptune_lab_mode` 인데스가 비활성화되었던 버그 문제를 해결했습니다.
+ `.fold()` 단계 내의 `.project().by()`에서 Gremlin 쿼리에 영향을 주는 버그가 수정되었습니다. 예를 들어 이 때문에 다음 쿼리가 불완전한 결과를 반환했습니다.
```
g.V().project("a").by(valueMap().fold())
```
+ RDF 데이터의 대량 로드 시 성능 병목 현상이 수정되었습니다.
+ 스트림이 활성화되고 기본 이전에 복제본이 다시 시작될 때 복제본에서 충돌을 일으키는 버그가 수정되었습니다.
+ 인스턴스를 다시 시작하지 않은 경우 인스턴스의 교체된 SSL 인증서가 선택되지 않는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.1.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.1.R3에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
그러나 **이 릴리스에 대한 자동 업데이트는 지원되지 않습니다**.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.1.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
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.1.R2(2019년 11월 25일)
## 이 엔진 릴리스에서 수정된 결함
+ 비 라운드 로빈 순회 및 비 `project().by()` 순회가 있는 모든 `path()` 쿼리에 영향을 주는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.1.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.1.R2에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
그러나 **이 릴리스에 대한 자동 업데이트는 지원되지 않습니다**.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.1.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.1 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
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.0(2019년 11월 8일)
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2020년 5월 19일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
현재 이 엔진 버전은 [버전 1.0.2.1](engine-releases-1.0.2.1.md)로 대체되며, 여기에는 이 버전의 모든 버그 수정뿐만 아니라 전체 텍스트 검색 통합, OSGP 인덱스 지원, AWS 리전 간 데이터베이스 스냅샷 클러스터 사본 등의 추가 기능이 포함되어 있습니다.
2020년 6월 1일부터 Neptune은 다음 유지 관리 기간에 이 엔진 버전을 실행하는 모든 클러스터를 [버전 1.0.2.1의 최신 패치](engine-releases-1.0.2.1.R6.md)로 자동 업그레이드됩니다. [여기](engine-releases-1.0.2.1.md)에 설명된 대로 수동으로 업그레이드할 수 있습니다.
업그레이드에 문제가 있는 경우 [AWS Support](https://aws.amazon.com/support) 또는 [AWS 개발자 포럼](https://forums.aws.amazon.com/forum.jspa?forumID=253)을 통해 문의하시기 바랍니다.
## 이 릴리스의 후속 패치 릴리스
+ [릴리스: 1.0.2.0.R3(2020년 5월 5일)](engine-releases-1.0.2.0.R3.md)
+ [릴리스: 1.0.2.0.R2(2019년 11월 21일)](engine-releases-1.0.2.0.R2.md)
## 이 엔진 릴리스의 새로운 기능
이 릴리스에는 유지 관리 업데이트 외에도 한 번에 두 개 이상의 엔진 버전을 지원하는 새로운 기능이 추가되었습니다([Amazon Neptune DB 클러스터 유지 관리](cluster-maintenance.md) 참조).
결과적으로 엔진 릴리스의 번호 매기기가 변경되었습니다([엔진 릴리스 1.3.0.0 이전의 버전 번호 지정](cluster-maintenance.md#older-engine-numbers) 참조).
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.0으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.0에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
이 릴리스로 자동으로 업그레이드하지 않습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.0을 이제 정식 버전으로 사용할 수 있습니다.
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.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.0 ^
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.0.R3(2020년 5월 5일)
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2020년 5월 19일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
현재 이 엔진 버전은 [버전 1.0.2.1](engine-releases-1.0.2.1.md)로 대체되며, 여기에는 이 버전의 모든 버그 수정뿐만 아니라 전체 텍스트 검색 통합, OSGP 인덱스 지원, AWS 리전 간 데이터베이스 스냅샷 클러스터 사본 등의 추가 기능이 포함되어 있습니다.
2020년 6월 1일부터 Neptune은 다음 유지 관리 기간에 이 엔진 버전을 실행하는 모든 클러스터를 [버전 1.0.2.1의 최신 패치](engine-releases-1.0.2.1.R6.md)로 자동 업그레이드됩니다. [여기](engine-releases-1.0.2.1.md)에 설명된 대로 수동으로 업그레이드할 수 있습니다.
업그레이드에 문제가 있는 경우 [AWS Support](https://aws.amazon.com/support) 또는 [AWS 개발자 포럼](https://forums.aws.amazon.com/forum.jspa?forumID=253)을 통해 문의하시기 바랍니다.
## 이 엔진 릴리스에서 수정된 결함
+ `ConcurrentModificationConflictException` 및 `TransactionException`이 일반 `InternalFailureException`으로 보고되는 버그를 수정했습니다.
+ 시작 중에 서버가 자주 다시 시작되도록 하는 상태 확인 버그를 수정했습니다.
+ 특정 조건에서 커밋이 순서가 잘못되어 복제본에 데이터가 표시되지 않는 버그를 수정했습니다.
+ Amazon S3 액세스 권한 부족으로 로드가 실패하는 로드 상태 직렬화 버그를 수정했습니다.
+ Gremlin 세션에서 리소스 유출을 수정했습니다.
+ IAM 인증을 관리하는 구성 요소 시작 시 비정상 상태를 숨기는 상태 확인 버그를 수정했습니다.
+ 채널을 닫기 전에 Neptune에서 WebSocket 닫기 프레임을 전송하지 못하는 버그를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.0.R3으로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.0.R3에 대한 업그레이드 경로
엔진 버전 `1.0.2.0`를 실행하는 경우 다음 유지 관리 기간 동안 클러스터가 이 패치 릴리스로 자동 업그레이드됩니다.
이전 Neptune 엔진 릴리스를 이 릴리스로 수동으로 업그레이드할 수 있습니다.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.0.R3을 이제 정식 버전으로 사용할 수 있습니다.
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.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.0 ^
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.0.R2(2019년 11월 21일)
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2020년 5월 19일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
현재 이 엔진 버전은 [버전 1.0.2.1](engine-releases-1.0.2.1.md)로 대체되며, 여기에는 이 버전의 모든 버그 수정뿐만 아니라 전체 텍스트 검색 통합, OSGP 인덱스 지원, AWS 리전 간 데이터베이스 스냅샷 클러스터 사본 등의 추가 기능이 포함되어 있습니다.
2020년 6월 1일부터 Neptune은 다음 유지 관리 기간에 이 엔진 버전을 실행하는 모든 클러스터를 [버전 1.0.2.1의 최신 패치](engine-releases-1.0.2.1.R6.md)로 자동 업그레이드됩니다. [여기](engine-releases-1.0.2.1.md)에 설명된 대로 수동으로 업그레이드할 수 있습니다.
업그레이드에 문제가 있는 경우 [AWS Support](https://aws.amazon.com/support) 또는 [AWS 개발자 포럼](https://forums.aws.amazon.com/forum.jspa?forumID=253)을 통해 문의하시기 바랍니다.
## 이 엔진 릴리스에서 수정된 결함
+ 서버가 메모리 부족 상태로 전환되면 `FreeableMemory`가 더 빠르게 복구되도록 서버의 더티 페이지에 대한 캐싱 전략이 개선되었습니다.
+ 서버에서 많은 동시 로드 상태 및/또는 시작 로드 요청을 처리할 때 교착 상태와 충돌이 발생할 수 있는 버그가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.2.0.R2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
## 엔진 릴리스 1.0.2.0.R2에 대한 업그레이드 경로
이전 Neptune 엔진 릴리스를 이 릴리스 버전으로 수동 업그레이드할 수 있습니다.
그러나 **이 릴리스에 대한 자동 업데이트는 지원되지 않습니다**.
## 이 릴리스로 업그레이드
Amazon Neptune 1.0.2.0.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.0 \
4. --apply-immediately
```
Windows의 경우:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.0 ^
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.1.2(2020년 6월 10일)
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
## 이 엔진 릴리스의 개선 사항
+ 이제부터 Neptune은 존재하지 않는 속성, 버텍스 또는 엣지에 대한 액세스를 시도할 경우 `IllegalArgumentException`을 발생시킵니다. 이전에는 이런 상황에서 Neptune이 `UnsupportedOperationException`을 발생시켰습니다.
예를 들어, 존재하지 않는 버텍스를 참조하는 엣지를 추가하려고 할 경우 이제부터는 `IllegalArgumentException`이 발생합니다.
## 이 엔진 릴리스에서 수정된 결함
+ 두 개의 `value->id` 매핑이 동시에 삽입될 때 사전 및 사용자 트랜잭션 커밋이 순서가 잘못되는 버그를 수정했습니다.
+ 로드 상태 직렬화의 버그를 수정했습니다.
+ 인스턴스 생성을 지연시켰던 서버 시작 시 확률 실패를 수정하였습니다.
+ 커서 누수가 수정되었습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.1.2로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.4.1`
+ *SPARQL 버전:* `1.1`
# Amazon Neptune 엔진 버전 1.0.1.1(2020년 6월 26일)
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 동시에 삽입할 때 커밋의 순서가 맞지 않는 버그를 수정했습니다.
+ 로드 상태 직렬화의 버그를 수정했습니다.
+ 인스턴스 생성을 지연시켰던 서버 시작 시 확률 실패를 수정하였습니다.
+ 메모리 누수를 수정했습니다.
## 이 릴리스에서 지원되는 쿼리 언어 버전
DB 클러스터를 버전 1.0.1.1로 업그레이드하기 전에 프로젝트가 다음 쿼리 언어 버전과 호환되는지 확인합니다.
+ *Gremlin 버전:* `3.3.2`
+ *SPARQL 버전:* `1.1`
# Amazon Neptune 엔진 버전 1.0.1.0(2019년 7월 2일)
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
# Amazon Neptune 엔진 업데이트 2019년 10월 31일
**버전**: 1.0.1.0.200502.0
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 클라이언트가 `tree()`를 사용하여(다시 말해서, GLV 바이트코드를 사용하여) Neptune에 연결할 때 `traversal().withRemote(...)` 단계 응답의 직렬화에서 발생하는 Gremlin 버그가 수정되었습니다.
이 릴리스에서는 `traversal().withRemote(...)`를 사용하여 Neptune에 연결한 클라이언트가 `tree()` 단계를 포함한 Gremlin 쿼리에 대해 잘못된 응답을 수신하는 문제가 해결됩니다.
+ 경합 상태로 인해 쿼리 종료 프로세스가 중단되어 쿼리가 시간 초과되는 `DELETE WHERE LIMIT` 쿼리의 SPARQL 버그가 수정되었습니다.
# Amazon Neptune 엔진 업데이트 2019년 10월 15일
**버전**: 1.0.1.0.200463.0
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
## 이 엔진 릴리스의 새로운 기능
+ Gremlin Explain/Profile 기능이 추가되었습니다([Gremlin `explain`을 사용하여 Neptune 쿼리 실행 분석](gremlin-explain.md) 참조).
+ 단일 트랜잭션에서 여러 Gremlin 순회를 실행할 수 있도록 [Gremlin 스크립트 기반 세션 지원](access-graph-gremlin-sessions.md)이 추가되었습니다.
+ Neptune에서 SPARQL 페더레이션 쿼리 확장에 대한 지원이 추가되었습니다([SPARQL 1.1 페더레이션 쿼리](https://www.w3.org/TR/sparql11-federated-query/) 및 [`SERVICE` 확장을 사용하는 Neptune의 SPARQL 페더레이션된 쿼리](sparql-service.md) 참조).
+ HTTP URL 파라미터나 SPARQL `queryId` 쿼리를 통해 Gremlin 또는 SPARQL 쿼리에 자체 `queryId`을 주입할 수 있도록 하는 기능이 추가되었습니다([Neptune Gremlin 또는 SPARQL 쿼리에 사용자 지정 ID 주입](features-query-id.md) 참조).
+ 아직 프로덕션 환경에서 사용이 지원되지 않고 있는 출시 예정 기능들을 사용해 볼 수 있도록 Neptune에 [랩 모드](features-lab-mode.md) 기능이 추가되었습니다.
+ 데이터베이스에 대해 수행된 모든 변경을 1주일 간 지속되는 스트림에 안정적으로 기록할 수 있도록 출시 예정인 [Neptune 스트림](streams.md) 기능이 추가되었습니다. 이 기능은 랩 모드에서만 사용할 수 있습니다.
+ 동시 트랜잭션에 대한 공식 시맨틱이 업데이트 되었습니다([Neptune의 트랜잭션 시맨틱](transactions.md) 참조). 이 기능은 동시성과 관련된 업계 표준 보장을 제공합니다.
이러한 트랜잭션 시맨틱은 기본적으로 활성화되어 있습니다. 일부 시나리오에서는 이 기능이 현재 로드 동작을 변경하여 로드 성능을 줄일 수도 있습니다. DB 클러스터 `neptune_lab_mode` 파라미터를 사용해 파라미터 값에 `ReadWriteConflictDetection=disabled`를 포함시켜 이전 시맨틱으로 되돌아갈 수 있습니다.
## 이 엔진 릴리스의 개선 사항
+ 엔진에서 사용 중인 TinkerPop의 버전과 SPARQL의 버전을 보고하는 방법으로 [인스턴스 상태](access-graph-status.md) API가 개선되었습니다.
+ Gremlin 하위 그래프 연산자 성능이 개선되었습니다.
+ Gremlin 응답 직렬화 성능이 개선되었습니다.
+ Gremlin Union 단계의 성능이 개선되었습니다.
+ 간단한 SPARQL 쿼리의 지연 시간이 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 제한 시간이 내부 장애로 인해 올바르지 않게 반환되었던 Gremlin 버그가 수정되었습니다.
+ 변수의 일부에 대한 ORDER BY 절로 인해 내부 서버 오류를 야기되었던 SPARQL 버그가 수정되었습니다.
# Amazon Neptune 엔진 업데이트 2019년 9월 19일
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
**버전:** 1.0.1.0.200457.0
Amazon Neptune 1.0.1.0.200457.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200457.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 문제의 원인 된 접속 조건자 처리에 대한 성능 개선을 제거하여 이전의 엔진 릴리스(1.0.1.0.200369.0)에서 발생한 Gremlin 정확성 문제를 수정했습니다.
+ `DISTINCT`이 포함된 쿼리와 `OPTIONAL`로 래핑된 단일 패턴에서 `InternalServerError` 생성을 야기한 SPARQL 버그가 수정되었습니다.
# Amazon Neptune 엔진 업데이트 2019년 8월 13일
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
## 이 엔진 릴리스의 새로운 기능
+ Neptune 대량 로더가 사용 가능한 모든 스레드 및 리소스를 사용하도록 [Neptune 로더 명령](load-api-reference-load.md)의 `parallelism` 파라미터에 `OVERSUBSCRIBE` 옵션이 추가되었습니다.
## 이 엔진 릴리스의 개선 사항
+ 간단한 논리적 OR 표현식을 포함하는 SPARQL 필터의 성능이 향상되었습니다.
+ 결합 조건자 처리 시 Gremlin 성능이 향상되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ `xsd:date`에서 `xsd:duration`을 빼지 못하던 SPARQL 버그가 수정되었습니다.
+ `UNION`이 있을 때 정적 인라인으로 인해 불완전한 결과가 발생하던 SPARQL 버그가 수정되었습니다.
+ 쿼리 취소 시 발생하던 SPARQL 버그가 수정되었습니다.
+ 유형 승격 중 오버플로가 발생하던 Gremlin 버그가 수정되었습니다.
+ `addE().from().to()` 단계에서 버텍스 요소를 처리할 때 발생하던 Gremlin 버그가 수정되었습니다.
+ 단일 카디널리티 삽입에서 NaN Double 및 부동 소수점 처리와 관련된 Gremlin 버그([엔진 버전 1.0.1.0.200366.0](engine-releases-1.0.1.0.200366.0.md)의 2019-07-26 릴리스)가 수정되었습니다.
+ 속성 기반 검색과 관련된 쿼리 계획을 생성할 때 발생하던 버그가 수정되었습니다.
# Amazon Neptune 엔진 업데이트 2019년 7월 26일
**버전**: 1.0.1.0.200366.0
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
## 이 엔진 릴리스의 새로운 기능
+ TinkerPop 3.4.1로 업그레이드되었습니다([TinkerPop Upgrade Information](http://tinkerpop.apache.org/docs/3.4.1/upgrade/) 및 [TinkerPop 3.4.1 Change Log](https://github.com/apache/tinkerpop/blob/3.4.1/CHANGELOG.asciidoc#release-3-4-1) 참조).
이러한 변경 사항은 Neptune 고객에게 다음과 같은 새로운 기능과 개선 사항을 제공합니다.
+ `GraphBinary`가 이제 직렬화 형식으로 제공됩니다.
+ TinkerPop Java 드라이버에서 메모리 누수를 유발하는 연결 유지 버그가 수정되었으므로 더 이상 해결 방법이 필요하지 않습니다.
그러나 경우에 따라 Neptune의 기존 Gremlin 코드에 영향을 줄 수 있습니다. 예:
+ `valueMap()`은 이제 `Map` 대신 `Map`를 반환합니다.
+ `within()` 단계의 일관되지 않은 동작이 수정되어 다른 단계와 일관되게 작동합니다. 이전에는 유형이 일치해야만 비교를 수행할 수 있었습니다. 이제 다른 유형의 숫자를 정확하게 비교할 수 있습니다. 예를 들어, `33`과 `33L`이 예전에는 다르게 처리되었지만 이제는 동일합니다.
+ `ReducingBarrierStep`의 버그가 수정되었으므로 이제 출력에 사용할 수 있는 요소가 없는 경우 값을 반환하지 않습니다.
+ `select()` 범위의 순서가 변경되었습니다(현재 `maps`, `side-effects`, `paths` 순서). 이는 `side-effects` 및 `select`를 `side-effects`에 대해 `select`와 동일한 키 이름과 결합하는 드문 쿼리의 결과를 변경합니다.
+ `bulkSet()`는 이제 GraphSON 프로토콜의 일부입니다. `toBulkSet()`로 끝나는 쿼리는 이전 클라이언트에서는 작동하지 않습니다.
+ `Submit()` 단계의 한 파라미터화가 3.4 클라이언트에서 제거되었습니다.
TinkerPop 3.4에 도입된 다른 많은 변경 사항은 현재 Neptune 동작에 영향을 주지 않습니다. 예를 들어 Gremlin `io()`가 `Traversal`에 단계로 추가되었으며 이제 `Graph`에서 더 이상 지원되지 않습니다. 하지만 Neptune에서는 사용되지 않았습니다.
+ [Gremlin용 벌크 로더](bulk-load-tutorial-format-gremlin.md#bulk-load-tutorial-format-gremlin-propheaders)에 단일 카디널리티 버텍스 속성에 대한 지원을 추가하여 속성 그래프 데이터를 로드했습니다.
+ 벌크 로더의 단일 카디널리티 속성에 대한 기존 값을 덮어쓰는 옵션을 추가했습니다.
+ [Gremlin 쿼리 상태를 검색](gremlin-api-status.md)하고 [Gremlin 쿼리를 취소](gremlin-api-status-cancel.md)하는 기능이 추가되었습니다.
+ [SPARQL 쿼리 시간 제한에 대한 쿼리 힌트](sparql-query-hints-queryTimeout.md)를 추가했습니다.
+ 상태 API에서 인스턴스 역할을 보는 기능을 추가했습니다([인스턴스 상태](access-graph-status.md) 단원 참조).
+ 데이터베이스 복제에 대한 지원이 추가되었습니다([Neptune의 데이터베이스 복제본 생성](manage-console-cloning.md) 단원 참조).
## 이 엔진 릴리스의 개선 사항
+ FROM 절에서 그래프 변수를 보여주는 SPARQL 쿼리 설명을 개선했습니다.
+ 필터, 같음 필터, VALUES 절 및 범위 수의 SPARQL의 성능을 개선했습니다.
+ Gremlin 단계 주문의 성능을 개선했습니다.
+ Gremlin `.repeat.dedup` 순회의 성능을 개선했습니다.
+ Gremlin `valueMap()` 및 `path().by()` 순회의 성능이 개선되었습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 그래프의 이름이 지정된 작업을 포함하는 SPARQL 속성 경로와 관련된 여러 문제를 수정했습니다.
+ 메모리 문제를 야기하는 SPARQL CONSTRUCT 쿼리 관련 문제를 수정했습니다.
+ RDF Turtle Parser 및 로컬 이름 관련 문제를 수정했습니다.
+ 사용자에게 표시되는 오류 메시지를 바로잡는 문제를 수정했습니다.
+ Gremlin `repeat()...drop()` 순회 관련 문제를 수정했습니다.
+ Gremlin `drop()` 단계 관련 문제를 수정했습니다.
+ Gremlin 레이블 필터 관련 문제를 수정했습니다.
+ Gremlin 쿼리 시간 제한 관련 문제를 수정했습니다.
# Amazon Neptune 엔진 업데이트 2019년 7월 2일
## 중요: 이제 이 엔진 버전은 지원이 중지됩니다.
2021년 4월 27일부터는 이 엔진 버전 사용 시 새 인스턴스가 생성되지 않습니다.
## 이 엔진 릴리스에서 수정된 결함
+ 속성 이름 및 값이 최적화되지 않도록 바인딩된 특정 패턴을 발생시키는 버그를 수정했습니다.
# 이전 Neptune 엔진 릴리스
**Topics**
+ [Amazon Neptune 엔진 업데이트 2019년 6월 12일](engine-releases-1.0.1.0.200310.0.md)
+ [Amazon Neptune 엔진 업데이트 2019년 5월 1일](engine-releases-1.0.1.0.200296.0.md)
+ [Amazon Neptune 엔진 업데이트 2019년 1월 21일](engine-releases-1.0.1.0.200267.0.md)
+ [Amazon Neptune 엔진 업데이트 2018년 11월 19일](engine-releases-1.0.1.0.200264.0.md)
+ [Amazon Neptune 엔진 업데이트 2018년 11월 8일](engine-releases-1.0.1.0.200258.0.md)
+ [Amazon Neptune 엔진 업데이트 2018년 10월 29일](engine-releases-1.0.1.0.200255.0.md)
+ [Amazon Neptune 엔진 업데이트 2018년 9월 6일](engine-releases-1.0.1.0.200237.0.md)
+ [Amazon Neptune 엔진 업데이트 2018년 7월 24일](engine-releases-1.0.1.0.200236.0.md)
+ [Amazon Neptune 엔진 업데이트 2018년 6월 22일](engine-releases-1.0.1.0.200233.0.md)
# Amazon Neptune 엔진 업데이트 2019년 6월 12일
**버전**: 1.0.1.0.200310.0
Amazon Neptune 1.0.1.0.200310.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200310.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200310.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ 엣지의 동시 삽입 및 드롭이 동일한 ID의 여러 엣지를 낳는 버그를 수정합니다.
+ 기타 마이너 수정 및 개선 사항
# Amazon Neptune 엔진 업데이트 2019년 5월 1일
**버전**: 1.0.1.0.200296.0
Amazon Neptune 1.0.1.0.200296.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200296.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200296.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ 쿼리 계획을 시각화하고 필요한 경우 최적화하는 단계를 수행하는 데 도움이 되는 새 `explain` 기능이 Neptune SPARQL 쿼리에 추가되었습니다. 자세한 내용은 [SPARQL `explain`SPARQL `SERVICE` 확장](sparql-explain.md) 섹션을 참조하세요.
+ 다양한 방법으로 SPARQL 성능 및 보고가 개선되었습니다.
+ 다양한 방법으로 Gremlin 성능 및 동작이 개선되었습니다.
+ 장기 실행 `drop( )` 쿼리의 제한 시간이 개선되었습니다.
+ `otherV( )` 쿼리의 성능이 개선되었습니다.
+ DB 클러스터 또는 인스턴스의 Neptune 상태 확인을 쿼리할 때 반환되는 정보에 두 개의 필드가 추가되었습니다. 이 필드는 엔진 버전 번호와 클러스터 또는 인스턴스 시작 시각입니다. [인스턴스 상태](access-graph-status.md)을(를) 참조하세요.
+ Neptune 로더 `Get-Status` API는 이제 로드 작업이 시작한 때를 기록하는 `startTime` 필드를 반환합니다.
+ 이제 로더 명령은 로더가 사용하는 스레드 수를 제한할 수 있는 선택적 `parallelism` 파라미터를 사용합니다.
# Amazon Neptune 엔진 업데이트 2019년 1월 21일
**버전**: 1.0.1.0.200267.0
Amazon Neptune 1.0.1.0.200267.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200267.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200267.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ Neptune은 충돌 문제가 해결될 때까지 더욱 오래(지정된 쿼리 제한 시간까지) 대기합니다. 이러한 대기 시간을 통해 클라이언트에서 처리해야 하는 동시 수정 예외 수가 줄어듭니다([쿼리 오류](errors-engine-codes.md#errors-query) 단원을 참조하십시오.).
+ Gremlin 카디널리티 적용 시 간혹 엔진이 다시 시작되는 문제가 해결되었습니다.
+ `emit.times` 반복 쿼리를 위한 Gremlin 성능이 개선되었습니다.
+ `repeat.until`이 필터링해야 할 `.emit` 솔루션을 허용했던 Gremlin 문제가 해결되었습니다.
+ Gremlin의 오류 처리가 개선되었습니다.
# Amazon Neptune 엔진 업데이트 2018년 11월 19일
**버전**: 1.0.1.0.200264.0
Amazon Neptune 1.0.1.0.200264.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200264.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200264.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ [Gremlin 쿼리 힌트](gremlin-query-hints.md) 지원이 추가되었습니다.
+ IAM 인증에 대한 오류 메시지가 개선되었습니다. 자세한 내용은 [IAM 인증 오류](errors-engine-codes.md#errors-iam-auth) 섹션을 참조하세요.
+ 많은 수의 예측으로 SPARQL 쿼리 성능이 향상되었습니다.
+ SPARQL 속성 경로 성능이 향상되었습니다.
+ `fold().coalesce(unfold(), …)`, `addV()` 및 `addE()` 단계와 함께 사용할 때 `property()` 패턴과 같은 조건 변형에 대한 Gremlin 성능이 향상되었습니다.
+ `by()` 및 `sack()` 변조에 대한 Gremlin 성능이 향상되었습니다.
+ `group()` 및 `groupCount()` 단계에 대한 Gremlin 성능이 향상되었습니다.
+ `store()`, `sideEffect()` 및 `cap().unfold()` 단계에 대한 Gremlin 성능이 향상되었습니다.
+ Gremlin 단일 카디널리티 속성 제약에 대한 지원이 향상되었습니다.
+ 단일 카디널리티 속성으로 표시된 엣지 속성 및 버텍스에 대한 단일 카디널리티 적용 향상.
+ Neptune Load 작업 중에 기존 엣지 속성에 추가 속성 값을 지정하면 오류가 발생했습니다.
# Amazon Neptune 엔진 업데이트 2018년 11월 8일
**버전**: 1.0.1.0.200258.0
Amazon Neptune 1.0.1.0.200258.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200258.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200258.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ [SPARQL 쿼리 힌트](sparql-query-hints.md) 지원이 추가되었습니다.
+ SPARQL FILTER(NOT) Exists 쿼리에 대한 성능이 향상되었습니다.
+ SPARQL DESCRIBE 쿼리에 대한 성능이 향상되었습니다.
+ Gremlin에 repeat until 패턴의 성능이 향상되었습니다.
+ Gremlin에 엣지 추가에 대한 성능이 향상되었습니다.
+ 어떤 경우 SPARQL Update DELETE 쿼리가 실패할 수 있는 경우 문제를 수정했습니다.
+ Gremlin WebSocket 서버에서 시간 초과를 처리하는 문제가 해결되었습니다.
# Amazon Neptune 엔진 업데이트 2018년 10월 29일
**버전**: 1.0.1.0.200255.0
Amazon Neptune 1.0.1.0.200255.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200255.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200255.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ IAM 인증 정보를 감사 로그에 추가했습니다.
+ IAM 역할 및 인스턴스 프로파일을 사용하여 임시 자격 증명에 지원을 추가했습니다.
+ 권한이 취소되거나 IAM 사용자 또는 역할이 삭제된 경우 IAM 인증을 위한 WebSocket 연결 종료가 추가되었습니다.
+ 인스턴스 당 최대 WebSocket 연결 수는 60,000으로 제한되었습니다.
+ 소규모 인스턴스 유형에 대해 향상된 대량 로드 성능
+ Gremlin에 `and()`, `or()`, `not()`, `drop()` 연산자를 포함하는 쿼리의 성능이 향상되었습니다.
+ NTriples 파서는 이제 공백이 포함된 URI와 같은 잘못된 URI를 거부합니다.
# Amazon Neptune 엔진 업데이트 2018년 9월 6일
**버전**: 1.0.1.0.200237.0
Amazon Neptune 1.0.1.0.200237.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200237.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200237.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ 일부 `SPARQL COUNT(DISTINCT)` 쿼리를 실패할 때 발생하는 문제를 수정함.
+ `COUNT` 절이 포함된 `SUM`, `MIN`, `DISTINCT` 쿼리가 메모리 부족으로 실행될 때 발생하는 문제를 수정함.
+ `BLOB` 유형의 데이터가 Neptune 로더 작업의 실패 원인인 경우 문제를 수정함.
+ 이중 삽입이 트랜잭션 실패의 원인인 경우 문제를 수정함.
+ `DROP ALL` 쿼리를 취소할 수 없는 경우 문제를 수정함.
+ Gremlin 클라이언트가 간헐적으로 중단할 수 있는 경우 문제를 수정함.
+ 150M보다 큰 페이로드에 대한 모든 오류 코드가 `HTTP 400`로 업데이트됨.
+ Single-triple-pattern `COUNT()` 쿼리의 성능과 정확성이 향상됨.
+ `SPARQL UNION` 절을 포함한 `BIND` 쿼리의 성능이 향상됨.
# Amazon Neptune 엔진 업데이트 2018년 7월 24일
**버전**: 1.0.1.0.200236.0
Amazon Neptune 1.0.1.0.200236.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200236.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200236.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ `xsd:string` DataType에 대해 업데이트된 SPARQL 직렬화. xsd:string이 더 이상 JSON 직렬화에 포함되지 않아 이제 다른 출력 형식과 일정합니다.
+ `xsd:double`/`xsd:float` 무제한 처리를 수정했습니다. 이제 모든 SPARQL 데이터 로더 형식, SPARQL 1.1 UPDATE, SPARQL 1.1 쿼리에서 `-INF`, `NaN`, `INF` 값을 제대로 인식하고 처리합니다.
+ 빈 문자열 값이 예기치 않게 실패하는 Gremlin 쿼리 문제를 수정했습니다.
+ 빈 그래프에서 Gremlin `aggregate()` 및 `cap()`이 예기치 않게 실패하는 문제를 수정했습니다.
+ 카디널리티 사양이 잘못되었을 때(예: `.property(set,id,'10')` 및 `.property(single,id,'10')`) 잘못된 오류 응답이 Gremlin에 반환되는 문제를 수정했습니다.
+ 잘못된 Gremlin 구문이 InternalFailureException으로 반환되는 문제를 수정했습니다.
+ 오류 메시지에서 `TimeLimitExceeededException`의 맞춤법을 `TimeLimitExceededException`으로 수정했습니다.
+ 스크립트가 제공되지 않을 때 SPARQL 및 GREMLIN 엔드포인트가 일관되게 대응하도록 변경했습니다.
+ 동시 요청이 너무 많을 때 오류 메시지를 이해하기 쉽게 바꿨습니다.
# Amazon Neptune 엔진 업데이트 2018년 6월 22일
**버전**: 1.0.1.0.200233.0
Amazon Neptune 1.0.1.0.200233.0을 정식 버전으로 사용할 수 있습니다. 스냅샷에서 복원된 것을 포함한 모든 새 Neptune DB 클러스터는 해당 리전에서 엔진 업데이트가 완료된 후 Neptune 1.0.1.0.200233.0에 생성됩니다.
기존 클러스터는 콘솔의 DB 클러스터 작업을 사용하거나 SDK를 사용하여 이 릴리스로 즉시 업그레이드할 수 있습니다. 다음 CLI 명령을 사용하여 DB 클러스터를 이 릴리스로 즉시 업그레이드할 수 있습니다.
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
Neptune DB 클러스터는 시스템 유지 관리 기간 중에 자동으로 엔진 릴리스 1.0.1.0.200233.0으로 업그레이드됩니다. 업데이트가 적용되는 시기는 업데이트의 유형뿐 아니라 DB 클러스터에 대한 유지 관리 기간 설정 및 리전에 따라 다릅니다.
**참고**
인스턴스 유지 관리 기간은 엔진 업데이트에 적용되지 않습니다.
업데이트는 DB 클러스터의 모든 인스턴스에 동시에 적용됩니다. 업데이트하려면 DB 클러스터의 모든 인스턴스에서 데이터베이스를 다시 시작해야 하므로 20\$130초에서 수분까지 가동 중지가 발생할 수 있습니다. 이후 DB 클러스터 또는 클러스터 사용을 재개할 수 있습니다. [Neptune 콘솔](https://console.aws.amazon.com/neptune/home)에서 유지 관리 기간 설정을 확인하거나 변경할 수 있습니다.
질문이나 우려 사항이 있는 경우 커뮤니티 포럼 및 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 도움을 요청할 수 있습니다.
## 개선 사항
+ 오류로 인해 다수의 대량 로드 요청이 빠른 속도로 순차적으로 발행되는 문제를 해결하였습니다.
+ 쿼리가 InternalServerError로 인해 실패할 수 있는 데이터 종속 문제를 해결하였습니다. 다음 예시에서는 영향을 받은 쿼리의 유형을 보여줍니다.
```
g.V("my-id123").as("start").outE("knows").has("edgePropertyKey1", P.gt(0)).as("myedge").inV()
.as("end").select("start", "end", "myedge").by("vertexPropertyKey1")
.by("vertexPropertyKey1").by("edgePropertyKey1")
```
+ 장기 실행 중인 쿼리의 제한 시간이 지난 후에 Gremlin Java 클라이언트가 동일한 WebSocket 연결을 사용하여 서버에 연결할 수 없는 문제를 해결하였습니다.
+ HTTP를 통한 Gremlin 쿼리 또는 WebSocket 연결을 통한 문자열 기반 쿼리의 일부로 포함된 이스케이프 시퀀스가 올바르게 처리되지 않는 문제를 해결하였습니다.