View a markdown version of this page

Migre de KCL 3.x al formato de tabla única - Amazon Kinesis Data Streams

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Migre de KCL 3.x al formato de tabla única

Si ejecuta KCL 3.x con las tres tablas de metadatos de DynamoDB (tabla de arrendamiento, tabla de métricas de trabajadores y tabla de estados de coordinadores), puede migrar al formato de tabla única para consolidar todos los metadatos en la tabla de arrendamiento.

Requisitos previos

  • Su aplicación ejecuta KCL 3.x con las tres tablas de metadatos.

  • Su aplicación es estable y todos los trabajadores están sanos.

  • Su aplicación ha finalizado la migración a KCL 3.x y no se configura. CoordinatorConfig.clientVersionConfig No realice la migración de la tabla y la migración de la versión del cliente de la 2.x a la 3.x al mismo tiempo.

Para migrar de KCL 3.x al formato de tabla única, siga el proceso de implementación en dos fases

  1. Fase 1: actualice la dependencia de su proyecto a KCL 3.5 o una versión posterior. Implemente con el valor migrateAllEntitiesToLeaseTable establecido en false (predeterminado). Esta implementación instala el nuevo código que admite el formato de tabla única, pero no activa la migración.

  2. Espere a que se complete la implementación en todos los trabajadores. Supervise la entrada estatal del TableMigration3.5 coordinador hasta que TableMigrationStatus llegueDEPLOYED. Verifique que no haya regresiones y deje suficiente tiempo de horneado.

  3. Fase 2: Vuelva a implementar con el valor migrateAllEntitiesToLeaseTable establecido en. true Esta implementación inicia la migración al formato de tabla única.

  4. Supervise elTableMigrationStatus. El trabajador líder promueve el estado a través de DEPLOYED, PENDING y COMPLETE.

  5. Cuando el estado llegue a COMPLETADO, verifique que no haya regresiones y espere más tiempo de horneado para asegurarse de que no sea necesario realizar ninguna reversión.

  6. Elimine manualmente las tablas antiguas de estados de coordinadores y métricas de los trabajadores. KCL no elimina estas tablas automáticamente, solo deja de usarlas. Si ha configurado CoordinatorConfig.coordinatorStateTableConfig oLeaseManagementConfig.workerUtilizationAwareAssignmentConfig.workerMetricsTableConfig, puede eliminar estas configuraciones, ya que están en desuso.

importante

No revierta la aplicación después de que la migración alcance el estado COMPLETO. Una vez COMPLETADA, la aplicación funciona exclusivamente en modo de tabla única. Incluso una reversión del código a la fase 1 no permite volver a utilizar varias tablas: se ignora la configuración y la aplicación sigue utilizando únicamente la tabla de arrendamiento.

Para obtener más información sobre los estados de migración y las opciones de reversión, consulte. Formato de tabla única para KCL