

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Migrar da KCL 1.x para a KCL 3.x
<a name="kcl-migration-1-3"></a>

Este tópico explica como migrar seu consumidor da KCL 1.x para a KCL 3.x. A KCL 1.x usa classes e interfaces diferentes em comparação com a KCL 2.x e a KCL 3.x. Você deve migrar o processador de registros, a fábrica do processador de registros e as classes de trabalho para o KCL 2. x/3Formato compatível com .x primeiro e siga as etapas de migração da migração do KCL 2.x para o KCL 3.x. É possível atualizar diretamente da KCL 1.x para a KCL 3.x.

**Importante**  
Recomendamos que você migre para o KCL 3.5 ou posterior, que usa o formato de tabela única por padrão para novas migrações. Primeiro, migre seu processador de registros, fábrica e classes de trabalhadores para o KCL 2. x/3formato compatível com .x usando as etapas desta página. Em seguida, siga o caminho de migração do KCL 2.x para o KCL 3.5. O formato de tabela única é ativado automaticamente para novas migrações da versão 2.x. Para obter mais informações, consulte [Formato de tabela única para KCL](kcl-single-table-format.md).
+ **Etapa 1: migrar o processador de registros**

  Siga a seção [Migrar o processador de registros](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration) na página [Migrar consumidores da KCL 1.x para a KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration).
+ **Etapa 2: migrar a fábrica do processador de discos**

  Siga a seção [Migrar a fábrica do processador de registros](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-factory-migration) na página [Migrar consumidores da KCL 1.x para a KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration).
+ **Etapa 3: migrar o trabalhador**

  Siga a seção [Migrar o operador](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#worker-migration) na página [Migrar consumidores da KCL 1.x para a KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration).
+ **Etapa 4: migrar a configuração da KCL 1.x**

  Siga a seção [Configurar o cliente Amazon Kinesis](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#client-configuration) na página [Migrar consumidores da KCL 1.x para a KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration).
+ **Etapa 5: verifique a remoção do tempo de inatividade e as remoções da configuração do cliente**

  Siga as seções [Remoção do tempo de inatividade](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#idle-time-removal) e [Remoções da configuração do cliente](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#client-configuration-removals) na página [Migrar consumidores da KCL 1.x para a KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration).
+ **Etapa 6: siga as instruções passo a passo no guia de migração da KCL 2.x para a KCL 3.x**

  Siga as instruções na página [Migrar da KCL 2.x para a KCL 3.x](kcl-migration-from-2-3.md) para concluir a migração. Se precisar reverter para a versão anterior da KCL ou passar para a KCL 3.x após uma reversão, consulte [Reverter para a versão anterior da KCL](kcl-migration-rollback.md) e [Avançar para a KCL 3.x após uma reversão](kcl-migration-rollforward.md).

**Importante**  
Não use as AWS SDK para Java versões 2.27.19 a 2.27.23 com KCL 3.x. Essas versões têm um problema que causa um erro de exceção relacionado ao uso do DynamoDB da KCL. Recomendamos que você use a AWS SDK para Java versão 2.28.0 ou posterior para evitar esse problema. 