本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 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) 取得。