View a markdown version of this page

Avançar para a KCL 3.5.x+ na Fase 2 após uma reversão - Amazon DynamoDB
Etapa 1: executar a Ferramenta de Migração da KCLEtapa 2: implantar o código com a configuração da Fase 2

Avançar para a KCL 3.5.x+ na Fase 2 após uma reversão

Este tópico explica como avançar o aplicativo de consumidor para a KCL 3.5.x+ após uma reversão. Quando precisar avançar, você deve concluir um processo de duas etapas:

  1. Execute a Ferramenta de Migração da KCL no site do GitHub.

  2. Implante o código da Fase 2.

Etapa 1: executar a Ferramenta de Migração da KCL

Execute a Ferramenta de Migração da KCL com o seguinte comando para avançar para a KCL 3.5.x+:

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

Parâmetros

--region

Substitua region pela Região da AWS.

--application_name

Esse parâmetro será obrigatório se você estiver usando o nome padrão para a tabela de concessão. Se você tiver especificado um nome personalizado para a tabela de concessão, poderá omitir esse parâmetro. Substitua applicationName pelo nome da aplicação da KCL. A ferramenta usa esse nome para obter o nome de tabela padrão se um nome personalizado não for fornecido.

--lease_table_name

Esse parâmetro é necessário quando você define um nome personalizado para a tabela de concessões na configuração da KCL. Se você estiver usando o nome padrão da tabela, poderá omitir esse parâmetro. Substitua leaseTableName pelo nome da tabela personalizada que você especificou para a tabela de concessões.

Após a execução da ferramenta de migração no modo de avanço, a KCL cria o seguinte recurso do DynamoDB necessário para a KCL 3.5.x+:

  • Um índice secundário global na tabela de concessões

nota

A KCL 3.5.x+ não cria métricas de operador ou tabelas de estado de coordenador separadas durante a migração. Todos os metadados são armazenados na tabela de concessão.

Etapa 2: implantar o código com a configuração da Fase 2

Depois de executar a Ferramenta de Migração da KCL para um avanço, implante seu código com a configuração da KCL 3.5.x+ na Fase 2 (CLIENT_VERSION_CONFIG_COMPATIBLE_WITH_2X) nos seus operadores. Para concluir sua migração, consulte Step 8: Complete the migration.