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