Amazon Neptune 引擎更新 - Amazon Neptune
升级前测试升级前测试升级引擎版本号使用控制台手动升级使用 CLI 进行小幅升级使用 CLI 进行重大升级
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon Neptune 引擎更新

Amazon Neptune 定期发布引擎更新。您可以使用实例状态 API 确定当前安装的引擎发行版本。

引擎版本在 Amazon Neptune 中列出，补丁在 最新更新 中列出。

您可以在本节中找到有关如何发布更新以及如何升级 Neptune 引擎的信息。例如，引擎版本号的解释见中Neptune 引擎版本编号.

注意

在 2019 年 11 月之前，Neptune 一次只支持一个引擎版本，引擎版本号全部采用形式，1.0.1.0.200<xxx>，其中xxx是补丁号。新引擎版本均作为早期版本的补丁发布。

从 2019 年 11 月开始，Neptune 支持多个版本，允许客户更好地控制自己的升级路径。因此，引擎版本编号发生了变化。

请务必在升级前进行测试

发布新的主要或次要 Neptune 引擎版本时，请务必先在其上测试您的 Neptune 应用程序，然后再升级到该版本。即使是小规模的升级也可能引入新的功能或行为，从而影响您的代码。

首先，将当前版本的发行说明页面与目标版本的发行说明页面进行比较，看看查询语言版本是否会有变化或其他重大更改。

在升级生产数据库集群之前测试新版本的最佳方法是克隆生产集群，使克隆运行新的引擎版本。然后，您可以在克隆上运行查询，而不会影响生产数据库集群。

在升级之前，请务必创建手动快照

在执行升级之前，我们强烈建议您始终创建数据库集群的手动快照。拥有自动快照只能提供短期保护，而手动快照在您明确删除之前仍可用。

在某些情况下，作为升级过程的一部分，Neptune 会为你创建手动快照，但你不应该依赖它，无论如何都应该创建自己的手动快照。

如果您确定不需要将数据库集群恢复到升级前的状态，则可以明确删除自己创建的手动快照以及 Neptune 可能已创建的手动快照。如果 Neptune 创建手动快照，则其名称将以开头preupgrade，后面是数据库集群的名称、源引擎版本、目标引擎版本和日期。

升级你的Neptune 引擎

注意

更新将同时应用于数据库集群中的所有实例。更新需要在这些实例上重新启动数据库，因此，会出现 20 或 30 秒到几分钟的停机，之后您可以继续使用数据库集群。

补丁版本 (.R2,.R3等）总是在您的下个维护时段自动安装。

如果要使用 Amazon CLI 手动升级，请确保指定要升级到的引擎版本。如果不这样做，您的引擎可能会升级到非最新版本或不是您期望的版本。

您始终可以使用 实例状态 API 确定数据库集群正在运行的引擎版本。如果您正在使用 CreateDBCluster 创建集群，则 API 会在响应中返回用于创建集群的引擎版本。

自动更新的时间取决于Amazon数据库集群的区域和维护窗口设置。您可以通过以下网址查看或更改维护时段设置：Neptune 控制台. 有关更多信息，请参阅 Neptune 维护时段。

必须手动安装主要的引擎版本。

Neptune 引擎版本编号

Neptune 版本号有 3 个部分。以版本号 1.0.2.0.R2 为例：

  1. 第一部分（前两个数字，即 1.0.2.0.R2 中的 1.0）是数据库主版本号。

    仅当发生重大不兼容的更改（例如，升级数据时需要数据迁移的数据存储方式的更改）时，此部分才会更改。升级到新的主要版本通常需要停机时间，该停机时间与要升级的集群的大小成正比，并且可能比其他升级花费更长的时间。

  2. 第二部分（第三个和第四个数字，即 1.0.2.0.R2 中的 2.0）是引擎发行版的次要版本号。

    您可以选择将引擎自动升级到新的次要版本，如下所述，也可以选择确定每个次要版本的更改。

  3. 第三部分（最后一个数字，即 1.0.2.0.R2 中的 R2）是次版本引擎的补丁号。

    补丁程序涉及到紧急更改，例如在次要引擎版本之间部署的错误修复或安全更改。引擎版本的第一个版本隐式设置为 R0，其补丁号为 R1、R2，以此类推。

    补丁程序始终在系统维护窗口期间自动应用，如下所述。

您可以使用 Amazon CLI 列出可用的引擎版本，如下所示：

针对 Linux、OS X 或 Unix：

aws neptune describe-db-engine-versions \
    --region <your-region> \
    --engine neptune

对于 Windows：

aws neptune describe-db-engine-versions ^
    --region <your-region> ^
    --engine neptune

可用的引擎版本仅包括版本号高于当前版本且已定义升级路径的那些版本。

使用控制台将您的引擎升级到更新的版本

您可以使用 Neptune 数据库集群的次要版本升级Amazon Web Services Management Console如下所示：

使用控制台升级数据库集群的引擎版本

  1. 登录Amazon管理控制台并通过以下网址打开 Amazon Neptune 控制台：https://console.aws.amazon.com/neptune/home.

  2. 在导航窗格中，选择集群，然后选择要修改的数据库集群。

  3. 选择操作，然后选择修改集群。此时会显示修改数据库集群页面。

  4. 对于数据库引擎版本，选择新版本。

  5. 选择继续，查看修改摘要。

  6. 要立即应用更改，请选择立即应用。

  7. 在确认页面上，检查您的更改。如果更改正确无误，请选择修改集群以保存更改。

    或者，选择 Back (返回) 编辑您的更改，或者选择 Cancel (取消) 取消更改。

使用 CLI 手动执行 Neptune 数据库引擎的小规模升级

您可以通过以下方式手动对数据库集群的引擎版本进行小规模升级，使用Amazon CLI还有ModifyDBClusterAPI：

针对 Linux、OS X 或 Unix：

aws neptune modify-db-cluster \
  --db-cluster-identifier (your-neptune-cluster) \
  --engine-version (new-engine-version) \
  --apply-immediately

对于 Windows：

aws neptune modify-db-cluster ^
  --db-cluster-identifier (your-neptune-cluster) ^
  --engine-version (new-engine-version) ^
  --apply-immediately

确保包括要升级到的引擎版本。如果不这样做，您的引擎可能会升级到非最新版本。

使用 CLI 手动执行 Neptune 数据库引擎的重大升级

要手动对数据库集群的引擎版本进行重大升级，请使用Amazon CLI还有ModifyDBClusterAPI，您需要提供比小规模升级更多的参数：

包括要升级到的引擎版本非常重要。如果不这样做，您的引擎可能会升级到非最新版本。

针对 Linux、OS X 或 Unix：

aws neptune modify-db-cluster \
  --db-cluster-identifier (your-neptune-cluster) \
  --engine neptune \
  --engine-version (new-engine-version) \
  --apply-immediately

对于 Windows：

aws neptune modify-db-cluster ^
  --db-cluster-identifier (your-neptune-cluster) ^
  --engine neptune ^
  --engine-version <new-engine-version> ^
  --apply-immediately

而不是--apply-immediately，您可以指定--no-apply-immediately.

如果您的集群使用自定义集群参数组，请务必包含以下参数以进行指定：

  --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)