Utiliser les fonctionnalités de cartographie avancées

Découvrez les fonctionnalités avancées du schéma de table dans l'API DynamoDB Enhanced Client.

Comprendre les types de schéma de table

TableSchemaest l'interface de la fonctionnalité de mappage de l'API DynamoDB Enhanced Client. Il peut mapper un objet de données vers et depuis une carte de AttributeValues. Un TableSchema objet doit connaître la structure de la table qu'il mappe. Ces informations de structure sont stockées dans un TableMetadataobjet.

L'API client améliorée comporte plusieurs implémentations deTableSchema, qui suivent.

Schéma de table généré à partir de classes annotées

La création d'une classe à TableSchema partir de classes annotées est une opération modérément coûteuse. Nous vous recommandons donc de ne le faire qu'une seule fois, au démarrage de l'application.

BeanTableSchema

Cette implémentation est construite sur la base des attributs et des annotations d'une classe de bean. Un exemple de cette approche est présenté dans la section Commencer.

Note

Si a ne BeanTableSchema se comporte pas comme prévu, activez la journalisation du débogage pour. software.amazon.awssdk.enhanced.dynamodb.beans

ImmutableTableSchema

Cette implémentation est construite à partir d'une classe de données immuable. Cette approche est décrite dans la Travaillez avec des classes de données immuables section.

Schéma de table généré avec un générateur

Les éléments suivants TableSchema sont créés à partir du code à l'aide d'un générateur. Cette approche est moins coûteuse que celle qui utilise des classes de données annotées. L'approche du générateur évite l'utilisation d'annotations et ne nécessite pas de normes de JavaBean dénomination.

StaticTableSchema

Cette implémentation est conçue pour les classes de données mutables. La section de démarrage de ce guide explique comment générer un à StaticTableSchema l'aide d'un générateur.

StaticImmutableTableSchema

De la même manière que vous créez unStaticTableSchema, vous générez une implémentation de ce type en TableSchema utilisant un générateur à utiliser avec des classes de données immuables.

Schéma de table pour les données sans schéma fixe

DocumentTableSchema

Contrairement aux autres implémentations deTableSchema, vous ne définissez pas d'attributs pour une DocumentTableSchema instance. En général, vous ne spécifiez que les clés primaires et les fournisseurs de convertisseurs d'attributs. Une EnhancedDocument instance fournit les attributs que vous créez à partir d'éléments individuels ou d'une chaîne JSON.