기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# KCL 1.x에서 KCL 3.x로 마이그레이션
<a name="kcl-migration-1-3"></a>

이 주제에서는 소비자를 KCL 1.x에서 KCL 3.x로 마이그레이션하는 지침을 설명합니다. KCL 1.x는 KCL 2.x 및 KCL 3.x와 다른 클래스와 인터페이스를 사용합니다. 먼저 레코드 프로세서, 레코드 프로세서 팩토리, 워커 클래스를 KCL 2.x/3.x 호환 형식으로 마이그레이션하고 KCL 2.x에서 KCL 3.x로 마이그레이션하는 단계를 따라야 합니다. 바로 KCL 1.x에서 KCL 3.x로 업그레이드할 수 있습니다.
+ **1단계: 레코드 프로세서 마이그레이션**

  [Migrate consumers from KCL 1.x to KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 페이지의 [Migrate the record processor](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 섹션을 따릅니다.
+ **2단계: 레코드 프로세서 팩토리 마이그레이션**

  [Migrate consumers from KCL 1.x to KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 페이지의 [Migrate the record processor factory](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-factory-migration) 섹션을 따릅니다.
+ **3단계: 작업자 마이그레이션**

  [Migrate consumers from KCL 1.x to KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 페이지의 [Migrate the worker](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#worker-migration) 섹션을 따릅니다.
+ **4단계: KCL 1.x 구성 마이그레이션**

  [Migrate consumers from KCL 1.x to KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 페이지의 [Configure the Amazon Kinesis client](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#client-configuration) 섹션을 따릅니다.
+ **5단계: 유휴 시간 제거 및 클라이언트 구성 제거 확인**

  [Migrate consumers from KCL 1.x to KCL 2.x](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#recrod-processor-migration) 페이지의 [Idle time removal](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#idle-time-removal) 및 [Client configuration removals](https://docs.aws.amazon.com/streams/latest/dev/kcl-migration.html#client-configuration-removals) 섹션을 따릅니다.
+ **6단계: KCL 2.x에서 KCL 3.x로 마이그레이션 가이드의 단계별 지침 수행**

  [KCL 2.x에서 KCL 3.x로 마이그레이션](kcl-migration-from-2-3.md) 페이지의 지침에 따라 마이그레이션을 완료합니다. 롤백 후 이전 KCL 버전으로 롤백하거나 KCL 3.x로 롤포워드해야 하는 경우 [이전 KCL 버전으로 롤백](kcl-migration-rollback.md) 및 [롤백 후 KCL 3.x로 롤포워드](kcl-migration-rollforward.md) 섹션을 참조하세요.

**중요**  
KCL 3.x에서는 AWS SDK for Java 버전 2.27.19\~2.27.23을 사용하지 마십시오. 이러한 버전에는 KCL의 DynamoDB 사용과 관련된 예외 오류가 발생하는 문제가 포함되어 있습니다. 이 문제를 방지하려면 AWS SDK for Java 버전 2.28.0 이상을 사용하는 것이 좋습니다.