Actualización de esquema in situ

Cloud Directory ofrece la actualización de atributos de esquema y facetas existentes para ayudar a integrar sus aplicaciones con servicios proporcionados por AWS. Los esquemas que están en estado publicado o aplicado tienen versiones y no pueden modificarse. Para obtener más información, consulte Ciclo de vida de esquemas.

Control de versiones de esquemas

Una versión de esquema indica un identificador único para un esquema que los desarrolladores pueden especificar al programar sus aplicaciones para cumplir determinadas reglas y el formato de los datos. Es importante que los desarrolladores comprendan dos diferenciadores clave en el modo en el que funciona el control de versiones con Cloud Directory. Estos diferenciadores (la versión principal y la secundaria) pueden determinar cómo afectan las futuras actualizaciones del esquema a la aplicación.

Versión principal

La versión principal es el identificador de versión que se utiliza para realizar el seguimiento de los cambios de la versión principal de un esquema. Puede tener hasta 10 caracteres de longitud. Las distintas versiones del mismo esquema son totalmente independientes. Por ejemplo, dos esquemas con el mismo nombre y distintas versiones se tratan como esquemas completamente diferentes, con sus propios espacios de nombres.

Cambios no compatibles con versiones anteriores

Recomendamos realizar cambios en la versión principal solo cuando los esquemas no sean compatibles. Por ejemplo, al cambiar el tipo de datos de un atributo existente (como, por ejemplo, cambiar de string a integer) o suprimir un atributo obligatorio de su esquema. Los cambios no compatibles con versiones anteriores requieren la migración de los datos del directorio de una versión del esquema anterior a la nueva versión del esquema.

Versión secundaria

La versión secundaria es el identificador de versión utilizado para actualizar in situ esquemas o cuando desea realizar actualizaciones compatibles con versiones anteriores, como añadir atributos adicionales o añadir facetas. Se puede aplicar un esquema actualizado con una versión secundaria en todos los directorios que lo utilicen sin interrumpir ninguna aplicación en ejecución. Esto incluye los directorios que se utilizan en entornos de producción. Para ver un ejemplo de caso de uso, consulte«How to Easiy Apply Amazon Cloud Directory Schema Changes with In-Place Schema Upgrades»en el blog de Cloud Directory

La información de la versión secundaria y el historial se guardan con la demás información del esquema en el repositorio de metadatos del esquema. No se conserva en los objetos ninguna información de versión secundaria. La ventaja de introducir la versión secundaria es que el código de cliente funciona perfectamente siempre que no cambie la versión principal.

Límites de la versión secundaria

Cloud Directory conserva y, por lo tanto, limita hasta cinco versiones secundarias. Sin embargo, los límites de versión secundaria se aplican de forma diferente para los esquemas publicados y aplicados de las siguientes maneras:

• Esquemas aplicados: Una vez superado el límite de versión secundaria, Cloud Directory elimina automáticamente la versión secundaria más antigua.

• Esquemas publicados: Una vez superado el límite de versiones menores, Cloud Directory no elimina ninguna de las versiones secundarias, pero sí informa al usuario a través de unLimitExceededExceptionque se ha superado el límite. Una vez que supere los límites de versiones secundarias, puede eliminar el esquema mediante la herramientaDeleteSchemaAPI o solicitar un aumento de límite.

Uso de operaciones API de actualización de esquema

Puede utilizar la llamada a la API UpgradePublishedSchema para actualizar esquemas publicados. Las actualizaciones de esquema se aplican in situ en los directorios que lo utilizan mediante la llamada a la API UpgradeAppliedSchema. También puede conseguir la versión principal y secundaria de un esquema aplicado llamando a GetAppliedSchemaVersion O bien puede ver los ARN de esquema asociados y el historial de revisiones del esquema de un directorio llamando aListAppliedSchemaArns. Cloud Directory mantiene las cinco versiones más recientes de los cambios aplicados en el esquema.

Para obtener un ejemplo ilustrativo, consulte«How to Easiy Apply Amazon Cloud Directory Schema Changes with In-Place Schema Upgrades»en el blog de Cloud Directory La publicación del blog demostrará cómo se realiza una actualización de esquema in situ y se utilizan las versiones de esquema en Cloud Directory. Trata acerca de cómo añadir atributos adicionales a una faceta existente, añadir una nueva faceta a un esquema, publicar el nuevo esquema y aplicarlo a directorios en ejecución para completar la actualización de un esquema in situ. También muestra cómo ver el historial de la versión de un esquema de directorios, lo que contribuye a garantizar que la flota de directorios está ejecutando la misma versión del esquema y que tiene aplicado el historial de cambios de esquema correcto.