View a markdown version of this page

在回滚后,前滚到第 2 阶段 KCL 3.5.x+ - Amazon DynamoDB

在回滚后,前滚到第 2 阶段 KCL 3.5.x+

本主题介绍如何在回滚后将使用者应用程序前滚到 KCL 3.5.x+。当您需要前滚时,必须完成一个由两步组成的过程:

  1. 运行 GitHub 网站上的 KCL 迁移工具。

  2. 部署第 2 阶段代码。

步骤 1:运行 KCL 迁移工具

使用以下命令运行 KCL 迁移工具,以便前滚到 KCL 3.5.x+:

python3 ./KclMigrationTool.py --region region --mode rollforward [--application_name applicationName] [--lease_table_name leaseTableName]

参数

--region

将区域替换为您的 AWS 区域。

--application_name

如果您为租约表使用默认名称,则此参数为必需。如果您为租约表指定了自定义名称,则可以忽略此参数。将 applicationName 替换为实际的 KCL 应用程序名称。如果未提供自定义名称,该工具将使用此名称来派生默认表名称。

--lease_table_name

如果您在 KCL 配置中为租约表设置了自定义名称,则需要此参数。如果您使用的是默认表名称,则可以忽略此参数。将 leaseTableName 替换为您为租约表指定的自定义表名称。

在前滚模式下运行迁移工具后,KCL 会创建 KCL 3.5.x+ 所需的以下 DynamoDB 资源:

  • 租约表上的全局二级索引

注意

在迁移期间,KCL 3.5.x+ 不会创建单独的工作线程指标表或协调器状态表。所有元数据都存储在租约表中。

步骤 2:使用第 2 阶段配置部署代码

运行 KCL 迁移工具以进行前滚后,使用 KCL 3.5.x+ 第 2 阶段的配置 (CLIENT_VERSION_CONFIG_COMPATIBLE_WITH_2X) 将代码部署到工作线程。要完成迁移,请参阅 Step 8: Complete the migration。