View a markdown version of this page

롤백 후 2단계 KCL 3.5.x+로 롤포워드 - Amazon DynamoDB
1단계: KCL 마이그레이션 도구 실행2단계: 2단계 구성으로 코드 배포

롤백 후 2단계 KCL 3.5.x+로 롤포워드

이 주제에서는 롤백 후 소비자 애플리케이션을 KCL 3.5.x+로 롤포워드하는 방법을 설명합니다. 롤포워드가 필요한 경우 2단계 프로세스를 완료해야 합니다.

  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+ Phase 2 구성(CLIENT_VERSION_CONFIG_COMPATIBLE_WITH_2X)으로 코드를 워커에 배포합니다. 마이그레이션을 완료하려면 8단계: 마이그레이션 완료를 참조하세요.