As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Atualização de esquema no local
O Cloud Directory oferece a atualização dos atributos do esquema existente atributos e as facetas que ajudam a integrar seus aplicativos com serviços fornecidos pela AWS. Os esquemas que não estão nos estados de publicado ou aplicado têm versões e não podem ser alterados. Para obter mais informações, consulte Ciclo de vida do esquema.
Versionamento do esquema
Uma versão do esquema indica um identificador exclusivo para um esquema que os desenvolvedores podem especificar ao programar seus aplicativos para estar em conformidade com determinadas regras e formatação de dados. Dois principais diferenciais na maneira como o versionamento funciona com o Cloud Directory são importantes para os desenvolvedores compreender. Esses diferenciadores – versão principal e versão secundária – podem determinar como futuras atualizações de esquema afetam o seu aplicativo.
Versão principal
Major version é o identificador de versão usado para controlar alterações na versão principal de um esquema. Ele pode ter até 10 caracteres de comprimento. As diferentes versões do mesmo esquema são completamente independentes. Por exemplo, dois esquemas com o mesmo nome e diferentes versões são tratados como esquemas completamente diferentes, que têm seus próprios namespaces.
Alterações incompatíveis com versões anteriores
Recomendamos fazer alterações à versão principal somente quando os esquemas são incompatíveis. Por exemplo, ao alterar o tipo de dados de um atributo existente (como a alteração de string para integer) ou retirar um atributo obrigatório do seu esquema. Alterações incompatíveis com versões anteriores exigem migração de dados de diretório a partir de uma versão anterior do esquema para a nova versão do esquema.
Versão secundária
Minor version é o identificador de versão usado para a atualização de esquemas no local ou quando você deseja fazer atualizações compatíveis com as versões anteriores, como a adição de atributos adicionais ou de facetas. Um esquema atualizado usando uma versão secundária pode ser aplicado no local em todos os diretórios que o utilizam sem quebrar nenhum aplicativo em execução. Isso inclui diretórios que são usados em ambientes de produção. Para obter um caso de uso de exemplo, consulte“Como aplicar com facilidade alterações de esquema de Amazon Cloud Directory com atualizações de esquemas no local”
As informações e o histórico da versão secundária são salvos juntamente com outras informações do esquema no repositório de metadados do esquema. Nenhuma informação de versão secundária é retida nos objetos. A vantagem de introdução de versão secundária é que o código do cliente funciona perfeitamente, desde que a versão principal não seja alterada.
Limites da Versão secundária
O Cloud Directory retém e, portanto, limita até cinco versões secundárias. No entanto, limites de versão secundária são aplicados de forma diferente para esquemas publicados e aplicados das seguintes maneiras:
Esquemas aplicados: Depois que o limite de versão secundária for excedido, o Cloud Directory exclui automaticamente a versão secundária mais antiga.
Esquemas publicados: Uma vez que o limite de versão secundária tenha sido excedido, o Cloud Directory não exclui nenhuma das versões secundárias, mas informa o usuário por meio de um
LimitExceededExceptionQue o limite foi excedido. Depois de exceder os limites de versão secundária, você pode excluir o esquema usando a opçãoDeleteSchemaAPI ou solicitar um aumento de limite.
Usando as operações de API de atualização de esquema
Você pode usar a chamada de API UpgradePublishedSchema para atualizar esquemas publicados. Atualizações de esquema são aplicadas no local para os diretórios que contam com ele usando a chamada de API UpgradeAppliedSchema. Você também pode obter as versões principal e secundária de um esquema aplicado chamando o GetAppliedSchemaVersions. Ou visualize os ARNs do esquema associado e o histórico de revisão do esquema para um diretório chamandoListAppliedSchemaArns. O Cloud Directory mantém as cinco versões mais recentes das alterações de esquema aplicadas.
Para obter um exemplo ilustrativo, consulte“Como aplicar com facilidade alterações de esquema de Amazon Cloud Directory com atualizações de esquemas no local”
