View a markdown version of this page

Migre de KCL 3.x a un 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 a un 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 a un formato de tabla única para consolidar todos los metadatos en la tabla de arrendamiento.

Requisitos previos

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

  • Su aplicación es estable y todos los trabajadores están en buen estado.

  • 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 versión 2.x a la 3.x al mismo tiempo.

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

  1. Fase 1: actualice la dependencia del proyecto a KCL 3.5 o una versión posterior. Implemente con la migrateAllEntitiesToLeaseTable configuración establecida en false (opción predeterminada). 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 del estado TableMigration3.5 coordinador hasta las TableMigrationStatus llegadasDEPLOYED. Compruebe que no haya regresiones y deje pasar suficiente tiempo de cocción.

  3. Fase 2: Vuelva a implementar con la migrateAllEntitiesToLeaseTable configuración establecida en. true Esta implementación comienza la migración al formato de tabla única.

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

  5. Cuando el estado llegue a COMPLETADO, compruebe que no haya regresiones y espere un tiempo de horneado adicional para asegurarse de que no sea necesario realizar retrocesos.

  6. Elimine manualmente las antiguas tablas de estadísticas de los trabajadores y estados de los coordinadores. 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 una vez 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 de código a la fase 1 no permite volver a tener 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