Skip to main content

MongoDB Server 升级最佳实践

嵌入式和用户管理 MongoDB 的架构升级

大多数季度升级都会更改数据库架构以适应新功能。升级后首次启动 Alteryx Server 服务时,架构迁移将自动执行。虽然这是自动进行的,但这一过程中的任何问题都会导致 Server 无法正常启动。

查看 Alteryx 升级前检查 ,因为它们是确保您的 Mongo 数据库架构已准备好进行迁移并且不会出错的最佳方法。

要在启动 Alteryx Server 服务后确认架构已迁移到预期版本,请查看迁移日志的末尾并将其与 Server 版本的正确架构进行比较: C:\ProgramData\Alteryx\Gallery\Logs\alteryx-migration.csv

如需详细了解 MongoDB 架构,请访问 MongoDB 架构参考 帮助页面。MongoDB 架构参考

确认您的 Mongo 数据库版本是否需要升级

Mongo DB 架构参考列出了每个 Server 版本的“嵌入式 MongoDB 版本”和“对于用户自行管理实例受支持的 MongoDB 版本”。

嵌入式 MongoDB

  • 如果显示版本升级,则该升级会在 Server 升级过程结束时自动进行。请参阅以下详细信息,了解所需的可用空间量以及升级完成后可以删除或存档的文件夹。

  • 如果您正在进行的重大升级(例如从 2019.2 升级到 2021.4)显示 2 项 Mongo 版本升级(从 3.4 升级到 4.0,然后从 4.0 升级到 4.2),您需要在升级到使用 Mongo 中间版本的 Server 版本时中途停止(因此,先从 2019.2 升级到 2019.3 以获取 Mongo 4.0,然后从 2019.3 升级到 2021.4 以获取 Mongo 4.2)。

用户管理的 Mongo

您会注意到,每个版本的 Server 都支持多个 Mongo 版本。确定您是否需要升级您的 Mongo 或此次升级是否是可选的。

不同类型 MongoDB 的版本升级

进行某些 Server 升级的同时,还会升级嵌入式 MongoDB 的版本。版本到版本指南将这类情况称为“停站”。对于 MongoDB 版本升级,只要您没有经过 2 次 Mongo 停站,您可以直接从其中一次停站之前的版本升级到停站之后的版本。

重要

如果您的 Server 升级时将升级 Mongo 数据库,则在升级过程中,您需要的可用空间相当于当前 Mongo 数据库大小的 1-3 倍。

如果您的 Server 升级时不升级 Mongo 数据库版本,则在 Server 升级过程中不会使用额外空间,本节内容也不适用。

要规划所需的空间,请检查当前 MongoDB 的大小。

文件夹: C:\ProgramData\Alteryx\Service\Persistence\MongoDB

  • 在升级前手动备份数据库, MongoDB 备份。要节省空间,您可以在继续之前存档备份。

  • 在 Mongo 升级过程中,数据库被复制到 \MongoDB_PreUpgrade 文件夹。在 Server 升级过程中,系统会要求您提供此文件夹的位置,您可以在计算机上选择另一个驱动器。虽然可以指定网络位置,但建议不要执行此操作,因为大型数据库可能会因网络连接问题而失败。

  • 对于 Server 升级 2018 - 2021.3.5,系统将在名为 \MongoDB_MongoVer 的新文件夹中创建升级后的数据库。升级后,您可以删除原始的 \MongoDB 文件夹。

MongoDB 版本升级文件夹组织 2021.3.6+

MongoDB Version Upgrade folder organization 2021.4+

MongoDB 版本升级文件夹组织 2018 - 2021.3.5

MongoDB Version Upgrade Folder Organization 2018 - 2021.3

如果您根据上述情况确定必须或希望升级本地用户管理的 Mongo,则应将这项升级与 Alteryx Server 升级分开进行。在升级应用程序后,如果没有对 Server 进行全面测试,请不要同时升级两者。

升级本地用户管理 Mongo 的步骤如下:

  1. 停止 AlteryxService。

  2. 备份 MongoDB。

  3. 请遵循 Mongo 的升级建议,这可能需要停站。例如,如果要进行 Mongo 3.4 -> 4.0 的迁移,Mongo 建议先进行 3.4 -> 3.6 的更新,然后再进行 3.6 -> 4.0 的更新。

  4. 启动 Mongo。

  5. 启动 AlteryxService。

  6. 测试 Server 和工作流是否按预期运行。

如需了解详情,请参阅以下文章:

如果您根据上述情况确定必须或希望升级 Atlas 用户管理的 MongoDB,则应将这项升级与 Alteryx Server 升级分开进行。在升级应用程序后,如果没有对 Server 进行全面测试,请不要同时升级两者。

升级 Atlas 用户管理的 Mongo 的步骤如下:

  1. 停止 AlteryxService。

  2. 按照 Mongo Atlas 文档所述,备份数据库。

  3. 按照 Mongo 文档所述,使用“升级版本”按钮。

  4. 启动 AlteryxService。

  5. 测试 Server 和工作流是否按预期运行。