本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 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 注释从子遍历泄漏到父级导致的 Gemlin 错误。
+ 修复了在 `.otherV()` 之后调用 `select()` 时 Gremlin 中出现的错误。
+ 修复了一个 Gremlin 错误，该错误导致了某些 `.hasLabel()` 步骤在 `bothE()` 步骤执行后失败。
+ 对 Gremlin .sum() 和 .project() 进行了小的修复。
+ 修复了在处理缺少右括号的 SPARQL 查询时的错误。
+ 修复了 SPARQL Explain 中的一些小错误。
+ 修复了处理并发获取加载状态请求的错误。
+ 减少了执行一些带有 `.project()` 步骤的 Grenolin 遍历所用的内存。
+ 修复了 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 Premium Support](https://aws.amazon.com/support) 联系 AWS Support 团队。
# Amazon Neptune 引擎版本 1.0.2.1.R6（2020 年 4 月 22 日）
截至 2020 年 4 月 22 日，引擎版本 1.0.2.1.R6 正在普遍部署中。请注意，新版本在每个区域的发布需要几天的时间。
## 在此引擎版本中修复的缺陷
+ 修复了一个错误，其中 `ConcurrentModificationConflictException` 和 `TransactionException` 未转换为 `NeptuneGremlinException`，导致向客户返回了 `InternalFailureException`。
+ 修复了 Neptune 在服务器完全准备就绪之前报告其状态为正常的错误。
+ 修复了在有两个 `value->id` 映射同时插入时字典和用户事务提交顺序混乱的错误。
+ 修复了加载状态序列化中的一个错误。
+ 修正了一个 Gremlin 会话错误。
+ 修复了在服务器无法启动时 Neptune 未能引发异常的错误。
+ 修复了 Neptune 无法在关闭通道之前发送 WebSocket 关闭帧的错误。
## 此版本支持的查询语言版本
在将数据库集群升级到版本 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 Premium Support](https://aws.amazon.com/support) 联系 AWS Support 团队。
# Amazon Neptune 引擎版本 1.0.2.1.R5（2020 年 4 月 22 日）
从未部署过引擎版本 1.0.2.1.R5。
# Amazon Neptune 引擎版本 1.0.2.1.R4（2019 年 12 月 20 日）
## 此引擎版本中的改进
+ Neptune 现在总是尝试首先在执行管道中放置任何全文搜索调用。这可以减少对 OpenSearch 的调用量，从而显著提高性能。请参阅[Full-text-search 查询执行](full-text-search-query-execution.md)。
+ 如果您尝试访问不存在的属性、顶点或边缘，Neptune 现在会引发 `IllegalArgumentException`。以前，Neptune 在这种情况下会引发 `UnsupportedOperationException`。
例如，如果您尝试添加引用不存在顶点的边缘，则现在将引发 `IllegalArgumentException`。
## 在此引擎版本中修复的缺陷
+ 修复了一个 Grenomlin 错误，即 `union` 在 `project-by` 内遍历不会返回结果或者返回错误的结果。
+ 修复了导致嵌套的 `.project().by()` 步骤返回错误结果的 Gemlin 错误。
## 此版本支持的查询语言版本
在将数据库集群升级到版本 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 Premium Support](https://aws.amazon.com/support) 联系 AWS Support 团队。
# Amazon Neptune 引擎版本 1.0.2.1.R3（2019 年 12 月 12 日）
## 在此引擎版本中修复的缺陷
+ 修复了一个错误，该错误的表现为：即使使用 `OSGP` 参数中的 [实验室模式](features-lab-mode.md) 值正确启用了`ObjectIndex`中的功能，也禁用 `neptune_lab_mode` 索引。
+ 修复了一个错误，该错误会影响在 `.fold()` 步骤内带有 `.project().by()` 的 Gremlin 查询。例如，它导致以下查询返回不完整的结果：
```
g.V().project("a").by(valueMap().fold())
```
+ 修复了 RDF 数据批量加载中的性能瓶颈。
+ 修复了在启用流并在主服务器之前重启副本时导致副本崩溃的错误。
+ 修复了实例上轮换的 SSL 证书在没有重新启动实例的情况下不会被选取的错误。
## 此版本支持的查询语言版本
在将数据库集群升级到版本 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 Premium Support](https://aws.amazon.com/support) 联系 AWS Support 团队。
# Amazon Neptune 引擎版本 1.0.2.1.R2（2019 年 11 月 25 日）
## 在此引擎版本中修复的缺陷
+ 修复了影响所有具有非循环 by-traversals 和非 `project().by()` by-traversals 的 `path()` 查询的错误。
## 此版本支持的查询语言版本
在将数据库集群升级到版本 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 Premium Support](https://aws.amazon.com/support) 联系 AWS Support 团队。