

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
<a name="kcl-migration-from-3-3-5"></a>

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.

1. Espere a que se complete la implementación en todos los trabajadores. Supervise la entrada del estado `TableMigration3.5` coordinador hasta las `TableMigrationStatus` llegadas`DEPLOYED`. Compruebe que no haya regresiones y deje pasar suficiente tiempo de cocción.

1. **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.

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

1. 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.

1. 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` o`LeaseManagementConfig.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](kcl-single-table-format.md)