本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Neptune 的引擎版本
Amazon Neptune 會定期發行引擎更新。
您可以使用[執行個體狀態 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) 處理進行評估的版本號碼。
| 版本 | 產品版本 | 主要版本 | 次要版本 | 修補程式版本 | 狀態 | Released | 生命週期結束 | 升級至： |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [1.4.7.0](engine-releases-1.4.7.0.md) | 1 | 4 | 7 | 0 | *作用中* | 2026-03-03 | 2027-06-03 | N/A |
| [1.4.6.3](engine-releases-1.4.6.3.md) | 1 | 4 | 6 | 3 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 2023-11-15 | 2027-03-06 | 1.3.2.1 |
下表列出自 1.0.1.0 以來的所有引擎版本，以及版本生命週期結束的相關資訊。您可以使用此表中的日期來規劃測試和升級週期。
| 版本 | 主要版本 | 次要版本 | 狀態 | Released | 生命週期結束 | 升級至： |
| --- | --- | --- | --- | --- | --- | --- |
| [1.2.1.2](engine-releases-1.2.1.2.md) | 1.2 | 1.2 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *作用中* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 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 | *已棄用* | 2019-10-15 | — | — |
| [1.0.1.1](engine-releases-1.0.1.1.md) | 1.0 | 1.1 | *已棄用* | 2019-08-13 | — | — |
| [1.0.1.0.\$1](engine-releases-1.0.1.0.md) | 1.0 | 1.0.\$1 | *已棄用* | 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 個月傳送給您的訊息將包含此自動更新所涉及內容的詳細資料，包括您將自動升級至哪個版本、對資料庫叢集的影響，以及我們建議的動作。
**重要**
您負責將資料庫引擎版本保持在最新狀態。 AWS 會促使所有客戶將其資料庫升級至最新的引擎版本，以便得益於最新的安全性、隱私權和可用性防禦措施。如果在超過棄用日期的不受支援引擎或軟體 (「舊版引擎」) 上操作資料庫，您可能會面臨更大的安全性、隱私權和操作風險 (包括停機事件)。
在任何引擎上操作資料庫，需受規範您使用 AWS 服務的協議約束。舊版引擎並非一般可用。 AWS 不再提供舊版引擎的支援， AWS 而且如果 AWS 確定舊版引擎對服務、 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 版。我們預計在幾週內啟用升級。
## 這個引擎版本的新功能
+ 從 S3 讀取的 openCypher 透過 OC 支援 Parquet 和 CSV 檔案。請參閱 [neptune.read()](access-graph-opencypher-21-extensions-s3-read.md) 文件。
+ openCypher 地理空間查詢函數。此版本包含以 ISO/IEC 13249-3：2016 標準為基礎的 12 個空間類型函數、存放在新幾何索引中用於快速擷取之 POINT 的新幾何屬性類型，以及支援 Well-Known Text (WKT) 格式。請參閱 [空間資料](access-graph-opencypher-22-spatial-data.md)和 [空間函數](access-graph-opencypher-22-spatial-functions.md) 文件。
## 這個引擎版本的改善項目
+ 改善 SPARQL 子查詢傳回小型結果集的查詢效能，包括具有小型 LIMIT 值的查詢
+ 在變數受到非常大量的常數值限制的情況下改善查詢效能 （例如，SPARQL VALUES 子句或 OpenCypher UNWIND 子句）
+ 透過字典插入的部分最佳化改善低延遲插入查詢
+ 將新的 Gremlin 語言步驟新增至 DFE 引擎 （請參閱 [DFE 中的 Gremlin 步驟涵蓋](gremlin-step-coverage-in-DFE.md)範圍）。
+ 路徑和周遊步驟： `order(local)`
+ 彙總和收集步驟： `dedup(local)`
+ OpenCypher 查詢的效能改善，包括 `COLLECT(DISTINCT ...)`。使用引擎版本 1.4.7.0 或更新版本時，不再需要[重寫 COLLECT(DISTINCT ...) 查詢](best-practices-content-11.md)中所述的重寫。
## 此引擎版本中修正的缺陷
一般修正：
+ 修正大量負載在載入大量邊緣檔案時變得沒有回應的問題
+ 修正影響 1.4.0.0、1.4.1.0 和 1.4.2.0 版次要叢集更新的全域資料庫叢集修補問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# 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 查詢引擎組態執行，並正常處理非 URL 字典項目。
+ 修正 Neptune 大量載入器可能因為不正確的端點解析而無法連線到特定區域中 S3 的問題。
**openCypher 修正**
+ 已修正使用 查詢中有時會發生的引擎當機問題`CALL`。
+ 修正變動查詢的逾時和取消處理。
+ 修正當傳遞給 的其中一個屬性值`MERGE`具有 null 值時， `MERGE`子句提供不正確結果的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.4.6.2 (2025-11-18)
截至 2025-11-18，引擎版本 1.4.6.2 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的瑕疵
**一般修正**
+ 某些錯誤分類為內部故障例外 (IFEs) 的例外狀況現在會在資料流程引擎 (DFE) 執行期間正確回報為並行修改例外狀況 (CMEs)。
**Gremlin 修正**
+ 已改善 Gremlin 相較於 DFE 的引擎穩定性
**openCypher 修正**
+ 修正 Neptune 引擎 1.4.6.0 版中引入的問題，其中 openCypher MERGE 查詢錯誤地處理傳入的關係方向 (←)。使用 MERGE (n)←【：type】-(m) 等模式的查詢現在會建立與正確方向的關係。
+ 已修正未正確復原之寫入器交易的失敗遞交操作。
+ 參考參數化值的 MERGE 查詢現在支援最佳化查詢計劃。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮，AWS支援團隊可在社群論壇和 [AWSPremium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.4.6.1 (2025-09-18)
截至 2025-09-18，引擎版本 1.4.6.1 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的瑕疵
**一般修正**
+ 移除網路檢查是否有使用非 RFC 1918 的叢集符合版本 中介紹的私有 IP 範圍[Amazon Neptune 引擎 1.4.6.0 版 (2025-09-02)](engine-releases-1.4.6.0.md)。
**Gremlin 修正**
+ 修正交易的 Websocket 連線管理問題。
+ 修正使用 gremlin DFE 模式時的罕見執行個體重新啟動問題
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎 1.4.6.0 版 (2025-09-02)
截至 2025-09-02，引擎版本 1.4.6.0 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**警告**
1.4.6.0 引擎版本包含新的網路檢查，這些叢集使用符合資料庫 VPC 私有 IP 範圍的非 RFC 1918，無需 IAM 身分驗證。如果您有此 VPC 和 IAM 組態，則需要更新資料庫 VPC 以使用 RFC 1918 私有 IP 範圍和/或啟用 IAM 身分驗證，以避免升級至 1.4.6.0 後查詢發生錯誤。
## 此引擎版本中的新功能
+ 使用公有端點連線至 Neptune。如需詳細資訊，請參閱 [Neptune 公有端點](neptune-public-endpoints.md)。
## 此引擎版本的改善
**一般改進**
+ 改善更新操作的 SPARQL 效能。
+ 改善 `CREATE`、 `MERGE`和 `SET`（變動） 操作的 OpenCypher 效能。
+ 改善 CALL Subquery 操作的 OpenCypher 效能。
**openCypher 改進**
+ 新增了新的查詢提示，以支援[查詢層級逾時](opencypher-query-hints-timeout-hint.md)。
## 此引擎版本中修正的瑕疵
**Gremlin 修正**
+ 與 Gremlin 工作階段的連線必須在建立 Gremlin 工作階段的相同頻道上進行，這表示無法將多個用戶端執行個體連線至相同的工作階段。
+ 當用戶端關閉時，Gremlin 工作階段一律會關閉，但現在也會關閉連線關閉啟動的伺服器，以防止意外或意外重新連線。
+ 修正讀取大型 Blob 類型資料的 Gremlin 查詢的記憶體流失問題。
**openCypher 修正**
+ 修正`CALL`子查詢後的變數處理。
+ 修正 `reduce`函數正確處理算術溢位案例的問題。
+ 修正啟用查詢計畫快取時影響參數化查詢的記憶體流失問題。
+ 修正`NOT EXISTS`在複雜 `WHERE` 子句中使用的 問題。
+ 修正錯誤回報為 BadRequestException CMEs)。
**SPARQL 修正**
+ 修正遠端來源無法使用`LOAD/UNLOAD`時 SPARQL 的錯誤訊息。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮，AWS支援團隊可在社群論壇和 [AWSPremium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.4.5.1 (2025-06-30)
截至 2025-06-30，引擎版本 1.4.5.1 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的瑕疵
**一般修正**
+ 已修正影響所有查詢語言的無伺服器擴展問題。
+ 修正在`collect(distinct())`清單上執行時，某些 OpenCypher 查詢傳回內部錯誤的問題。
+ 修正使用 OpenSearch 無伺服器時，並行 FTS 查詢導致其他並行 FTS 查詢終止的問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎 1.4.5.0 版 (2025-04-09)
截至 2025-04-09，引擎版本 1.4.5.0 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**警告**
由於某些無伺服器組態中可能發生問題，我們已暫停升級至 1.4.5.0。我們建議您升級至 1.4.5.1 引擎版本。已暫時停用 1.4.5.0 的升級。
## 此引擎版本中的新功能
+ 已將新的 Gremlin 語言步驟新增至 DFE 引擎。
+ **路徑和周遊步驟：**asDate()， dateAdd()， dateDiff()， fail()， Inject()， label()， path()， project()， repeat()， sack()， select()， unfold()， disjunct()， drop()， identity()， intersect()， length()， loops()， barrier()， order()， range()， reverse()， sample()， cap()， split()， filter()， flatMap()， map()， sideEffect()， union()， index()
+ **彙總和集合步驟：**upremerization(global)、combint()、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()
+ **篩選步驟： **和 ()、coalesce()、win()、is()、local()、no()、not() 或 ()， where()
+ **字串操作步驟：**concat()、lTrim()、rTrim()、substring()、toLower()、toUpper()、trim()
+
**述詞：**
+ 比較：eq、neq、lt、lte、gt、gte
+ 包含：內部，不含
+ TextP：endingWith、include、notStartingWith、notEndingWith、notContaining
+ P： 和，或在外部、內部之間
如需 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 子查詢效能改善。
+ 支援 HTTP 結尾標頭支援分段 openCypher 回應。如需詳細資訊，請參閱[選用的 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 修正**
+ 修正處理 SPARQL 查詢時，宣告多個基本 IRIs 的問題，這只會使用初始宣告。
+ 修正使用無效模式字串處理 SPARQL `REPLACE`函數時會導致傳回錯誤的問題。
+ 修正使用大小寫敏感度 (`"i"`) 旗標搭配 Unicode 資料處理 SPARQL `REPLACE`函數的問題。
+ 修正使用無效`\u`和`\U`轉碼點逸出序列剖析 SPARQL 查詢時，可能導致未傳回任何回應的問題。
+ 修正 SPARQL `IRI`函數中不一定能針對目前的基礎 IRIs 正確解析相對 IRI 的問題。
+ 修正使用字首名稱導致 `SPARQL INSERT DATA`和 `DELETE DATA` 更新無法正確解析相對於目前基本 IRIs相對 IRI 的問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮，AWS支援團隊可在社群論壇和 [AWSPremium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.4.4.0 (2025-02-24)
截至 2025-02-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 中的查詢剖析不正確。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.4.3.0 (2025-01-21)
截至 2025-01-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% 的迴歸。
## 此引擎版本的新功能
+ [將 Gremlin 查詢結果匯出至 Amazon S3](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 執行個體**。R7i 執行個體系列現可於下列區域使用，最高可達 48xlarge：
+ 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`，它會為新插入釋放索引中的空間。相對於未啟用字典 GC 時，在 中的成長率`VolumeBytesUsed`可能較低。當`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
```
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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
```
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 函數。我們正在引入八個新函數，以協助處理字串、集合操作和集合排序。這些包括：`textIndexOf`、`collToSet`、`collSubtract`、`collIntersection`、`collSort`、`collSortMulti`、 `collSortMaps`和 `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" 篩選條件最佳化的問題。當使用 not() 步驟結合 outV()/inV()/otherV() 步驟來篩選邊緣時，此問題會影響查詢。範例查詢包括：
+ `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 改進**
+ 改善使用大型靜態清單或地圖的查詢效能。透過用於插入 / upsert 屬性節點的大型巢狀貼圖清單，使用 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 修正**
+ 修正 TinkerPop OSS 程式碼路徑中，當在`GraphTraversalSource`「g」物件上使用任何`withStrategies()/withoutStrategies()/with()`步驟時，建立周遊查詢的位元組表示法的問題。此問題錯誤地將新指示附加到 Bytecode，而不是取代相同策略的現有指示，並在結果快取失效期間導致快取金鑰不相符，以清除儲存的結果。
**openCypher 修正**
+ 在 CREATE/MERGE/MATCH 子句``~id`match`中更正 的行為。使用 null 或非字串類型等無效``~id``值時，CREATE/MERGE 子句現在擲回正確的例外狀況，`MATCH`子句傳回零結果。
+ 已修正當使用者將不支援類型的值與彙總函數 （即 sum()) 搭配使用時的 IFE。
+ 修正來自大量查詢工作負載的一些低延遲變動查詢因 OutOfMemory 錯誤而失敗的問題。
**SPARQL 修正**
+ 修正處理包含 `'%'` 字元的 SPARQL 查詢時的稽核日誌問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮，AWS支援團隊可在社群論壇和 [AWSPremium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.4.0.0 (2024-11-06)
截至 2024-11-06，引擎版本 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，該 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) 或高輸送量工作負載 (>1000 qps) 的效能。
**Gremlin 改進**
+ 依預設，每個查詢逾時會強制執行為小於叢集層級逾時。在先前的版本中，引進此檢查，但需要透過 實驗室模式參數 'StrictTimeoutValidation' 明確啟用。在此版本中，預設會啟用 'StrictTimeoutValidation'，且必須明確停用才能保留舊的行為。
**openCypher 改進**
+ 在上一版中，我們推出了透過實驗室模式參數 啟用的[延長日期時間格式支援](https://docs.aws.amazon.com//neptune/latest/userguide/feature-opencypher-compliance.html#opencypher-compliance-time-na)`DatetimeMillisecond`。此延長日期時間格式支援現在預設為啟用。
**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.
```
## 此引擎版本中修正的瑕疵
**一般修正**
+ 修正擴展時可能導致資料庫重新啟動的 Serverless 執行個體問題。
+ 修正與稽核日誌檔案管理相關的問題，可能導致無法存取日誌檔案進行下載或輪換，在某些情況下會增加 CPU 用量。
+ 修正與最佳化延遲在 DFE 引擎中產生映射輸出相關的查詢問題。
+ 已修正導致稽核日誌與慢查詢日誌之間時間戳記不相符的問題。
**Gremlin 修正**
+ 已解決 Gremlin WebSocket 連線管理中查詢執行時間超過連線閒置逾時的問題。這特別影響了使用 AIOHTTP 傳輸的 Python Gremlin 用戶端。
**openCypher 修正**
+ 已修正在 collect(distinct(n)) 查詢建構期間存在 null 值時，導致內部失敗例外狀況的收集步驟問題。
+ 修正啟用查詢計劃快取時，查詢中`NullPointerException`可能發生 的問題。
+ 已修正當查詢包含 LIMIT 子句時，評估超過所需資料的問題。
+ 修正在具有查詢計劃快取的參數化查詢中使用範圍操作 (＜、<=、＞、>=) 會產生重複結果的問題。
+ 已修正在使用螺栓連線執行 UNION 和 UNION ALL 操作時轉傳結果欄的問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮，AWS支援團隊可在社群論壇和 [AWSPremium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎 1.3.4.0 版 (2024-10-01)
截至 2024-10-01，引擎版本 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 連線傳送 Websocket 升級請求時，我們改善了請求處理和錯誤報告 （先前 400 個回應中發生錯誤「未提供 gremlin 指令碼，傳回程式碼 MissingParameterException」)。
+ 最佳化處理具有單一基數屬性值更新`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 修正**
+ 修正`collect(distinct())`使用 null 值執行 導致傳回錯誤的問題。
+ 修正執行包含範圍篩選條件的參數化查詢 (/>= 參數值） 導致重複/遺失結果的問題。
+ 修正 DFE 引擎產生的輸出超過限制查詢中請求的錯誤，這可能會導致記憶體不足錯誤。
**SPARQL 修正**
+ 修正在啟用 IAM 身分驗證的叢集上執行聯合 SPARQL 更新查詢導致傳回錯誤的問題。
+ 已修正 SPARQL 1.1 更新操作的動作型許可。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.3.3.0 (2024-08-05)
截至 2024-08-05，引擎版本 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 修正**
+ 修正 SPARQL 1.1 圖形存放區 HTTP 通訊協定 (GSP) 的問題，當 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}
```
+ 如果查詢是 UNION 或 UNION ALL 查詢，則使用 Bolt 通訊協定執行的查詢可能會產生不正確的結果。若要避免此問題，請考慮使用 HTTP 端點執行特定查詢。或者，使用 Bolt 通訊協定時，請分別執行聯集的每個部分。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.3.2.1 (2024-06-20)
截至 2024-06-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.1 中的變更從 1.3.2.0 轉移
### 從引擎 1.3.2.0 版轉移的改進
**一般改進**
+ 支援 TLS 1.3 版，包括密碼套件 TLS\$1AES\$1128\$1GCM\$1SHA256 和 TLS\$1AES\$1256\$1GCM\$1SHA384。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 語言驅動程式時，請注意序列化程式類別已無一些[重新命名](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming)。如果指定，您將需要更新組態檔案和程式碼中的套件和類別命名。
+ `StrictTimeoutValidation` （僅當透過包含 `StrictTimeoutValidation`的 實驗室模式啟用時`StrictTimeoutValidation=enabled`)：當`StrictTimeoutValidation`參數的值為 時`enabled`，指定為請求選項或查詢提示的每個查詢逾時值不能超過參數群組中全域設定的值。在這種情況下，Neptune 會擲回 `InvalidParameterException`。當值為 時，可以在`/status`端點上的回應中確認此設定`disabled`，而在 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 彙總查詢的效能提升。
+ 改善涉及 nullable 變數之聯結的效能。
+ 涉及不等於 id（節點/關係） 述詞之查詢的效能改善。
+ 延長對日期時間功能的支援 （僅透過包含 `DatetimeMillisecond`的實驗室模式啟用`DatetimeMillisecond=enabled`。如需詳細資訊，請參閱[Neptune openCypher 實作的暫時支援 (Neptune Analytics 和 Neptune 資料庫 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 查詢轉譯中的錯誤，此`NullPointerException`錯誤會在查詢在兩個 DFE 片段中執行時發生，而第一個片段最佳化為不滿意的節點。例如：
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'doesNotExists').
has("name", TextP.regex("mark.*")).
inject(1).
V().
out().
has('name', 'vadas')
```
+ 修正當查詢在 by() 調節器內包含 ValueTraversal 且其輸入為 Map `InternalFailureException`時，Neptune 可能會擲回 的錯誤。例如：
```
g.V().
hasLabel("person").
project("age", "name").by("age").by("name").
order().by("age")
```
**openCypher 修正**
+ 改善 UNWIND 操作 （例如，將值清單展開為個別值），以協助防止記憶體不足 (OOM) 情況。例如：
```
MATCH (n)-->(m)
WITH collect(m) AS list
UNWIND list AS m
RETURN m, list
```
+ 已修正在多個 MERGE 操作中，透過 UNWIND 注入 id 時的自訂 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 修正**
+ 已修正 SPARQL 剖析器，以改善 INSERT DATA 等大型查詢的剖析時間，其中包含許多三元組和大型字符。
### 緩解 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}
```
+ 如果查詢是 UNION 或 UNION ALL 查詢，則使用 Bolt 通訊協定執行的查詢可能會產生不正確的結果。若要避免此問題，請考慮使用 HTTP 端點執行特定查詢。或者，使用 Bolt 通訊協定時，請分別執行聯集的每個部分。
### 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.3.2.0 (2024-06-10)
截至 2024-06-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 1.3 版，包括密碼套件 TLS\$1AES\$1128\$1GCM\$1SHA256 和 TLS\$1AES\$1256\$1GCM\$1SHA384。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 語言驅動程式時，請注意，序列化程式類別已無一些[重新命名](https://tinkerpop.apache.org/docs/3.7.1/upgrade/#_serializer_renaming)。如果指定，您將需要更新組態檔案和程式碼中的套件和類別命名。
+ `StrictTimeoutValidation` （僅當透過包含 `StrictTimeoutValidation`的 實驗室模式啟用時`StrictTimeoutValidation=enabled`)：當`StrictTimeoutValidation`參數的值為 時`enabled`，指定為請求選項或查詢提示的每個查詢逾時值不能超過參數群組中全域設定的值。在這種情況下，Neptune 會擲回 `InvalidParameterException`。當值為 時，可以在`/status`端點上的回應中確認此設定`disabled`，而在 Neptune 1.3.2.0 版中，此參數的預設值為 `Disabled`。
**openCypher 改進**
+ 與先前的引擎版本相比，Amazon Neptune 引擎版本 1.3.2.0 為 openCypher 查詢效能提供高達 9 倍的速度和 10 倍的輸送量。
+ 低延遲查詢和輸送量效能改善：低延遲 openCypher 查詢的整體效能改善。新版本也會改善此類查詢的輸送量。使用參數化查詢時，改善更為重要。
+ 支援查詢計畫快取：將查詢提交至 Neptune 時，查詢字串會剖析、最佳化，並轉換為查詢計畫，然後由引擎執行。應用程式通常由以不同值執行個體化的常見查詢模式提供支援。查詢計畫快取可以透過快取查詢計畫來減少整體延遲，進而避免剖析和最佳化這類重複模式。
+ DISTINCT 彙總查詢的效能提升。
+ 改善涉及 nullable 變數之聯結的效能。
+ 涉及不等於 id（節點/關係） 述詞之查詢的效能改善。
+ 延長對日期時間功能的支援 （僅透過包含 `DatetimeMillisecond`的實驗室模式啟用`DatetimeMillisecond=enabled`。如需詳細資訊，請參閱[Neptune openCypher 實作的暫時支援 (Neptune Analytics 和 Neptune 資料庫 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 查詢轉譯中的錯誤，此`NullPointerException`錯誤會在查詢在兩個 DFE 片段中執行時發生，而第一個片段最佳化為不滿意的節點。例如：
```
g.withSideEffect('Neptune#useDFE', true).
V().
has('name', 'doesNotExists').
has("name", TextP.regex("mark.*")).
inject(1).
V().
out().
has('name', 'vadas')
```
+ 修正當查詢在 by() 調節器內包含 ValueTraversal 且其輸入為 Map `InternalFailureException`時，Neptune 可能會擲回 的錯誤。例如：
```
g.V().
hasLabel("person").
project("age", "name").by("age").by("name").
order().by("age")
```
**openCypher 修正**
+ 改善 UNWIND 操作 （例如，將值清單展開為個別值），以協助防止記憶體不足 (OOM) 情況。例如：
```
MATCH (n)-->(m)
WITH collect(m) AS list
UNWIND list AS m
RETURN m, list
```
+ 已修正在多個 MERGE 操作中，透過 UNWIND 注入 id 時的自訂 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 修正**
+ 已修正 SPARQL 剖析器，以改善 INSERT DATA 等大型查詢的剖析時間，其中包含許多三元組和大型字符。
## 緩解 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}
```
+ 如果查詢是 UNION 或 UNION ALL 查詢，則使用 Bolt 通訊協定執行的查詢可能會產生不正確的結果。若要避免此問題，請考慮使用 HTTP 端點執行特定查詢。或者，使用 Bolt 通訊協定時，請分別執行聯集的每個部分。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.3.1.0 (2024-03-06)
截至 2024-03-06，引擎版本 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 改進**
+ 改善 DFE 統計資料運算，以避免 Serverless 執行個體的 NCUs非常高。
+ WITHIN 的 Gremlin 效能改善。
## 此引擎版本中修正的瑕疵
**Gremlin 修正**
+ Gremlin DFE 查詢計畫的其他改進。
+ 具有選用周遊的 Gremlin 查詢的錯誤修正，例如，對於格式為 `g.V().hasLabel('person').group().by(id()).by(\$1\$1.in('friend').id())` 的查詢，其中沒有朋友邊緣的人未分組。
+ 修正以下錯誤：如果使用 DFE 引擎執行，則 Gremlin `by` 查詢包含調變器內的 Coalesce 步驟會導致傳回錯誤。
+ 修正在連線至僅供讀取複本時，導致 Gremlin 工作階段中執行的唯讀查詢無法運作的錯誤。
+ 針對 Gremlin 成功的初始 Websocket 連線請求，在稽核日誌中不存在 IAM ARN 的錯誤修正。
+ Coalesce 步驟，使用 DFE 識別步驟涵蓋範圍。
+ 整個 DFE 計劃的特性集最佳化。
**openCypher 修正**
+ openCypher SET 子句中的錯誤修正，以允許設定非變數表達式 （即 match(n：TEST) set(n.prop = 2 然後 n end).prop = 3 傳回 n.prop。
+ 針對涉及彙總和排序依據的 openCypher 查詢失敗的錯誤修正。
+ 已改善包含靜態映射之大型清單的 UNWIND。
+ 使用具有重複值的自訂 ID 修正 openCypher MERGE 查詢的錯誤。
**SPARQL 修正**
+ 已修正選用模式中有關變數範圍的 SPARQL 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 為超過 40 種 Neptune 的資料操作提供 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)控制的次要版本，以及您可以透過[訂閱](events-subscribing.md)[`RDS-EVENT-0156`](event-lists.md#RDS-EVENT-0156) 事件來接收通知的次要版本。
如需有關這些變更的詳細資訊，請參閱[維護 Amazon Neptune 資料庫叢集](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`
+ 最佳化的 Gemlin DFE 查詢計畫，以避免在使用 `by()` 調變時進行完整的頂點掃描。
+ 大幅改善低基數和低延遲查詢的效能。
+ 新增對 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 修正**
+ 已修正 Gemlin 錯誤，其中針對不是在 DFE 引擎中原生處理的步驟，檢查 Gremlin 查詢狀態端點是否有子周遊中具有述詞的查詢時，將會發生交易洩漏。
+ 已修正 Gremlin 錯誤，其中未在 DFE 引擎的 `by()` 周遊下將 `valueMap()` 最佳化。
+ 已修正 Gremlin 錯誤，其中未將連接至 `UnionStep` 的步驟標籤各別傳播至其子周遊的最後一個路徑元素。
+ 已修正 Gremlin 錯誤，其中查詢將會失敗，因為它包含了太多的 TinkerPop 步驟，接著並不會將其清除。
+ 已修正 Gremlin 錯誤，其中 `NullPointerException` 會在 `mergeV` 和 `mergeE` 步驟中擲回。
+ 已修正 Grimlin 錯誤，其中 `order()` 將不會正確排序字串輸出，因為這些字串輸出中有一些包含空格字元時。
+ 已修正在 DFE 引擎中處理 `valueMap` 步驟時所發生的 Gemlin 正確性問題。
+ 已修正 `GroupStep` 或 `GroupCountStep` 嵌套於鍵周遊中時發生的 Gemlin 正確性問題。
**openCypher 修正**
+ 已修正涉及 NULL 字元錯誤處理的 openCypher 錯誤。
+ 已修正 openCypher Bolt 交易處理中的錯誤。
**SPARQL 修正**
+ 已修正遞迴函式中的值未正確解析的 SPARQL 錯誤。
+ 已修正使用 `VALUES` 子句注入大量值時，導致效能下降的 SPARQL 錯誤。
+ 已修正 SPARQL 錯誤，該錯誤會導致語言標記文字的`REGEX` 運算子呼叫永遠不會成功。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.2.1.2 (2024-08-05)
截至 2024-08-05，引擎版本 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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
**警告**
偵測到 SPARQL 1.1 圖形存放區 HTTP 通訊協定 (GSP) 問題，當 GSP 與動作型授權政策搭配使用時，該問題可能在某些條件下存在。如果您使用 SPARQL 1.1 圖形存放區 HTTP 通訊協定搭配以動作為基礎的授權政策，建議您升級至最新的次要 Neptune 引擎版本 （至少 1.2.1.2)，其中包含此問題的修正。
## 此引擎版本中修正的缺陷
**SPARQL 修正**
+ 修正 SPARQL 1.1 圖形存放區 HTTP 通訊協定 (GSP) 的問題，當 GSP 與動作型授權政策搭配使用時，可能會在特定條件下存在。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.2.1.1 (2024-03-11)
截至 2024-03-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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
**一般改進**
Neptune 已改善設定檔/說明中顯示的警告。
**Gremlin 改進**
+ 改善 DFE 統計資料運算，以避免 Serverless 執行個體的 NCUs非常高。
+ WITHIN 的 Gremlin 效能改善。
## 此引擎版本中修正的缺陷
**Gremlin 修正**
+ Gremlin DFE 引擎查詢計劃的排序錯誤修正。
+ 當最初報告為 InternalFailureException 時，使用 Gremlin out-of-memory錯誤進行錯誤修正。
+ 針對成功的初始 Websocket 連線請求，在稽核日誌中不存在 IAM ARN 的錯誤修正。
+ 在工作階段中的查詢失敗時啟用 TinkerPop 工作階段的 Gremlin 查詢錯誤修正，即使所有查詢都唯讀並連線至讀取器執行個體也是如此。
**openCypher 修正**
+ openCypher SET 子句中的錯誤修正，以允許設定非變數表達式 （即 match(n：TEST) set(n.prop = 2 然後 n end).prop = 3 傳回 n.prop。
+ 針對涉及彙總和排序依據的 openCypher 查詢失敗的錯誤修正。
+ 已改善包含靜態映射之大型清單的 UNWIND。
+ 使用具有重複值的自訂 ID 修正 openCypher MERGE 查詢的錯誤。
**SPARQL 修正**
+ SPARQL DFE 查詢規劃器中的錯誤修正。
+ 搭配 BIND 和 OPTIONAL 關鍵字使用時，SPARQL 的錯誤修正。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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) 或更新版本升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 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-06)](engine-releases-1.2.1.0.R7.md)
## 這個引擎版本的新功能
+ 已新增對 [TinkerPop 3.6.2](https://tinkerpop.apache.org/docs/3.6.2-SNAPSHOT/dev/provider/) 的支援，這會新增許多新的 Gremlin 功能，例如新的 `mergeV()`、`mergeE()`、`element()` 和 `fail()` 步驟。`mergeV()` 和 `mergeE()` 步驟特別值得注意，因為它們提供了一個期待已久的宣告式選項，用於執行類似 Upsert 的操作，這應該大大簡化現有的程式碼模式，並使 Gemlin 更容易讀取。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 會對 `Merge` 使用比 `Coalesce` 更窄的鎖定模式，這可以減少並行修改例外狀況 (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/)。
+ 已新增對 [R6i 執行個體類型](https://aws.amazon.com/ec2/instance-types/r6i/)的支援，此執行個體類型是由第三代 Intel Xeon 可擴展處理器提供。這些非常適合記憶體密集型工作負載，與同類 R5 執行個體類型相比，提供每個 vCPU 最多可提升 15% 的運算/價格效能，以及最多可提高 20% 的記憶體頻寬。
+ 已同時新增屬性圖和 RDF 圖形的[圖形摘要 API](neptune-graph-summary.md) 端點，可讓您取得有關圖形的快速摘要報告。
對於屬形 (PG) 圖，圖形摘要 API 會提供節點和邊緣標籤以及屬性索引鍵的唯讀清單，也會提供節點、邊緣和屬性的計數。對於 RDF 圖形，它會提供類別和述詞索引鍵的清單，以及四元組、主旨和述詞的計數。
新的圖形摘要 API 進行了以下變更：
+ 已新增一個 [GetGraphSummary](iam-dp-actions.md#getgraphsummary) 資料平面動作。
+ 已新增 `rdf/statistics` 端點來取代現已遭棄用的 `sparql/statistics` 端點。
+ 將統計資料狀態回應中的 `summary` 欄位名稱變更為 `signatureInfo`，以免將其與圖形摘要資訊混淆。先前的引擎版本會繼續在 JSON 回應中使用 `summary`。
+ 將統計資料狀態回應中 `date` 欄位的精確度從分鐘變更為毫秒。先前的格式為 `2020-05-07T23:13Z` (分鐘精確度)，而新格式為 `2023-01-24T00:47:43.319Z` (毫秒精確度)。兩者都符合 ISO 8601 標準，但此變更可能會破壞現有的程式碼，取決於日期的剖析方式。
+ 已在工作台中新增 [`%statistics`](notebooks-magics.md#notebooks-line-magics-statistics) 行魔法，可讓您擷取 DFE 引擎統計資料。
+ 已在工作台中新增 [`%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) 函數，此函數會從映射中移除指定的索引鍵並傳回產生的新映射。
## 這個引擎版本的改善項目
+ 已將 Gremlin DFE 支援延伸至具有本機範圍的 `limit` 步驟。
+ 已在 DFE 引擎中新增對 Gremlin `DedupGlobalStep` 的 `by()` 調變支援。
+ 已新增對 Gremlin `SelectStep` 和 `SelectOneStep` 的支援。
+ 各種 Gemlin 運算子 (包括 `repeat`、`coalesce`、`store` 和 `aggregate`) 的效能改善和正確性修正。
+ 已改善涉及 `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 僅邊緣大量載入的載入處理等待時間。
+ 已使大量載入在 Neptune 重新啟動時以非同步方式繼續，以避免在繼續嘗試失敗之前，因 Amazon S3 連線問題所造成的漫長等待時間。
+ 已改善 SPARQL DESCRIBE 查詢的處理，這些查詢具有查詢提示設定為 `"CBD"` (簡潔的界限描述) 的 [describeMode](sparql-query-hints-for-describe.md#sparql-query-hints-describeMode) 查詢，以及涉及大量空白節點。
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中查詢傳回了字串 `"null"`，而不是 Bolt 和 SPARQL-JSON 中的 null 值。
+ 己修正清單理解中的 OpenCypher 錯誤，此錯誤產生了空值，而不是為清單元素提供的值。
+ 已修正位元組值未正確序列化的 OpenCypher 錯誤。
+ 已修正 `UnionStep` 中在下列情況發生的 Gremlin 錯誤：輸入是周遊至子周遊內頂點的邊緣。
+ 已修正 Grimlin 錯誤，此錯誤導致了與 `UnionStep` 相關聯的步驟標籤無法正確傳播到每個子周遊的最後一個步驟。
+ 已針對其標籤跟在 `repeat` 步驟後面的 `dedup` 步驟修正了 Gremlin 錯誤，其中附加到 `dedup` 步驟的標籤無法在查詢中進一步使用。
+ 已修正 Gremlin 錯誤，其中轉換 `union` 步驟內的 `repeat` 步驟失敗，發生內部錯誤。
+ 已透過返回 Tinkerpop 修正了 DEF 查詢的 Grimlin 正確性問題，這些查詢具有 `limit` 做為非聯集步驟的子周遊。表單中像這樣的查詢會受到影響：
```
g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
```
+ 已修正 SPARQL 錯誤，其中 `SPARQL GRAPH` 模式不會考慮 `FROM NAMED` 子句提供的資料集。
+ 已修正 SPARQL 錯誤，其中具有某些 `FROM` 和/或 `FROM NAMED` 子句的 SPARQL `DESCRIBE` 並不總是正確地使用來自預設圖形的資料，而且有時會擲回例外狀況。請參閱 [關於預設圖形的 SPARQL DESCRIBE 行為](sparql-default-describe.md)。
+ 已修正 SPARQL 錯誤，以便在拒絕 null 字元時傳回正確的例外狀況訊息。
+ 已修正 SPARQL [Explain](sparql-explain.md) 錯誤，此錯誤影響了包含 [PipelinedHashIndexJoin](sparql-explain-operators.md#sparql-explain-operator-pipeline-hash-index-join) 運算子的計劃。
+ 已修正錯誤，此錯誤已在提交一個傳回常數值的查詢時，導致擲回內部錯誤。
+ 已修正死鎖偵測器邏輯偶爾會使引擎沒有回應的問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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](engine-releases-1.1.0.0.md) 的先前 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎更新，版本 1.2.1.0.R7 (2023-10-06)。
截至 2023-10-06，引擎版本 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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 此引擎版本中修正的缺陷
+ 已修正在某些情況下，未適當地關閉失敗交易的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的新功能
+ 已發行 [Neptune 資料 API](data-api.md)。
Amazon Neptune 資料 API 為載入資料、執行查詢、取得資料相關資訊，以及執行機器學習操作提供 SDK 支援。它支援 Neptune 中的 Gremlin 和 OpenCypher 查詢語言，並且可在所有 SDK 語言中使用。它會自動簽署 API 請求，並大幅簡化將 Neptune 整合至應用程式的操作。
## 此引擎版本中修正的缺陷
+ 已修正慢查詢日誌啟用時，在高載入下可能導致 CPU 峰值的錯誤。
+ 已修正 Gremlin 錯誤，其中新增邊緣及其後面跟著 `inV()` 或 `outV()` 的屬性引發了 `InternalFailureException`。
+ 已修正 IAM 角色鏈結在某些情況下造成大量載入器效能降低的數個問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的新功能
+ 已發行 [Neptune 資料 API](data-api.md)。
Amazon Neptune 資料 API 為載入資料、執行查詢、取得資料相關資訊，以及執行機器學習操作提供 SDK 支援。它支援 Neptune 中的 Gremlin 和 OpenCypher 查詢語言，並且可在所有 SDK 語言中使用。它會自動簽署 API 請求，並大幅簡化將 Neptune 整合至應用程式的操作。
## 此引擎版本中修正的缺陷
+ 已修正 Gremlin 錯誤，其中新增邊緣及其後面跟著 `inV()` 或 `outV()` 的屬性引發了 `InternalFailureException`。
+ 已修正 IAM 角色鏈結在某些情況下造成大量載入器效能降低的數個問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 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
```
## 此引擎版本中修正的缺陷
+ 已修正 Gemlin 錯誤，其中在對於不是原生處理的步驟，檢查 Gremlin 查詢狀態端點是否有子周遊中具有述詞的查詢時，將會發生交易洩漏。
+ 已修正 Bolt 交易處理中的 openCypher 錯誤。
+ 已修正儲存層上可能導致當機的並行問題。
+ 已修正慢查詢日誌中的錯誤，以確保它們停用時不是作用中。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的新功能
+ 已新增使用 [IAM 角色鏈結](bulk-load-tutorial-chain-roles.md)進行跨帳戶大量載入的支援。
## 這個引擎版本的改善項目
+ 已改善 Gremlin 的 `fail()` 步驟，以區分它從泛型 `InternalFailureException` 產生的例外狀況，並確保提供給它的任何使用者提供的訊息都回傳給呼叫者。
+ 已改善 `store`、`aggregate`、`cap`、`limit` 和 `hasLabel` 的 Gemlin 查詢引擎最佳化。
+ 已新增對 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 靜態偵錯 Explain 工具的支援。
+ 已新增對 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` 和彙總函數中的值進行備援實體化。
+ 已改善 SPARQL 查詢的效能，這些查詢在 `VALUES` 子句中包含大量靜態輸入，例如：
```
SELECT ?n WHERE { VALUES (?name) { ("John") ("Jim") ... many values ... } ?n a ?n_type . ?n ?name . }
```
+ 已改善 SPARQL CBD 查詢效能。
## 此引擎版本中修正的缺陷
+ 已修正 Gemlin 錯誤，其中在查詢規劃階段期間，具有深層巢狀的長時間查詢造成了高 CPU 使用率和查詢逾時。
+ 已修正 Gremlin 錯誤，其中在使用 `mergeV` 或 `mergeE` 時可能會擲回無效的 `NullPointerException`。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已將 `enableInterContainerTrafficEncryption` 參數新增至所有 [Neptune ML API](machine-learning-api-reference.md)，您可以使用此參數，在訓練或超參數調校工作中啟用和停用容器間流量加密。
+ 已新增對 Gremlin `mergeV()` 和 `mergeE()` 的多標籤支援。
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中更新和傳回查詢並未適當地處理 `orderBy`、`limit` 或 `skip`。
+ 已修正 OpenCypher 錯誤，此錯誤允許一個請求中包含的參數被另一個同時請求中包含的參數覆寫。
+ 已修正 OpenCypher 錯誤，其中慢查詢日誌未包含正確的查詢時間。
+ 已修正 Gremlin 錯誤，其中包含 `GroupCountStep` 的查詢作為字串提交時可能發生交易洩漏。
+ 已修正慢查詢日誌啟用時 WebSocket 查詢失敗的 Gremlin 錯誤。
+ 已修正 Grimlin 錯誤，其中 WebSocket 請求的慢查詢日誌中缺少儲存體計數器偵錯日誌。
+ 已修正數個涉及 `mergeV()` 和 `mergeE()` 的 Gremlin 錯誤。
+ 已修正 SPARQL 錯誤，其中錯誤估計了具名圖形查詢成本，導致次佳查詢計畫和記憶體不足錯誤。
+ 已修正在啟用 IAM 的叢集上影響了 Gremlin 和 OpenCypher 查詢授權的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 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 中引進 Gemlin 的[即時歸納推論](machine-learning-overview-evolving-data.md#inductive-vs-transductive-inference)。
+ 已引進 OpenCypher 延伸模組，支援指定[實體的自訂 ID 值](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids)，而不是 Neptune 以其他方式產生的 UUID。指派自訂 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)以及查詢提示來設定它們。
## 這個引擎版本的改善項目
+ 已改善 openCypher 效能，特別是針對 VLP 查詢。
+ 已針對具有非終端限制的 Gemlin 查詢改善了 DFE 效能，例如：
```
g.withSideEffect('Neptune#useDFE',true).V().hasLabel('Student').limit(5).out('takesCourse')
```
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 此引擎版本中修正的缺陷
+ 已修正 SPARQL 錯誤，其中在呼叫語言標記的常值時，`REGEX` 運算子永遠不會成功。
+ 已修正導致大量載入效能下降的問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 資料庫叢集將在下一個維護時段自動升級至此維護修補程式版本。
## 升級至此版本
Amazon Neptune 1.2.0.2.R6 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 此引擎版本中修正的缺陷
+ 已修正 Grimlin 錯誤，其中 `order()` 將不會正確排序字串輸出，因為這些字串輸出中有一些包含空格字元時。
+ 已修正 Gemlin 錯誤，其中在對於不是原生處理的步驟，檢查 Gremlin 查詢狀態端點是否有子周遊中具有述詞的查詢時，將會發生交易洩漏。
+ 已修正 Bolt 交易處理中的 openCypher 錯誤。
+ 已修正儲存層上可能導致當機的並行問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 資料庫叢集將在下一個維護時段自動升級至此維護修補程式版本。
## 升級至此版本
Amazon Neptune 1.2.0.2.R5 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 此引擎版本中修正的缺陷
+ 已修正 SPARQL 錯誤，其中透過 `VALUES` 子句插入大量值可能導致效能降低。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 資料庫叢集將在下一個維護時段自動升級至此維護修補程式版本。
## 升級至此版本
Amazon Neptune 1.2.0.2.R4 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 對於無伺服器資料庫叢集，已將最小容量設定變更為 1.0 NCU，並將最低有效的上限設定變更為 2.5 NCU。請參閱[Neptune Serverless 資料庫叢集中的容量擴展](neptune-serverless-capacity-scaling.md)
+ 已將 `enableInterContainerTrafficEncryption` 參數新增至所有 [Neptune ML API](machine-learning-api-reference.md)，您可以使用此參數，在訓練或超參數調校工作中啟用和停用容器間流量加密。
## 此引擎版本中修正的缺陷
+ 已修正 Gremlin 錯誤，其中 `option(Predicate)` 未被辨識為有效的 Gremlin 語法。
+ 已修正 Gremlin 錯誤，此錯誤導致了查詢若失敗，將不會進行適當的清除，因為它們包含太多的步驟。
+ 已透過返回 Tinkerpop 修正了影響 DEF 查詢的 Grimlin 正確性問題，這些查詢具有 `limit` 做為非聯集步驟的子周遊。以下是此類查詢的範例：
```
g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
```
+ 已修正以字串形式提交的查詢包含 `GroupCountStep` 時潛在的 Gemlin 交易洩漏。
+ 已修正 OpenCypher 錯誤，其中參數值的類型並未在清單或映射清單中正確地推論出來。
+ 已修正 OpenCypher 錯誤，其中更新和傳回查詢並未適當地處理 `orderBy`、`limit` 或 `skip`。
+ 已修正 OpenCypher 錯誤，此錯誤允許一個請求中包含的參數被另一個同時請求中包含的參數覆寫。
+ 已修正 SPARQL 錯誤，其中在 `VALUES` 子句插入大量值可能導致效能降低。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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 資料庫叢集將在下一個維護時段自動升級至此維護修補程式版本。
## 升級至此版本
Amazon Neptune 1.2.0.2.R3 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 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
```
+ 各種 Gemlin 運算子 (包括 `repeat`、`coalesce`、`store` 和 `aggregate`) 的效能改善和正確性修正。
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中查詢傳回了字串 `"null"`，而不是 Bolt 和 SPARQL-JSON 中的 null 值。
+ 已修正 Gremlin 錯誤，此錯誤導致了附加至 `UnionStep` 的步驟標籤不會傳播至其子周遊的最後一個路徑元素。
+ 已修正 Gremlin 錯誤，此錯誤已導致 `valueMap()` 未在 DFE 引擎的 `by()` 周遊下進行最佳化。
+ 已修正 Grimlin 錯誤，其中作為較長 Gemlin 交易一部分執行的讀取查詢不會鎖定資料列。
+ 已修正稽核日誌錯誤，此錯誤已導致記錄不必要的資訊，以及某些欄位從日誌中遺失。
+ 已修正稽核日誌錯誤，其中未記錄對啟用 IAM 的資料庫叢集發出的 HTTP 請求的 IAM ARN。
+ 已修正查詢快取錯誤，以便限制用於寫入快取的增量記憶體。
+ 已修正查閱快取錯誤，此錯誤涉及在寫入失敗時為查詢快取設定唯讀模式。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 資料庫叢集將在下一個維護時段自動升級至此維護修補程式版本。
## 升級至此版本
Amazon Neptune 1.2.0.2.R2 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 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)，這是一種隨需自動擴展組態，可擴增您的資料庫叢集以滿足處理需求的增加，然後在需求減少時再次縮減。
## 這個引擎版本的改善項目
+ 已改善 Gremlin `order-by` 查詢的效能。在 `NeptuneGraphQueryStep` 結尾具有 `order-by` 的 Gemlin 查詢現在會使用較大的區塊大小以取得更好的效能。這不適用於查詢計劃的內部 (非根) 節點上的 `order-by`。
+ 已改善 Gremlin 更新查詢的效能。在新增邊緣或屬性時，必須鎖住頂點和邊緣以防刪除。此變更會消除交易內的重複鎖定，進而改善效能。
+ 已透過將 `dedup` 向下推送至原生執行層，改善了在 `repeat()` 子查詢內部使用 `dedup()` 的 Gemlin 查詢效能。
+ 已對 IAM 身分驗證錯誤新增了使用者易於了解的錯誤訊息。這些訊息現在會顯示您的 IAM 使用者或角色 ARN、資源 ARN，以及請求的未經授權動作清單。未經授權的動作清單可協助您查看所使用的 IAM 政策中可能遺漏或明確拒絕的內容。
## 此引擎版本中修正的缺陷
+ 已修正 Gremlin 錯誤，其中在升級至 TinkerPop 3.5 之後使用 `PartitionStrategy`，不正確地造成了阻止執行周遊的錯誤，並顯示訊息「PartitionStrategy 不會使用匿名周遊」。
+ 已修正涉及 `WherePredicateStep` 轉換的 Gemlin 正確性錯誤，其中 Neptune 的查詢引擎對使用 `where(P.neq('x'))` 和其變化的查詢產生不正確的結果。
+ 已修正 `MERGE` 子句中在某些情況下導致了建立重複節點和邊緣的 OpenCypher 錯誤。
+ 已修正處理查詢時發生的 SPARQL 錯誤，這些查詢在 `OPTIONAL` 子句內包含 `(NOT) EXISTS`，在某些情況下會遺失查詢結果。
+ 已修正大量載入器錯誤，此錯誤在大量插入負載下造成了效能迴歸。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已將 `enableInterContainerTrafficEncryption` 參數新增至所有 [Neptune ML API](machine-learning-api-reference.md)，您可以使用此參數，在訓練或超參數調校工作中啟用和停用容器間流量加密。
+ 對於無伺服器資料庫叢集，已將最小容量設定變更為 1.0 NCU，並將最低有效的上限設定變更為 2.5 NCU。請參閱 [Neptune Serverless 資料庫叢集中的容量擴展](neptune-serverless-capacity-scaling.md) *(((在發行之前，此變更也需要反映在無伺服器頁面中)))。*
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中更新和傳回查詢並未適當地處理 `orderBy`、`limit` 或 `skip`。
+ 已修正 OpenCypher 錯誤，此錯誤允許一個請求中包含的參數被另一個同時請求中包含的參數覆寫。
+ 已修正 Bolt 交易處理中的 openCypher 錯誤。
+ 已透過返回 Tinkerpop 修正了 DEF 查詢的 Grimlin 正確性問題，這些查詢具有 `limit` 做為非聯集步驟的子周遊。例如，對於像這樣的查詢：
```
g.withSideEffect('Neptune#useDFE', true)
.V()
.as("a")
.select("a")
.by(out()
.limit(1))
```
+ 已修正 Gremlin 錯誤，其中查詢將會失敗，因為它包含了太多的 TinkerPop 步驟，接著並不會將其清除。
+ 已修正 Grimlin 錯誤，其中 `order()` 將不會正確排序字串輸出，因為這些字串輸出中有一些包含空格字元時。
+ 已修正 Gremlin 錯誤，其中當以字串和包含的 `GroupCountStep` 形式提交查詢時，可能發生交易洩漏。
+ 已修正 Gemlin 錯誤，其中在對於不是原生處理的步驟，檢查 Gremlin 查詢狀態端點是否有子周遊中具有述詞的查詢時，將會發生交易洩漏。
+ 已修正 Gremlin 錯誤，其中新增邊緣及其後面跟著 `inV()` 或 `outV()` 的屬性導致了 `InternalFailureException`。
+ 已修正儲存層中的並行問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 資料庫叢集將在下一個維護時段自動升級至此修補程式版本。
## 升級至此版本
Amazon Neptune 1.2.0.1.R3 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已改善涉及常值映射清單上 `UNWIND` 的 OpenCypher 查詢效能。
+ 各種 Gemlin 運算子 (包括 `repeat`、`coalesce`、`store` 和 `aggregate`) 的效能改善和正確性修正。
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中查詢傳回了字串 `"null"`，而不是 Bolt 和 SPARQL-JSON 中的 null 值。
+ 已修正稽核日誌錯誤，此錯誤已導致記錄不必要的資訊，以及某些欄位從日誌中遺失。
+ 已修正查詢快取錯誤，以便限制用於寫入快取的增量記憶體。
+ 已修正查閱快取錯誤，此錯誤涉及在寫入失敗時為查詢快取設定唯讀模式。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 資料庫叢集將在下一個維護時段自動升級至此修補程式版本。
## 升級至此版本
Amazon Neptune 1.2.0.1.R2 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 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 區域，並在一個區域中包含一個主要資料庫叢集，並在其他區域中包含最多五個次要資料庫叢集。
+ 根據資料平面動作，已新增在 Neptune IAM 政策中支援比之前所提供更精細的存取控制。這是一項重大變更，其中以棄用的 `connect` 動作為基礎的現有 IAM 政策必須進行調整，才能使用更精細的資料平面動作。請參閱 [IAM 政策的類型](security-iam-access-manage.md#iam-auth-policy)。
+ 已改善讀取器執行個體可用性。之前，當寫入器執行個體重新啟動時，Neptune 叢集中的所有讀取器執行個體也會自動重新啟動。從引擎 1.2.0.0 版開始，讀取器執行個體會在寫入器重新啟動之後保持作用中，進而改善讀取器可用性。您可以個別重新啟動讀取器執行個體，以取得參數群組變更。請參閱 [在 Amazon Neptune 中重新啟動資料庫執行個體](manage-console-instances-reboot.md)。
+ 已新增 [neptune\$1streams\$1expiry\$1days](parameters.md#parameters-db-cluster-parameters-neptune_streams_expiry_days) 資料庫叢集參數，此參數可讓許您設定串流記錄在刪除之前保留在伺服器上的天數。範圍為 1 至 90，而預設值為 7。
## 這個引擎版本的改善項目
+ 已改善 ByteCode 查詢的 Grimlin 序列化效能。
+ Neptune 現在會使用 DFE 引擎處理文字述詞，以提升效能。
+ Neptune 現在會使用 DFE 引擎處理 Grimlin `limit()` 步驟，包括非終端和子周遊限制。
+ 已變更 Gemlin `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) 函數，此函數會將清單中的字串串連成單一字串。
+ 已更新 [Neptune 受管政策](security-iam-access-managed-policies.md)，以包含資料存取許可，以及新全球資料庫 API 的許可。
## 此引擎版本中修正的缺陷
+ 已修正沒有指定 content-type 的 HTTP 請求將會自動失敗的錯誤。
+ 已修正查詢最佳化工具中阻止在查詢內使用服務呼叫的 SPARQL 錯誤。
+ 已修正 Turtle RDF 剖析器中的 SPARQL 錯誤，其中 Unicode 資料的特定組合導致了失敗。
+ 已修正 SPARQL 錯誤，其中 `GRAPH` 和 `SELECT` 子句的特定組合產生了不正確的查詢結果。
+ 已修正 Grimlin 錯誤，此錯誤對於在聯集步驟中使用任何篩選步驟的查詢造成了正確性問題，如下所示：
```
g.V("1").union(hasLabel("person"), out())
```
+ 已修正 Gremlin 錯誤，其中若沒有 `count()`，`both().simplePath()` 的 `count()` 將會導致傳回的結果實際數量增加一倍。
+ 已修正 OpenCypher 錯誤，其中向啟用 IAM 身分驗證的叢集發出 Bolt 請求時，伺服器產生了錯誤的簽章不符例外狀況。
+ 已修正 OpenCypher 錯誤，其中使用 HTTP 保持連線的查詢，若在失敗的請求後提交，則系統可能會錯誤地關閉它。
+ 已修正在提交傳回常數值的查詢時，可能會導致擲回內部錯誤的 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 ║
╚════╧════════╧════════╧═══════════════════════╧═══════════════════════════════════╧══════╧══════════╧═══════════╧═══════╧═══════════╝
```
下表最後一欄的子查詢時間加起來為 0.36 毫秒 (`.04 + .29 + .01 + .02 = .36`)。當加上該子查詢 (`.36 + .026 = .386`) 的協調時間時，您得到的結果會接近上表最後一欄中所記錄的子查詢時間，即 `0.38` 毫秒。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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`，重新建立任何已與舊版搭配使用的自訂資料庫叢集參數群組。如需詳細資訊，請參閱[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 資料庫叢集](cluster-maintenance.md))。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已將 `enableInterContainerTrafficEncryption` 參數新增至所有 [Neptune ML API](machine-learning-api-reference.md)，您可以使用此參數，在訓練或超參數調校工作中啟用和停用容器間流量加密。
+ 對於無伺服器資料庫叢集，已將最小容量設定變更為 1.0 NCU，並將最低有效的上限設定變更為 2.5 NCU。請參閱 [Neptune Serverless 資料庫叢集中的容量擴展](neptune-serverless-capacity-scaling.md) *(((在發行之前，此變更也需要反映在無伺服器頁面中)))。*
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中更新和傳回查詢並未適當地處理 `orderBy`、`limit` 或 `skip`。
+ 已修正 OpenCypher 錯誤，此錯誤允許一個請求中包含的參數被另一個同時請求中包含的參數覆寫。
+ 已修正 Bolt 交易處理中的 openCypher 錯誤。
+ 已透過返回 Tinkerpop 修正了 DEF 查詢的 Grimlin 正確性問題，這些查詢具有 `limit` 做為非聯集步驟的子周遊。例如，對於像這樣的查詢：
```
g.withSideEffect('Neptune#useDFE', true)
.V()
.as("a")
.select("a")
.by(out()
.limit(1))
```
+ 已修正 Gremlin 錯誤，其中查詢將會失敗，因為它包含了太多的 TinkerPop 步驟，接著並不會將其清除。
+ 已修正 Grimlin 錯誤，其中 `order()` 將不會正確排序字串輸出，因為這些字串輸出中有一些包含空格字元時。
+ 已修正 Gremlin 錯誤，其中當以字串和包含的 `GroupCountStep` 形式提交查詢時，可能發生交易洩漏。
+ 已修正 Gemlin 錯誤，其中在對於不是原生處理的步驟，檢查 Gremlin 查詢狀態端點是否有子周遊中具有述詞的查詢時，將會發生交易洩漏。
+ 已修正 Gremlin 錯誤，其中新增邊緣及其後面跟著 `inV()` 或 `outV()` 的屬性導致了 `InternalFailureException`。
+ 已修正儲存層中的並行問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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.
```
如果遇到此錯誤，請等候待定動作完成，或立即觸發維護時段，讓先前的升級完成。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 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
```
+ 各種 Gemlin 運算子 (包括 `repeat`、`coalesce`、`store` 和 `aggregate`) 的效能改善和正確性修正。
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中查詢傳回了字串 `"null"`，而不是 Bolt 和 SPARQL-JSON 中的 null 值。
+ 己修正 OpenCypher 錯誤，以便在值為清單或映射清單時能夠正確地解譯參數類型。
+ 已修正稽核日誌錯誤，此錯誤已導致記錄不必要的資訊，以及某些欄位從日誌中遺失。
+ 已修正稽核日誌錯誤，其中未記錄對啟用 IAM 的資料庫叢集發出的 HTTP 請求的 IAM ARN。
+ 已修正查詢快取錯誤，以便限制用於寫入快取的增量記憶體。
+ 已修正查閱快取錯誤，此錯誤涉及在寫入失敗時為查詢快取設定唯讀模式。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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.
```
如果遇到此錯誤，請等候待定動作完成，或立即觸發維護時段，讓先前的升級完成。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 指標必須降至零，然後才能開始從 1.2.0.0 之前的版本進行任何升級。如果在嘗試啟動更新時有太多的還原日誌 (200,000 或更多)，則在等待清除還原日誌完成時，升級嘗試可能會逾時。
您可以升級叢集的寫入器執行個體 (此為進行清除的位置)，以加快清除率。在嘗試升級之前執行此操作可能會在您開始之前減少還原日誌的數目。將寫入器的大小增加至 24XL 執行個體類型，可以將清除率提高到每小時超過一百萬筆記錄。
如果 `UndoLogsListSize` CloudWatch 指標非常大，開啟支援案例可協助您探索其他策略，以降低該指標。
最後，1.2.0.0 版中有重大變更，這會影響使用 Bolt 通訊協定搭配 IAM 身分驗證的舊版程式碼。從 1.2.0.0 版開始，Bolt 需要一個資源路徑進行 IAM 簽署。在 Java 中，設定資源路徑可能如下所示：`request.setResourcePath("/openCypher"));`。在其他語言中，`/openCypher` 可以附加到端點 URI。如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已改善 Gremlin `order-by` 查詢的效能。在 `NeptuneGraphQueryStep` 結尾具有 `order-by` 的 Gemlin 查詢現在會使用較大的區塊大小以取得更好的效能。這不適用於查詢計劃的內部 (非根) 節點上的 `order-by`。
+ 已改善 Gremlin 更新查詢的效能。在新增邊緣或屬性時，必須鎖住頂點和邊緣以防刪除。此變更會消除交易內的重複鎖定，進而改善效能。
+ 已透過將 `dedup` 向下推送至原生執行層，改善了在 `repeat()` 子查詢內部使用 `dedup()` 的 Gemlin 查詢效能。
+ 已新增 Gremlin `Neptune#cardinalityEstimates` 查詢提示。設定為 `false` 時，這會停用基數估計。
+ 已對 IAM 身分驗證錯誤新增了使用者易於了解的錯誤訊息。這些訊息現在會顯示您的 IAM 使用者或角色 ARN、資源 ARN，以及請求的未經授權動作清單。未經授權的動作清單可協助您查看所使用的 IAM 政策中可能遺漏或明確拒絕的內容。
## 此引擎版本中修正的缺陷
+ 已修正涉及 `WherePredicateStep` 轉換的 Gemlin 正確性錯誤，其中 Neptune 的查詢引擎對使用 `where(P.neq('x'))` 和其變化的查詢產生不正確的結果。
+ 已修正 Gremlin 錯誤，其中在升級至 TinkerPop 3.5 之後使用 `PartitionStrategy`，不正確地造成了阻止執行周遊的錯誤，並顯示訊息「PartitionStrategy 不會使用匿名周遊」。
+ 已修正與最終聯結的 `joinTime` 和 `Project.ASK` 子群組內的統計資料相關的各種 Gemlin 錯誤。
+ 已修正 `MERGE` 子句中在某些情況下導致了建立重複節點和邊緣的 OpenCypher 錯誤。
+ 已修正交易錯誤，其中即使回復了對應的並行字典插入，工作階段仍可以插入圖形資料並遞交。
+ 已修正大量載入器錯誤，此錯誤在大量插入負載下造成了效能迴歸。
+ 已修正處理查詢時發生的 SPARQL 錯誤，這些查詢在 `OPTIONAL` 子句內包含 `(NOT) EXISTS`，在某些情況下會遺失查詢結果。
+ 已修正驅動程式在下列情況下似乎當機的錯誤：評估開始之前，由於逾時而請求遭到取消。如果在請求佇列中的項目發生逾時時，伺服器上的所有查詢處理執行緒都已使用，則可能會進入此狀態。因為來自請求佇列的逾時並未立即傳送訊息，所以在用戶端看來回應仍處於待定狀態。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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.
```
如果遇到此錯誤，請等候待定動作完成，或立即觸發維護時段，讓先前的升級完成。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎 1.1.1.0 版 (2022 年 4 月 19 日)
截至 2022 年 4 月 19 日，引擎 1.1.1.0 版已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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)現在已普遍適用於生產用途。
**警告**
對於使用 OpenCypher 搭配 IAM 身分驗證的程式碼，此版本中有一項重大變更。在 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))，以及將 `datetime()` 函數新增至 Grimlin 語言。
**警告**
在 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())`。
+ 已新增對 [AWS 全域條件金鑰](iam-data-condition-keys.md#iam-data-global-condition-keys)的支援，您可以在 [IAM 資料存取政策](iam-admin-policies.md)中使用這些金鑰，控制對 Neptune 資料庫叢集中儲存之資料的存取。
+ [Neptune DFE 查詢引擎](neptune-dfe-engine.md)現在通常可用於與 OpenCypher 查詢語言搭配使用的生產，但尚未用於 Gremlin 和 SPARQL 查詢。現在，您可以使用它自己的 [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 處理可變長度路徑的雙向和深度限制。
+ 已完成 DFE 引擎中對 Gremlin `within` 和 `without` 述詞的支援，包括它們與其他述詞運算子合併的案例。例如：
```
g.V().has('age', within(12, 15, 18).or(gt(30)))
```
+ 當範圍為全域 (亦即，不是 `order(local)`) 時，以及未使用 `by()` 調幅器時，已在 DFE 引擎中延伸對 Gemlin `order` 步驟的支援。例如，此查詢現在將具有 DFE 支援：
```
g.V().values("age").order()
```
+ 已將 `isLastOp` 欄位新增至 [Neptune 串流變更日誌](streams-using-api-reponse.md)回應格式，以指出記錄是其交易中的最後一個操作。
+ 已大幅改善稽核記錄的效能，並在啟用稽核記錄時減少了延遲。
+ 已將 Gremlin WebSocket 位元碼和 HTTP 查詢轉換為稽核日誌中使用者可讀取的格式。查詢現在可以直接從要在 Neptune 筆記本和其他位置執行的稽核日誌複製。請注意，這項對目前稽核日誌格式的變更會構成重大變更。
## 此引擎版本中修正的缺陷
+ 已修正罕見的 Gemlin 錯誤，其中使用巢狀 `filter()` 和 `count()` 步驟組合時未傳回任何結果，例如在以下查詢中：
```
g.V("1").filter(out("knows")
.filter(in("knows")
.hasId("notExists"))
.count())
```
+ 已修正 Gremlin 錯誤，其中在使用 `to()` 或 `from()` 周遊中的彙總步驟中儲存的頂點，搭配 `addE` 步驟時傳回了錯誤。此類查詢範例如下：
```
g.V("id").aggregate("v").out().addE().to(select("v").unfold()))
```
+ 已修正使用 DFE 引擎時，`not` 步驟在邊緣情況下失敗的錯誤。例如：
```
g.V().not(V())
```
+ 已修正 Gremlin 錯誤，其中 `sideEffect` 值無法在 `to()` 和 `from()` 周遊內使用。
+ 已修正偶爾導致快速重設以觸發執行個體容錯移轉的錯誤。
+ 已修正大量載入器錯誤，其中失敗的交易在開始下一個載入工作之前不會關閉。
+ 已修正大量載入器錯誤，其中記憶體不足的情況可能會導致系統當機。
+ 已新增重試，來修正大量載入器錯誤，其中載入器未等待足夠長的時間，讓 IAM 憑證在容錯移轉後變成可用。
+ 已修正未針對非查詢端點 (例如 `status` 端點) 適當清除內部憑證快取的錯誤。
+ 已修正串流錯誤，以確保串流遞交序號正確排序。
+ 已修正在啟用 IAM 的叢集上，長時間執行連線不到十天就終止的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.1.1.0.R7 (2023 年 1 月 23 日)
截至 2023 年 1 月 23 日，引擎版本 1.1.1.0.R7 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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
```
+ 各種 Gemlin 運算子 (包括 `repeat`、`coalesce`、`store` 和 `aggregate`) 的效能改善和正確性修正。
## 此引擎版本中修正的缺陷
+ 已修正 OpenCypher 錯誤，其中使用 HTTP 保持連線的請求，若在失敗的請求後提交，則系統可能會錯誤地關閉它。
+ 已修正 OpenCypher 錯誤，其中參數類型並不總是正確解譯為清單或對應清單。
+ 已修正 OpenCypher 錯誤，其中查詢傳回了字串 `"null"`，而不是 Bolt 和 SPARQL-JSON 中的 null 值。
+ 已修正查詢逾時失敗和記憶體不足錯誤的 OpenCypher 錯誤代碼和錯誤訊息。
+ 已修正 Gremlin 錯誤，此錯誤已導致 `valueMap()` 未在 DFE 引擎的 `by()` 周遊下進行最佳化。
+ 已修正死鎖偵測器邏輯偶爾會使引擎沒有回應的問題。
+ 已修正稽核日誌錯誤，此錯誤已導致記錄不必要的資訊，以及某些欄位從日誌中遺失。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.1.1.0.R6 (2022 年 9 月 23 日)
截至 2022 年 9 月 23 日，引擎版本 1.1.1.0.R6 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
**注意**
對於使用 OpenCypher 搭配 IAM 身分驗證的程式碼，此版本中有一項重大變更。到目前為止，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` 的 Gemlin 查詢現在會使用較大的區塊大小以取得更好的效能。這不適用於查詢計劃的內部 (非根) 節點上的 `order-by`。
+ 已改善 Gremlin 更新查詢的效能。在新增邊緣或屬性時，必須鎖住頂點和邊緣以防刪除。此變更會消除交易內的重複鎖定，進而改善效能。
## 此引擎版本中修正的缺陷
+ 已修正 `MERGE` 子句中在某些情況下導致了建立重複節點和邊緣的 OpenCypher 錯誤。
+ 已修正處理 SPARQL 查詢時發生的錯誤，這些查詢在 `OPTIONAL` 子句內包含 `(NOT) EXISTS`，在某些情況下將會遺失查詢結果。
+ 已修正在進行大量載入時延遲伺服器重新啟動的錯誤。
+ 已修正錯誤，其中 OpenCypher 可變長度模式雙向周遊搭配關係屬性上的篩選條件會導致錯誤。這類可變長度模式的範例為 `(n)-[r*1..2]->(m)`。
+ 已修正與快取資料如何傳回用戶端相關的錯誤，在某些情況下這導致了非預期的長延遲。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.1.1.0.R5 (2022 年 7 月 21 日)
截至 2022 年 7 月 21 日，引擎版本 1.1.1.0.R5 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
**注意**
對於使用 OpenCypher 搭配 IAM 身分驗證的程式碼，此版本中有一項重大變更。到目前為止，IAM 簽章中的主機字串包含通訊協定，例如 `bolt://`，如下所示：
```
"Host":"bolt://(host URL):(port)"
```
從引擎版本 `1.1.1.0` 開始，必須省略通訊協定：
```
"Host":"(host URL):(port)"
```
如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已進行改善，以支援死鎖檢測。
## 此引擎版本中修正的缺陷
+ 已修正在特定情況下阻止正常關閉資料庫叢集的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.1.1.0.R4 (2022 年 6 月 23 日)
截至 2022 年 6 月 23 日，引擎版本 1.1.1.0.R4 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
**注意**
對於使用 OpenCypher 搭配 IAM 身分驗證的程式碼，此版本中有一項重大變更。到目前為止，IAM 簽章中的主機字串包含通訊協定，例如 `bolt://`，如下所示：
```
"Host":"bolt://(host URL):(port)"
```
從引擎版本 `1.1.1.0` 開始，必須省略通訊協定：
```
"Host":"(host URL):(port)"
```
如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已更新 `x2g` 執行個體類型的執行個體組態。
+ 已改善頂點掉落的效能。
## 此引擎版本中修正的缺陷
+ 已修正 Gemlin 錯誤，其中解決方案無法針對多次呼叫的查詢維持穩定順序，也無法針對特定種類的 ASK 聯結在多個讀取器之間維持穩定順序。
+ 此外，已縮小之前版本中的變更範圍，此變更導致 Gremlin 中特定種類的 ASK 聯結的效能迴歸。
+ 已修正 `union()` 步驟中在下列情況發生的 Gremlin 錯誤：對子周遊內的頂點有邊緣輸入和周遊。
+ 已修正 Gremlin 設定檔錯誤，其中報告了一些步驟未最佳化，但實際上它們已最佳化。
+ 已修正 SPARQL 錯誤，其中 `FILTER` 運算式內使用與 `UNION` 子句構成巢狀的變數獲指派無效的範圍資訊。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.1.1.0.R3 (2022 年 6 月 7 日)
截至 2022 年 6 月 7 日，引擎版本 1.1.1.0.R3 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
**注意**
對於使用 OpenCypher 搭配 IAM 身分驗證的程式碼，此版本中有一項重大變更。到目前為止，IAM 簽章中的主機字串包含通訊協定，例如 `bolt://`，如下所示：
```
"Host":"bolt://(host URL):(port)"
```
從引擎版本 `1.1.1.0` 開始，必須省略通訊協定：
```
"Host":"(host URL):(port)"
```
如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 這個引擎版本的改善項目
+ 已新增對 Graviton2 提供的 `x2g` 執行個體類型的支援，並針對記憶體密集型工作負載進行最佳化。這些最初僅在四個 中可用 AWS 區域：
+ 美國東部 (維吉尼亞北部) (`us-east-1`)
+ 美國東部 (俄亥俄) (`us-east-2`)
+ 美國西部 (奧勒岡) (`us-west-2`)
+ 歐洲 (愛爾蘭) (`eu-west-1`)
如需詳細資訊，請參閱 [Neptune 定價頁面](https://aws.amazon.com/neptune/pricing/)。
+ 已改善 Gemlin 步驟的效能，這些步驟涉及多個邊緣或頂點周遊、屬性查詢或標籤查詢。
## 此引擎版本中修正的缺陷
+ 已修正在子周遊內處理 `otherV()` 步驟時發生的 Gremlin 錯誤。
+ 已修正 `union` 僅具有篩選步驟做為子項的查詢中的 Gremlin 錯誤。例如：
```
g.V().union(has("name"), out("knows")).out()
```
+ 已修正 SPARQL 錯誤，其中 `FILTER` 運算式內使用與 `UNION` 子句構成巢狀的變數獲指派無效的範圍資訊。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 維護版本，版本 1.1.1.0.R2 (2022 年 5 月 16 日)
截至 2022 年 5 月 16 日，引擎版本 1.1.1.0.R2 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
**注意**
對於使用 OpenCypher 搭配 IAM 身分驗證的程式碼，此版本中有一項重大變更。到目前為止，IAM 簽章中的主機字串包含通訊協定，例如 `bolt://`，如下所示：
```
"Host":"bolt://(host URL):(port)"
```
從引擎版本 `1.1.1.0` 開始，必須省略通訊協定：
```
"Host":"(host URL):(port)"
```
如需範例，請參閱 [使用 Bolt 通訊協定](access-graph-opencypher-bolt.md)。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎 1.1.0.0 版 (2021 年 11 月 19 日)
截至 2021 年 11 月 19 日，引擎 1.1.0.0 版已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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)。如果您要在資料庫叢集中使用 `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` 資料庫執行個體。與目前同級 x86 型執行個體相比，對於各種工作負載，Graviton2 型執行個體提供明顯更優異的價格/效能。應用程式可在這些新的執行個體類型上正常運作，而且升級至這些執行個體類型時不需要移植應用程式程式碼。
如需定價和區域可用性的詳細資訊，請參閱 [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 串流做了改善：
+ 已將 `commitTimestamp` 欄位新增至 `records` 物件的 [Neptune 串流變更日誌回應格式](streams-using-api-reponse.md)，為變更日誌串流中的每筆記錄提供時間戳記。
+ 已將 `LATEST` 值新增至 `iteratorType` 參數，可讓您從串流擷取最後一個有效的 eventId。請參閱 [呼叫串流 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 延伸 `CREATE` 和 `UPDATE` 子句與 `RETURN` 搭配使用的支援。
+ 已在 DFE 引擎中新增了對 Gremlin `limit`、`range` 和 `skip` 步驟的支援。
+ 已改善在既未請求 `explain` 也未請求 `profile` 時 DFE 引擎中的查詢執行。
+ 已改善 DFE 引擎中針對 `value` 運算式的查詢執行。
+ 已改善一些鏈結的 Gemlin 條件式插入模式，以避免並行修改例外狀況，並允許鏈結查詢模式，如下所示：
+ 依 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 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.1.0.0 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.11`
+ *SPARQL 版本：*`1.1`
## 引擎 1.1.0.0 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
您不會自動升級至此版本。
## 升級至此版本
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
您可以指定 `--no-apply-immediately`，而不是 `--apply-immediately`。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。
如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：
```
--db-cluster-parameter-group-name (name of the custom DB cluster parameter group)
```
同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：
```
--db-instance-parameter-group-name (name of the custom instance parameter group)
```
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 維護版本，版本 1.1.0.0.R3 (2022 年 12 月 23 日)
截至 2022 年 12 月 23 日，引擎版本 1.1.0.0.R3 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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`
## 這個引擎版本的改善項目
+ 各種 Gemlin 運算子 (包括 `repeat`、`coalesce`、`store` 和 `aggregate`) 的效能改善和正確性修正。
## 此引擎版本中修正的缺陷
+ 已修正 CPU 峰值問題。
+ 已修正 OpenCypher 錯誤，其中查詢傳回了字串 `"null"`，而不是 Bolt 和 SPARQL-JSON 中的 null 值。
+ 已修正稽核日誌錯誤，此錯誤已導致記錄不必要的資訊，以及某些欄位從日誌中遺失。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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)。如果您要在資料庫叢集中使用 `R4` 執行個體，則在升級至此版本之前，必須手動將其取代為不同的執行個體類型。如果您的寫入器執行個體是 `R4`，請遵循[這些指示](best-practices-general-basic.md#best-practices-resize-instance)進行移動。
## 升級至此版本
Amazon Neptune 1.1.0.0.R3 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 維護版本，版本 1.1.0.0.R2 (2022 年 5 月 16 日)
截至 2022 年 5 月 16 日，引擎版本 1.1.0.0.R2 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
**重要**
**從 `1.1.0.0` 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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.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` 以前的任何版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。**
在升級開始時，Neptune 會產生一個快照，其名稱由 `preupgrade` 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。
當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後，您就可以繼續寫入工作負載。
此過程會產生下列事件：
每個叢集事件訊息：
`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)。如果您要在資料庫叢集中使用 `R4` 執行個體，則在升級至此版本之前，必須手動將其取代為不同的執行個體類型。如果您的寫入器執行個體是 `R4`，請遵循[這些指示](best-practices-general-basic.md#best-practices-resize-instance)進行移動。
## 升級至此版本
Amazon Neptune 1.1.0.0.R2 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 中新增了日期/時間支援。
+ 已增加對 `List` 和 `Map` 可存取 Neptune openCypher 中元素的支援。
## 這個引擎版本的改善項目
+ 已使 Neptune OpenCypher 端點名稱需區分大小寫。
+ 已改善 openCypher Explain。
+ 已改善以 `iterate()` 和 `profile()` 步驟終止的 Gremlin 單一 upsert 查詢模式。
+ 已改善 Gremlin `keys()` 和 `property()` 函數中的效能。
+ 當 Gremlin `dedup()` 步驟與全域範圍搭配使用時，該步驟是在 DFE 中執行。
+ DFE 引擎啟用時，下列 Gremlin `HAS` 述詞是在 DFE 引擎中執行：
+ `EQ`
+ `NEQ`
+ `LT`
+ `LTE`
+ `GT`
+ `GTE`
+ `BETWEEN`
+ `INSIDE`
+ `OUTSIDE`
+ `WITHIN`
+ `AND (connectives)`
+ `OR (connectives)`
+ 已改善 LIMIT 查詢效能。
+ 已改善 openCypher 一般彙總查詢的效能。
## 此引擎版本中修正的缺陷
+ 已修正允許邊緣連線到另一個邊緣的 Gremlin 錯誤。
+ 已修正導致選擇次佳聯結策略的 Gremlin 錯誤。
+ 已修正當存在 100 個以上屬性時，導致了節點和關係序列化停滯的 Gemlin 錯誤。
+ 已修正為具有大型圖形模式的查詢進行查詢執行規畫時速度變慢的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.5.1 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.11`
+ *SPARQL 版本：*`1.1`
## 引擎 1.0.5.1 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
您不會自動升級至此版本。
## 升級至此版本
Amazon Neptune 1.0.5.1 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 維護版本，版本 1.0.5.1.R4 (2022 年 5 月 16 日)
截至 2022 年 5 月 16 日，引擎版本 1.0.5.1.R4 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.5.1.R3 (2022 年 1 月 13 日)
截至 2022 年 1 月 13 日，引擎版本 1.0.5.1.R3 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的缺陷
+ 已修正查詢無法取得其需要的所有資源時，可能導致資源洩漏的錯誤。
+ 已修正查詢執行期間由未宣告的記憶體配置所造成的少量記憶體洩漏。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.5.1.R2 (2021 年 10 月 26 日)
截至 2021 年 10 月 26 日，引擎版本 1.0.5.1.R2 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的缺陷
+ 已修正下列錯誤：在可重複讀取隔離下建立舊版圖形元素的同時發生暫時性錯誤，導致了伺服器重新啟動。Neptune 現在反而會傳回錯誤，以便用戶端可以重試。
+ 已修正在單一基數更新期間發生暫時性錯誤時，導致了伺服器重新啟動的錯誤。Neptune 現在反而會傳回錯誤，以便用戶端可以重試。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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)，而且 Neptune ML 不再處於實驗室模式。
+ 已在實驗室模式下新增了對 [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)。
也支援對 [Bolt 通訊協定](https://neo4j.com/docs/bolt/current/bolt/)的支援，Neptune 用戶端會將此通訊協定用於 OpenCypher 查詢。請參閱 [使用 Bolt 通訊協定，對 Neptune 進行 openCypher 查詢](access-graph-opencypher-bolt.md)。
對 OpenCypher 的支援現在會自動啟用，但這取決於目前僅能在[實驗室模式](features-lab-mode.md)中使用的 [Neptune DFE 引擎](neptune-dfe-engine.md)。`neptune_lab_mode` 資料庫叢集參數中的預設 `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`，這表示 DEF 引擎現在預設為啟用，但僅用於存在 `true` 查詢提示且其設定為 `useDFE` 的查詢。
+ 已新增 Amazon CloudWatch 指標 `StatsNumStatementsScanned`，用於監控 Neptune DFE 引擎統計資料的計算。請參閱 [使用 `StatsNumStatementsScanned` CloudWatch 指標監控統計資料計算](neptune-dfe-statistics.md#neptune-dfe-statistics-monitoring)。
## 這個引擎版本的改善項目
+ 已新增對 Apache 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()
```
+ Neptune DFE 替代查詢引擎現在支援 [SPARQL `joinOrder` 查詢提示](sparql-query-hints-joinOrder.md)。
+ [Neptune 狀態 API](access-graph-status.md) 的輸出已擴充並重組，讓您更清晰地了解資料庫叢集設定和功能。
新輸出具有最上層 `features` 物件，其中包含有關資料庫叢集功能的狀態資訊，也具有最上層 `settings` 物件，其中包含設定資訊。若要檢閱新格式，請參閱 [執行個體狀態命令的範例輸出](access-graph-status.md#access-graph-status-sample-output)。
+ 已改善在下列情況處理串流變更日誌的方式：使用伺服器上的最後一個事件 ID 請求 `AFTER_SEQUENCE_NUMBER` 串流，但該事件 ID 已過期。如果請求的事件 ID 是伺服器上最近清除的事件 ID，則伺服器不再擲回過期的事件 ID 錯誤。
## 此引擎版本中修正的缺陷
+ 已修正與數值排序相關的 Gremlin 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.5.0 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.11`
+ *SPARQL 版本：*`1.1`
## 引擎 1.0.5.0 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
您不會自動升級至此版本。
## 升級至此版本
Amazon Neptune 1.0.5.0 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 維護版本，版本 1.0.5.0.R5 (2022 年 5 月 16 日)
從 2022 年 5 月 16 日起，引擎版本 1.0.5.0.R5 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.5.0.R3 (2021 年 9 月 15 日)
截至 2021 年 9 月 15 日，引擎版本 1.0.5.0.R3 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的缺陷
+ 已修正在下列任一情況下，導致引擎無回應的錯誤：
+ 大量載入與自動統計資料計算同時發生。
+ 統計資料計算是在已有一個統計資料計算發生的同時手動請求的。
+ 已修正死鎖偵測和鎖定擷取中可能導致引擎當機的錯誤。
+ 已修正 Gemlin 錯誤，其中引擎在 Gremlin 推論查詢中遇到來自遠端 ML 端點的未知資料時會擲回錯誤。
+ 己修正 ML 模型管理 API 中與模型轉換工作和執行個體建議相關的數個錯誤。
+ 已修正在產生節點和邊緣 ID 時可能會導致引擎當機的錯誤。
+ 已修正為具有大型圖形模式的查詢產生查詢計畫時速度變慢的錯誤。
+ 已修正 OpenCypher 錯誤，此錯誤可能導致查詢在擷取具有 100 個以上屬性的節點時停滯。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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)在引擎對複本重新啟動時仍然存在。複本重新啟動現在會清除查閱快取。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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)在引擎對複本重新啟動時仍然存在。複本重新啟動現在會清除查閱快取。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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，或 Grimlin ID、金鑰和字串值。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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" ` 的查詢會傳回 JSON 輸出而非 CSV 輸出。
**解決方法：**
如果您移除標頭中 `Accept` 子句中的空格，引擎會以正確的請求格式傳回輸出。換句話說，不是 ` -H "Accept: text/csv; q=1.0, */*; q=0.1" `，而是使用：
```
-H "Accept: text/csv;q=1.0,*/*;q=0.1"
```
## 此引擎版本中修正的缺陷
+ 已修正快速重設之後清除複本上查閱快取的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 1.0.4.2.R3 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.10`
+ *SPARQL 版本：*`1.1`
## 引擎版本 1.0.4.2.R3 的升級途徑
除非您的資料庫叢集使用一或多個 `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" ` 的查詢會傳回 JSON 輸出而非 CSV 輸出。
**解決方法：**
如果您移除標頭中 `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)。
+ 已新增一個新的實驗室模式參數，該參數僅可讓實驗 DFE 引擎使用查詢提示 `useDFE` 根據每個查詢進行調用。
## 這個引擎版本的改善項目
+ 已新增對 TinkerPop 3.4.10 的支援。
+ 已新增在傳送 Gremlin 指令碼請求時使用 `withStrategies( )` 組態步驟的支援。具體而言，`SubgraphStrategy`、`PartitionStrategy`、`ReadOnlyStrategy`、`EdgeLabelVerificationStrategy` 和 `ReservedKeysVerificationStrategy` 全都受到支援。
+ 已新增對查詢中間的 `V()` 周遊的最佳化。以前，這樣的周遊未在 Neptune 中進行最佳化。
+ 已新增對 [RFC 2141 URNs](https://tools.ietf.org/html/rfc2141) 用作 `baseUri` 和 `namedGraphUri` 參數進行大量載入的支援。
## 此引擎版本中修正的缺陷
+ 已修正剖析器中將不正確的查詢視為有效的 Gremlin 錯誤。
+ 已修正 Gremlin 錯誤，其中使用 `cap().unfold()` 將 `aggregate()` 副作用展開至 `valueMap()` 會引發例外狀況。
+ 已修正 Gremlin 錯誤，其中在 `addV()` 後面的一些 `property()` 步驟會由於發生「無法轉換為字串」錯誤而失敗。
+ 已修正 Gremlin 錯誤，以防止某些條件式插入模式引發並行修改例外狀況。
+ 已修正 Gimlin 錯誤，以便查詢請求逾時現在無法超過工作階段逾時。
+ 已修正 SPARQL 錯誤，其中當遠端伺服器無法使用時，使用 LOAD 或 UNLOAD 的更新可能會失敗，並出現 HTTP 代碼 500 而非 HTTP 代碼 400。
+ 已修正錯誤，其中當使用大於 32 位元帶正負號整數限制 (2,147,483,647) 的 `commitNum` 或 `opNum` 值時，串流 API 呼叫失敗。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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。不過，該版本中的一個錯誤已允許 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，這會影響您與 Girmlin 主控台、Gremlin 驅動程式、Gremlin Python、.NET、nodeJs、REST API 的連線，同時也會影響負載平衡器連線。如果您到目前為止一直針對任何或全部這些連線使用 HTTP 或舊版 TLS 版本，則必須在將您的系統更新至最新修補程式之前，更新相關的用戶端和驅動程式，並將您的程式碼變更為僅使用 HTTPS。
## 這個引擎版本的新功能
+ 已引進 Neptune ML 功能，為 Amazon Neptune 帶來強大的機器學習功能。請參閱 [用於圖形上機器學習的 Amazon Neptune ML](machine-learning.md)。
+ 已新增自訂 SPARQL `UNLOAD` 操作，用於移除從遠端來源擷取的資料。請參閱 [SPARQL UPDATE UNLOAD](sparql-api-reference-unload.md)。
## 這個引擎版本的改善項目
+ 已最佳化一些 Gemlin 條件式插入模式，以避免並行修改例外狀況。
## 此引擎版本中修正的缺陷
+ 已修正可能會導致使用 `as()` 步驟的特定查詢模式遺失結果的 Gemlin 錯誤。
+ 已修正在另一個步驟 (例如 `union()`) 內以巢狀方式使用 `project()` 步驟時可能會導致錯誤的 Gemlin 錯誤。
+ 已修正 `project()` 步驟中的 Gremlin 錯誤。
+ 已修正字串型周遊中 `none()` 步驟無法運作的 Gremlin 錯誤。
+ 已修正字串型周遊中的 Gremlin 錯誤，其中不支援空對應做為 `inject()` 步驟的論點。
+ 已修正 DFE 引擎中字串型周遊執行中的 Gremlin 錯誤，其中終端方法 (例如 `toList()`) 無法正常運作。
+ 已修正在字串查詢中使用 `iterate()` 步驟時無法關閉交易的 Gemlin 錯誤。
+ 已修正在某些情況下可能導致使用 `is(P.gte(0))` 模式的查詢擲回例外狀況的 Gemlin 錯誤。
+ 已修正在某些情況下可能導致使用 `order().by(T.id)` 模式的查詢擲回例外狀況的 Gemlin 錯誤。
+ 已修正在某些情況下可能導致使用 `addV().aggregate()` 模式的查詢提供不正確結果的 Gemlin 錯誤。
+ 已修正在某些情況下可能導致使用 `path()` 步驟 (後面跟著 `project()` 步驟模式) 的查詢擲回例外狀況的 Gemlin 錯誤。
+ 已修正 SPARQL 錯誤，其中 `SUBSTR` 函數發出錯誤信號，而不是傳回空字串。
+ 已修正 DFE 引擎中的錯誤，此錯誤可能導致非封鎖查詢計畫中的聯結操作，在未繫結的變數存在時產生不正確的結果。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.4.1.R1.1 (2021 年 3 月 22 日)
截至 2021 年 3 月 22 日，引擎版本 1.0.4.1.R1.1 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的缺陷
+ 已停用對可以新增或附加至現有標籤和屬性的 Gemlin 條件式插入模式進行最佳化。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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) 中的錯誤，該錯誤允許使用 `HTTP` 或更舊版本的 TLS，而不是 `HTTPS` 和 TLS 1.2 連線到 Neptune。
**重要**
**與 Neptune 的所有連線都必須使用 SSL/TLS，可能是重大變更。**它會影響您與 Girmlin 主控台、Gremlin 驅動程式、Gremlin Python、.NET、nodeJs、REST API 的連線，同時也會影響負載平衡器連線。如果您到目前為止一直針對任何或全部這些連線使用 HTTP 或舊版 TLS 版本，則必須在安裝此修補程式之前更新相關的用戶端和驅動程式，並將您的程式碼變更為僅使用 HTTPS。
+ 已修正在某些情況下，當 `ConcurrentModificationException` 發生時 `InternalFailureException` 被設定為回應代碼的 Girmlin 錯誤。
+ 已修正在某些情況下更新邊緣或頂點可能導致暫時性 `InternalFailureException` 的 Gemlin 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎更新，版本 1.0.4.1.R2.1，於 2021 年 3 月 11 日發行。
截至 2021 年 3 月 11 日，引擎版本 1.0.4.1.R2.1 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的缺陷
+ 已停用對可以新增或附加至現有標籤和屬性的 Gemlin 條件式插入模式進行最佳化。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 現在需要使用 Secure Sockets Layer (SSL) 搭配 TLSv1.2 通訊協定，以便在所有區域中使用這些強式密碼套件進行與 Neptune 的所有連線：
+ `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 時，您必須使用 HTTPS 而非 HTTP。
因為在任何地方都不再支援使用 HTTP 或 TLS 1.1 的用戶端連線，所以在升級至此引擎版本之前，請確定您的用戶端和程式碼已更新為使用 TLS 1.2 和 HTTPS。
**重要**
**與 Neptune 的所有連線都必須使用 SSL/TLS，可能是重大變更。**它會影響您與 Girmlin 主控台、Gremlin 驅動程式、Gremlin Python、.NET、nodeJs、REST API 的連線，同時也會影響負載平衡器連線。如果您一直在使用 HTTP 進行任何或所有這些連線，則現在必須更新相關的用戶端和驅動程式，並變更您的程式碼以使用 HTTPS，否則您的連線將失敗。
此版本中的一個錯誤已允許 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()` 步驟的效能。
+ 已在 Explain 和設定檔報告中新增有關 `BindOp` 和 `MultiplexerOp` 的詳細資訊。
+ 已新增資料預先提，以在有快取遺漏時改善效能。
+ 已在大量載入器的 `parserConfiguration` 參數中新增 `allowEmptyStrings` 設定，這允許在 CSV 載入中將空字串視為有效屬性值 (請參閱 [Neptune 載入器請求參數](load-api-reference-load.md#load-api-reference-load-parameters))。
+ 載入器現在允許在多值 CSV 資料行中使用逸出分號。
## 此引擎版本中修正的缺陷
+ 已修正與 `both()` 步驟相關的潛在 Gremlin 記憶體洩漏問題。
+ 已修正以下錯誤：由於未正確處理以 '/' 結尾的端點，遺失了請求指標。
+ 已修正在實驗室模式下啟用 DFE 引擎時，導致複本落後並在大量載入下重新啟動的錯誤。
+ 已修正當大量載入由於記憶體不足的情況而失敗時，無法回報正確錯誤訊息的錯誤。
+ 已修正 SPARQL 錯誤，其中字元編碼置於 SPARQL 查詢回應中的 Content-Encoding 標頭中。現在 `charset` 改為置於 Content-Type 標頭中，這可讓 HTTP 用戶端辨識正在自動使用的字元集。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.4.0 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.8`
+ *SPARQL 版本：*`1.1`
## 引擎 1.0.4.0 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
您不會自動升級至此版本。
## 升級至此版本
Amazon Neptune 1.0.4.0 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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) 中的錯誤，該錯誤允許使用 `HTTP` 或更舊版本的 TLS，而不是 `HTTPS` 和 TLS 1.2 連線到 Neptune。
**重要**
**與 Neptune 的所有連線都必須使用 SSL/TLS，可能是重大變更。**它會影響您與 Girmlin 主控台、Gremlin 驅動程式、Gremlin Python、.NET、nodeJs、REST API 的連線，同時也會影響負載平衡器連線。如果您到目前為止一直針對任何或全部這些連線使用 HTTP 或舊版 TLS 版本，則必須在安裝此修補程式之前更新相關的用戶端和驅動程式，並將您的程式碼變更為僅使用 HTTPS。
+ 已修正 CSV 大量載入中涉及標籤以 `#` 結尾的錯誤。
+ 已修正在某些情況下，當 `ConcurrentModificationException` 發生時 `InternalFailureException` 被設定為回應代碼的 Girmlin 錯誤。
+ 已修正在某些情況下更新邊緣或頂點可能導致暫時性 `InternalFailureException` 的 Gemlin 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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)。
## 這個引擎版本的改善項目
+ 您現在可以將批次請求的大小提供給 ElasticSearch，以在 Gemlin 中進行全文檢索搜尋。
+ 已改善 SPARQL GROUP BY 的記憶體使用量。
+ 新增了一個新的 Gemlin 查詢最佳化工具來刪改某些未限制的篩選條件。
+ 已將使用 IAM 驗證的 WebSocket 連線可以保持開啟狀態的時間上限從 36 小時增加到 10 天。
## 此引擎版本中修正的缺陷
+ 已修正下列錯誤：如果您在 POST 請求中傳送了未編碼的 URL 參數，Neptune 會傳回 HTTP 狀態碼 500 和 `InternalServerErrorException`。現在，Neptune 會傳回 HTTP 狀態碼 400 和 `BadRequestException`，並顯示訊息：`Failure to process the POST request parameters`。
+ 已修正未正確報告 WebSocket 連線失敗的 Gremlin 錯誤。
+ 已修正涉及 sideEffects 消失的 Gremlin 錯誤。
+ 已修正未適當支援全文檢索搜尋 `batchsize` 參數的 Girmlin 錯誤。
+ 已修正 Gremlin 錯誤，為 `bothE` 上的每個方向單獨處理 `toV` 和 `fromV`。
+ 已修正 `hasLabel` 步驟中涉及 `Edge pathType` 的 Gremlin 錯誤。
+ 已修正使用靜態繫結來重新排序聯結無法正常運作的 SPARQL 錯誤。
+ 已修正 SPARQL UPDATE LOAD 錯誤，其中未正確報告無法使用的 Amazon S3 儲存貯體。
+ 已修正 SPARQL 錯誤，其中未正確報告子查詢中的 SERVICE 節點發生問題。
+ 已修正 SPARQL 錯誤，其中包含巢狀 FILTER EXISTS 或 FILTER NOT EXISTS 條件的查詢未適當地進行評估。
+ 已修正 SPARQL 錯誤，以在透過產生查詢呼叫 SPARQL 服務端點時，正確處理重複產生的繫結。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.3.0 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.3`
+ *SPARQL 版本：*`1.1`
## 引擎 1.0.3.0 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
如果您的叢集已將其 `AutoMinorVersionUpgrade` 參數設為 `True`，則在維護時段期間，您的叢集會在此發行日期後兩至三週自動升級至此引擎版本。
## 升級至此版本
Amazon Neptune 1.0.3.0 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.3.0.R3 (2021 年 2 月 19 日)
截至 2021 年 2 月 19 日，引擎版本 1.0.3.0.R3 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的缺陷
+ 已修正 CSV 大量載入中涉及標籤以 `#` 結尾的錯誤。
+ 已修正可能會導致使用 `as()` 步驟的特定查詢模式遺失結果的 Gemlin 錯誤。
+ 已修正在另一個步驟 (例如 `union()`) 內以巢狀方式使用 `project()` 步驟時可能會導致錯誤的 Gemlin 錯誤。
+ 已修正當使用類似 `toList()` 的終端方法時，於實驗 DFE 引擎中進行字串周遊執行所發生的 Gremlin 錯誤。
+ 已修正在字串查詢中使用 `iterate()` 步驟時無法關閉交易的 Gemlin 錯誤。
+ 已修正在特定情況下可能導致使用 `is(P.gte(0))` 模式的查詢擲回例外狀況的 Gemlin 錯誤。
+ 已修正在某些情況下，當 `ConcurrentModificationException` 發生時 `InternalFailureException` 被設定為回應代碼的 Girmlin 錯誤。
+ 已修正在某些情況下更新邊緣或頂點可能導致暫時性 `InternalFailureException` 的 Gemlin 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.3.0.R2 (2020 年 10 月 12 日)
截至 2020 年 10 月 12 日，引擎版本 1.0.3.0.R2 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 這個引擎版本的改善項目
+ 已改善 Gremlin `properties()` 步驟的效能。
+ 已在 Explain 和設定檔報告中新增有關 `BindOp` 和 `MultiplexerOp` 的詳細資訊。
+ 對於 SPARQL 查詢回應，已將 `charset` 新增至 Content-Type 標頭，讓 HTTP 用戶端可以辨識自動使用的字元集。
## 此引擎版本中修正的缺陷
+ 已修正未處理 `CancellationException` 的 SPARQL 錯誤。
+ 已修正 SPARQL 錯誤，其中包含巢狀選項的查詢無法正常運作。
+ 已修正 LOAD 中的 SPARQL 錯誤，其中 `ConcurrentModificationException` 可能導致查詢停止回應。
+ 已修正 SPARQL 錯誤，此錯誤會阻止查詢回應使用 gzip 進行壓縮。
+ 已修正 `groupBy()` 步驟中的 Gremlin 錯誤。
+ 已修正與在 `local()` 步驟內使用 `aggregate()` 步驟相關的 Gremlin 錯誤。
+ 已修正與使用 `bothE()` (其後跟著使用彙總值的述詞) 相關的 Gremlin 錯誤。
+ 已修正與使用 `bothE()` 步驟搭配 `repeat()` 步驟相關的 Gremlin 錯誤。
+ 已修正與 `both()` 步驟相關的潛在 Gremlin 記憶體洩漏問題。
+ 已修正以下錯誤：由於未正確處理以 '/' 結尾的端點，遺失了請求指標。
+ 已修正即使請求佇列未滿，也可能引發 `ThrottlingException` 的錯誤。
+ 已修正當載入由於 `LOAD_DATA_FAILED_DUE_TO_FEED_MODIFIED_OR_DELETE` 等原因失敗時，擷取載入狀態的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 1.0.3.0.R2 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.3`
+ *SPARQL 版本：*`1.1`
## 引擎版本 1.0.3.0.R2 的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
如果您的叢集已將其 `AutoMinorVersionUpgrade` 參數設為 `True`，則在維護時段期間，您的叢集會在此發行日期後兩至三週自動升級至此引擎版本。
## 升級至此版本
Amazon Neptune 1.0.3.0.R2 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 錯誤。
+ 已修正一個 Gremlin 錯誤，此錯誤會導致在 `.repeat()` 內具有 `.simplePath()` 或 `.cyclicPath()` 的查詢傳回不正確的結果。
+ 已修正一個 Gremlin 錯誤，此錯誤會導致 `.project()` 在其子周遊未傳回任何解決方案時傳回不正確的結果。
+ 已修正一個 Gremlin 錯誤，其中來自讀寫衝突的錯誤引發了 `InternalFailureException` 而不是 `ConcurrentModificationException`。
+ 已修正導致 `.group().by(...).by(values("property"))` 失敗的 Gremlin 錯誤。
+ 已修正全文搜尋步驟之設定檔輸出中的 Gremlin 錯誤。
+ 已修正 Gremlin 工作階段中的資源洩漏。
+ 已修正在某些情況下狀態 API 無法報告正確的可訂購版本的錯誤。
+ 已修正一個大量載入器錯誤，此錯誤允許使用 Amazon S3 以外之位置的 URL 做為大量載入請求中的來源。
+ 已修正詳細載入狀態下的大量載入器錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.2.2 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.3`
+ *SPARQL 版本：*`1.1`
## 引擎 1.0.2.2 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
如果您的叢集已將其 `AutoMinorVersionUpgrade` 參數設為 `True`，則在維護時段期間，您的叢集會在此發行日期後兩至三週自動升級至此引擎版本。
## 升級至此版本
Amazon Neptune 1.0.2.2 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.2.2.R6 (2021 年 2 月 19 日)
截至 2021 年 2 月 19 日，引擎版本 1.0.2.2.R6 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 此引擎版本中修正的缺陷
+ 已修正在某些情況下，當 `ConcurrentModificationException` 發生時 `InternalFailureException` 被設定為回應代碼的 Girmlin 錯誤。
+ 已修正在某些情況下更新邊緣或頂點可能導致暫時性 `InternalFailureException` 的 Gemlin 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.2.2.R5 (2020 年 10 月 12 日)
截至 2020 年 10 月 12 日，引擎版本 1.0.2.2.R5 已普遍部署。請注意，新版本需要數天才能在每個區域推出。
## 這個引擎版本的改善項目
+ 已改善 Gremlin `properties()` 步驟的效能。
+ 已在 Explain 和設定檔報告中新增有關 `BindOp` 和 `MultiplexerOp` 的詳細資訊。
+ 對於 SPARQL 查詢回應，已將 `charset` 新增至 Content-Type 標頭，讓 HTTP 用戶端可以辨識自動使用的字元集。
## 此引擎版本中修正的缺陷
+ 已修正未處理 `CancellationException` 的 SPARQL 錯誤。
+ 已修正 SPARQL 錯誤，其中包含巢狀選項的查詢無法正常運作。
+ 已修正 LOAD 中的 SPARQL 錯誤，其中 `ConcurrentModificationException` 可能導致查詢停止回應。
+ 已修正 SPARQL 錯誤，此錯誤會阻止查詢回應使用 gzip 進行壓縮。
+ 已修正 `groupBy()` 步驟中的 Gremlin 錯誤。
+ 已修正與在 `local()` 步驟內使用 `aggregate()` 步驟相關的 Gremlin 錯誤。
+ 已修正與使用 `bothE()` (其後跟著使用彙總值的述詞) 相關的 Gremlin 錯誤。
+ 已修正與使用 `bothE()` 步驟搭配 `repeat()` 步驟相關的 Gremlin 錯誤。
+ 已修正與 `both()` 步驟相關的潛在 Gremlin 記憶體洩漏問題。
+ 已修正以下錯誤：由於未正確處理以 '/' 結尾的端點，遺失了請求指標。
+ 已修正即使請求佇列未滿，也可能引發 `ThrottlingException` 的錯誤。
+ 已修正當載入由於 `LOAD_DATA_FAILED_DUE_TO_FEED_MODIFIED_OR_DELETE` 等原因失敗時，擷取載入狀態的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 錯誤。
+ 已修正 Gremlin 錯誤，為 `bothE` 上的每個方向單獨處理 `toV` 和 `fromV`。
+ 已修正涉及 sideEffects 消失的 Gremlin 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 個大量載入的任務排入佇列，而不必等待其中一個完成，再啟動下一個。您也可以在使用 `load` 命令的 `dependencies` 參數順利完成一或多個先前佇列的載入任務時，執行佇列的載入請求。請參閱 [Neptune 載入器命令](load-api-reference-load.md)。
+ 現在可以對全文搜尋輸出進行排序 (請參閱[全文檢索搜尋參數](full-text-search-parameters.md))。
+ 現在已有用於呼叫 Neptune 串流的資料庫叢集參數，且該功能已移出實驗室模式。請參閱 [啟用 Neptune 串流](streams-using-enabling.md)。
## 此引擎版本中修正的缺陷
+ 已修正伺服器啟動時的隨機故障，此故障會延遲執行個體的建立。
+ 已修正最佳化工具問題，其中，查詢中的 `BIND` 陳述式讓最佳化工具在連結順序規劃中使用非選擇性模式展開。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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)。
+ 資料庫叢集快照現在可以跨 AWS 區域複製。請參閱 [複製快照](backup-restore-copy-snapshot.md)。
## 這個引擎版本的改善項目
+ 改進處理大量述詞時的效能。
+ 增強查詢最佳化。儘管這對客戶而言，應該是完全透明的，但建議您在升級前，先測試應用程式，以確保應用程式如預期運作。
+ 錯誤報告的小規模增強功能。
+ 已新增 Gremlin `.project()` 和 `.identity()` 步驟的最佳化。
+ 已新增非終結 Gremlin `.union()` 案例的最佳化。
+ 已新增 Gremlin `.path().by()` 周遊的原生支援。
+ 已新增 Gremlin `.coalesce()` 的原生支援。
+ 進一步最佳化大量寫入。
+ 我們現在要求 HTTPS 連線至少使用 TLS 版本 1.2 或更高版本，以防止使用過時/不安全的密碼。
## 此引擎版本中修正的缺陷
+ 已修正 Gremlin `addE()` 內部周遊處理錯誤。
+ 已修正由 AST 註釋從子系周遊洩漏到父系周遊造成的 Gremlin 錯誤。
+ 已修正在 `select()` 之後呼叫 `.otherV()` 時，在 Gremlin 中發生的錯誤。
+ 已修正某些 `.hasLabel()` 步驟出現在 `bothE()` 步驟之後會失敗的 Gremlin 錯誤。
+ 對 Gremlin .sum() 和 .project() 進行小規模修正。
+ 已修正處理 SPARQL 查詢缺少右括號的錯誤。
+ 已修正 SPARQL Explain 中的一些小錯誤。
+ 已修正處理並行取得載入狀態要求時的錯誤。
+ 減少利用 `.project()` 步驟執行一些 Gremlin 周遊所使用的記憶體。
+ 已修正 SPARQL 中特殊值的數值比較。請參閱 [標準合規](feature-overview-standards-compliance.md)。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.2.1 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.1`
+ *SPARQL 版本：*`1.1`
## 引擎 1.0.2.1 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
您不會自動升級至此版本。
## 升級至此版本
Amazon Neptune 1.0.2.1 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 無法在關閉頻道前傳送 Web Socket 關閉框架。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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`。
## 此引擎版本中修正的缺陷
+ 已修正 Gremlin 錯誤，其中 `project-by` 內的 `union` 周遊不會傳回結果或傳回不正確的結果。
+ 已修正導致巢狀 `.project().by()` 步驟傳回不正確結果的 Gremlin 錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.2.1.R3 (2019 年 12 月 12 日)
## 此引擎版本中修正的缺陷
+ 已修正下列錯誤：即使已在 `neptune_lab_mode` 參數中使用 `ObjectIndex` 值，正確地啟用在 [實驗室模式](features-lab-mode.md) 使用的功能，仍會停用 `OSGP` 索引。
+ 已修正因 `.project().by()` 步驟內部的 `.fold()` 而影響 Gremlin 查詢的錯誤。例如，此錯誤會造成下列查詢傳回不完整的結果：
```
g.V().project("a").by(valueMap().fold())
```
+ 已修正大量載入 RDF 資料的效能瓶頸。
+ 已修正在啟用串流時造成複本當機，且複本在主版之前重新啟動的錯誤。
+ 已修正在未重新啟動書執行個體的情況下，未挑選在執行個體上輪換的 SSL 憑證的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎版本 1.0.2.1.R2 (2019 年 11 月 25 日)
## 此引擎版本中修正的缺陷
+ 已修正透過非循環配置資源依序周遊和非 `path()` 依序周遊影響所有 `project().by()` 查詢的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 資料庫叢集](cluster-maintenance.md))。
因此，引擎版本的編號已變更 (請參閱 [引擎版本 1.3.0.0 之前的版本編號](cluster-maintenance.md#older-engine-numbers))。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.2.0 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.1`
+ *SPARQL 版本：*`1.1`
## 引擎 1.0.2.0 版的升級途徑
您可以將任何先前的 Neptune 引擎版本手動升級為此版本。
您不會自動升級至此版本。
## 升級至此版本
Amazon Neptune 1.0.2.0 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 關閉框架。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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` 能夠更快復原。
+ 已修正伺服器上處理許多並行載入狀態及/或啟動載入要求時，可能導致競爭條件和當機的錯誤。
## 此版本支援的查詢語言版本
將資料庫叢集升級至版本 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 現已正式推出。
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 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
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，所有這些執行個體都需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集。
### 一律在升級之前執行測試
發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。
首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。
在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。
### 升級前一律建立手動快照
在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。
在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。
確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 `preupgrade` 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。
**注意**
如果您嘗試在[待定動作進行中](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 資料庫叢集](cluster-maintenance.md)。如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
# Amazon Neptune 引擎 1.0.1.2 版 (2020 年 6 月 10 日)
## 重要：此引擎版本現在已棄用
從 2021 年 4 月 27 日開始，將不會建立任何使用此引擎版本的新執行個體。
## 這個引擎版本的改善項目
+ 如果您嘗試存取不存在的屬性、頂點或邊緣，則 Neptune 現在會引發 `IllegalArgumentException`。先前，Neptune 已在該情況下引發了 `UnsupportedOperationException`。
例如，如果您嘗試新增一個參考不存在頂點的邊緣，則您現在將引發一個 `IllegalArgumentException`。
## 此引擎版本中修正的缺陷
+ 修正以下錯誤：同時插入兩個 `value->id` 對應時，未按照順序遞交字典和使用者交易。
+ 修正載入狀態序列化的錯誤。
+ 已修正伺服器啟動時的隨機故障，此故障會延遲執行個體的建立。
+ 已修正游標流失的問題。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 1.0.1.2 版之前，請確定您的專案與下列查詢語言版本相容：
+ *Gremlin 版本：*`3.4.1`
+ *SPARQL 版本：*`1.1`
# Amazon Neptune 引擎 1.0.1.1 版 (2020 年 6 月 26 日)
## 重要：此引擎版本現在已棄用
從 2021 年 4 月 27 日開始，將不會建立任何使用此引擎版本的新執行個體。
## 此引擎版本中修正的缺陷
+ 修正了同時插入時提交的失序錯誤。
+ 修正載入狀態序列化的錯誤。
+ 已修正伺服器啟動時的隨機故障，此故障會延遲執行個體的建立。
+ 已修正記憶體流失。
## 此版本支援的查詢語言版本
將資料庫叢集升級至 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 日
**版本：**
## 重要：此引擎版本現在已棄用
從 2021 年 4 月 27 日開始，將不會建立任何使用此引擎版本的新執行個體。
## 此引擎版本中修正的缺陷
+ 修正了當用戶端使用 `traversal().withRemote(...)` (亦即使用 GLV 位元碼) 連接到 Neptune 時，`tree()` 步驟回應序列化中的 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/描述檔功能 (請參閱 [使用 Gremlin `explain` 分析 Neptune 查詢執行](gremlin-explain.md))。
+ 已新增 [支援 Gremlin 指令碼型工作階段](access-graph-gremlin-sessions.md) 以在單一交易中啟用多個 Gremlin 周遊的執行。
+ 已在 Neptune 中新增對 SPARQL 聯合查詢延伸模組的支援 (請參閱 [SPARQL 1.1 聯合查詢](https://www.w3.org/TR/sparql11-federated-query/)和 [Neptune 中使用 `SERVICE` 延伸模組的 SPARQL 聯合查詢](sparql-service.md))。
+ 已新增一項功能，讓您可透過 HTTP URL 參數或透過 SPARQL `queryId` 查詢提示 (請參閱 [將自訂 ID 注入至 Neptune Gremlin 或 SPARQL 查詢](features-query-id.md))，將自己的 `queryId` 注入至 Gremlin 或 SPARQL 查詢。
+ 已將 [實驗室模式](features-lab-mode.md) 功能新增至 Neptune，讓您可以試用尚未準備好用於生產環境但即將推出的功能。
+ 已新增即將推出的 [Neptune 串流](streams.md) 功能，可將對資料庫進行的每項變更可靠地記錄到持續一週的串流中。此功能只能在實驗室模式中使用。
+ 更新並行交易的正式語意 (請參閱[Neptune 中的交易語意](transactions.md))。此功能針對並行提供產業標準保證。
根據預設，會啟用這些交易語意。在某些情況下，此功能可能會變更目前的載入行為，並降低載入效能。您可以在參數值中包含 `ReadWriteConflictDetection=disabled`，以使用資料庫叢集 `neptune_lab_mode` 參數來還原到先前語意。
## 這個引擎版本的改善項目
+ 已改善 [執行個體狀態](access-graph-status.md) API，方法為回報引擎使用哪個 TinkerPop 版本和哪個 SPARQL 版本。
+ 已提升 Gremlin 子圖形運算子的效能。
+ 已提升 Gremlin 回應序列化的效能。
+ 已提升 Gremlin Union 步驟的效能。
+ 已縮短簡單 SPARQL 查詢的延遲。
## 此引擎版本中修正的缺陷
+ 已修正 Gremlin 錯誤，其中未正確地以內部失敗形式傳回逾時。
+ 已修正 SPARQL 錯誤，其中局部變數集的 ORDER BY 已導致內部伺服器錯誤。
# Amazon Neptune 引擎更新 2019 年 9 月 19 日
## 重要：此引擎版本現在已棄用
從 2021 年 4 月 27 日開始，將不會建立任何使用此引擎版本的新執行個體。
**版本：**1.0.1.0.200457.0
Amazon Neptune 1.0.1.0.200457.0 正式推出。在該區域的引擎更新完成之後，所有新的 Neptune 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200457.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令來升級 DB 叢集：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
## 此引擎版本中修正的缺陷
+ 已修正先前引擎版本 (1.0.1.0.200369.0) 中引進的 Gremlin 正確性問題，方法為移除造成此問題之接續述詞處理的效能改善。
+ 已修正 SPARQL 錯誤，此錯誤會導致搭配 `DISTINCT` 的查詢，以及包裝為 `OPTIONAL` 的單一模式產生 `InternalServerError`。
# Amazon Neptune 引擎更新 2019 年 8 月 13 日
## 重要：此引擎版本現在已棄用
從 2021 年 4 月 27 日開始，將不會建立任何使用此引擎版本的新執行個體。
## 這個引擎版本的新功能
+ 已將 `OVERSUBSCRIBE` 選項新增至 [Neptune 載入器命令](load-api-reference-load.md) 的 `parallelism` 參數，這會導致 Neptune 大量載入器使用所有可用的執行緒和資源。
## 這個引擎版本的改善項目
+ 改善包含簡單邏輯 OR 運算式的 SPARQL 篩選條件的效能。
+ 改善處理接續述詞方面的 Gremlin 效能。
## 此引擎版本中修正的缺陷
+ 已修正防止從 `xsd:date` 減去 `xsd:duration` 的 SPARQL 錯誤。
+ 修正導致存在 `UNION` 時靜態內嵌的結果不完整的 SPARQL 錯誤。
+ 修正查詢取消中的 SPARQL 錯誤。
+ 修正類型提升期間導致溢位的 Gremlin 錯誤。
+ 修正 `addE().from().to()` 步驟中處理頂點元素時的 Gremlin 錯誤。
+ 修正涉及單一基數插入中 NaN 雙精位數和浮點數處理的 Gremlin 錯誤 (2019-07-26 於[引擎版本 1.0.1.0.200366.0](engine-releases-1.0.1.0.200366.0.md) 中發行)。
+ 修正涉及以屬性為基礎的搜尋中產生查詢計畫的錯誤。
# Amazon Neptune 引擎更新 2019 年 7 月 26 日
**版本：**1.0.1.0.200366.0
## 重要：此引擎版本現在已棄用
從 2021 年 4 月 27 日開始，將不會建立任何使用此引擎版本的新執行個體。
## 這個引擎版本的新功能
+ 已升級至 TinkerPop 3.4.1 (請參閱 [TinkerPop 升級資訊](http://tinkerpop.apache.org/docs/3.4.1/upgrade/)以及 [TinkerPop 3.4.1 變更日誌](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))。
## 這個引擎版本的改善項目
+ 改進 SPARQL 查詢說明，從 FROM 子句顯示圖形變數。
+ 改進篩選、等於篩選、VALUES 子句和範圍計數的 SPARQL 效能。
+ 改進 Gremlin 步驟排序的效能。
+ 改進 Gremlin `.repeat.dedup` 周遊的效能。
+ 改善 Gremlin `valueMap()` 和 `path().by()` 周遊的效能。
## 此引擎版本中修正的缺陷
+ 修正 SPARQL 屬性路徑的多個問題，包括具名圖形的操作。
+ 修正造成記憶體問題的 SPARQL CONSTRUCT 查詢問題。
+ 修正 RDF Turtle 剖析器與本機名稱的問題。
+ 修正更正顯示給使用者之錯誤訊息的問題。
+ 修正 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 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200310.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200310.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
## 改善項目
+ 修正同時插入和捨棄邊緣可能導致多個邊緣具有產生相同 ID 的錯誤。
+ 其他次要修正和改進。
# Amazon Neptune 引擎更新 2019 年 5 月 1 日
**版本：**1.0.1.0.200296.0
Amazon Neptune 1.0.1.0.200296.0 正式推出。在該區域的引擎更新完成之後，所有新的 Neptune 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200296.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200296.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
## 改善項目
+ 已將新 `explain` 功能新增至 Neptune SPARQL 查詢，以協助您視覺化查詢計劃，並在必要時採取步驟來進行最佳化。如需相關資訊，請參閱[SPARQL `explain`SPARQL `SERVICE` 延伸模組](sparql-explain.md)。
+ 以各種方式改善 SPARQL 效能和報告。
+ 以各種方式改善 Gremlin 效能和行為。
+ 改善長時間執行的 `drop( )` 查詢逾時。
+ 改善 `otherV( )` 查詢的效能。
+ 已將兩個欄位新增至在您查詢資料庫叢集或執行個體的 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 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200267.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200267.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
## 改善項目
+ Neptune 會等待更長的時間 (在指定的查詢逾時內)，讓任何衝突得以解決。這可減少用戶端需要處理之並行修改例外狀況的數目 (請參閱[查詢錯誤](errors-engine-codes.md#errors-query))。
+ 已修改 Gremlin 基數強制執行有時會造成引擎重新啟動的問題。
+ 已提升 `emit.times` 重複查詢的 Gremlin 效能。
+ 已修正 Gremlin 問題，其中 `repeat.until` 允許應該透過其進行篩選的 `.emit` 解決方案。
+ 已改善 Gremlin 中的錯誤處理能力。
# Amazon Neptune 引擎更新 2018 年 11 月 19 日
**版本：**1.0.1.0.200264.0
Amazon Neptune 1.0.1.0.200264.0 正式推出。在該區域的引擎更新完成之後，所有新的 Neptune 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200264.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200264.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
## 改善項目
+ 新增了對 [Gremlin 查詢提示](gremlin-query-hints.md) 的支援。
+ 改進 IAM 身分驗證的錯誤訊息。如需詳細資訊，請參閱[IAM 身分驗證錯誤](errors-engine-codes.md#errors-iam-auth)。
+ 提升包含大量述詞的 SPARQL 查詢效能。
+ 提升 SPARQL 屬性路徑的效能。
+ 提升於 `addV()`、`addE()`、`property()` 步驟所用的 Gremlin 條件式變動 (例如 `fold().coalesce(unfold(), …)` 樣式) 效能。
+ 提升 Gremlin 的 `by()` 和 `sack()` 調變效能。
+ 提升 Gremlin 的 `group()` 和 `groupCount()` 步驟的效能。
+ 提升 Gremlin 的 `store()`、`sideEffect()`、`cap().unfold()` 步驟的效能。
+ 改進對 Gremlin 單一基數屬性限制的支援。
+ 改進標示為單一基數屬性的邊緣屬性和頂點屬性的單一基數強制性。
+ 引進錯誤：如果在 Neptune 載入工作中為現有邊緣屬性指定額外的屬性值，會發生錯誤。
# Amazon Neptune 引擎更新 2018 年 11 月 8 日
**版本:**1.0.1.0.200258.0
Amazon Neptune 1.0.1.0.200258.0 正式推出。在該區域的引擎更新完成之後，所有新的 Neptune 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200258.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200258.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200255.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200255.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200237.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200237.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
## 改善項目
+ 已修正部分 `SPARQL COUNT(DISTINCT)` 查詢失敗的問題。
+ 已修正具有 `DISTINCT` 子句的 `COUNT`、`SUM` 和 `MIN` 查詢可能會用盡記憶體的問題。
+ 已修正 `BLOB` 類型的資料可能導致 Neptune 載入器任務失敗的問題。
+ 已修正重複插入可能導致交易失敗的問題。
+ 已修正無法將 `DROP ALL` 查詢取消的問題。
+ 已修正 Gremlin 用戶端可能間歇性停止回應的問題。
+ 已針對承載大於 150M 的情況將所有錯誤碼更新為 `HTTP 400`。
+ 已改進單次三元組模式 `COUNT()` 查詢的效能與準確性。
+ 已改進具有 `BIND` 子句的 `SPARQL UNION` 查詢的效能。
# Amazon Neptune 引擎更新 2018 年 7 月 24 日
**版本：**1.0.1.0.200236.0
Amazon Neptune 1.0.1.0.200236.0 正式推出。在該區域的引擎更新完成之後，所有新的 Neptune 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200236.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200236.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/support) 取得。
## 改善項目
+ 已更新 `xsd:string` 資料類型的 SPARQL 序列化。xsd:string 不再隨附於 JSON 序列化，目前已與其他輸出格式一致。
+ 已修正 `xsd:double`/`xsd:float` 無限的處理問題。`-INF`、`NaN` 和 `INF` 的值現已可在所有 SPARQL 資料載入器格式、SPARQL 1.1 更新及 SPARQL 1.1 查詢中正確加以辨識和處理。
+ 包含空字串值的 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 資料庫叢集 (包括從快照還原的資料庫叢集) 將會在 Neptune 1.0.1.0.200233.0 中建立。
您可以在主控台上使用資料庫叢集操作或使用軟體開發套件，立即將現有叢集升級至此版本。您可以使用以下 CLI 命令，立即將資料庫叢集升級至此版本：
```
aws neptune apply-pending-maintenance-action \
--apply-action system-update \
--opt-in-type immediate \
--resource-identifier arn:aws:rds::::
```
在系統維護時段期間，Neptune 資料庫叢集會自動升級至引擎版本 1.0.1.0.200233.0。套用更新的時間取決於資料庫叢集的區域和維護時段設定，以及更新類型。
**注意**
執行個體維護時段無法進行引擎更新。
更新會同時套用到資料庫叢集中的所有執行個體。更新時，資料庫叢集中的所有執行個體需要重新啟動資料庫，因此您會經歷 20 至 30 秒的停機時間，之後就可以繼續使用資料庫叢集或叢集。您可以在 [Neptune 主控台](https://console.aws.amazon.com/neptune/home)上檢視或變更您的維護時段設定。
如果您有任何問題或疑慮， AWS 支援團隊可在社群論壇和 [AWS Premium Support](https://aws.amazon.com/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 連線的字串查詢中的逸出序列無法正確處理。